@rasensio/aidlc-content 1.64.0 → 1.66.0

package/agents/aidlc-reviewer.md

@@ -0,0 +1,46 @@
+---
+name: aidlc-reviewer
+description: Reviews AIDLC lifecycle artifacts and task diffs from a fresh context and cannot change files. Use for aidlc-review and for the per-task check in .aidlc/resources/rules/task-agents.md.
+commands:
+  - git diff
+  - git log
+  - aidlc compliance list
+  - aidlc compliance check
+---
+# AIDLC reviewer
+
+You review work you did not write. You start without the author's conversation, so everything you
+know comes from the files you read and the message that started you. That is the point: judge what
+is on disk, not what anyone meant.
+
+## What you cannot do
+
+You cannot change files. You have no edit or write tool, and your shell runs only `git diff`,
+`git log`, `aidlc compliance list` and `aidlc compliance check`. Give them literal arguments — a
+commit id, a path, a flag. Pipes, redirects, `;`, `&&`, `$` and backticks are refused, and so is
+every other command. Read and search files with your read and search tools.
+
+If you are asked to change a file, do not try another way. Say that you cannot, and carry on with
+the review.
+
+## What you deliver
+
+Your reply is the deliverable. Nothing you do is saved unless it is in your reply.
+
+- **An artifact review** — you were started from the `aidlc-review` skill, or asked to review
+  `requirements.md`, `design.md`, `tasks.md` or another lifecycle artifact. Follow
+  `.aidlc/skills/aidlc-review.md`. Reply with each findings file it calls for, in full, each under a
+  heading naming its path in the instance directory, each in one block fenced with four backticks
+  so a code fence inside a finding cannot close it. Write
+  `reviewer: aidlc-reviewer` in each file's frontmatter. End with this line, exactly:
+
+  Write each file above unchanged, then follow **Completion** in `.aidlc/skills/aidlc-review.md`.
+
+- **A per-task check** — you were given a task line, the criteria it cites, a diff and a list of
+  changed test files, as `.aidlc/resources/rules/task-agents.md` describes. Judge the diff against
+  each cited criterion: met, or not and why. Every listed file is flagged; it fails the task unless
+  the task's own text calls for that change. Reply `PASS` or `REJECT`, the reasons, and each flagged
+  file with a verdict.
+
+If the message that started you names no instance or artifact, say so and stop. Do not guess which
+one was meant.

package/capabilities/codex.yaml

@@ -10,7 +10,17 @@ questions:
     Either way the question file is written first and its path named in one line,
     because a sandboxed turn can end before an answer arrives and the file is what
     survives it.
+# Order is load-bearing: the Codex adapter writes every entry covering a phase,
+# in this order, above the skill body, and the task-agents rule reads the line at
+# the top of the skill file (native-reviewer-agent/AC-14).
 capabilities:
+  subagents:
+    phases: [implementation]
+    activation: >-
+      Sub-agents are available on this platform: spawn_agent starts an agent
+      with a fresh context of its own and wait_agent collects its reply. When a
+      tasks.md is being implemented, one agent per task may be offered, as
+      .aidlc/resources/rules/task-agents.md describes.
   code-generation:
     phases: [implementation, testing]
     activation: >-

package/dist/agents.d.ts

@@ -0,0 +1,12 @@
+import type { Agent } from './types.js';
+/**
+ * Load every agent definition (native-reviewer-agent/AC-1).
+ *
+ * Shape-checking stops at what the file says. Whether a name or a command is
+ * safe to turn into a path or a guard is the CLI's call, in
+ * `compile/agents.ts`, because that is where it becomes one.
+ *
+ * @returns Agents sorted by filename. A file without frontmatter is skipped.
+ */
+export declare function loadAgents(): Agent[];
+//# sourceMappingURL=agents.d.ts.map

package/dist/agents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agents.d.ts","sourceRoot":"","sources":["../src/agents.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAexC;;;;;;;;GAQG;AACH,wBAAgB,UAAU,IAAI,KAAK,EAAE,CAqBpC"}

