> The Markdown version of [aayudha](overview.html) on the aayudha docs site. Every page is listed in [llms.txt](llms.txt). # aayudha Your coding agent can write a feature in an afternoon. aayudha is the delivery team around it: it turns a vague idea into clear promises, checks every change against them before it merges, and measures whether the result helped. It works inside the agent you already use (Claude Code, Codex, Cursor, or Amp), on your GitHub repository. - **Clear work.** An interview turns "make it faster" into a Goal with a baseline, and stories with numbered promises. - **Proof before merge.** A merge gate runs fixed checks in your CI, then sends each ready pull request that is not docs-only for review, by default to a review model you choose, with one key in your CI ([who reviews when](https://github.com/rahulnakmol/agentic-ayudha/blob/de79988060cd4c1522adb9e991f78cc9e58b9a68/docs/releases/v0.3.0.md?utm_campaign=docs-site&utm_medium=docs&utm_source=agentic-ayudha#whats-new)). - **A person decides.** An agent's change merges without a person only on proof, which is off by default, or on a long correction-free streak, and every bypass is recorded ([how a change joins](https://github.com/rahulnakmol/agentic-ayudha/blob/de79988060cd4c1522adb9e991f78cc9e58b9a68/docs/releases/v0.3.0.md?utm_campaign=docs-site&utm_medium=docs&utm_source=agentic-ayudha#how-a-change-joins-your-code-now)). **New in v0.3.0:** a story's pull request can merge on proof, and each project names one review tool. Read [what's new](https://github.com/rahulnakmol/agentic-ayudha/blob/de79988060cd4c1522adb9e991f78cc9e58b9a68/docs/releases/v0.3.0.md?utm_campaign=docs-site&utm_medium=docs&utm_source=agentic-ayudha#whats-new) and [how to upgrade](https://github.com/rahulnakmol/agentic-ayudha/blob/de79988060cd4c1522adb9e991f78cc9e58b9a68/docs/releases/v0.3.0.md?utm_campaign=docs-site&utm_medium=docs&utm_source=agentic-ayudha#upgrade). It is not a coding agent and it does not run your production. It organises, checks, and records the work your agent does. ![A terminal running aayu tour: it checks the machine, asks which agent you use, sets the repository up with aayu init and aayu install, and reaches Level 1. Then aayu next names the one next step: aayu grill story.](docs/guide/media/first-run.svg) ## Install ```sh curl -fsSL https://raw.githubusercontent.com/rahulnakmol/agentic-ayudha/main/install.sh | sh ``` The script installs the latest signed release as `aayudha`, with the short name `aayu`. It checks the release's signature and checksum before it copies anything. It needs `git` 2.40 or newer and `git-lfs`. Other ways to install are in [Install and connect](getting-started.md). ## Your first run In a clone of your repository, signed in to GitHub (`gh auth login`): ```sh aayu tour ``` The tour checks your machine, asks which agent you use, then runs `aayu init` and `aayu install`. Each one shows what it will write and asks first. It adds labels, issue forms, a config file, and a records branch. It adds no CI workflows and needs no keys. Commit what it wrote in a pull request. Then open your agent in the repository and ask: > Use the grill skill to write a story: people should be able to export their report as CSV. The agent interviews you, one question at a time, until the story has numbered promises a person could check. It files the story on GitHub. Then run `aayu ready `: you will see a `status:ready` label and a comment that freezes what was agreed. Lost at any point? `aayu next` prints the one next step. ## Where to go next - [Your first hour](start.md): the same steps, with what you should see after each one. - [The story](journey.md): one real day, from a goal to a measured release, setbacks included. - [When to use what](when-to-use-what.md): start from your situation and find the command. - [How it works](how-it-works.md): the architecture, file formats, and guarantees, for engineers. All of it is on [the docs site](https://rahulnakmol.github.io/agentic-ayudha/?utm_campaign=docs-site&utm_medium=docs&utm_source=agentic-ayudha). Agents can read the same docs as Markdown, starting from [llms.txt](https://rahulnakmol.github.io/agentic-ayudha/llms.txt?utm_campaign=docs-site&utm_medium=docs&utm_source=agentic-ayudha). What's new: the [v0.3.0 release notes](https://github.com/rahulnakmol/agentic-ayudha/blob/de79988060cd4c1522adb9e991f78cc9e58b9a68/docs/releases/v0.3.0.md?utm_campaign=docs-site&utm_medium=docs&utm_source=agentic-ayudha) say what the release does for you, and how to upgrade. ## Adopt at your own pace 1. **Level 1, clear work items.** Free, no keys, no CI changes: what the tour sets up. 2. **Level 2, proof on every pull request.** The merge gate and its fixed checks run in your CI, and a review model you choose, with one key, reviews each ready change that is not docs-only ([who reviews when](https://github.com/rahulnakmol/agentic-ayudha/blob/de79988060cd4c1522adb9e991f78cc9e58b9a68/docs/releases/v0.3.0.md?utm_campaign=docs-site&utm_medium=docs&utm_source=agentic-ayudha#whats-new)). 3. **Level 3, autonomy and loops.** Scheduled and event-driven work in your agent's own tools, and agents that earn more freedom as their record grows. [Adopt at your own pace](adopt.md) says what each level costs and gives. ## Project aayudha is free and open source under the BSD-3-Clause licence ([LICENSE](https://github.com/rahulnakmol/agentic-ayudha/blob/de79988060cd4c1522adb9e991f78cc9e58b9a68/LICENSE?utm_campaign=docs-site&utm_medium=docs&utm_source=agentic-ayudha), [THIRD_PARTY_NOTICES.md](https://github.com/rahulnakmol/agentic-ayudha/blob/de79988060cd4c1522adb9e991f78cc9e58b9a68/THIRD_PARTY_NOTICES.md?utm_campaign=docs-site&utm_medium=docs&utm_source=agentic-ayudha)). [CONTRIBUTING.md](contributing.md) explains how to send a change, [SECURITY.md](security.md) how to report a vulnerability, and [the project reference](reference.md) lists the branches, every verb, and the governance files. Coding agents working on this repository start at [AGENTS.md](https://github.com/rahulnakmol/agentic-ayudha/blob/de79988060cd4c1522adb9e991f78cc9e58b9a68/AGENTS.md?utm_campaign=docs-site&utm_medium=docs&utm_source=agentic-ayudha). ## Proven Features A Feature is listed here once every shipped story under it has an authoritative proof pack. These are the only work items this site links. - [M4.5 Thin slice run](https://github.com/rahulnakmol/agentic-ayudha/issues/37?utm_campaign=docs-site&utm_medium=docs&utm_source=agentic-ayudha) (#37) - [Grounded answers API (benefits-qa)](https://github.com/rahulnakmol/agentic-ayudha/issues/127?utm_campaign=docs-site&utm_medium=docs&utm_source=agentic-ayudha) (#127) - [Answer analytics (benefits-qa)](https://github.com/rahulnakmol/agentic-ayudha/issues/128?utm_campaign=docs-site&utm_medium=docs&utm_source=agentic-ayudha) (#128) - [Ask page (benefits-qa)](https://github.com/rahulnakmol/agentic-ayudha/issues/129?utm_campaign=docs-site&utm_medium=docs&utm_source=agentic-ayudha) (#129) - [Feature baselines are drafted, approved, and pinned](https://github.com/rahulnakmol/agentic-ayudha/issues/874?utm_campaign=docs-site&utm_medium=docs&utm_source=agentic-ayudha) (#874)