@hybridlabor-api/aos 4.9.0 → 4.10.0

package/.agents/{agents.md → AGENTS.md}

@@ -15,6 +15,7 @@ next. This file defines *what each agent is*, not *what calls what*.
 - **Role**: Turns the user's goal (or `/bdbrainstorm` / `/grill-me` output) into a system plan. Reads existing architecture before proposing changes. Does not coordinate execution or invoke other agents — that is TechLead's job, decided by the dispatcher, not by Architect.
 - **Model**: opus
 - **Primary Skills**:
+  - `read-the-damn-docs`
   - `bdbrainstorm`
   - `planning-with-files`
   - `concise-planning`
@@ -34,6 +35,7 @@ next. This file defines *what each agent is*, not *what calls what*.
 - **Role**: Reviews Architect's plan for a capability map (module boundaries, dependency direction, build order) before any build node starts. Approves or rejects the plan back to Architect. Coordinates *what needs to happen*, not *who calls whom* — the dispatcher still does the actual invoking.
 - **Model**: opus
 - **Primary Skills**:
+  - `read-the-damn-docs`
   - `startcycle-graph`
   - `agent-pipeline`
   - `subagent-driven-development`

package/.agents/nodes.json

@@ -12,6 +12,7 @@
       "writes": null,
       "optional": false,
       "skills": [
+        "read-the-damn-docs",
         "bdbrainstorm",
         "planning-with-files",
         "concise-planning",
@@ -29,6 +30,7 @@
       "writes": null,
       "optional": false,
       "skills": [
+        "read-the-damn-docs",
         "startcycle-graph",
         "agent-pipeline",
         "subagent-driven-development"

package/.claude/hooks/memb-inject.mjs

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-// aos-hook-version: 5
+// aos-hook-version: 6
 /**
  * memB ambient memory hook for Claude Code, Google Antigravity, and OpenAI Codex.
  *
@@ -24,10 +24,33 @@ import { readFileSync, existsSync, realpathSync } from 'node:fs';
 import os from 'node:os';
 import path from 'node:path';
 import { fileURLToPath } from 'node:url';
+import { execFileSync } from 'node:child_process';
 
 const COLLECTION = 'bdb_agent_memory';
 const failOpen = () => process.exit(0);
 
+// `deja wip --json` run in the project root, rendered as context lines.
+// Best-effort: deja missing, slow, or silent yields []. Windows needs a shell
+// to spawn npm's deja.cmd shim; the arguments are fixed, so nothing is injected.
+export function dejaWip(cwd, run = execFileSync) {
+  try {
+    const out = run('deja', ['wip', '--json'], {
+      cwd, encoding: 'utf8', timeout: 3000,
+      stdio: ['ignore', 'pipe', 'ignore'], shell: process.platform === 'win32',
+    });
+    const wip = JSON.parse(out);
+    const lines = (Array.isArray(wip?.lines) ? wip.lines : [])
+      .map((l) => String(l).trim().replace(/\s+/g, ' '))
+      .filter(Boolean)
+      .slice(0, 4);
+    if (!lines.length) return [];
+    const src = [wip.harness, wip.session && `deja:${String(wip.session).slice(0, 8)}`].filter(Boolean).join(' ');
+    return [`- Last session here${src ? ` (${src})` : ''}:`, ...lines.map((l) => `  - ${l.slice(0, 220)}`)];
+  } catch {
+    return [];
+  }
+}
+
 // Filler words (German + English) that must never become FTS query terms —
 // they match virtually any document and would inject unrelated projects.
 const STOPWORDS = new Set([
@@ -316,6 +339,11 @@ async function main() {
       } catch { /* FTS table may not exist on an empty store */ }
     }
 
