docs: drop docs/INDEX.md, add PRD README with format

Remove the one-line docs/INDEX.md (its directory pointers are covered
by docs/README.md's "when to write which document" table). Add
docs/prds/README.md documenting the PRD naming, Status lifecycle, and
section format. Repoint the AGENTS.md repository-layout list at the
new READMEs and add the decisions/ dir.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
2026-05-28 22:26:09 -04:00
parent 1308e61c7e
commit d329e511fd
3 changed files with 67 additions and 4 deletions
+4 -3
View File
@@ -28,9 +28,10 @@ the container lifecycle and the copying of skills and env vars into it.
- `bot-bottle.json` — legacy manifest of named agents (env / skills / prompt
per agent), consumed by `cli.py`. See "Manifest" under
"Intended design".
- `docs/INDEX.md`pointer to the research notes.
- `docs/prds/` — product requirement docs.
- `docs/research/` — research notes (empty for now, kept tracked via `.gitkeep`).
- `docs/README.md`docs overview; when to write which document.
- `docs/prds/` — product requirement docs (see `docs/prds/README.md` for format).
- `docs/research/` — research notes.
- `docs/decisions/` — decision records (ADR-lite).
## Conventions