Summary
Standalone manager project at ~/.kata/manager/ that acts as a control plane for all kata-enabled projects. First-class kata projects subcommand tree.
Key capabilities
- Auto-discover kata projects from
~/.claude/projects/ + manual add/remove
- List all projects with version, mode, layout info
- Init from manager — set up new projects from outside (avoids hook loops)
- Cross-project doctor — health checks across all projects
- Bulk upgrade —
batteries --update across all projects
- Compare/sync/backup — config operations between projects
Bundled surgical fixes (from config traceability audit)
- Stop condition enum (no more magic strings)
- Remove hardcoded mode names in enter.ts/suggest.ts
- Dead field cleanup (micro_planning, workflow_prefix, VALID_CATEGORIES)
Implementation phases
- P1: Surgical fixes (B11-B13)
- P2: Manager foundation — init, discovery, registry, list (B1-B4)
- P3: Project management — init from manager, doctor, upgrade (B5-B7)
- P4: Config operations — compare, sync, backup (B8-B10)
- P5: Tests and verification
Spec
planning/specs/24-kata-manager-project.md
Research
planning/research/2026-02-25-config-traceability-refactor.md
planning/research/2026-02-25-kata-manager-project.md
Summary
Standalone manager project at
~/.kata/manager/that acts as a control plane for all kata-enabled projects. First-classkata projectssubcommand tree.Key capabilities
~/.claude/projects/+ manual add/removebatteries --updateacross all projectsBundled surgical fixes (from config traceability audit)
Implementation phases
Spec
planning/specs/24-kata-manager-project.mdResearch
planning/research/2026-02-25-config-traceability-refactor.mdplanning/research/2026-02-25-kata-manager-project.md