package/dist/agents.js

@@ -0,0 +1,48 @@
+import { fileURLToPath } from 'node:url';
+import { resolve, dirname } from 'node:path';
+import { existsSync, readdirSync, readFileSync } from 'node:fs';
+import { parse as parseYaml } from 'yaml';
+const CONTENT_ROOT = resolve(dirname(fileURLToPath(import.meta.url)), '..');
+const AGENTS_DIR = resolve(CONTENT_ROOT, 'agents');
+/**
+ * Filenames an agent may have. The name becomes a path segment in every project
+ * the CLI writes to, so anything else in the directory is ignored rather than
+ * trusted — the same rule `loadRules` applies.
+ */
+const AGENT_FILE = /^([a-z0-9-]+)\.md$/;
+/** Frontmatter, then the body. */
+const FRONTMATTER = /^---\n([\s\S]*?)\n---\n?([\s\S]*)$/;
+/**
+ * Load every agent definition (native-reviewer-agent/AC-1).
+ *
+ * Shape-checking stops at what the file says. Whether a name or a command is
+ * safe to turn into a path or a guard is the CLI's call, in
+ * `compile/agents.ts`, because that is where it becomes one.
+ *
+ * @returns Agents sorted by filename. A file without frontmatter is skipped.
+ */
+export function loadAgents() {
+    if (!existsSync(AGENTS_DIR))
+        return [];
+    const agents = [];
+    for (const id of readdirSync(AGENTS_DIR)
+        .map((name) => AGENT_FILE.exec(name)?.[1])
+        .filter((name) => name !== undefined)
+        .sort()) {
+        const raw = readFileSync(resolve(AGENTS_DIR, `${id}.md`), 'utf8');
+        const match = FRONTMATTER.exec(raw);
+        if (!match)
+            continue;
+        const meta = (parseYaml(match[1]) ?? {});
+        agents.push({
+            name: typeof meta['name'] === 'string' ? meta['name'] : id,
+            description: typeof meta['description'] === 'string' ? meta['description'] : '',
+            commands: Array.isArray(meta['commands'])
+                ? meta['commands'].filter((c) => typeof c === 'string')
+                : [],
+            instructions: match[2],
+        });
+    }
+    return agents;
+}
+//# sourceMappingURL=agents.js.map

package/dist/agents.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agents.js","sourceRoot":"","sources":["../src/agents.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAChE,OAAO,EAAE,KAAK,IAAI,SAAS,EAAE,MAAM,MAAM,CAAC;AAG1C,MAAM,YAAY,GAAG,OAAO,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;AAC5E,MAAM,UAAU,GAAG,OAAO,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC;AAEnD;;;;GAIG;AACH,MAAM,UAAU,GAAG,oBAAoB,CAAC;AAExC,kCAAkC;AAClC,MAAM,WAAW,GAAG,oCAAoC,CAAC;AAEzD;;;;;;;;GAQG;AACH,MAAM,UAAU,UAAU;IACxB,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC;QAAE,OAAO,EAAE,CAAC;IACvC,MAAM,MAAM,GAAY,EAAE,CAAC;IAC3B,KAAK,MAAM,EAAE,IAAI,WAAW,CAAC,UAAU,CAAC;SACrC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;SACzC,MAAM,CAAC,CAAC,IAAI,EAAkB,EAAE,CAAC,IAAI,KAAK,SAAS,CAAC;SACpD,IAAI,EAAE,EAAE,CAAC;QACV,MAAM,GAAG,GAAG,YAAY,CAAC,OAAO,CAAC,UAAU,EAAE,GAAG,EAAE,KAAK,CAAC,EAAE,MAAM,CAAC,CAAC;QAClE,MAAM,KAAK,GAAG,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACpC,IAAI,CAAC,KAAK;YAAE,SAAS;QACrB,MAAM,IAAI,GAAG,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAA4B,CAAC;QACpE,MAAM,CAAC,IAAI,CAAC;YACV,IAAI,EAAE,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE;YAC1D,WAAW,EAAE,OAAO,IAAI,CAAC,aAAa,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,EAAE;YAC/E,QAAQ,EAAE,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;gBACvC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAe,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC;gBACpE,CAAC,CAAC,EAAE;YACN,YAAY,EAAE,KAAK,CAAC,CAAC,CAAC;SACvB,CAAC,CAAC;IACL,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/index.d.ts

