# Documentation


Kata is a practice for a team of coding agents. The team works one cycle a day,
and each job below covers one part of that cycle. Start with the setup job. Then
pick the job you have in front of you now.

## Set Up the Team (Teams Using Agents)

<div class="grid">

<a href="getting-started/">
<h3>Getting Started: Your First Kata Shift</h3>
<p>Install the Kata skill pack. Generate the shift workflow. Run one scheduled shift. Read the memory, traces, and pull requests it leaves behind.</p>
</a>

</div>

## Run a Continuously Improving Agent Team (Teams Using Agents)

<div class="grid">

<a href="continuous-improvement/">
<h3>Run a Continuously Improving Agent Team</h3>
<p>Run the daily Plan-Do-Study-Act cycle with an agent team. Every shift leaves evidence behind. Every finding re-enters the loop as a pushed fix or a pushed spec.</p>
</a>

<a href="continuous-improvement/agent-roster/">
<h3>Choose and Scope Your Agent Roster</h3>
<p>Decide which agent personas run in your repository. Write the scope constraints that turn an out-of-scope finding into a spec instead of an unreviewed fix.</p>
</a>

<a href="continuous-improvement/team-memory/">
<h3>Keep Team Memory and Coordination Apart</h3>
<p>Memory holds an agent's own state. Coordination needs a named receiver and an addressable artifact. Learn where the line sits. Learn what breaks when a team buries a handoff in the wiki.</p>
</a>

<a href="continuous-improvement/daily-storyboard/">
<h3>Run the Daily Storyboard and Coaching Session</h3>
<p>Facilitate the team storyboard meeting and the one-on-one coaching session with the Toyota Kata five questions. Every experiment then starts from measured data instead of an impression.</p>
</a>

<a href="continuous-improvement/findings-to-action/">
<h3>Turn Study Findings into Fixes and Specs</h3>
<p>Classify every Study finding once. Then route it to a fix branch, a spec branch, a Discussion, or a close. Fix branches and spec branches never mix. A local commit is never a completion signal.</p>
</a>

</div>

## Take a Change from Spec to Shipped (Teams Using Agents)

<div class="grid">

<a href="spec-to-shipped/">
<h3>Take a Change from Spec to Shipped</h3>
<p>Walk one change through the full arc: spec, design, plan, implementation, independent review, merge, and release. Each phase produces one artifact that answers one question.</p>
</a>

<a href="spec-to-shipped/approval-gates/">
<h3>Set the Approval Gates and Trust Boundary</h3>
<p>Decide what your agents may approve and what a human must approve. Then make the approval signal travel from a human action to the state file the agents read at merge time.</p>
</a>

</div>

Kata ships skills and agent profiles. It ships no command of its own. Three
other standards carry the parts underneath it, and each one has its own site.

- The runtime is [Gemba](https://www.gemba.team/docs/). Kata skills call the
  `gemba-*` commands to run a session, read a trace, hold memory, and chart a
  metric. Read every command surface there.
- The instruction architecture is [Jidoka](https://www.jidoka.team/docs/). Use
  it when you author or repair an agent profile, a skill file, or a checklist.
- The repository shape is [Monorepo](https://www.monorepo.team/). It names the
  root files and the directory tree an adopting repository carries.
