library.html

<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8"><meta name="viewport" content="width=device-width, initial-scale=1">
<title>Documentation library — AIDA</title>
<link rel="icon" type="image/png" href="assets/aida-icon.png"><link rel="icon" href="assets/favicon.ico" sizes="any"><link rel="apple-touch-icon" href="assets/aida-icon.png">
<link rel="stylesheet" href="styles.css"><link rel="stylesheet" href="guide.css">
<script src="search-data.js" defer></script><script src="library.js" defer></script>
</head>
<body>
<!-- trace:TASK-B6B1278890774EF993D2EBC327862470-106 | ai:codex -->
<a class="skip" href="#main">Skip to content</a>
<header class="guide-header"><a class="brand" href="index.html"><span class="brand-symbol" aria-hidden="true"><img src="assets/aida-icon-64.png" width="28" height="28" alt=""></span> AIDA</a><nav aria-label="Product navigation"><a href="index.html">Product</a><a href="library.html" aria-current="page">Library</a><a href="getting-started.html">Get started</a><a href="configuration.html">Configuration</a><a href="workflow.html">Workflow</a><a href="autonomy.html">Autonomy</a><a href="trust.html">Trust</a><a href="metrics.html">Metrics</a><a href="setup.html">Setup</a><a href="capabilities.html">Capabilities</a><a href="integrations.html">Integrations</a><a href="air-gapped.html">Air-gapped</a><a href="authority.html">Authority</a><a href="glossary.html">Glossary</a></nav></header>
<main id="main" class="guide"><p class="eyebrow">THE GOVERNED SOFTWARE FACTORY</p><!-- trace:TASK-B6B1278890774EF993D2EBC327862470-111 | ai:codex -->
<h1>Find the context<br>for your next change.</h1>
<p>Explore current product guides for people and operators. Search the source content, then follow a guide into its evidence and references.</p>
<p>Read the <a href="../what-is-aida.html">complete product assessment</a> for capabilities, integrations, offline operation and current limitations.</p>
<p>Technical references remain linked from the guides. Historical and internal evidence material is excluded from this curated library.</p>
<p>New to the vocabulary? The <a href="glossary.html">glossary</a> defines terms such as merge hold, mandate, grant and hub in plain words. Searching here also finds glossary terms.</p>
<form class="library-search" role="search" id="library-search">
<div><label for="query">Search guides and glossary terms</label><input type="search" id="query" name="q" placeholder="Try intent, review, cost or configuration" autocomplete="off"></div>
<div><label for="category">Audience</label><select id="category"><option value="all">All guides</option><option value="human">Human guides</option><option value="operator">Operator guides</option></select></div>
<button type="reset">Clear filters</button>
</form>
<p id="search-status" role="status" aria-live="polite">All curated guides are listed below. Enable JavaScript for content search and filters.</p>
<p id="search-empty" hidden>No matching guides or glossary terms. Try fewer words or choose all audiences.</p>
<div class="library-grid"><article class="library-card" data-url="getting-started.html" data-category="human"><p class="eyebrow">human guide</p><h2><a href="getting-started.html">Build as you already work</a></h2><p class="excerpt">Build as you already work Keep working with your conversational coding agent. Explain the change, discuss tradeoffs, inspect the implementation and decide what should happen next. …</p><a href="../getting-started.md">Source Markdown</a></article>
<article class="library-card" data-url="configuration.html" data-category="operator"><p class="eyebrow">operator guide</p><h2><a href="configuration.html">Configure the way your team works</a></h2><p class="excerpt">Configure the way your team works AIDA separates what work means, how it is dispatched and who may authorize its next step. You can start with conversational development and config…</p><a href="../configuration-guide.md">Source Markdown</a></article>
<article class="library-card" data-url="workflow.html" data-category="human"><p class="eyebrow">human guide</p><h2><a href="workflow.html">From a conversation to a maintainable system</a></h2><p class="excerpt">From a conversation to a maintainable system AIDA connects the work people and agents do with the intent behind it. Start with a conversation, develop the system, and keep enough s…</p><a href="../product-workflow.md">Source Markdown</a></article>
<article class="library-card" data-url="autonomy.html" data-category="human"><p class="eyebrow">human guide</p><h2><a href="autonomy.html">Choose where people take part</a></h2><p class="excerpt">Choose where people take part AIDA is a governed software factory with selectable autonomy. The choice is made per spec, so the same project can keep sensitive design interactive w…</p><a href="../selectable-autonomy.md">Source Markdown</a></article>
<article class="library-card" data-url="trust.html" data-category="human"><p class="eyebrow">human guide</p><h2><a href="trust.html">Inspect what allows a change to advance</a></h2><p class="excerpt">Inspect what allows a change to advance AIDA&#x27;s governed workflow makes evidence and authority explicit. Ask what was agreed, which change was checked, who checked it and what autho…</p><a href="../trust-and-evidence.md">Source Markdown</a></article>
<article class="library-card" data-url="metrics.html" data-category="operator"><p class="eyebrow">operator guide</p><h2><a href="metrics.html">Measure the flow. Inspect the evidence.</a></h2><p class="excerpt">Measure the flow. Inspect the evidence. AIDA&#x27;s reports help a team inspect delivery flow, traceability, recorded usage and tool reliability. They describe the evidence available to…</p><a href="../metrics-guide.md">Source Markdown</a></article>
<article class="library-card" data-url="setup.html" data-category="operator"><p class="eyebrow">operator guide</p><h2><a href="setup.html">Set up AIDA for conversational development</a></h2><p class="excerpt">Set up AIDA for conversational development Operator setup connects AIDA to the coding agent and project policy. It is separate from the normal user journey: people can keep discuss…</p><a href="../operator-setup.md">Source Markdown</a></article>
<article class="library-card" data-url="capabilities.html" data-category="human"><p class="eyebrow">human guide</p><h2><a href="capabilities.html">Follow intent through a change</a></h2><p class="excerpt">Follow intent through a change AIDA connects the intent for a software change to the work and evidence around it. It is alpha software for Linux. Begin with one bounded change and …</p><a href="../product-capabilities.md">Source Markdown</a></article>
<article class="library-card" data-url="integrations.html" data-category="operator"><p class="eyebrow">operator guide</p><h2><a href="integrations.html">Connect agents and project tools</a></h2><p class="excerpt">Connect agents and project tools AIDA provides a shared intent graph around the coding agents and repository tools a project configures. It is alpha software for Linux. Integration…</p><a href="../product-integrations.md">Source Markdown</a></article>
<article class="library-card" data-url="air-gapped.html" data-category="operator"><p class="eyebrow">operator guide</p><h2><a href="air-gapped.html">Support for air-gapped development</a></h2><p class="excerpt">Support for air-gapped development AIDA keeps requirements in Git, so a team on an isolated network can use it with an internal Git server. Its records travel the way code does. Th…</p><a href="../air-gapped-development.md">Source Markdown</a></article>
<article class="library-card" data-url="authority.html" data-category="human"><p class="eyebrow">human guide</p><h2><a href="authority.html">Who may do what: roles, seats, grants and mandates</a></h2><p class="excerpt">Who may do what: roles, seats, grants and mandates AIDA runs a team of agents and people in one repository. Some actions change what everyone else sees: approving a spec, recording…</p><a href="../authority-and-seats.md">Source Markdown</a></article>
<article class="library-card" data-url="glossary.html" data-category="human"><p class="eyebrow">human guide</p><h2><a href="glossary.html">Product glossary</a></h2><p class="excerpt">Product glossary Plain-language definitions of the words AIDA uses in its guides, commands and messages. Each entry says what you see or do, and links to the page that explains it …</p><a href="../../aida-core/templates/.aida/discipline/product-glossary.md">Source Markdown</a></article>
<article class="library-card term-card" data-url="glossary.html#agreed-id" data-category="human" data-term hidden><p class="eyebrow">glossary term</p><h2><a href="glossary.html#agreed-id">Agreed ID</a></h2><p class="excerpt">The short ID a spec keeps for good: its type and a number, such as TASK-&lt;number&gt;. It is unique across every clone of the project, because each number is handed out once from a shar…</p></article>
<article class="library-card term-card" data-url="glossary.html#block" data-category="human" data-term hidden><p class="eyebrow">glossary term</p><h2><a href="glossary.html#block">Block</a></h2><p class="excerpt">A small range of spec numbers set aside for one clone. The clone gives new specs short agreed IDs from its own blocks, so it never has to ask anyone else first. Blocks are carved f…</p></article>
<article class="library-card term-card" data-url="glossary.html#brief" data-category="human" data-term hidden><p class="eyebrow">glossary term</p><h2><a href="glossary.html#brief">Brief</a></h2><p class="excerpt">A short note that assigns a piece of work to a named agent, such as &quot;pick up this spec next&quot;. The agent reads it, does the work, and acknowledges it so it stops showing up. A brief…</p></article>
<article class="library-card term-card" data-url="glossary.html#child-grant" data-category="human" data-term hidden><p class="eyebrow">glossary term</p><h2><a href="glossary.html#child-grant">Child grant</a></h2><p class="excerpt">A grant that a launcher gives an agent it starts, for one named seat. Your session can hand out only the seats you listed when you entered your own seat, and a child grant cannot b…</p></article>
<article class="library-card term-card" data-url="glossary.html#commit-trailer" data-category="human" data-term hidden><p class="eyebrow">glossary term</p><h2><a href="glossary.html#commit-trailer">Commit trailer</a></h2><p class="excerpt">The spec ID in parentheses at the end of a commit subject, as in fix(api): handle missing ids (SPEC-ID). When that commit lands on the main branch, AIDA marks the named spec comple…</p></article>
<article class="library-card term-card" data-url="glossary.html#control-plane" data-category="human" data-term hidden><p class="eyebrow">glossary term</p><h2><a href="glossary.html#control-plane">Control plane</a></h2><p class="excerpt">The part of AIDA that decides whether work may move forward and reports what is in flight: the queue, seats, leases, reviews, merge holds and the status views. The spec records the…</p></article>
<article class="library-card term-card" data-url="glossary.html#deputy" data-category="human" data-term hidden><p class="eyebrow">glossary term</p><h2><a href="glossary.html#deputy">Deputy</a></h2><p class="excerpt">A helper you start in your own terminal with aida deputy. Agents hand it commands to run under your seat grant, and it runs only what you allowed, records each job and tells the su…</p></article>
<article class="library-card term-card" data-url="glossary.html#grant" data-category="human" data-term hidden><p class="eyebrow">glossary term</p><h2><a href="glossary.html#grant">Grant</a></h2><p class="excerpt">The authority your terminal session holds to act in a seat. You get one by running aida role enter &lt;seat&gt; at an interactive terminal; it expires after a set time (24 hours by defau…</p></article>
<article class="library-card term-card" data-url="glossary.html#handoff" data-category="human" data-term hidden><p class="eyebrow">glossary term</p><h2><a href="glossary.html#handoff">Handoff</a></h2><p class="excerpt">A note a session writes before it ends so the next session can carry on without the conversation that came before: what was done, what is open and what to do next. AIDA keeps hando…</p></article>
<article class="library-card term-card" data-url="glossary.html#hub" data-category="human" data-term hidden><p class="eyebrow">glossary term</p><h2><a href="glossary.html#hub">Hub</a></h2><p class="excerpt">A Git server that the requirement store syncs through, such as GitHub, GitLab or a repository on an internal host. A mirror that only copies another hub counts as the same hub. See…</p></article>
<article class="library-card term-card" data-url="glossary.html#local-id" data-category="human" data-term hidden><p class="eyebrow">glossary term</p><h2><a href="glossary.html#local-id">Local ID</a></h2><p class="excerpt">A longer spec ID that also names the clone that made it, used when that clone has no block to draw short numbers from. Local IDs never collide, so they need no coordination, and a …</p></article>
<article class="library-card term-card" data-url="glossary.html#mailbox" data-category="human" data-term hidden><p class="eyebrow">glossary term</p><h2><a href="glossary.html#mailbox">Mailbox</a></h2><p class="excerpt">AIDA&#x27;s message channel between agents and people, for things that are not a change of state: a heads-up, a question, a warning about a shared file. Messages are kept, so a differen…</p></article>
<article class="library-card term-card" data-url="glossary.html#mandate" data-category="human" data-term hidden><p class="eyebrow">glossary term</p><h2><a href="glossary.html#mandate">Mandate</a></h2><p class="excerpt">Time-limited permission, started by a person at a terminal with aida mandate start, for the advisor seat to do named things while that person is away, such as shipping held pull re…</p></article>
<article class="library-card term-card" data-url="glossary.html#merge-hold" data-category="human" data-term hidden><p class="eyebrow">glossary term</p><h2><a href="glossary.html#merge-hold">Merge hold</a></h2><p class="excerpt">A stop placed on a pull request so it cannot merge, even when its checks and review pass. It shows as the aida:merge-hold label and a failing required check. It stays until a perso…</p></article>
<article class="library-card term-card" data-url="glossary.html#operator-only" data-category="human" data-term hidden><p class="eyebrow">glossary term</p><h2><a href="glossary.html#operator-only">Operator-only</a></h2><p class="excerpt">A tag that keeps a spec in human hands. No mandate covers it, so its pull request waits for a person to merge, and the tag&#x27;s effect remains even if the tag is later removed. See ai…</p></article>
<article class="library-card term-card" data-url="glossary.html#pool" data-category="human" data-term hidden><p class="eyebrow">glossary term</p><h2><a href="glossary.html#pool">Pool</a></h2><p class="excerpt">A range of one spec type&#x27;s numbers given to one hub. Clones that sync through that hub take their blocks from it, so two hubs never hand out the same number. See Support for air-ga…</p></article>
<article class="library-card term-card" data-url="glossary.html#ref" data-category="human" data-term hidden><p class="eyebrow">glossary term</p><h2><a href="glossary.html#ref">Ref</a></h2><p class="excerpt">Git&#x27;s name for a pointer to a commit, such as a branch. AIDA keeps its records on the aida-store branch, called the store ref; a push to it succeeds only if nobody else moved it fi…</p></article>
<article class="library-card term-card" data-url="glossary.html#review-story" data-category="human" data-term hidden><p class="eyebrow">glossary term</p><h2><a href="glossary.html#review-story">Review story</a></h2><p class="excerpt">The story AIDA files when it opens a pull request, titled Review PR-&lt;number&gt;: … and routed to the reviewer seat. Whoever picks it up reviews that pull request and records a verdict…</p></article>
<article class="library-card term-card" data-url="glossary.html#rework-round" data-category="human" data-term hidden><p class="eyebrow">glossary term</p><h2><a href="glossary.html#rework-round">Rework round</a></h2><p class="excerpt">One trip back to the implementer after a reviewer asks for changes. aida rework returns the spec to active work with the reviewer&#x27;s reasons, and the implementer pushes fixes to the…</p></article>
<article class="library-card term-card" data-url="glossary.html#role" data-category="human" data-term hidden><p class="eyebrow">glossary term</p><h2><a href="glossary.html#role">Role</a></h2><p class="excerpt">A named job in AIDA&#x27;s workflow, such as advisor, implementer, reviewer or integrator. Work can be routed to a role, and the role decides what a session wearing it is expected and a…</p></article>
<article class="library-card term-card" data-url="glossary.html#root" data-category="human" data-term hidden><p class="eyebrow">glossary term</p><h2><a href="glossary.html#root">Root</a></h2><p class="excerpt">The one clone of a project that owns every spec number not yet handed out. You choose it once with aida node enroll-root; it splits the numbers into pools. See Support for air-gapp…</p></article>
<article class="library-card term-card" data-url="glossary.html#roster" data-category="human" data-term hidden><p class="eyebrow">glossary term</p><h2><a href="glossary.html#roster">Roster</a></h2><p class="excerpt">The list of seats each person is allowed to take, kept per project. It is a ceiling: aida role enter refuses a seat that is not on your roster, and aida team allow-seat adds one. S…</p></article>
<article class="library-card term-card" data-url="glossary.html#seat" data-category="human" data-term hidden><p class="eyebrow">glossary term</p><h2><a href="glossary.html#seat">Seat</a></h2><p class="excerpt">A role as a place in the workflow that a session occupies, such as the advisor seat. A seat can receive work and hold sessions, and some seats allow only one active occupant at a t…</p></article>
<article class="library-card term-card" data-url="glossary.html#supervised-spec" data-category="human" data-term hidden><p class="eyebrow">glossary term</p><h2><a href="glossary.html#supervised-spec">Supervised spec</a></h2><p class="excerpt">A sensitive spec, such as one touching security, containment, review or merge authority, or one marked guided or keystone. A mandate leaves its merge hold for a person unless that …</p></article></div>
<noscript><p>All guide links and source files remain available above.</p></noscript>
</main>
<footer class="guide-footer"><p>Generated from <a href="publication.json">the publication manifest</a>. Alpha software · Linux only.</p><a href="index.html">Back to product</a></footer>
</body>
</html>