Skip to content

feat: Kata Manager Project — multi-project control plane #23

@codevibesmatter

Description

@codevibesmatter

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 upgradebatteries --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

  1. P1: Surgical fixes (B11-B13)
  2. P2: Manager foundation — init, discovery, registry, list (B1-B4)
  3. P3: Project management — init from manager, doctor, upgrade (B5-B7)
  4. P4: Config operations — compare, sync, backup (B8-B10)
  5. 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

Metadata

Metadata

Assignees

No one assigned

    Labels

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions