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/RELEASE_CHECKLIST.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

1.5 KiB
Raw Blame History

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 " (a table from the catalog)
    • "Show me last 5 rows of " 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.