README
¶
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).
- 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).
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 and how to upgrade.
It is not a coding agent and it does not run your production. It organises, checks, and records the work your agent does.
Install
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.
Your first run
In a clone of your repository, signed in to GitHub (gh auth login):
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 <issue>: 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: the same steps, with what you should see after each one.
- The story: one real day, from a goal to a measured release, setbacks included.
- When to use what: start from your situation and find the command.
- How it works: the architecture, file formats, and guarantees, for engineers.
All of it is on the docs site. Agents can read the same docs as Markdown, starting from llms.txt.
What's new: the v0.3.0 release notes say what the release does for you, and how to upgrade.
Adopt at your own pace
- Level 1, clear work items. Free, no keys, no CI changes: what the tour sets up.
- 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).
- 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 says what each level costs and gives.
Project
aayudha is free and open source under the BSD-3-Clause licence (LICENSE, THIRD_PARTY_NOTICES.md). CONTRIBUTING.md explains how to send a change, SECURITY.md how to report a vulnerability, and the project reference lists the branches, every verb, and the governance files. Coding agents working on this repository start at AGENTS.md.
Documentation
¶
Overview ¶
Package aayudha embeds the source asset trees that ship inside the aayudha binary (docs/BUILD-PLAN.md ground rule 3). Owned by WP0.2.
Running `go generate ./...` from the repository root regenerates every artifact derived from the verb registry in internal/verbs (ground rule 4) and CONSTRAINTS.md from the embedded default configuration in internal/config (WP0.5), and the work-item issue forms from the schema in internal/workitems (WP2.2), and the docs guide's diagrams with the brief diagram renderer (internal/tell/gen, WP8.2).
Index ¶
Constants ¶
This section is empty.
Variables ¶
View Source
var Assets embed.FS
Assets holds skills/, work-items/, hosts/, and seats/ exactly as committed, and loops/*.toml, the default loops `aayu install --loops` adds to a repository that has none.
Functions ¶
This section is empty.
Types ¶
This section is empty.
Source Files
Directories
¶
| Path | Synopsis |
|---|---|
|
cmd
|
|
|
aayudha
command
Command aayudha (alias aayu) is the agentic-ayudha binary.
|
Command aayudha (alias aayu) is the agentic-ayudha binary. |
|
examples
|
|
|
benefits-qa/analytics
Package analytics turns the benefits-qa example's product events into an Application Insights export (layer L08, docs/BUILD-PLAN.md WP8.1): JSON lines in the Log Analytics shape (TimeGenerated, Name, UserAuthenticatedId) that `aayu measure --appinsights` reads.
|
Package analytics turns the benefits-qa example's product events into an Application Insights export (layer L08, docs/BUILD-PLAN.md WP8.1): JSON lines in the Log Analytics shape (TimeGenerated, Name, UserAuthenticatedId) that `aayu measure --appinsights` reads. |
|
benefits-qa/analytics/simulate
command
Command simulate writes a synthetic Application Insights export of the benefits-qa example (docs/BUILD-PLAN.md WP8.1): a seeded population of fictional employees asking benefits questions through a channel.
|
Command simulate writes a synthetic Application Insights export of the benefits-qa example (docs/BUILD-PLAN.md WP8.1): a seeded population of fictional employees asking benefits questions through a channel. |
|
benefits-qa/answer
Package answer finds the plan passage that answers a benefits question (layer L05, docs/BUILD-PLAN.md WP8.1).
|
Package answer finds the plan passage that answers a benefits question (layer L05, docs/BUILD-PLAN.md WP8.1). |
|
benefits-qa/api
Package api is the benefits-qa example's HTTP boundary (layer L02, docs/BUILD-PLAN.md WP8.1): POST /api/ask takes a contracts.AskRequest and answers a contracts.AskResponse; GET /healthz reports readiness.
|
Package api is the benefits-qa example's HTTP boundary (layer L02, docs/BUILD-PLAN.md WP8.1): POST /api/ask takes a contracts.AskRequest and answers a contracts.AskResponse; GET /healthz reports readiness. |
|
benefits-qa/ask
Package ask is the benefits-qa example's question workflow (layer L03, docs/BUILD-PLAN.md WP8.1): screen the question (policy), retrieve the best plan passage (answer), ground it (policy), and shape the contract response, recording each step as a product event for analytics.
|
Package ask is the benefits-qa example's question workflow (layer L03, docs/BUILD-PLAN.md WP8.1): screen the question (policy), retrieve the best plan passage (answer), ground it (policy), and shape the contract response, recording each step as a product event for analytics. |
|
benefits-qa/cmd/benefits-qa
command
Command benefits-qa serves the benefits-qa example (layer L02, docs/BUILD-PLAN.md WP8.1): the Ask page at /, POST /api/ask, and GET /healthz, over the embedded synthetic plan documents.
|
Command benefits-qa serves the benefits-qa example (layer L02, docs/BUILD-PLAN.md WP8.1): the Ask page at /, POST /api/ask, and GET /healthz, over the embedded synthetic plan documents. |
|
benefits-qa/contracts
Package contracts is the benefits-qa example's API contract (layer L06, docs/BUILD-PLAN.md WP8.1): the request and response of POST /api/ask as Go types, and ask.schema.json, the JSON Schema generated from them that clients integrate against.
|
Package contracts is the benefits-qa example's API contract (layer L06, docs/BUILD-PLAN.md WP8.1): the request and response of POST /api/ask as Go types, and ask.schema.json, the JSON Schema generated from them that clients integrate against. |
|
benefits-qa/deploy
Package deploy holds how the benefits-qa example is run (layer L09, docs/BUILD-PLAN.md WP8.1): serve.sh builds it and starts it detached on its synthetic seed data, the `[verify] seed` command aayudha's web floors run before they capture the Ask page.
|
Package deploy holds how the benefits-qa example is run (layer L09, docs/BUILD-PLAN.md WP8.1): serve.sh builds it and starts it detached on its synthetic seed data, the `[verify] seed` command aayudha's web floors run before they capture the Ask page. |
|
benefits-qa/policy
Package policy decides what the benefits-qa example may answer (layer L04, docs/BUILD-PLAN.md WP8.1).
|
Package policy decides what the benefits-qa example may answer (layer L04, docs/BUILD-PLAN.md WP8.1). |
|
benefits-qa/store
Package store holds the benefit plan passages the benefits-qa example answers from (layer L07, docs/BUILD-PLAN.md WP8.1).
|
Package store holds the benefit plan passages the benefits-qa example answers from (layer L07, docs/BUILD-PLAN.md WP8.1). |
|
benefits-qa/web
Package web is the benefits-qa example's Ask page (layer L01, docs/BUILD-PLAN.md WP8.1): a server-rendered page, styled only with the design-system tokens, that asks the question workflow and shows the answer with its sources, a referral to HR, or a refusal.
|
Package web is the benefits-qa example's Ask page (layer L01, docs/BUILD-PLAN.md WP8.1): a server-rendered page, styled only with the design-system tokens, that asks the question workflow and shows the answer with its sources, a referral to HR, or a refusal. |
|
notes/cmd/notes
command
Command notes is the notes example (docs/BUILD-PLAN.md WP4.5b): a small CLI with no user interface beyond its commands, whose feature map proves the generic design of behaviour checks on something that is not a web app.
|
Command notes is the notes example (docs/BUILD-PLAN.md WP4.5b): a small CLI with no user interface beyond its commands, whose feature map proves the generic design of behaviour checks on something that is not a web app. |
|
notes/store
Package store keeps the notes of the notes example (docs/BUILD-PLAN.md WP4.5b): a plain-text file, one note per line, "[ ] text" or "[x] text".
|
Package store keeps the notes of the notes example (docs/BUILD-PLAN.md WP4.5b): a plain-text file, one note per line, "[ ] text" or "[x] text". |
|
hosts
|
|
|
verify-skill/go/control
command
Command control is the control tool of a Go product's verify skill (docs/BUILD-PLAN.md WP4.5b): it runs one behaviour check of the feature map in the product's own stack, Go, and answers by the contract aayu's behaviour floor holds every control tool to:
|
Command control is the control tool of a Go product's verify skill (docs/BUILD-PLAN.md WP4.5b): it runs one behaviour check of the feature map in the product's own stack, Go, and answers by the contract aayu's behaviour floor holds every control tool to: |
|
internal
|
|
|
actions
Package actions is the single path for external writes (ground rule 6, WP1.5).
|
Package actions is the single path for external writes (ground rule 6, WP1.5). |
|
agentenv
Package agentenv sets up the environments that agent hosts (Amp orbs, Cursor cloud agents, Codex cloud, Claude Code on the web) run a repository in, from one spec discovered from the code (founder request 2026-10-16, Appendix B S-3.2c).
|
Package agentenv sets up the environments that agent hosts (Amp orbs, Cursor cloud agents, Codex cloud, Claude Code on the web) run a repository in, from one spec discovered from the code (founder request 2026-10-16, Appendix B S-3.2c). |
|
audit
Package audit builds aayudha's audit report (WP7.6): it reconciles GitHub's own event history (rule-suite bypasses, issue and PR timelines, workflow runs) against the actions segments on the ledger (ground rule 6) and reports solo-mode bypasses, founder-identity ledger writes, promotions, tag ruleset bypasses, human-fallback writes, unlogged writes, proof coverage, floors, waivers, decision SLAs, autonomy exceptions, and the licence scan.
|
Package audit builds aayudha's audit report (WP7.6): it reconciles GitHub's own event history (rule-suite bypasses, issue and PR timelines, workflow runs) against the actions segments on the ledger (ground rule 6) and reports solo-mode bypasses, founder-identity ledger writes, promotions, tag ruleset bypasses, human-fallback writes, unlogged writes, proof coverage, floors, waivers, decision SLAs, autonomy exceptions, and the licence scan. |
|
autonomy
Package autonomy computes the autonomy streak (WP5.7, V4): for each layer, the number of consecutive correction-free agent PRs merged on it, counted back from the newest.
|
Package autonomy computes the autonomy streak (WP5.7, V4): for each layer, the number of consecutive correction-free agent PRs merged on it, counted back from the newest. |
|
brain
Package brain keeps the product brain: an Obsidian vault of linked Markdown notes on the orphan `brain` branch, which is never merged.
|
Package brain keeps the product brain: an Obsidian vault of linked Markdown notes on the orphan `brain` branch, which is never merged. |
|
brief
Package brief implements `aayu brief` (WP7.3, WP7.4): a host-written Markdown draft, grounded in a work item's evidence, is checked deterministically (structure, citations, the register's lint, visuals), then rendered as one self-contained, accessible HTML page with a grounding footer, inline SVG diagrams and charts, labelled illustrations, and annotated screens from proof packs.
|
Package brief implements `aayu brief` (WP7.3, WP7.4): a host-written Markdown draft, grounded in a work item's evidence, is checked deterministically (structure, citations, the register's lint, visuals), then rendered as one self-contained, accessible HTML page with a grounding footer, inline SVG diagrams and charts, labelled illustrations, and annotated screens from proof packs. |
|
chart
Package chart is the Data & AI Architect's verb (Decision #283; docs/BUILD-PLAN.md WP5.1g): a chart note is the data or AI design of an issue, written by the twin after it has interviewed the human and before the issue is planned.
|
Package chart is the Data & AI Architect's verb (Decision #283; docs/BUILD-PLAN.md WP5.1g): a chart note is the data or AI design of an issue, written by the twin after it has interviewed the human and before the issue is planned. |
|
cli
Package cli is the aayudha command-line frame.
|
Package cli is the aayudha command-line frame. |
|
config
Package config loads and validates aayudha configuration.
|
Package config loads and validates aayudha configuration. |
|
config/gen
command
Command gen regenerates CONSTRAINTS.md from the embedded default configuration (internal/config/defaults.toml, docs/BUILD-PLAN.md WP0.5).
|
Command gen regenerates CONSTRAINTS.md from the embedded default configuration (internal/config/defaults.toml, docs/BUILD-PLAN.md WP0.5). |
|
counsel
Package counsel is the Founder twin's on-demand counsel (Story #478): Atri, the Founder's Sage, is consulted on any topic, issue, Decision, path, or pull request, the way an oracle is, and answers with the call framed and its door, the operations, technology, and product readings with the dominant one, one recommendation, what not to do, what would change it, the next aayu command, and the question the person must answer.
|
Package counsel is the Founder twin's on-demand counsel (Story #478): Atri, the Founder's Sage, is consulted on any topic, issue, Decision, path, or pull request, the way an oracle is, and answers with the call framed and its door, the operations, technology, and product readings with the dominant one, one recommendation, what not to do, what would change it, the next aayu command, and the question the person must answer. |
|
decide
Package decide holds the rules of `aayu decide` (WP5.6, V8): who may accept a Decision ([decisions] authority), its SLA clock in business hours (time), what lapses at the SLA (a page to the authority and an escalation comment that mentions [decisions] escalate_to) and at provisional_after_hours (a reversible Decision's recommendation applies provisionally, labelled decision:provisional, with a ratify-or-revert deadline in its body), and floor waivers (`decide --waiver`).
|
Package decide holds the rules of `aayu decide` (WP5.6, V8): who may accept a Decision ([decisions] authority), its SLA clock in business hours (time), what lapses at the SLA (a page to the authority and an escalation comment that mentions [decisions] escalate_to) and at provisional_after_hours (a reversible Decision's recommendation applies provisionally, labelled decision:provisional, with a ratify-or-revert deadline in its body), and floor waivers (`decide --waiver`). |
|
delegate
Package delegate hands a Ready story to another coding agent (WP5.5b): the Codex, Cursor, Claude Code, or Amp cloud agent, or its CLI on this machine in an aayu worktree.
|
Package delegate hands a Ready story to another coding agent (WP5.5b): the Codex, Cursor, Claude Code, or Amp cloud agent, or its CLI on this machine in an aayu worktree. |
|
design
Package design holds the deterministic half of the design verbs (WP6.5): research, wireframe, mockup, and prototype.
|
Package design holds the deterministic half of the design verbs (WP6.5): research, wireframe, mockup, and prototype. |
|
doctor
Package doctor implements `aayu doctor` (WP1.7): environment, identity, configuration, and coexistence checks.
|
Package doctor implements `aayu doctor` (WP1.7): environment, identity, configuration, and coexistence checks. |
|
evals
Package evals is the skill eval harness (WP3.4).
|
Package evals is the skill eval harness (WP3.4). |
|
evals/cmd/eval
command
Command eval runs the skill eval harness outside go test (WP3.4).
|
Command eval runs the skill eval harness outside go test (WP3.4). |
|
experiment
Package experiment holds what `aayu experiment` and `aayu readout` (WP6.7) compute: the minimum sample size per arm for a conversion experiment, the lift between two arms with its two-proportion z-test, and the text both verbs write into an Experiment issue.
|
Package experiment holds what `aayu experiment` and `aayu readout` (WP6.7) compute: the minimum sample size per arm for a conversion experiment, the lift between two arms with its two-proportion z-test, and the text both verbs write into an Experiment issue. |
|
github
Package github is aayudha's GitHub API client (WP2.3): REST through go-github for issues, sub-issues, issue types, labels, comments, refs, and rulesets, and GraphQL through githubv4 only for Projects v2.
|
Package github is aayudha's GitHub API client (WP2.3): REST through go-github for issues, sub-issues, issue types, labels, comments, refs, and rulesets, and GraphQL through githubv4 only for Projects v2. |
|
github/fake
Package fake is an in-memory GitHub for tests of the verbs: the REST endpoints M2 uses (users, repositories, labels, issue types, rulesets, git refs/trees/commits, issues, comments, sub-issues) with enough fidelity that a verb's second run sees what its first run wrote.
|
Package fake is an in-memory GitHub for tests of the verbs: the REST endpoints M2 uses (users, repositories, labels, issue types, rulesets, git refs/trees/commits, issues, comments, sub-issues) with enough fidelity that a verb's second run sees what its first run wrote. |
|
github/scratch
Package scratch creates and deletes the aayu-scratch-* repositories that live tests (AAYU_LIVE=1) run against.
|
Package scratch creates and deletes the aayu-scratch-* repositories that live tests (AAYU_LIVE=1) run against. |
|
gittest
Package gittest is test support for packages whose tests run git on temporary repositories.
|
Package gittest is test support for packages whose tests run git on temporary repositories. |
|
grill
Package grill holds what makes a grilled spec concrete (WP5.3b): the catalogues that decompose vague qualifiers ("high quality", "fast") into dimensions, the checks that a Story's or Bug's criteria leave no qualifier unresolved and record who stated or confirmed each one, and the read-only assessment of the repository that grounds the questions in facts.
|
Package grill holds what makes a grilled spec concrete (WP5.3b): the catalogues that decompose vague qualifiers ("high quality", "fast") into dimensions, the checks that a Story's or Bug's criteria leave no qualifier unresolved and record who stated or confirmed each one, and the read-only assessment of the repository that grounds the questions in facts. |
|
hosts
Package hosts adapts skills, hooks, and MCP registration to each host.
|
Package hosts adapts skills, hooks, and MCP registration to each host. |
|
identity
Package identity resolves human and bot GitHub identities.
|
Package identity resolves human and bot GitHub identities. |
|
identity/cmd/protected-paths-gate
command
Command protected-paths-gate decides the protected-paths check from API responses the workflow saved to files (.github/workflows/protected-paths.yml).
|
Command protected-paths-gate decides the protected-paths check from API responses the workflow saved to files (.github/workflows/protected-paths.yml). |
|
initrepo
Package initrepo sets up a product repository (WP2.5 `aayu init`, WP2.6 extras) and takes it apart again (`aayu uninit`).
|
Package initrepo sets up a product repository (WP2.5 `aayu init`, WP2.6 extras) and takes it apart again (`aayu uninit`). |
|
inspect
Package inspect implements `aayu inspect` (WP4.8): an adversarial review of a pull request by the review lane's model (a different family from the builder's), against the story's Completion Goal and the PR's proof pack.
|
Package inspect implements `aayu inspect` (WP4.8): an adversarial review of a pull request by the review lane's model (a different family from the builder's), against the story's Completion Goal and the PR's proof pack. |
|
integrations
Package integrations holds what aayudha's provider adapters share (WP5.2): the reproducible baseline tuple, resolution of [integrations.<name>] for a read verb (WP1.3 scope refusal before any call), the provider-reported key scope that doctor and the adapters verify, and a transport that keeps every adapter read-only.
|
Package integrations holds what aayudha's provider adapters share (WP5.2): the reproducible baseline tuple, resolution of [integrations.<name>] for a read verb (WP1.3 scope refusal before any call), the provider-reported key scope that doctor and the adapters verify, and a transport that keeps every adapter read-only. |
|
integrations/aws
Package aws is the AWS adapter (WP7.2b): baselines from CloudWatch Logs Insights over a CloudWatch RUM app monitor's log group, and event pulls from CloudWatch RUM (GetAppMonitorData), signed with Signature Version 4 (the WP4.2 signer).
|
Package aws is the AWS adapter (WP7.2b): baselines from CloudWatch Logs Insights over a CloudWatch RUM app monitor's log group, and event pulls from CloudWatch RUM (GetAppMonitorData), signed with Signature Version 4 (the WP4.2 signer). |
|
integrations/azure
Package azure is the Azure Monitor adapter (WP7.2b): baselines and event pulls from Application Insights through the Log Analytics query API (KQL, resource-centric), with a Microsoft Entra token minted by client credentials, GitHub Actions workload identity federation, or `az account get-access-token`.
|
Package azure is the Azure Monitor adapter (WP7.2b): baselines and event pulls from Application Insights through the Log Analytics query API (KQL, resource-centric), with a Microsoft Entra token minted by client credentials, GitHub Actions workload identity federation, or `az account get-access-token`. |
|
integrations/cloud
Package cloud holds what the Azure, AWS, and GCP adapters share (WP7.2b): the GitHub Actions OIDC token they federate with, the local CLI fallback (az, aws, gcloud) run with a scrubbed environment, short-lived token caching, OAuth token responses, and filter checks.
|
Package cloud holds what the Azure, AWS, and GCP adapters share (WP7.2b): the GitHub Actions OIDC token they federate with, the local CLI fallback (az, aws, gcloud) run with a scrubbed environment, short-lived token caching, OAuth token responses, and filter checks. |
|
integrations/exports
Package exports reads the analytics and billing exports `aayu measure` snapshots (WP7.2): a billing CSV, Azure Application Insights events, AWS CloudWatch RUM events, and Google Analytics 4 (Firebase) BigQuery events, each as a file.
|
Package exports reads the analytics and billing exports `aayu measure` snapshots (WP7.2): a billing CSV, Azure Application Insights events, AWS CloudWatch RUM events, and Google Analytics 4 (Firebase) BigQuery events, each as a file. |
|
integrations/figma
Package figma is the Figma client (WP6.4, V5): the REST API with a personal access token is primary (nodes, rendered image URLs, local variables); the remote MCP server is an opt-in ([integrations.figma] transport = "mcp") that answers nodes and variables with a token minted outside aayudha, since the Go SDK's client-side OAuth is experimental.
|
Package figma is the Figma client (WP6.4, V5): the REST API with a personal access token is primary (nodes, rendered image URLs, local variables); the remote MCP server is an opt-in ([integrations.figma] transport = "mcp") that answers nodes and variables with a token minted outside aayudha, since the Go SDK's client-side OAuth is experimental. |
|
integrations/fixture
Package fixture replays recorded provider exchanges for the integration adapters' tests (WP5.2): a recording is an ordered list of requests and their responses, and the replayer fails the test on any request that is not the next one recorded, so a fixture pins the exact queries an adapter sends.
|
Package fixture replays recorded provider exchanges for the integration adapters' tests (WP5.2): a recording is an ordered list of requests and their responses, and the replayer fails the test on any request that is not the next one recorded, so a fixture pins the exact queries an adapter sends. |
|
integrations/gcp
Package gcp is the Google Cloud adapter (WP7.2b): baselines and event pulls from the Google Analytics 4 (Firebase) BigQuery export through the BigQuery jobs.query API, with an OAuth token from a service account key (a signed JWT), GitHub Actions workload identity federation (STS token exchange, then service account impersonation), or `gcloud auth print-access-token`.
|
Package gcp is the Google Cloud adapter (WP7.2b): baselines and event pulls from the Google Analytics 4 (Firebase) BigQuery export through the BigQuery jobs.query API, with an OAuth token from a service account key (a signed JWT), GitHub Actions workload identity federation (STS token exchange, then service account impersonation), or `gcloud auth print-access-token`. |
|
integrations/githubread
Package githubread is the GitHub read baseline adapter (WP5.2): issue and pull-request counts over a window from the search API, through the WP2.3 client (rate limits, call budget, and no way to write without an actions log), with its own read-only key from [integrations.github].
|
Package githubread is the GitHub read baseline adapter (WP5.2): issue and pull-request counts over a window from the search API, through the WP2.3 client (rate limits, call budget, and no way to write without an actions log), with its own read-only key from [integrations.github]. |
|
integrations/growthbook
Package growthbook is the GrowthBook adapter (WP6.7, WP7.2): it finds an experiment by its tracking key and reads one metric's per-variation users and conversions from the latest results, for `aayu readout`, and the control rate as a baseline for `aayu measure`.
|
Package growthbook is the GrowthBook adapter (WP6.7, WP7.2): it finds an experiment by its tracking key and reads one metric's per-variation users and conversions from the latest results, for `aayu readout`, and the control rate as a baseline for `aayu measure`. |
|
integrations/hostcall
Package hostcall decides the PostHog and Sentry calls an agent makes through its host rather than through aayudha's own adapters (Decision #449): a tool of a host-connected PostHog or Sentry MCP server, or a command of their CLIs.
|
Package hostcall decides the PostHog and Sentry calls an agent makes through its host rather than through aayudha's own adapters (Decision #449): a tool of a host-connected PostHog or Sentry MCP server, or a command of their CLIs. |
|
integrations/mobbin
Package mobbin is the Mobbin MCP client (WP6.4).
|
Package mobbin is the Mobbin MCP client (WP6.4). |
|
integrations/posthog
Package posthog is the PostHog baseline adapter (WP5.2): it counts events or distinct persons over a window with one HogQL query, after checking that the personal API key carries only read scopes.
|
Package posthog is the PostHog baseline adapter (WP5.2): it counts events or distinct persons over a window with one HogQL query, after checking that the personal API key carries only read scopes. |
|
integrations/providers
Package providers is the catalog of integration adapters this binary carries: what each one is for, the config fields it needs, and the entry points verbs (Baseline, Figma, Mobbin) and doctor (Check) use.
|
Package providers is the catalog of integration adapters this binary carries: what each one is for, the config fields it needs, and the entry points verbs (Baseline, Figma, Mobbin) and doctor (Check) use. |
|
integrations/sentry
Package sentry is the Sentry baseline adapter (WP5.2): crash-free session and user rates from the sessions API, and error and affected-user counts from the events API, after checking that the auth token carries only read scopes.
|
Package sentry is the Sentry baseline adapter (WP5.2): crash-free session and user rates from the sessions API, and error and affected-user counts from the events API, after checking that the auth token carries only read scopes. |
|
journey
Package journey is the home screen and `aayu next` (WP1.1b): where a repository is on the journey from a grilled idea to a measured release, and the single best next command.
|
Package journey is the home screen and `aayu next` (WP1.1b): where a repository is on the journey from a grilled idea to a measured release, and the single best next command. |
|
ledger
Package ledger writes to the orphan `ledger` branch (WP2.4): each write builds one commit in a temporary worktree on the current ledger tip and pushes it, fetching, re-applying, and retrying with bounded backoff when another writer got there first.
|
Package ledger writes to the orphan `ledger` branch (WP2.4): each write builds one commit in a temporary worktree on the current ledger tip and pushes it, fetching, re-applying, and retrying with bounded backoff when another writer got there first. |
|
loops
Package loops renders scheduled loops for each host.
|
Package loops renders scheduled loops for each host. |
|
loops/gen
command
Command gen renders aayudha's own loops (loops/*.toml) for every host: .github/workflows/aayudha-loops.yml, loops/amp/<name>.json, and loops/cursor/aayudha-loops.tf (WP7.1).
|
Command gen renders aayudha's own loops (loops/*.toml) for every host: .github/workflows/aayudha-loops.yml, loops/amp/<name>.json, and loops/cursor/aayudha-loops.tf (WP7.1). |
|
mcp
Package mcp is the MCP server.
|
Package mcp is the MCP server. |
|
measure
Package measure implements the analysis behind `aayu measure` (WP7.2): it loads exports into a SQLite snapshot (modernc.org/sqlite, pure Go), runs the AARRR cohort and North Star queries over it with the built-in engine or, optionally, the duckdb binary, and judges a Goal's or Initiative's measured value against its baseline and target.
|
Package measure implements the analysis behind `aayu measure` (WP7.2): it loads exports into a SQLite snapshot (modernc.org/sqlite, pure Go), runs the AARRR cohort and North Star queries over it with the built-in engine or, optionally, the duckdb binary, and judges a Goal's or Initiative's measured value against its baseline and target. |
|
models
Package models is the model gateway.
|
Package models is the model gateway. |
|
notify
Package notify sends pages and digests.
|
Package notify sends pages and digests. |
|
ops
Package ops is the ops action catalog `respond` executes from (WP5.6): ops/actions.toml, read only from the protected default branch at a pinned commit, never from a checkout or a pull request.
|
Package ops is the ops action catalog `respond` executes from (WP5.6): ops/actions.toml, read only from the protected default branch at a pinned commit, never from a checkout or a pull request. |
|
planning
Package planning checks the drafts of slice and plan (WP5.4).
|
Package planning checks the drafts of slice and plan (WP5.4). |
|
production
Package production implements the Production Engineer's checks (WP5.10, Decision #324): reading a sanitised OpenTelemetry export, bounded queries over it, the investigation note, the postmortem, SLOs, and runbooks.
|
Package production implements the Production Engineer's checks (WP5.10, Decision #324): reading a sanitised OpenTelemetry export, bounded queries over it, the investigation note, the postmortem, SLOs, and runbooks. |
|
proof
Package proof defines and verifies proof packs.
|
Package proof defines and verifies proof packs. |
|
proof/fakecloud
Package fakecloud holds in-memory Azure Blob Storage (with the Azure Resource Manager management policy) and Google Cloud Storage (JSON API) servers for tests of the proof media stores (WP7.2b.2).
|
Package fakecloud holds in-memory Azure Blob Storage (with the Azure Resource Manager management policy) and Google Cloud Storage (JSON API) servers for tests of the proof media stores (WP7.2b.2). |
|
proof/fakes3
Package fakes3 is an in-memory S3-compatible store for tests of the proof media bucket (WP4.2): objects and lifecycle configuration, with every request's SigV4 signature recomputed and checked.
|
Package fakes3 is an in-memory S3-compatible store for tests of the proof media bucket (WP4.2): objects and lifecycle configuration, with every request's SigV4 signature recomputed and checked. |
|
proof/sigv4
Package sigv4 signs HTTP requests with AWS Signature Version 4, for the S3-compatible proof media bucket (WP4.2).
|
Package sigv4 signs HTTP requests with AWS Signature Version 4, for the S3-compatible proof media bucket (WP4.2). |
|
ratchet
Package ratchet keeps this repository's coverage floor from loosening (private research note video-learnings-2026-10.md P7; Appendix B S-4.3r and D-4.3r).
|
Package ratchet keeps this repository's coverage floor from loosening (private research note video-learnings-2026-10.md P7; Appendix B S-4.3r and D-4.3r). |
|
ratchet/cmd/ratchet
command
Command ratchet checks or tightens this repository's coverage floor (internal/ratchet; Appendix B S-4.3r) and, given a base, checks that the change lowers no skill-eval bar (evals.CheckBars, Story #400).
|
Command ratchet checks or tightens this repository's coverage floor (internal/ratchet; Appendix B S-4.3r) and, given a base, checks that the change lowers no skill-eval bar (evals.CheckBars, Story #400). |
|
ready
Package ready implements `aayu ready` (WP2.7): it parses an issue into a work item, validates it for Ready, and, when it passes, writes the Ready snapshot to the ledger, posts it as a replace-in-place comment, and labels the issue status:ready.
|
Package ready implements `aayu ready` (WP2.7): it parses an issue into a work item, validates it for Ready, and, when it passes, writes the Ready snapshot to the ledger, posts it as a replace-in-place comment, and labels the issue status:ready. |
|
scope
Package scope plans what a release contains (the Product Strategist's `aayu scope`): the plan is the GitHub milestone named by the Release's version, an agent snapshots it as a draft, a person accepts the draft as a numbered baseline on the ledger, and every later change is measured against that baseline as drift, weighted by effort points, within a budget.
|
Package scope plans what a release contains (the Product Strategist's `aayu scope`): the plan is the GitHub milestone named by the Release's version, an agent snapshots it as a draft, a person accepts the draft as a numbered baseline on the ledger, and every later change is measured against that baseline as drift, weighted by effort points, within a budget. |
|
seats
Package seats implements WP5.1: the generated parts of the fourteen seat charters and of the AGENTS.md RACI section, and `aayu seat add|remove|list`, which pair a seat with a human (config, CODEOWNERS, onboarding issue) and switch the WP0.1 solo-mode policy when a second human arrives.
|
Package seats implements WP5.1: the generated parts of the fourteen seat charters and of the AGENTS.md RACI section, and `aayu seat add|remove|list`, which pair a seat with a human (config, CODEOWNERS, onboarding issue) and switch the WP0.1 solo-mode policy when a second human arrives. |
|
secrets
Package secrets stores and resolves secrets.
|
Package secrets stores and resolves secrets. |
|
skills
Package skills validates and packages host skills.
|
Package skills validates and packages host skills. |
|
status
Package status implements `aayu status` (WP2.8): it walks a Goal, Initiative, or Feature through its sub-issues and rolls up Delivery Status, health, risk, blocked and over-budget items, shipped-but-unmeasured items, Decisions near their SLA, and cost, for the table, --json, the Goal comment, and the --digest page.
|
Package status implements `aayu status` (WP2.8): it walks a Goal, Initiative, or Feature through its sub-issues and rolls up Delivery Status, health, risk, blocked and over-budget items, shipped-but-unmeasured items, Decisions near their SLA, and cost, for the table, --json, the Goal comment, and the --digest page. |
|
survey
Package survey indexes a repository that has code but no product documentation, deterministically and with no model (WP5.9): files and languages, build systems and their targets, symbols, the include and import graph, a name-resolved call graph, entry points, I/O surfaces, tests, known-issue markers, documents, and git churn, grouped into modules sized for a model to read one at a time.
|
Package survey indexes a repository that has code but no product documentation, deterministically and with no model (WP5.9): files and languages, build systems and their targets, symbols, the include and import graph, a name-resolved call graph, entry points, I/O surfaces, tests, known-issue markers, documents, and git churn, grouped into modules sized for a model to read one at a time. |
|
telemetry
Package telemetry records traces of verb runs.
|
Package telemetry records traces of verb runs. |
|
tell
Package tell is the deterministic half of `aayu tell` (WP7.5).
|
Package tell is the deterministic half of `aayu tell` (WP7.5). |
|
tell/gen
command
Command gen renders the docs guide's diagrams: each docs/guide/img/<name>.diagram (the line-based format of internal/brief, WP7.4) becomes <name>.svg beside it, which the guide pages show and `aayu tell docs --site` copies into the site (WP8.2).
|
Command gen renders the docs guide's diagrams: each docs/guide/img/<name>.diagram (the line-based format of internal/brief, WP7.4) becomes <name>.svg beside it, which the guide pages show and `aayu tell docs --site` copies into the site (WP8.2). |
|
testbin
Package testbin builds fixture programs for tests that run a program the way a product does, by its path.
|
Package testbin builds fixture programs for tests that run a program the way a product does, by its path. |
|
triage
Package triage implements `aayu triage` (WP2.9): it classifies an intake issue as Feedback, Bug, or Incident and records the result in labels only.
|
Package triage implements `aayu triage` (WP2.9): it classifies an intake issue as Feedback, Bug, or Incident and records the result in labels only. |
|
ui
Package ui is how aayu talks to a person on a terminal (WP1.1b): colour, themes, symbols, tables, live progress, celebrations, and the seat that speaks for a command.
|
Package ui is how aayu talks to a person on a terminal (WP1.1b): colour, themes, symbols, tables, live progress, celebrations, and the seat that speaks for a command. |
|
uireview
Package uireview is UI review (WP6.6): two isolated lanes critique the captured states of a change.
|
Package uireview is UI review (WP6.6): two isolated lanes critique the captured states of a change. |
|
upgrade
Package upgrade migrates a repository's aayudha files from their recorded schema versions to the running binary's (WP1.9, `aayu upgrade`), always showing a diff first.
|
Package upgrade migrates a repository's aayudha files from their recorded schema versions to the running binary's (WP1.9, `aayu upgrade`), always showing a diff first. |
|
verbs
Package verbs holds the verb and plumbing registry, the single source of truth (ground rule 4) for generated artifacts.
|
Package verbs holds the verb and plumbing registry, the single source of truth (ground rule 4) for generated artifacts. |
|
verbs/gen
command
Command gen regenerates every artifact derived from the verb registry (internal/verbs/registry.go, docs/BUILD-PLAN.md ground rule 4).
|
Command gen regenerates every artifact derived from the verb registry (internal/verbs/registry.go, docs/BUILD-PLAN.md ground rule 4). |
|
verify
Package verify runs deterministic floors.
|
Package verify runs deterministic floors. |
|
workitems
Package workitems defines work-item types and their stage validation.
|
Package workitems defines work-item types and their stage validation. |
|
workitems/gen
command
Command gen writes the artifacts derived from the work-item schema (internal/workitems, WP2.1-WP2.2).
|
Command gen writes the artifacts derived from the work-item schema (internal/workitems, WP2.1-WP2.2). |
Click to show internal directories.
Click to hide internal directories.