# Komputa Practice

> How Komputa builds software with coding agents: the quality funnel, the life of a program, the rules, the hooks and the evidence behind each rule.

Search these docs before you invent a herdr skill script, hook, rule or file name of Komputa Practice.

## Docs

- [Komputa Practice](https://docs.komputa.io/): How Komputa builds software with coding agents, the evidence behind each rule, and the parts that make it work.

## Explanation

- [Explanation](https://docs.komputa.io/explanation): Why the practice works the way it does.
- [Context economics](https://docs.komputa.io/explanation/context-economics): Where the tokens go when agents run as workers.
- [Framework evidence](https://docs.komputa.io/explanation/framework-evidence): What the practice caught, what it cost, and how the next period is measured.
- [How it fits](https://docs.komputa.io/explanation/how-it-fits): The three places the practice lives, how a project connects to it, and how a rule changes.
- [Model selection](https://docs.komputa.io/explanation/model-selection): How each agent's model is chosen.
- [The archive](https://docs.komputa.io/explanation/archive): What the practice no longer runs, and why.
- [The life of a program](https://docs.komputa.io/explanation/life-of-a-program): One program from the plan to the retirement of its lead, and the check at each step.
- [The quality funnel](https://docs.komputa.io/explanation/quality-funnel): Five layers that catch a mistake, and the rule to catch each one at the highest layer.
- [The watcher](https://docs.komputa.io/explanation/the-watcher): How one small timer keeps a long agent session going while nobody watches it, for example overnight.

## Guides

- [Guides](https://docs.komputa.io/guides): Step-by-step guides for the work you do with the practice.
- [Build a change](https://docs.komputa.io/guides/build-a-change): Take a bug fix or a small feature from the prompt to the merge, with the checks that its risk needs.
- [Run large work as a program](https://docs.komputa.io/guides/large-work): Plan a new app or a large feature as a set of pull requests, and run it in one session over hours or days.
- [Bring the practice to an existing codebase](https://docs.komputa.io/guides/existing-codebase): Add the project template to a repo that already exists, review what it adds, and get its gate green.
- [Run a session overnight](https://docs.komputa.io/guides/overnight): Put a long session on the watch, so a timer nudges it when it goes idle and alerts you when it needs you.
- [Turn a review finding into a rule](https://docs.komputa.io/guides/review-finding-to-rule): After a review, fix each mistake where it starts, in the project, the house rules or the template, so it does not come back.
- [Configuration](https://docs.komputa.io/guides/configure): Every setting of the practice, the file that holds it, and how to change the common ones.
- [Set up the practice for daily use](https://docs.komputa.io/guides/deploy): Choose links or copies, keep a machine in step after a pull, set up a team, give a client a copy, and remove the practice.
- [Contribute to the practice](https://docs.komputa.io/guides/contribute): Change a rule, add a hook or a check, add a template question, or change these docs, with the checks each change needs.

## Reference

- [Reference](https://docs.komputa.io/reference): Look-up pages for the rules, the hooks, the skills and the template questions.
- [Hooks reference](https://docs.komputa.io/reference/hooks): Every hook, from its own header comment.
- [Lead-only rules](https://docs.komputa.io/reference/lead-rules): The extra rules for a lead that starts workers.
- [Repo layout](https://docs.komputa.io/reference/repo-layout): What each folder and file of the practice repo holds.
- [Skills](https://docs.komputa.io/reference/skills): Every skill in the practice, and when an agent uses it.
- [Template questions](https://docs.komputa.io/reference/template-questions): Every question that copier copy asks, from copier.yml.
- [The rules](https://docs.komputa.io/reference/rules): The working rules, and what holds each one.

## Start

- [Introduction](https://docs.komputa.io/start): Why Komputa Practice exists, what makes it different, and how its parts fit.
- [Quickstart](https://docs.komputa.io/start/quickstart): Install Komputa Practice, then make one small, verified change in the sample repo.
- [FAQ](https://docs.komputa.io/start/faq): Short answers to the questions people ask first, each with a link to the page that holds the detail.

## Agent skills

- [komputa-practice](https://docs.komputa.io/.well-known/agent-skills/komputa-practice/SKILL.md): Read the Komputa Practice docs instead of answering from memory. How Komputa builds software with coding agents: the quality funnel, the life of a program, the rules, the hooks and the evidence behind each rule. Use when a task involves Komputa Practice: how it works, how to set it up or configure it, or its API.

## Agent resources

- [llms-full.txt](https://docs.komputa.io/llms-full.txt): The full Markdown of every page in one file.
- [Page Markdown](https://docs.komputa.io/index.md): Append `.md` to any page URL to fetch that page as raw Markdown.
- [JSON API](https://docs.komputa.io/api/docs/pages.json): Page index of the JSON docs API; each entry links the page's JSON and Markdown forms. Described by the OpenAPI document at https://docs.komputa.io/openapi.json.
- [MCP server](https://docs.komputa.io/mcp): Streamable HTTP Model Context Protocol server with search_docs, get_page, list_pages, and get_navigation tools, plus every page as a resource. Discovery document: https://docs.komputa.io/.well-known/mcp.json
- [Agent skills](https://docs.komputa.io/.well-known/agent-skills/index.json): Agent Skills discovery index of the skills this site publishes.
- [API catalog](https://docs.komputa.io/.well-known/api-catalog): RFC 9727 linkset of the APIs documented here.
- [AI catalog](https://docs.komputa.io/.well-known/ai-catalog.json): ARD manifest of the agent-facing resources on this site (MCP server, skills, APIs).
- [agent-readability.json](https://docs.komputa.io/agent-readability.json): Manifest of every agent-facing artifact on this site.
- [Sitemap](https://docs.komputa.io/sitemap.xml): Every indexable page URL with its last-modified date.