Sweep operator runbooks (docs/QUICKSTART, docs/HEADLESS_USAGE, docs/architecture, docs/sample-data, docs/agent-workspace-prompt, docs/metrics/metrics.yml, dev_docs/server, dev_docs/disaster-recovery), the corporate-memory service README, the jira connector README + backfill scripts, the deploy skill, and test docstrings. Replaces `da sync` → `agnes pull`, `da analyst setup` → `agnes init`, `da metrics ...` → `agnes catalog --metrics` / `agnes admin metrics ...`, `da fetch` → `agnes snapshot create`, plus the matching docker-compose admin invocations. Vendor-specific `/opt/data-analyst/` install paths in jira backfill / consistency scripts and operator docs are replaced with the placeholder `<install-dir>` and a new `AGNES_ENV_FILE` env-var override that lets a deployment inject its actual install path without a code change. Aligns with the OSS vendor-agnostic policy in CLAUDE.md. CHANGELOG `### Internal` entry summarizes the audit and reaffirms the intentional stale-marker tuples (`_LEGACY_STRINGS`, `_OUR_COMMAND_MARKERS`) that must keep referencing `da sync` / `da fetch` / etc. for hook upgrade and override-detection logic. |
||
|---|---|---|
| .. | ||
| design-system.md | ||
| desktop-app.md | ||
| disaster-recovery.md | ||
| insights.md | ||
| README.md | ||
| security.md | ||
| server.md | ||
| session_explore.md | ||
| telegram_bot.md | ||
Developer Documentation
This folder contains documentation for developers and server administrators only.
⚠️ This folder is NOT synced to analyst machines - it stays on the server and in the git repository only.
Contents
Server Administration
server.md- Data broker server configuration and managementdisaster-recovery.md- Recovery procedures for server failuressecurity.md- Security audit report and hardening guidelinesjira.md- Jira webhook integration and server-side processing
Application Development
desktop-app.md- macOS desktop app architecture and developmenttelegram_bot.md- Telegram notification bot technical docsdesign-system.md- UI/UX design system for web applicationsinsights.md- Activity Center dashboard feature documentation
Planning & Meetings
meetings/- Meeting transcripts, summaries, and notes
For Analysts
If you're an analyst looking for documentation on how to use the platform, see the docs/ folder instead:
docs/GETTING_STARTED.md- Quick start guidedocs/data_description.md- Data schemas and table definitionsdocs/metrics/- Business metric definitionsdocs/jira_schema.md- Jira data schema referencedocs/notifications.md- How to use Telegram notifications in your scripts