Phases (maintainer hub)
Planning notes under docs/phases/. They are synced to the Nextra docs site with the rest of docs/ (same content as in git / the published repo). Product docs also live under docs/commands/, docs/architecture/, docs/regex/.
Session scratch: docs/phases/temp/ is gitignored — see agents/temp-notes.md.
Start here
Hub: active-phase.md
One-page CLI plan (order: locales → generate/fill → key-sites → patching): CLI-ROADMAP-HANDOFF.md
| Area | Status |
|---|---|
CLI (locales, generate/fill progress, identity-streak) | Active — see handoff + locales.md, generate.md |
i18nprune.dev / apps/web | Active (parallel) — i18nprune.dev.md; residual demo/report embed |
Exports + baseline --json parity | Done — exports/README.md, cli-json-command-parity.md |
Completed (reference):
- exports/README.md — namespaces, JSON envelope, programmatic
run* - commands.md — command orchestrator boundary (
completed) - Key reference +
cleanup --ask— key-reference-unification.md, interactive-key-confirmation.md
| Doc | Role |
|---|---|
| key-reference-unification.md | reference config, core/preserve, key context, ripgrep modes |
| interactive-key-confirmation.md | --ask / --ask-per-key behavior and precedence |
All phase files (index)
| File | Summary |
|---|---|
| active-phase.md | Current sprint hub |
| CLI-ROADMAP-HANDOFF.md | CLI execution order + generate/fill + CepatEdge identity streak |
| key-reference-unification.md | Preserve + reference + detection docs links |
| interactive-key-confirmation.md | Interactive removal confirmations |
| i18nprune.dev.md | Public web / apps/web |
| web-report-i18n.md | Full i18n for apps/web + apps/report (after app churn settles) |
| Prompts & CLI boundaries | Where Inquirer runs, --json / CI skips, utils debt (maintainer) |
| extension/README.md | VS Code extension — plan, gates, tracks (apps/extension) |
| key-sites.md | keySites milestone notes |
| generate.md | generate command phase notes |
| missing.md | missing command |
| report.md | report command |
| versioning.md | CLI version / registry |
| locales.md | locales subcommands backlog |
| missing-pipeline.md | Pipeline automation ideas |
| validate.md | Rich validate backlog |
| commands.md | Command orchestrator boundary (commands orchestrate; core owns logic) |
| exports/README.md | Exports phase (completed — checklist + api-surface, docs-sync, alignment notes) |
| patching/README.md | Loader + patching phase hub |
| patching/loader.md | Maintainer checklist (canonical spec: patching/loader.md) |
| elit-tier/README.md | Integrations / plugins ideas |
Public pointers
- Roadmap — product direction
- Workflow — local dev
- Detection limits — what static analysis can prove
Phase rules
docs/phases/**is tracked in git (source of maintainer execution context).- Keep one active sprint in active-phase.md; mark completed work in the relevant phase README (avoid duplicate COMPLETED.md files unless a long archive is explicitly needed).
- Do not delete completed phase docs unless their decisions are preserved in ADRs/architecture docs or a canonical replacement phase README.
- Keep each phase actionable: explicit checklist, status, and clear handoff links.