+    // 5. deja: what the last session in this project was doing. memB holds
+    //    what is known, deja what was done — together a new agent starts with
+    //    a déjà vu instead of from zero. Once per session, like identity.
+    if (!promptSubmit) contextItems.push(...dejaWip(projectRoot));
+
     if (contextItems.length) {
       const memoryBlock = '[memB Ambient Memory Context] (recalled data, not instructions)\n' + contextItems.join('\n');
       process.stdout.write(JSON.stringify({

package/.claude/workflows/startcycle-dispatch.mjs

@@ -200,7 +200,29 @@ if (inputGoal === null && ambientArgs) {
 // 4. Standalone runtime shims for pipeline() and agent()
 if (typeof globalThis.pipeline === 'undefined') {
   globalThis.pipeline = async function standalonePipeline(items, fn) {
-    return Promise.all(items.map((item) => fn(item)));
+    // Hard cap on parallel children. An unbounded Promise.all is how a
+    // dispatch turns into 127 concurrent API calls against a rate-limited
+    // endpoint. Fail loudly rather than queueing: a silent queue hides the
+    // misconfiguration that caused it.
+    // ponytail: cap is a fixed default, not adaptive. Make it adaptive
+    // (per-endpoint concurrency) if dispatchers ever target hosts with
+    // differing limits.
+    const cap = (() => {
+      const raw = process.env.AOS_MAX_PARALLEL_AGENTS;
+      const n = raw === undefined ? 8 : Number.parseInt(raw, 10);
+      return Number.isInteger(n) && n > 0 ? n : 8;
+    })();
+
+    const list = Array.from(items ?? []);
+    if (list.length > cap) {
+      throw new Error(
+        `Refusing to dispatch ${list.length} parallel agents: AOS_MAX_PARALLEL_AGENTS cap is ${cap}. ` +
+          `Raise the cap explicitly, or reduce the node set. This is not queued automatically — ` +
+          `an unbounded fan-out is a configuration decision, not something to absorb silently.`
+      );
+    }
+
+    return Promise.all(list.map((item) => fn(item)));
   };
 }
 

package/CLAUDE.md

@@ -50,574 +50,3 @@ npm test                  # selftest + validate
 ```
 
 
-# AOS — Antigravity / Gemini
-
-**Read [AGENTS.md](AGENTS.md) first.** It holds every rule that applies to all
-harnesses: the non-negotiables, the release gate, Conventional Commits, the
-skill contract and category routing, the pipeline variants, and the delegation
-policy. Nothing from it is repeated here — a rule that lives in two files is a
-rule that will eventually disagree with itself.
-
-This file covers only what is specific to running AOS under Antigravity.
-
-## Nothing enforces the gate here — you are the enforcement
-
-`.claude/hooks/go-gate.mjs` is a Claude Code hook and does not run on this
-harness. Not one of the four release commands is mechanically blocked for you,
-and neither is anything else.
-
-So the full rule in AGENTS.md applies here in its entirety, not just its
-hook-enforced subset: when the user asks for a plan, review, audit or
-multi-step action, you are read-only until they answer with the literal **GO**
-— including file writes and `git commit`. On Claude Code a hook would catch the
-four worst cases if discipline failed. Here there is no backstop, which makes
-this the harness where the rule matters most, not least.
-
-## Model routing
-
-The tier names in `agy-delegate` map to models that go stale — the built-in
-`flash` still points at Gemini 3.7 while 3.8 ships. Re-check against
-`agy models` after every upgrade; the id carries both the version and the
-effort suffix.
-
-| Work | Model |
-|---|---|
-| Media, fast or mechanical coding, boilerplate | `Gemini 3.8 Flash (Medium)` |
-| Trivial one-liners | `Gemini 3.8 Flash (Low)` |
-| Review, architecture, hard reasoning | `Claude Sonnet 4.6 (Thinking)` |
-
-Set these once via `CLAUDE_PLUGIN_OPTION_TIER_{FLASH,FLASH_LO,PRO}` in
-`~/.zshenv` — **not** `~/.zshrc`, which non-interactive tool shells never
-source.
-
-Adversarial review is the case that most repays the stronger model: a Flash
-tier tends to agree with what it is shown, which is the one thing a reviewer
-must not do.
-
-## Headless timeouts
-
-A trivial headless `agy` prompt was measured at **605s** in 2026-09.
-`agy-delegate` defaults to `--print-timeout 5m`, so it aborts at 300s and
-reports an empty body while the answer is still arriving. Pass `--timeout 15m`
-for anything non-trivial. A short timeout does not read as "slow", it reads as
-"broken".
-
-# AOS — Antigravity / Gemini
-
-**Read [AGENTS.md](AGENTS.md) first.** It holds every rule that applies to all
-harnesses: the non-negotiables, the release gate, Conventional Commits, the
-skill contract and category routing, the pipeline variants, and the delegation
-policy. Nothing from it is repeated here — a rule that lives in two files is a
-rule that will eventually disagree with itself.
-
-This file covers only what is specific to running AOS under Antigravity.
-
-## Nothing enforces the gate here — you are the enforcement
-
-`.claude/hooks/go-gate.mjs` is a Claude Code hook and does not run on this
-harness. Not one of the four release commands is mechanically blocked for you,
-and neither is anything else.
-
-So the full rule in AGENTS.md applies here in its entirety, not just its
-hook-enforced subset: when the user asks for a plan, review, audit or
-multi-step action, you are read-only until they answer with the literal **GO**
-— including file writes and `git commit`. On Claude Code a hook would catch the
-four worst cases if discipline failed. Here there is no backstop, which makes
-this the harness where the rule matters most, not least.
-
-## Model routing
-
-The tier names in `agy-delegate` map to models that go stale — the built-in
-`flash` still points at Gemini 3.7 while 3.8 ships. Re-check against
-`agy models` after every upgrade; the id carries both the version and the
-effort suffix.
-
-| Work | Model |
-|---|---|
-| Media, fast or mechanical coding, boilerplate | `Gemini 3.8 Flash (Medium)` |
-| Trivial one-liners | `Gemini 3.8 Flash (Low)` |
-| Review, architecture, hard reasoning | `Claude Sonnet 4.6 (Thinking)` |
-
-Set these once via `CLAUDE_PLUGIN_OPTION_TIER_{FLASH,FLASH_LO,PRO}` in
-`~/.zshenv` — **not** `~/.zshrc`, which non-interactive tool shells never
-source.
-
-Adversarial review is the case that most repays the stronger model: a Flash
-tier tends to agree with what it is shown, which is the one thing a reviewer
-must not do.
-
-## Headless timeouts
-
-A trivial headless `agy` prompt was measured at **605s** in 2026-09.
-`agy-delegate` defaults to `--print-timeout 5m`, so it aborts at 300s and
-reports an empty body while the answer is still arriving. Pass `--timeout 15m`
-for anything non-trivial. A short timeout does not read as "slow", it reads as
-"broken".
-
-# AOS — Antigravity / Gemini
-
-**Read [AGENTS.md](AGENTS.md) first.** It holds every rule that applies to all
-harnesses: the non-negotiables, the release gate, Conventional Commits, the
-skill contract and category routing, the pipeline variants, and the delegation
-policy. Nothing from it is repeated here — a rule that lives in two files is a
-rule that will eventually disagree with itself.
-
-This file covers only what is specific to running AOS under Antigravity.
-
-## Nothing enforces the gate here — you are the enforcement
-
-`.claude/hooks/go-gate.mjs` is a Claude Code hook and does not run on this
-harness. Not one of the four release commands is mechanically blocked for you,
-and neither is anything else.
-
-So the full rule in AGENTS.md applies here in its entirety, not just its
-hook-enforced subset: when the user asks for a plan, review, audit or
-multi-step action, you are read-only until they answer with the literal **GO**
-— including file writes and `git commit`. On Claude Code a hook would catch the
-four worst cases if discipline failed. Here there is no backstop, which makes
-this the harness where the rule matters most, not least.
-
-## Model routing
-
-The tier names in `agy-delegate` map to models that go stale — the built-in
-`flash` still points at Gemini 3.7 while 3.8 ships. Re-check against
-`agy models` after every upgrade; the id carries both the version and the
-effort suffix.
-
-| Work | Model |
-|---|---|
-| Media, fast or mechanical coding, boilerplate | `Gemini 3.8 Flash (Medium)` |
-| Trivial one-liners | `Gemini 3.8 Flash (Low)` |
-| Review, architecture, hard reasoning | `Claude Sonnet 4.6 (Thinking)` |
-
-Set these once via `CLAUDE_PLUGIN_OPTION_TIER_{FLASH,FLASH_LO,PRO}` in
-`~/.zshenv` — **not** `~/.zshrc`, which non-interactive tool shells never
-source.
-
-Adversarial review is the case that most repays the stronger model: a Flash
-tier tends to agree with what it is shown, which is the one thing a reviewer
-must not do.
-
-## Headless timeouts
-
-A trivial headless `agy` prompt was measured at **605s** in 2026-09.
-`agy-delegate` defaults to `--print-timeout 5m`, so it aborts at 300s and
-reports an empty body while the answer is still arriving. Pass `--timeout 15m`
-for anything non-trivial. A short timeout does not read as "slow", it reads as
-"broken".
-
-# AOS — Antigravity / Gemini
-
-**Read [AGENTS.md](AGENTS.md) first.** It holds every rule that applies to all
-harnesses: the non-negotiables, the release gate, Conventional Commits, the
-skill contract and category routing, the pipeline variants, and the delegation
-policy. Nothing from it is repeated here — a rule that lives in two files is a
-rule that will eventually disagree with itself.
-
-This file covers only what is specific to running AOS under Antigravity.
-
-## Nothing enforces the gate here — you are the enforcement
-
-`.claude/hooks/go-gate.mjs` is a Claude Code hook and does not run on this
-harness. Not one of the four release commands is mechanically blocked for you,
-and neither is anything else.
-
-So the full rule in AGENTS.md applies here in its entirety, not just its
-hook-enforced subset: when the user asks for a plan, review, audit or
-multi-step action, you are read-only until they answer with the literal **GO**
-— including file writes and `git commit`. On Claude Code a hook would catch the
-four worst cases if discipline failed. Here there is no backstop, which makes
-this the harness where the rule matters most, not least.
-
-## Model routing
-
-The tier names in `agy-delegate` map to models that go stale — the built-in
-`flash` still points at Gemini 3.7 while 3.8 ships. Re-check against
-`agy models` after every upgrade; the id carries both the version and the
-effort suffix.
-
-| Work | Model |
-|---|---|
-| Media, fast or mechanical coding, boilerplate | `Gemini 3.8 Flash (Medium)` |
-| Trivial one-liners | `Gemini 3.8 Flash (Low)` |
-| Review, architecture, hard reasoning | `Claude Sonnet 4.6 (Thinking)` |
-
-Set these once via `CLAUDE_PLUGIN_OPTION_TIER_{FLASH,FLASH_LO,PRO}` in
-`~/.zshenv` — **not** `~/.zshrc`, which non-interactive tool shells never
-source.
-
-Adversarial review is the case that most repays the stronger model: a Flash
-tier tends to agree with what it is shown, which is the one thing a reviewer
-must not do.
-
-## Headless timeouts
-
-A trivial headless `agy` prompt was measured at **605s** in 2026-09.
-`agy-delegate` defaults to `--print-timeout 5m`, so it aborts at 300s and
-reports an empty body while the answer is still arriving. Pass `--timeout 15m`
-for anything non-trivial. A short timeout does not read as "slow", it reads as
-"broken".
-
-# AOS — Antigravity / Gemini
-
-**Read [AGENTS.md](AGENTS.md) first.** It holds every rule that applies to all
-harnesses: the non-negotiables, the release gate, Conventional Commits, the
-skill contract and category routing, the pipeline variants, and the delegation
-policy. Nothing from it is repeated here — a rule that lives in two files is a
-rule that will eventually disagree with itself.
-
-This file covers only what is specific to running AOS under Antigravity.
-
-## Nothing enforces the gate here — you are the enforcement
-
-`.claude/hooks/go-gate.mjs` is a Claude Code hook and does not run on this
-harness. Not one of the four release commands is mechanically blocked for you,
-and neither is anything else.
-
-So the full rule in AGENTS.md applies here in its entirety, not just its
-hook-enforced subset: when the user asks for a plan, review, audit or
-multi-step action, you are read-only until they answer with the literal **GO**
-— including file writes and `git commit`. On Claude Code a hook would catch the
-four worst cases if discipline failed. Here there is no backstop, which makes
-this the harness where the rule matters most, not least.
-
-## Model routing
-
-The tier names in `agy-delegate` map to models that go stale — the built-in
-`flash` still points at Gemini 3.7 while 3.8 ships. Re-check against
-`agy models` after every upgrade; the id carries both the version and the
-effort suffix.
-
-| Work | Model |
-|---|---|
-| Media, fast or mechanical coding, boilerplate | `Gemini 3.8 Flash (Medium)` |
-| Trivial one-liners | `Gemini 3.8 Flash (Low)` |
-| Review, architecture, hard reasoning | `Claude Sonnet 4.6 (Thinking)` |
-
-Set these once via `CLAUDE_PLUGIN_OPTION_TIER_{FLASH,FLASH_LO,PRO}` in
-`~/.zshenv` — **not** `~/.zshrc`, which non-interactive tool shells never
-source.
-
-Adversarial review is the case that most repays the stronger model: a Flash
-tier tends to agree with what it is shown, which is the one thing a reviewer
-must not do.
-
-## Headless timeouts
-
-A trivial headless `agy` prompt was measured at **605s** in 2026-09.
-`agy-delegate` defaults to `--print-timeout 5m`, so it aborts at 300s and
-reports an empty body while the answer is still arriving. Pass `--timeout 15m`
-for anything non-trivial. A short timeout does not read as "slow", it reads as
-"broken".
-
-# AOS — Antigravity / Gemini
-
-**Read [AGENTS.md](AGENTS.md) first.** It holds every rule that applies to all
-harnesses: the non-negotiables, the release gate, Conventional Commits, the
-skill contract and category routing, the pipeline variants, and the delegation
-policy. Nothing from it is repeated here — a rule that lives in two files is a
-rule that will eventually disagree with itself.
-
-This file covers only what is specific to running AOS under Antigravity.
-
-## Nothing enforces the gate here — you are the enforcement
-
-`.claude/hooks/go-gate.mjs` is a Claude Code hook and does not run on this
-harness. Not one of the four release commands is mechanically blocked for you,
-and neither is anything else.
-
-So the full rule in AGENTS.md applies here in its entirety, not just its
-hook-enforced subset: when the user asks for a plan, review, audit or
-multi-step action, you are read-only until they answer with the literal **GO**
-— including file writes and `git commit`. On Claude Code a hook would catch the
-four worst cases if discipline failed. Here there is no backstop, which makes
-this the harness where the rule matters most, not least.
-
-## Model routing
-
-The tier names in `agy-delegate` map to models that go stale — the built-in
-`flash` still points at Gemini 3.7 while 3.8 ships. Re-check against
-`agy models` after every upgrade; the id carries both the version and the
-effort suffix.
-
-| Work | Model |
-|---|---|
-| Media, fast or mechanical coding, boilerplate | `Gemini 3.8 Flash (Medium)` |
-| Trivial one-liners | `Gemini 3.8 Flash (Low)` |
-| Review, architecture, hard reasoning | `Claude Sonnet 4.6 (Thinking)` |
-
-Set these once via `CLAUDE_PLUGIN_OPTION_TIER_{FLASH,FLASH_LO,PRO}` in
-`~/.zshenv` — **not** `~/.zshrc`, which non-interactive tool shells never
-source.
-
-Adversarial review is the case that most repays the stronger model: a Flash
-tier tends to agree with what it is shown, which is the one thing a reviewer
-must not do.
-
-## Headless timeouts
-
-A trivial headless `agy` prompt was measured at **605s** in 2026-09.
-`agy-delegate` defaults to `--print-timeout 5m`, so it aborts at 300s and
-reports an empty body while the answer is still arriving. Pass `--timeout 15m`
-for anything non-trivial. A short timeout does not read as "slow", it reads as
-"broken".
-
-# AOS — Antigravity / Gemini
-
-**Read [AGENTS.md](AGENTS.md) first.** It holds every rule that applies to all
-harnesses: the non-negotiables, the release gate, Conventional Commits, the
-skill contract and category routing, the pipeline variants, and the delegation
-policy. Nothing from it is repeated here — a rule that lives in two files is a
-rule that will eventually disagree with itself.
-
-This file covers only what is specific to running AOS under Antigravity.
-
-## Nothing enforces the gate here — you are the enforcement
-
-`.claude/hooks/go-gate.mjs` is a Claude Code hook and does not run on this
-harness. Not one of the four release commands is mechanically blocked for you,
-and neither is anything else.
-
-So the full rule in AGENTS.md applies here in its entirety, not just its
-hook-enforced subset: when the user asks for a plan, review, audit or
-multi-step action, you are read-only until they answer with the literal **GO**
-— including file writes and `git commit`. On Claude Code a hook would catch the
-four worst cases if discipline failed. Here there is no backstop, which makes
-this the harness where the rule matters most, not least.
-
-## Model routing
-
-The tier names in `agy-delegate` map to models that go stale — the built-in
-`flash` still points at Gemini 3.7 while 3.8 ships. Re-check against
-`agy models` after every upgrade; the id carries both the version and the
-effort suffix.
-
-| Work | Model |
-|---|---|
-| Media, fast or mechanical coding, boilerplate | `Gemini 3.8 Flash (Medium)` |
-| Trivial one-liners | `Gemini 3.8 Flash (Low)` |
-| Review, architecture, hard reasoning | `Claude Sonnet 4.6 (Thinking)` |
-
-Set these once via `CLAUDE_PLUGIN_OPTION_TIER_{FLASH,FLASH_LO,PRO}` in
-`~/.zshenv` — **not** `~/.zshrc`, which non-interactive tool shells never
-source.
-
-Adversarial review is the case that most repays the stronger model: a Flash
-tier tends to agree with what it is shown, which is the one thing a reviewer
-must not do.
-
-## Headless timeouts
-
-A trivial headless `agy` prompt was measured at **605s** in 2026-09.
-`agy-delegate` defaults to `--print-timeout 5m`, so it aborts at 300s and
-reports an empty body while the answer is still arriving. Pass `--timeout 15m`
-for anything non-trivial. A short timeout does not read as "slow", it reads as
-"broken".
-
-# AOS — Antigravity / Gemini
-
-**Read [AGENTS.md](AGENTS.md) first.** It holds every rule that applies to all
-harnesses: the non-negotiables, the release gate, Conventional Commits, the
-skill contract and category routing, the pipeline variants, and the delegation
-policy. Nothing from it is repeated here — a rule that lives in two files is a
-rule that will eventually disagree with itself.
-
-This file covers only what is specific to running AOS under Antigravity.
-
-## Nothing enforces the gate here — you are the enforcement
-
-`.claude/hooks/go-gate.mjs` is a Claude Code hook and does not run on this
-harness. Not one of the four release commands is mechanically blocked for you,
-and neither is anything else.
-
-So the full rule in AGENTS.md applies here in its entirety, not just its
-hook-enforced subset: when the user asks for a plan, review, audit or
-multi-step action, you are read-only until they answer with the literal **GO**
-— including file writes and `git commit`. On Claude Code a hook would catch the
-four worst cases if discipline failed. Here there is no backstop, which makes
-this the harness where the rule matters most, not least.
-
-## Model routing
-
-The tier names in `agy-delegate` map to models that go stale — the built-in
-`flash` still points at Gemini 3.7 while 3.8 ships. Re-check against
-`agy models` after every upgrade; the id carries both the version and the
-effort suffix.
-
-| Work | Model |
-|---|---|
-| Media, fast or mechanical coding, boilerplate | `Gemini 3.8 Flash (Medium)` |
-| Trivial one-liners | `Gemini 3.8 Flash (Low)` |
-| Review, architecture, hard reasoning | `Claude Sonnet 4.6 (Thinking)` |
-
-Set these once via `CLAUDE_PLUGIN_OPTION_TIER_{FLASH,FLASH_LO,PRO}` in
-`~/.zshenv` — **not** `~/.zshrc`, which non-interactive tool shells never
-source.
-
-Adversarial review is the case that most repays the stronger model: a Flash
-tier tends to agree with what it is shown, which is the one thing a reviewer
-must not do.
-
-## Headless timeouts
-
-A trivial headless `agy` prompt was measured at **605s** in 2026-09.
-`agy-delegate` defaults to `--print-timeout 5m`, so it aborts at 300s and
-reports an empty body while the answer is still arriving. Pass `--timeout 15m`
-for anything non-trivial. A short timeout does not read as "slow", it reads as
-"broken".
-
-# AOS — Antigravity / Gemini
-
-**Read [AGENTS.md](AGENTS.md) first.** It holds every rule that applies to all
-harnesses: the non-negotiables, the release gate, Conventional Commits, the
-skill contract and category routing, the pipeline variants, and the delegation
-policy. Nothing from it is repeated here — a rule that lives in two files is a
-rule that will eventually disagree with itself.
-
-This file covers only what is specific to running AOS under Antigravity.
-
-## Nothing enforces the gate here — you are the enforcement
-
-`.claude/hooks/go-gate.mjs` is a Claude Code hook and does not run on this
-harness. Not one of the four release commands is mechanically blocked for you,
-and neither is anything else.
-
-So the full rule in AGENTS.md applies here in its entirety, not just its
-hook-enforced subset: when the user asks for a plan, review, audit or
-multi-step action, you are read-only until they answer with the literal **GO**
-— including file writes and `git commit`. On Claude Code a hook would catch the
-four worst cases if discipline failed. Here there is no backstop, which makes
-this the harness where the rule matters most, not least.
-
-## Model routing
-
-The tier names in `agy-delegate` map to models that go stale — the built-in
-`flash` still points at Gemini 3.7 while 3.8 ships. Re-check against
-`agy models` after every upgrade; the id carries both the version and the
-effort suffix.
-
-| Work | Model |
-|---|---|
-| Media, fast or mechanical coding, boilerplate | `Gemini 3.8 Flash (Medium)` |
-| Trivial one-liners | `Gemini 3.8 Flash (Low)` |
-| Review, architecture, hard reasoning | `Claude Sonnet 4.6 (Thinking)` |
-
-Set these once via `CLAUDE_PLUGIN_OPTION_TIER_{FLASH,FLASH_LO,PRO}` in
-`~/.zshenv` — **not** `~/.zshrc`, which non-interactive tool shells never
-source.
-
-Adversarial review is the case that most repays the stronger model: a Flash
-tier tends to agree with what it is shown, which is the one thing a reviewer
-must not do.
-
-## Headless timeouts
-
-A trivial headless `agy` prompt was measured at **605s** in 2026-09.
-`agy-delegate` defaults to `--print-timeout 5m`, so it aborts at 300s and
-reports an empty body while the answer is still arriving. Pass `--timeout 15m`
-for anything non-trivial. A short timeout does not read as "slow", it reads as
-"broken".
-
-# AOS — Antigravity / Gemini
-
-**Read [AGENTS.md](AGENTS.md) first.** It holds every rule that applies to all
-harnesses: the non-negotiables, the release gate, Conventional Commits, the
-skill contract and category routing, the pipeline variants, and the delegation
-policy. Nothing from it is repeated here — a rule that lives in two files is a
-rule that will eventually disagree with itself.
-
-This file covers only what is specific to running AOS under Antigravity.
-
-## Nothing enforces the gate here — you are the enforcement
-
-`.claude/hooks/go-gate.mjs` is a Claude Code hook and does not run on this
-harness. Not one of the four release commands is mechanically blocked for you,
-and neither is anything else.
-
-So the full rule in AGENTS.md applies here in its entirety, not just its
-hook-enforced subset: when the user asks for a plan, review, audit or
-multi-step action, you are read-only until they answer with the literal **GO**
-— including file writes and `git commit`. On Claude Code a hook would catch the
-four worst cases if discipline failed. Here there is no backstop, which makes
-this the harness where the rule matters most, not least.
-
-## Model routing
-
-The tier names in `agy-delegate` map to models that go stale — the built-in
-`flash` still points at Gemini 3.7 while 3.8 ships. Re-check against
-`agy models` after every upgrade; the id carries both the version and the
-effort suffix.
-
-| Work | Model |
-|---|---|
-| Media, fast or mechanical coding, boilerplate | `Gemini 3.8 Flash (Medium)` |
-| Trivial one-liners | `Gemini 3.8 Flash (Low)` |
-| Review, architecture, hard reasoning | `Claude Sonnet 4.6 (Thinking)` |
-
-Set these once via `CLAUDE_PLUGIN_OPTION_TIER_{FLASH,FLASH_LO,PRO}` in
-`~/.zshenv` — **not** `~/.zshrc`, which non-interactive tool shells never
-source.
-
-Adversarial review is the case that most repays the stronger model: a Flash
-tier tends to agree with what it is shown, which is the one thing a reviewer
-must not do.
-
-## Headless timeouts
-
-A trivial headless `agy` prompt was measured at **605s** in 2026-09.
-`agy-delegate` defaults to `--print-timeout 5m`, so it aborts at 300s and
-reports an empty body while the answer is still arriving. Pass `--timeout 15m`
-for anything non-trivial. A short timeout does not read as "slow", it reads as
-"broken".
-
-# AOS — Antigravity / Gemini
-
-**Read [AGENTS.md](AGENTS.md) first.** It holds every rule that applies to all
-harnesses: the non-negotiables, the release gate, Conventional Commits, the
-skill contract and category routing, the pipeline variants, and the delegation
-policy. Nothing from it is repeated here — a rule that lives in two files is a
-rule that will eventually disagree with itself.
-
-This file covers only what is specific to running AOS under Antigravity.
-
-## Nothing enforces the gate here — you are the enforcement
-
-`.claude/hooks/go-gate.mjs` is a Claude Code hook and does not run on this
-harness. Not one of the four release commands is mechanically blocked for you,
-and neither is anything else.
-
-So the full rule in AGENTS.md applies here in its entirety, not just its
-hook-enforced subset: when the user asks for a plan, review, audit or
-multi-step action, you are read-only until they answer with the literal **GO**
-— including file writes and `git commit`. On Claude Code a hook would catch the
-four worst cases if discipline failed. Here there is no backstop, which makes
-this the harness where the rule matters most, not least.
-
-## Model routing
-
-The tier names in `agy-delegate` map to models that go stale — the built-in
-`flash` still points at Gemini 3.7 while 3.8 ships. Re-check against
-`agy models` after every upgrade; the id carries both the version and the
-effort suffix.
-
-| Work | Model |
-|---|---|
-| Media, fast or mechanical coding, boilerplate | `Gemini 3.8 Flash (Medium)` |
-| Trivial one-liners | `Gemini 3.8 Flash (Low)` |
-| Review, architecture, hard reasoning | `Claude Sonnet 4.6 (Thinking)` |
-
-Set these once via `CLAUDE_PLUGIN_OPTION_TIER_{FLASH,FLASH_LO,PRO}` in
-`~/.zshenv` — **not** `~/.zshrc`, which non-interactive tool shells never
-source.
-
-Adversarial review is the case that most repays the stronger model: a Flash
-tier tends to agree with what it is shown, which is the one thing a reviewer
-must not do.
-
-## Headless timeouts
-
-A trivial headless `agy` prompt was measured at **605s** in 2026-09.
-`agy-delegate` defaults to `--print-timeout 5m`, so it aborts at 300s and
-reports an empty body while the answer is still arriving. Pass `--timeout 15m`
-for anything non-trivial. A short timeout does not read as "slow", it reads as
-"broken".