Talk to It Like a Person
Drive your entire workflow with natural language. Say "Start a new project" or "Debug this login issue" and Kata routes to the right workflow automatically.
型を練習する
型
/ˈkɑːtɑː/ noun
a choreographed pattern practiced repeatedly until perfected
Agent orchestration for
spec-driven development
Drive your entire workflow with natural language.
$
npx @gannonh/kata
Scroll
Built for how
Claude actually performs
Context engineering designed for Claude Code.
Context Engineering
Kata maintains your project vision, tracks progress, and remembers decisions across sessions. Claude stays aligned without repeated explanation.
Multi-Agent Orchestration
Thin orchestrators spawn specialized agents for research, planning, and execution. Your main context stays lean while work happens in fresh 200k windows.
Atomic Git Commits
Each task gets its own commit immediately after completion. Clean history, easy bisect, independently revertable. Every commit is traceable.
XML Prompt Formatting
Every plan is structured XML optimized for Claude. Precise instructions with verification built in. No ambiguity, no drift.
Modular by Design
Add phases, insert urgent work, complete milestones. The system adapts to changing requirements without rebuilding everything.
From idea to
working software
A deliberate sequence. Each step builds on the last. Context stays fresh. Quality stays high.
01
"Start a new project" or /kata:new-project Initialize Project
One command, one flow. Questions until it understands your idea completely, then research, requirements, and roadmap.
Creates:
PROJECT.mdREQUIREMENTS.mdROADMAP.mdSTATE.md 02
"Let's discuss phase 1" or /kata:discuss-phase 1 Discuss Phase
Shape the implementation. Kata identifies gray areas and asks until you're satisfied. Output feeds directly into research and planning.
Creates:
{phase}-CONTEXT.md 03
"Plan phase 1" or /kata:plan-phase 1 Plan Phase
Researches how to implement, creates atomic task plans with XML structure, verifies against requirements. Each plan fits in a fresh context.
Creates:
{phase}-RESEARCH.md{phase}-{N}-PLAN.md 04
"Execute phase 1" or /kata:execute-phase 1 Execute Phase
Plans run in parallel waves. Fresh 200k context per plan. Atomic commits per task. Walk away, come back to completed work.
Creates:
{phase}-{N}-SUMMARY.md{phase}-VERIFICATION.md 05
"Verify phase 1" or /kata:verify-work 1 Verify Work
Confirm it actually works. Walk through testable deliverables one at a time. If broken, spawns debug agents and creates fix plans.
Creates:
{phase}-UAT.md Repeat for each phase →
/kata:complete-milestone → /kata:new-milestone
All commands respond to
natural language
"What's my progress?" works the same as /kata:progress. Slash commands exist for precision when you want them.
Core Workflow
/kata:new-project Full initialization: questions → research → requirements → roadmap /kata:discuss-phase [N] Capture implementation decisions before planning /kata:plan-phase [N] Research + plan + verify for a phase /kata:execute-phase <N> Execute all plans in parallel waves, verify when complete /kata:verify-work [N] Manual user acceptance testing /kata:complete-milestone Archive milestone, tag release /kata:new-milestone [name] Start next version Navigation
/kata:progress Where am I? What's next? /kata:help Show all commands and usage guide /kata:whats-new See what changed since your installed version /kata:update Update Kata with changelog preview Phase Management
/kata:add-phase Append phase to roadmap /kata:insert-phase [N] Insert urgent work between phases /kata:remove-phase [N] Remove future phase, renumber /kata:map-codebase Analyze existing codebase before new-project Utilities
/kata:settings Configure model profile and workflow agents /kata:quick Execute ad-hoc task with Kata guarantees /kata:debug [desc] Systematic debugging with persistent state /kata:pause-work Create handoff when stopping mid-phase /kata:resume-work Restore from last session