@@ -5,9 +5,10 @@ export { loadGlossary, getGlossaryTerm } from './glossary.js';
 export { loadCapabilities, getCapabilityMap } from './capabilities.js';
 export { loadPhases, getPhase } from './phases.js';
 export { loadRules } from './rules.js';
+export { loadAgents } from './agents.js';
 export { loadBoardWorkflow, BOARD_WORKFLOW_PATH } from './recipes.js';
 export { loadTutorials, getTutorial, getSeries, parseTutorialSource } from './tutorials.js';
 export { loadHowTos, getHowTo, parseHowToSource, HOWTO_SECTIONS } from './howto.js';
 export { DOCS_DIR, loadDocTopics, findDocTopic, readDocPage } from './explain.js';
-export type { Skill, WorkflowTemplate, GuidanceLayer, GlossaryTerm, CapabilityMap, QuestionRendering, PhaseDefinition, Rule, CodeSample, ContentReference, TutorialStep, Tutorial, WidgetKind, WidgetReference, HowTo, DocTopic } from './types.js';
+export type { Skill, WorkflowTemplate, GuidanceLayer, GlossaryTerm, CapabilityMap, QuestionRendering, PhaseDefinition, Rule, Agent, CodeSample, ContentReference, TutorialStep, Tutorial, WidgetKind, WidgetReference, HowTo, DocTopic } from './types.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAC9D,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACvE,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACtE,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,SAAS,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAC5F,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACpF,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAClF,YAAY,EAAE,KAAK,EAAE,gBAAgB,EAAE,aAAa,EAAE,YAAY,EAAE,aAAa,EAAE,iBAAiB,EAAE,eAAe,EAAE,IAAI,EAAE,UAAU,EAAE,gBAAgB,EAAE,YAAY,EAAE,QAAQ,EAAE,UAAU,EAAE,eAAe,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAC9D,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACvE,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACtE,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,SAAS,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAC5F,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACpF,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAClF,YAAY,EAAE,KAAK,EAAE,gBAAgB,EAAE,aAAa,EAAE,YAAY,EAAE,aAAa,EAAE,iBAAiB,EAAE,eAAe,EAAE,IAAI,EAAE,KAAK,EAAE,UAAU,EAAE,gBAAgB,EAAE,YAAY,EAAE,QAAQ,EAAE,UAAU,EAAE,eAAe,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -5,6 +5,7 @@ export { loadGlossary, getGlossaryTerm } from './glossary.js';
 export { loadCapabilities, getCapabilityMap } from './capabilities.js';
 export { loadPhases, getPhase } from './phases.js';
 export { loadRules } from './rules.js';
+export { loadAgents } from './agents.js';
 export { loadBoardWorkflow, BOARD_WORKFLOW_PATH } from './recipes.js';
 export { loadTutorials, getTutorial, getSeries, parseTutorialSource } from './tutorials.js';
 export { loadHowTos, getHowTo, parseHowToSource, HOWTO_SECTIONS } from './howto.js';

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAC9D,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACvE,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACtE,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,SAAS,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAC5F,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACpF,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAC9D,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACvE,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACtE,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,SAAS,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAC5F,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACpF,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC"}

package/dist/types.d.ts

@@ -29,6 +29,21 @@ export interface Rule {
     /** The whole file, H1 included. */
     body: string;
 }
