kata-flight

Kata Flight

Kata Flight is a Claude Code and Codex plugin that wraps kata issue resolution, roborev review handling, and optional RDR-backed planning into a repeatable shipping workflow.

It is intentionally only a skill repository. The runtime dependencies are the kata and roborev CLIs, plus any agent harness that can install local skills. RDR support is a binding to an RDR process, not an embedded copy of RDR.

How It Fits Together

kata-flight drives a batch: it orders a wave of katas, runs them through the scope-review gate, and ships each one with kata-ship (resolve → roborev refine → fast-forward merge → close). Design-fork katas peel off to kind:rdr-seed and enter the RDR track; RDR implementations land and flight their bug children back through the same loop.

In the diagrams: a leading / marks an invokable skill (slash command); purple rectangles are skills, amber parallelograms are kata label/issue states, the hexagon is the external RDR engine's multi-stage flow, gray dashed boxes are reference libraries (read by §anchor, not invokable), and the blue stadium is the external roborev tool.

flowchart TD
    init["/kata-flight-init<br/>(bind repo)"] -.setup.-> flight
    doctor["/kata-flight-doctor<br/>(health check)"]
    ops["/kata-flow-ops<br/>(dashboard / reaper)"]
    kinbox["/kata-inbox<br/>(human inbox drain)"]

    flight["/kata-flight<br/>batch orchestrator"]
    review["/kata-scope-review<br/>review gate"]
    kship["/kata-ship<br/>single-kata ship"]
    resolve["/kata-resolve<br/>fix in worktree"]
    roborev(["roborev refine / respond"])

    flight -->|"per wave"| review
    flight -->|"per kata"| kship
    kship -->|"resolve"| resolve
    kship -->|"refine"| roborev

    review -->|"design fork"| seed[/"kind:rdr-seed<br/>(kata label)"/]
    review -->|"held / needs human"| inbox[/"inbox:*<br/>(kata label)"/]
    inbox --> kinbox
    kinbox -->|"READY"| flight
    kinbox -->|"TO-SEED"| seed
    seed --> seedtri["/rdr-seed-triage"]
    seedtri -->|"/rdr-seed (Stage 1)"| rdrflow{{"RDR design flow<br/>Stages 1-7 (external engine)"}}
    rdrflow --> impltri["/rdr-implement-triage<br/>(Stage 8: build)"]
    impltri --> roretri["/roborev-triage"]
    impltri --> implland["/rdr-implement-land<br/>(land)"]
    implland -->|"flight bug children"| flight

    pship["/prompt-ship"] -->|"refine"| roborev

    wsp["worktree-ship-pipeline"]:::lib -. read by .-> kship
    wsp -. read by .-> pship
    lland["lib-land-rdr"]:::lib -. read by .-> impltri
    lland -. read by .-> implland

    classDef skill fill:#EDE9FE,stroke:#7C3AED,color:#1E1B4B;
    classDef lib fill:#F5F5F4,stroke:#A8A29E,color:#1C1917,stroke-dasharray:4 3;
    classDef label fill:#FEF3C7,stroke:#D97706,color:#713F12;
    classDef ext fill:#DBEAFE,stroke:#2563EB,color:#1E3A8A;

    class init,doctor,ops,kinbox,flight,review,kship,resolve,seedtri,impltri,roretri,implland,pship skill;
    class seed,inbox label;
    class roborev,rdrflow ext;

See ARCHITECTURE.md for the skill-role table, the flight/review ship loop, and the rdr-seed peel-off in detail.

Runtime Dependencies

• kata — local-first issue tracking. Install and docs: https://katatracker.com/. Go install: go install go.kenn.io/kata/cmd/kata@latest.
• roborev — local continuous code review for agents. Install and docs: https://roborev.io/. Quick install: curl -fsSL https://roborev.io/install.sh | bash, or go install go.kenn.io/roborev/cmd/roborev@latest.

Optional Integration

• rdr — Recommendation Decisioning Records, the external RDR process the RDR-aware skills bind to. Optional: kata-only skills work without it. Source: https://github.com/cwensel/rdr. Bind a checkout with --rdr-home or the auto-detection described under Bind a Project.
• arc (Arcaneum) — optional corpus search for RDR/reference grounding, quotes, and prior art. Not a runtime dependency; init records whether arc is present but selects no corpora. Source: https://github.com/cwensel/arcaneum.

Install

Claude

/plugin marketplace add cwensel/kata-flight
/plugin install kata-flight@kata-flight

Codex

codex plugin marketplace add /path/to/kata-flight
codex plugin add kata-flight@kata-flight

Plugin versions use SemVer in .claude-plugin/plugin.json and .codex-plugin/plugin.json. Keep them in sync with ./bump.sh <patch|minor|major|X.Y.Z>, which also creates the release commit and vX.Y.Z tag.

To confirm the install path works end-to-end in a clean container (no host state touched), run the smoke test in test/install:

docker build -t kata-flight-installtest test/install
docker run --rm kata-flight-installtest

The canonical kata JSON helpers in scripts/kata-q.sh have an offline test (captured fixtures, no kata daemon needed):

bash test/kata-json/run.sh