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/docs/archive
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
..
superpowers docs: consolidate and de-clutter the documentation tree (#306) 2026-05-14 18:54:22 +00:00
HACKATHON.md docs: consolidate and de-clutter the documentation tree (#306) 2026-05-14 18:54:22 +00:00
NOTIFICATIONS.md docs: consolidate and de-clutter the documentation tree (#306) 2026-05-14 18:54:22 +00:00
pd-ps-comments.md docs: consolidate and de-clutter the documentation tree (#306) 2026-05-14 18:54:22 +00:00
README.md docs: consolidate and de-clutter the documentation tree (#306) 2026-05-14 18:54:22 +00:00
security-audit-2026-04.md docs: consolidate and de-clutter the documentation tree (#306) 2026-05-14 18:54:22 +00:00

README.md

Archived documentation

Historical artifacts kept for reference but not maintained. Nothing here is current guidance — paths, line numbers, and APIs cited inside these files reflect the state of the repo when they were written. For live docs, start at ../README.md.

Contents

  • superpowers/ — implementation plans (plans/) and design specs (specs/) from past development sprints. Each file is a point-in-time planning artifact for a feature that has since shipped (or been dropped). Useful as a record of why something was built a certain way; useless as a guide to what the code does now — read the code and CHANGELOG.md for that.
  • HACKATHON.md — condensed deploy + dev playbook written for a hackathon sprint. Superseded by ../QUICKSTART.md, ../DEPLOYMENT.md, and ../ONBOARDING.md.
  • NOTIFICATIONS.md — early spec for Telegram notifications via scripts + crontab. The feature shipped as a service; see ../../dev_docs/telegram_bot.md.
  • pd-ps-comments.md — review notes on the corporate-memory v1 branch. Accepted decisions live in ../ADR-corporate-memory-v1.md.
  • security-audit-2026-04.md — point-in-time security audit snapshot. Findings addressed in later releases; see CHANGELOG.md.

Policy

Don't edit archived files to "fix" stale references — rewriting historical planning artifacts is revisionist and loses the record of what was actually decided when. If an archived doc is genuinely worthless, delete it; otherwise leave it as-is.