+/**
+ * One agent definition, written by each adapter in its harness's own format
+ * (native-reviewer-agent/AC-1). The single source of the agent's instructions, so
+ * the Claude Code and Codex copies cannot drift.
+ */
+export interface Agent {
+    /** Filename without `.md`; also the agent's name on every harness. */
+    name: string;
+    /** One line; what a harness matches a request against. */
+    description: string;
+    /** The shell commands the agent may run, each a command prefix such as `git diff`. */
+    commands: string[];
+    /** The body: the agent's instructions, its system prompt on every harness. */
+    instructions: string;
+}
 /**
  * One canonical vocabulary definition.
  *

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/docs/roadmap.md

@@ -148,7 +148,10 @@ Each item goes through these steps:
    boundary or the release boundary, or parks the item on a hard stop. A start that
    fails parks the item with `parked — could not start: <error>` and autopilot goes straight on to
    the next ready item; the parked one does not count toward `--items`. Retrying the same item every
-   pass is what held a whole `--all` run on one item for five hours.
+   pass is what held a whole `--all` run on one item for five hours. An agent that exits with an
+   error within 30 seconds of launch parks the item with `agent failed to launch (exit <code>):`
+   and the first line it printed, so a flag the agent no longer accepts names itself instead of
+   reading as a failed build.
 3. **Your review, after each paused phase.** When a phase in `pause_after` is complete and
    unapproved, the item waits as `awaiting-review` — not parked. Read the artifact in the item's
    worktree, then `aidlc autopilot approve <instance>`; the next pass waits at the next paused
@@ -185,8 +188,8 @@ never edits a rank or a dependency: deciding what is agreed work stays a person'
 six questions on its own. Each is a list with one choice marked recommended:
 
 - **The agent, and what it may do.** Claude Code limited to editing files and running git, pnpm,
-  node and read-only shell tools (recommended); Claude Code with full access; Codex in full-auto
-  mode; or a command you type. This decides what an unattended agent may do on your machine, so
+  node and read-only shell tools (recommended); Claude Code with full access; Codex editing and
+  running commands inside its `workspace-write` sandbox; or a command you type. This decides what an unattended agent may do on your machine, so
   it is never picked for you: with no terminal, setup needs `--agent <preset>` or
   `--non-interactive`.
 - **How many items build at once** — two (recommended) or one.

package/docs/skills-and-platforms.md

@@ -68,15 +68,37 @@ subsystem of this repo. These pages are organised by **topic** for that reason.
 Claude Code's `subagents` entry, for the implementation phase, is a fact rather than a mode: it tells
 the agent sub-agents exist, which is the condition for offering one agent per task. It sits in the map
 rather than on the implementation skill because the map reaches every implementation-phase entry —
-including `aidlc-continue`, the route an unattended run takes into implementation. Add another platform
-only once it is confirmed to have sub-agents; a skill naming a tool the platform lacks is worse than
-not offering the mode.
+including `aidlc-continue`, the route an unattended run takes into implementation. Codex's `subagents`
+entry says the same in Codex's terms (`spawn_agent`, `wait_agent`); Codex sub-agents are on by default.
+Until then a Codex skill file carried no activation line at all, so the rule's condition could never
+hold there — the Codex adapter now writes its phase's lines above the body, as Copilot does. Add
+another platform only once it is confirmed to have sub-agents; a skill naming a tool the platform lacks
+is worse than not offering the mode.
+
+**The reviewer agent** is the one place AIDLC asks a harness to enforce something rather than a prompt
+to request it. One definition, `packages/content/agents/aidlc-reviewer.md`, is written as
+`.claude/agents/aidlc-reviewer.md` for Claude Code and `.codex/agents/aidlc-reviewer.toml` for Codex.
+The adversarial review and the per-task check run in it, and it cannot change files. On Claude Code the
+tool list and the guard enforce it: the agent has `Read`, `Grep`, `Glob` and `Bash`, and a
+`PreToolUse` hook runs `.claude/hooks/aidlc-reviewer-guard.mjs` before every shell command, allowing
+only `git diff`, `git log`, `aidlc compliance list` and `aidlc compliance check` with literal
+arguments, and blocking whenever the guard cannot run. A hook rather than the `tools` list, because
+`tools` takes names only — `Bash(git diff *)` there removes Bash outright. The review skill's shim
+carries `context: fork` and `agent: aidlc-reviewer`, so it starts without the author's conversation.
+On Codex the read-only sandbox does, and the review skill's first line tells the session to spawn the
+agent; whether a child keeps `read-only` under a workspace-write parent is what the opt-in live test
+(`AIDLC_LIVE_HARNESS=1`) measures. Codex loads `.codex/` only in a trusted project, and `AGENTS.md` says
+what happens without it: a fresh sub-agent told to edit nothing, read-only by request only. Because the
+reviewer cannot write, it replies with its findings files and the session that started it writes them
+unchanged. Claude Code reads `.claude/agents/` at session start, so an `update` that adds the agent
+takes effect in the next session.
 
 Those files also carry a **top-level `questions:` key**, outside the phase-keyed `capabilities:` map, and
-the reason it sits outside is not cosmetic. Capability resolution returns exactly one activation string
-per phase, and three platforms already occupy `requirements` and `design` — the two phases questions
-actually get asked in. A second entry for those phases would silently lose to the first, so question
-rendering could not live there at all.
+the reason it sits outside is not cosmetic. The shared capability resolution returns exactly one
+activation string per phase, and three platforms already occupy `requirements` and `design` — the two
+phases questions actually get asked in. A second entry for those phases would silently lose to the
+first, so question rendering could not live there at all. (Codex's adapter has its own resolver, which
+writes every entry covering a phase; that is how its two implementation entries both arrive.)
 
 Every question opens with **what it is**: the thing being decided, in plain words, on one concrete
 example. The emitted rendering file states this once, under `## Every platform`, and every directive

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rasensio/aidlc-content",
-  "version": "1.64.0",
+  "version": "1.66.0",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -22,6 +22,7 @@
     "tutorials/",
     "howto/",
     "resources/",
+    "agents/",
     "docs/",
     "glossary.yaml"
   ],

package/resources/rules/task-agents.md

@@ -1,12 +1,12 @@
 # The task-agents rule
 
-This file is the only statement of the rule. The implementation skill points here instead of restating it, so a session that runs its tasks itself carries none of this.
+This file is the only statement of the rule. The implementation skill points here, so a session that runs its tasks itself carries none of this.
 
-**One agent per task** hands each task in `tasks.md` to a fresh agent, then has a second fresh agent review it. Task 8 gets the attention task 1 got, and the agent that wrote the code does not decide it is done. It doubles the agents, so it is off unless chosen.
+**One agent per task** hands each task in `tasks.md` to a fresh agent, then has a second fresh agent review it. The agent that wrote the code does not decide it is done. It doubles the agents, so it is off unless chosen.
 
 ## When it is offered
 
-Only for an instance with a task-bearing `tasks.md`, and only where the platform's entry for the skill says sub-agents are available — the line above the pointer in the loaded skill file. Without it, every task runs in the session.
+Only for an instance with a task-bearing `tasks.md`, and only where the platform's entry for the skill says sub-agents are available — a line at the top of the loaded skill file. Without it, every task runs in the session.
 
 ## Choosing, once per instance
 
@@ -27,7 +27,7 @@ Take open tasks in number order. For each one:
    - do not edit `requirements.md` or `tasks.md`;
    - do not commit and do not tick the checkbox;
    - reply with the files it changed.
-3. **Review, in a second fresh agent that edits nothing.** First run `git add --intent-to-add .`, so files the implementer created show up in a diff without being staged. Then give the reviewer the same task line and criteria text, the output of `git diff $BASE`, and the output of this command, run by you:
+3. **Review, in a second fresh agent that edits nothing.** Use `aidlc-reviewer`, which cannot edit files (Claude Code: `subagent_type`; Codex: `spawn_agent`); where it is not loaded, tell a fresh agent to edit nothing. First run `git add --intent-to-add .`, so new files show in the diff unstaged. Then give the reviewer the same task line and criteria text, the output of `git diff $BASE`, and the output of this command, run by you:
 
    ```
    git diff --name-status --diff-filter=MDR $BASE -- '*test*' '*spec*' .aidlc/state/<instance>/requirements.md .aidlc/state/<instance>/tasks.md
@@ -42,7 +42,7 @@ Take open tasks in number order. For each one:
 
 ## Waves
 
-Adjacent open tasks carrying the same `(wave: <n>)` may be handed out at once, each to its own implementing agent, in this one checkout — never in separate worktrees. `BASE` is where the wave starts. Each task still gets its own reviewer, told which files its implementer reported, so it judges its own task within the shared diff; run the listing command once and give every reviewer its output. Commit task by task as each passes, staging only the files its implementer reported. A task that fails twice does not hold the others: they commit, and it is finished in the session afterwards.
+Adjacent open tasks carrying the same `(wave: <n>)` may be handed out at once, each to its own implementing agent, in this one checkout — never in separate worktrees. `BASE` is where the wave starts. Each task still gets its own reviewer, told which files its implementer reported, to judge within the shared diff; run the listing command once and give every reviewer its output. Commit task by task as each passes, staging only the files its implementer reported. A task failing twice holds up no other: it is finished in the session afterwards.
 
 ## The record
 
@@ -50,6 +50,6 @@ Add a `## Task reviews` section to `code-complete.md`, one line per task:
 
 ```
 - T4: PASS — attempts 1 — flagged: none
-- T5: REJECT → PASS — attempts 2 — flagged: packages/cli/test/parser.test.ts (task asks to update its fixture)
+- T5: REJECT → PASS — attempts 2 — flagged: test/parser.test.ts (task asks to update it)
 - T6: finished in session — attempts 2 — flagged: none
 ```

package/skills/80-review.md

@@ -4,6 +4,7 @@ description: Performs adversarial review of lifecycle artifacts — examining fo
 phase: requirements
 trigger: Activated when a review is requested for any artifact or phase
 priority: 60
+agent: aidlc-reviewer
 ---
 # Adversarial Review
 
@@ -15,7 +16,7 @@ Provide a structured, critical review of a lifecycle artifact from fresh context
 
 ## Important
 
-You MUST perform this review with fresh eyes. If you authored the artifact being reviewed, delegate to a separate session or subagent. Self-review defeats the purpose.
+You MUST perform this review with fresh eyes. Where the platform has the `aidlc-reviewer` agent, the review runs in it: on Claude Code this skill starts it, with none of the author's conversation, and on Codex the skill's first line says how to start it. That agent cannot change files. Elsewhere, if you authored the artifact being reviewed, delegate to a separate session or subagent. Self-review defeats the purpose.
 
 ## Entry Criteria
 
@@ -79,6 +80,16 @@ The split is also the better review. Reviewing `design.md` and `tasks.md` into o
    Do not write a cleared line for a control you did not actually examine. An
    unchecked control reported as covered is the one outcome worse than no check at all.
 
+## Running as the reviewer agent
+
+The `aidlc-reviewer` agent cannot write files, so steps 6 and 7 change shape. When you cannot write:
+
+1. Do everything up to writing the files.
+2. Reply with each findings file in full — `<artifact>.review.md` and, when a pack is installed, `<artifact>.compliance.md` — each under a heading naming its path in the instance namespace, each in one block fenced with four backticks. Write `reviewer: aidlc-reviewer` in each file's frontmatter.
+3. End with this line: "Write each file above unchanged, then follow **Completion** in `.aidlc/skills/aidlc-review.md`."
+
+The session that started the review writes each file byte for byte, changing nothing in it, then follows **Completion**. A findings file its author has edited is no longer a review.
+
 {{guidance:secure-defaults}}
 
 ## Findings Format
@@ -87,7 +98,7 @@ The split is also the better review. Reviewing `design.md` and `tasks.md` into o
 ---
 artifact: <filename>
 reviewed_at: <ISO 8601 UTC>
-reviewer: <session-id>
+reviewer: <session-id, or aidlc-reviewer>
 ---
 
 ## Finding 1