aayudha docs Built from de79988 (2026-10-26)

Your agentic team

One or two people cannot be the product strategist, the architect, the engineer, the reviewer, the release engineer, and the person on call, all at once. aayudha gives you a delivery team of fourteen seats, each a role with clear work, and each seat has an agent twin that does that work in your agent. You stay the person who decides.

The founder sits at the top with Atri, who counsels but never decides. Below, thirteen seats in five groups, each card naming its twin, the layers it owns, and some of its verbs. Every seat starts solo until you pair a person with it.

Fourteen seats, fourteen twins, one founder who decides.

Twins and their personas

Each twin has a name from the Hindu epics or the rishi tradition, and a persona: its purpose, its voice, its values, how it pushes back, what it never does, and a practice playbook drawn from published software practice. Arjun, the Product Strategist's twin, writes in plain customer language and ends on a number. Yama, the Quality Architect's twin, states a floor miss once, plainly, without apology.

Every twin follows the same evidence rule: a claim about the code, the risk, or progress cites its source in the same paragraph, such as a file and line, a proof pack, or a Decision. An analogy may illustrate a point, labelled as one, but never replaces the evidence. A twin never fakes, implies, or pre-announces an approval that did not happen.

The persona lives in seats/<seat>/persona.toml and is rendered into the seat's charter, the top of each of its skills, and your repository's AGENTS.md. Each seat's charter is in seats/.

Who answers for what

Every verb has exactly one Accountable seat, and that seat's twin does the work, in the verb's model lane. Some verbs also Consult other seats before they act and Inform others after. A few split ownership from execution: Nakul runs verify, but against floors that Yama owns.

Seat Twin Accountable for
Founder Atri decide, init, and the halt, resume, seat, tour, and inbox commands
Product Strategist Arjun grill, slice, triage, ready
Code Architect Vishwa plan, survey
Data & AI Architect Shuka chart, measure
Engineering Manager Drona inspect, ship, status, retro, next
AI Native Engineer Nakul build, verify, evolve
Production Engineer Shesha respond, investigate, slo, runbook
UX Researcher & Evolutionist Hanu research, wireframe, mockup, prototype, review, polish, baseline
DevOps & DevEx Tinkerer Nala release, install, doctor, and the setup commands
Quality Architect Yama proof, and the floors in CONSTRAINTS.md
Mentalist Sanjay brief
Auditor Vidhi audit
Marketer & Documenter Sauti tell
Revenue Architect Kuber experiment, readout

Atri, the Founder's Sage, is a counsellor: it frames a hard call, recommends one option, and names the question only you can answer. It never rules, approves, or acts. The full table, with every Consulted and Informed seat, is the RACI.

Who owns which layer

Your code is split into nine layers, from the screens to the platform (the nine layers). Each layer has exactly one owner seat. When you pair a person with that seat, they review changes in its layers.

Layer Owner seat (twin)
L01 Experience UX Researcher & Evolutionist (Hanu)
L02 Interaction / API boundary Code Architect (Vishwa)
L03 Application / workflow Engineering Manager (Drona)
L04 Domain / policy Quality Architect (Yama)
L05 Intelligence Data & AI Architect (Shuka)
L06 Contracts / integration Code Architect (Vishwa)
L07 Operational data / state Production Engineer (Shesha)
L08 Analytics / reporting Data & AI Architect (Shuka)
L09 Platform / operations DevOps & DevEx Tinkerer (Nala)

L04, L07, and L09 are the risky layers by default: they never earn autonomy, however well the agents have done before. A change there always waits for a person: their review, or, working alone, your recorded solo-mode bypass.

Which model does the work

A twin works in a model lane, a kind of work with a default model per agent host. The reviewer's model always comes from a different vendor than the builder's, so the agent that wrote the code never marks its own work.

Lane The work Used by, for example
spec Specs, decisions, briefs, and copy grill, decide, brief, tell
plan Slicing and planning slice, plan, survey
build Code and artifacts build, evolve, wireframe
review Adversarial code and spec review inspect, audit
ui-review Visual and interaction critique review
chore Cheap mechanical work ready, verify, ship, status

The default model for each lane on each host is in the model gateway and lanes. You can change any of them in [models].

From solo to paired

Every seat starts solo: its twin works alone, and anything that needs a person goes to the founder. When someone joins, pair them with the seats they care about, one command each: aayu seat add <seat> --human <github-login>. A paired person reviews their seat's layers, and the twin keeps doing the work. Once two people are in the repository, protected paths need a CODEOWNER's approval and the solo-mode bypass is refused. The steps, with a picture, are in when a second person joins.

aayu seat remove <seat> returns a seat to solo and hands its person's open stories back to the twin.

Terms are defined in the glossary.

Under the hood: seats, verbs, layers, and lanes are declared once in the verb registry and checked by a lint that fails the build on a verb without one Accountable seat; see the verb registry.

What's next

Working alone for now? See run it alone: the solo founder. Planning to grow? See from MVP to scale.