learning_ai_notes/docs/roadmaps/07_QA_RELEASE_DOCS_ROADMAP.md

QA, Release, and Docs Roadmap

Status: Draft Parent: docs/ROADMAP.md

Phase Q0 — Foundations

• Define local run commands
• Define test commands
• Define typecheck commands
• Define smoke-check commands
• Define manual QA matrix

Phase Q1 — MVP Coverage

• Backend CRUD/search test coverage
• Web flow coverage
• Mobile smoke coverage
• Platform integration smoke coverage
• Artifact/task/relationship test coverage

Phase Q2 — Agent Coverage

• MCP tool tests
• Approval workflow tests
• Audit verification tests
• Regression coverage for agent-mediated note changes

Phase Q3 — Release

• Production-readiness checklist
• Release commands and docs
• Deferred-items list
• PRD and roadmap status update
• Local development workflow docs
• Agent ownership/runbook docs

Continuous Documentation Tasks

• Keep PRD aligned with implementation reality
• Keep ROADMAP.md phase status current
• Keep workstream docs updated when scope changes
• Record known limitations and explicit deferrals

Progress Notes

• 2026-03-10 — Added initial backend verification command set:
  • run: cd backend && npm run dev
  • build: cd backend && npm run build
  • test: cd backend && npm test
  • typecheck: cd backend && npm run typecheck
• These commands are defined but not yet executed because the new backend package still needs dependency installation.

Open Questions

• Should smoke checks include both /health and /ready once local env is configured?
• What minimum regression matrix is required before MCP mutating tools begin landing?

Blockers

• Backend and web package installation/verification are still pending.

Deferred

• Production-readiness checklist
• Full manual QA matrix
• Agent ownership and release runbooks

Done When

• Build/test/release flows are documented and repeatable
• QA coverage is good enough to support multi-agent development safely
• Docs reflect shipped state rather than planned-only state