AI-Cognitive-Leap/agnes-the-ai-analyst
2
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
agnes-the-ai-analyst/dev_docs
History
ZdenekSrotyr a48524509a
docs: consolidate and de-clutter the documentation tree (#306) 
CLAUDE.md rewritten (708 -> ~320 lines): four overlapping release
sections collapsed to one, stale v1->v35 schema history dropped (it
lives in CHANGELOG), marketplace endpoint internals and verbose
process sections moved out or tightened.

New focused docs:
- docs/RELEASING.md - release process, deploy workflows, CI quirks
  (RELEASE_TEMPLATE.md folded in as an appendix)
- docs/marketplace.md - marketplace ingestion + re-serving internals
- docs/README.md - documentation index by audience, linked from
  README.md and CLAUDE.md

Archived under docs/archive/: docs/superpowers/ (52 historical
planning artifacts), HACKATHON.md, pd-ps-comments.md,
security-audit-2026-04.md, future/NOTIFICATIONS.md.

Removed the docs/auto-install.md stub. Fixed dangling links in
connectors/jira/README.md and dev_docs/README.md, repointed
code/doc references to archived paths.
2026-05-14 18:54:22 +00:00
..
design-system.md Initial commit: OSS data distribution platform 2026-03-08 23:31:28 +01:00
desktop-app.md Update paths in docs and sudoers after services/ extraction 2026-03-09 13:02:13 +01:00
disaster-recovery.md chore(docs): replace stale da verbs and vendor-specific install paths 2026-05-04 21:22:19 +02:00
insights.md chore: clean repo for public release — fix references, remove drafts 2026-04-08 19:27:25 +02:00
README.md docs: consolidate and de-clutter the documentation tree (#306) 2026-05-14 18:54:22 +00:00
security.md Update paths in docs and sudoers after services/ extraction 2026-03-09 13:02:13 +01:00
server.md chore(docs): replace stale da verbs and vendor-specific install paths 2026-05-04 21:22:19 +02:00
session_explore.md Security fixes: sanitize dev_docs, harden sudoers and config validation 2026-03-09 08:06:45 +01:00
telegram_bot.md feat(observability): request_id end-to-end + dev debug toolbar + centralized logging (#136) 2026-04-29 22:54:21 +02:00

README.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 management
  • disaster-recovery.md — recovery procedures for server failures
  • security.md — security audit report and hardening guidelines

Application Development

  • desktop-app.md — macOS desktop app architecture and development
  • telegram_bot.md — Telegram notification bot technical docs
  • design-system.md — UI/UX design system for web applications
  • insights.md — Activity Center dashboard feature documentation
  • session_explore.md — session exploration tooling

Jira webhook integration and server-side processing is documented in ../connectors/jira/README.md.

For Analysts

If you're an analyst looking for documentation on how to use the platform, see the docs/ folder instead — start at ../docs/README.md for the full index. Key entry points:

  • docs/QUICKSTART.md — quick start guide
  • docs/DATA_SOURCES.md — data sources and table definitions
  • docs/metrics/ — business metric definitions
  • docs/HOWTO/ — task-oriented analyst cookbook