a48524509a
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.
31 lines
1.5 KiB
Markdown
31 lines
1.5 KiB
Markdown
# Release Checklist
|
|
|
|
Pre-merge checks for changes that touch sensitive paths. Each section below
|
|
applies only when the PR diff intersects the listed files.
|
|
|
|
## Bootstrap path changes (mandatory pre-merge)
|
|
|
|
For any PR touching the analyst-bootstrap path (`agnes init`, `cli/lib/pull.py`,
|
|
`cli/lib/hooks.py`, `app/web/setup_instructions.py`, `/api/welcome`,
|
|
`config/agnes_workspace_template.txt`), run this protocol locally before
|
|
requesting review:
|
|
|
|
1. `git clean -fdx` in the repo (no build artifacts).
|
|
2. Boot FastAPI locally against a clean test instance state.
|
|
3. Empty terminal in `/tmp/test-analyst-1`. From the web `/setup?role=analyst`,
|
|
click the analyst tile and copy the paste prompt.
|
|
4. Paste into Claude Code and let it run. `tree -a /tmp/test-analyst-1` and
|
|
compare with the expected tree from the design spec
|
|
(`docs/archive/superpowers/specs/2026-05-04-clean-analyst-bootstrap-design.md` §5.2).
|
|
5. `claude` in that folder. Three queries:
|
|
- "What tables can I see?"
|
|
- "SELECT count(\*) FROM <t>" (a table from the catalog)
|
|
- "Show me last 5 rows of <t>"
|
|
All must work without further intervention.
|
|
6. `/exit`. Verify SessionEnd hook ran (server-side audit log shows `agnes push`;
|
|
`du -sh /tmp/test-analyst-1/user/sessions/` non-empty).
|
|
7. Second `claude` in same folder. Verify SessionStart hook fires
|
|
(`agnes pull` request in audit log).
|
|
8. Second workspace `/tmp/test-analyst-2` with the same PAT (within TTL).
|
|
Repeat steps 5-7. Verify global `~/.config/agnes/` is not duplicated;
|
|
the second workspace has its own DuckDB.
|