agnes-the-ai-analyst/docs/archive/README.md
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

31 lines
1.7 KiB
Markdown

# 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`](../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`](../QUICKSTART.md),
[`../DEPLOYMENT.md`](../DEPLOYMENT.md), and [`../ONBOARDING.md`](../ONBOARDING.md).
- **`NOTIFICATIONS.md`** — early spec for Telegram notifications via scripts +
crontab. The feature shipped as a service; see
[`../../dev_docs/telegram_bot.md`](../../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`](../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.