Release checklist
Release identity
pyproject.tomlversion updatedsrc/aictx/_version.pyupdated- README documented implementation updated
docs/UPGRADE.mdcurrent runtime updatedCHANGELOG.mdupdated- official website / repository / PyPI package links validated
- tag format is
vX.Y.Z
Product clarity
- README explains normal agent-driven workflow
- README does not make AICTX look like a manual CLI-only tool
- README is Codex-first, GitHub Copilot-aware, Claude-aware, generic-agent compatible
- README shows real startup identity format
- RepoMap has appropriate visibility
- Install/init flow is documented with example answers
- Communication mode is documented under init, not install
- Cleanup is documented
- Technical overview covers all runtime capabilities
aictx doctor --repo . --release-readiness --jsonreflects release diagnostics without modifying repo state- Docs distinguish
internal bootdiagnostic output from user-visible startup banner - Strategy Memory and Handoffs have dedicated docs if listed as README core concepts
- Limitations remain honest
git check-ignoretests cover portable/local-only artifactsdocs/PORTABILITY.mdupdatedaictx portability status --repo . --jsondocumentedaictx portability compact --repo . --apply --jsondocumentedaictx init --yesdoes not enable portability by default- portability can be enabled after local-only init
- portability can be disabled after being enabled
- messages mute/unmute/status tested
- default message mode is unmuted
- muted mode suppresses startup banner
- muted mode suppresses agent summary text
- explicit command output still works
Validation
python -m pytest -q
python -m build
aictx doctor --repo . --release-readiness --json