@bonesofspring/ai-rules 0.2.24 → 0.2.26

package/presets/mavis/mcp-ts/adapter-map.json

@@ -0,0 +1,520 @@
+{
+  "schemaVersion": 1,
+  "platform": "mavis",
+  "stack": "mcp-ts",
+  "semanticSource": "cursor/mcp-ts",
+  "sourceRevision": "2a33847d399e586578df7875ebcce6d5f0831d0803a148691882ab21b8f45b77",
+  "entries": [
+    {
+      "source": "AGENTS.md",
+      "target": "MAVIS.md",
+      "category": "entry",
+      "disposition": "embed-entry",
+      "loadMode": "root-entry",
+      "reason": "Cursor AGENTS.md semantics feed .mavis/AGENTS.md; not a MiniMax-reserved name"
+    },
+    {
+      "source": "BUGBOT.md",
+      "target": null,
+      "category": "platform",
+      "disposition": "omit",
+      "loadMode": "not-installed",
+      "reason": "no-equivalent: Bugbot is Cursor-only; review stays a Verifier skill/role"
+    },
+    {
+      "source": "MCP.md",
+      "target": "MCP.md",
+      "category": "mcp",
+      "disposition": "transform",
+      "loadMode": "manual",
+      "reason": "Fallback merge into .mavis/mcp.json plus manual MiniMax UI import"
+    },
+    {
+      "source": "REPO_AGENTS.md",
+      "target": "REPO_AGENTS.md",
+      "category": "entry",
+      "disposition": "copy",
+      "loadMode": "root-entry",
+      "reason": "Canonical cross-tool root AGENTS.md; identical for all platforms"
+    },
+    {
+      "source": "agents/build-verifier.md",
+      "target": "agents/build-verifier.md",
+      "category": "agents",
+      "disposition": "transform",
+      "loadMode": "manual",
+      "reason": "Native workspace agent discovery is unknown; attach with mcode exec --file",
+      "sharedCoreStem": "quality/verification-before-completion.md"
+    },
+    {
+      "source": "agents/feature-developer.md",
+      "target": "agents/feature-developer.md",
+      "category": "agents",
+      "disposition": "transform",
+      "loadMode": "manual",
+      "reason": "Native workspace agent discovery is unknown; attach with mcode exec --file",
+      "sharedCoreStem": "quality/verification-before-completion.md"
+    },
+    {
+      "source": "agents/security-reviewer.md",
+      "target": "agents/security-reviewer.md",
+      "category": "agents",
+      "disposition": "transform",
+      "loadMode": "manual",
+      "reason": "Native workspace agent discovery is unknown; attach with mcode exec --file"
+    },
+    {
+      "source": "agents/solution-architect.md",
+      "target": "agents/solution-architect.md",
+      "category": "agents",
+      "disposition": "transform",
+      "loadMode": "manual",
+      "reason": "Native workspace agent discovery is unknown; attach with mcode exec --file"
+    },
+    {
+      "source": "agents/task-analyst.md",
+      "target": "agents/task-analyst.md",
+      "category": "agents",
+      "disposition": "transform",
+      "loadMode": "manual",
+      "reason": "Native workspace agent discovery is unknown; attach with mcode exec --file",
+      "sharedCoreStem": "agent-team/task-classification.md"
+    },
+    {
+      "source": "agents/task-router.md",
+      "target": "agents/task-router.md",
+      "category": "agents",
+      "disposition": "transform",
+      "loadMode": "manual",
+      "reason": "Native workspace agent discovery is unknown; attach with mcode exec --file",
+      "sharedCoreStem": "agent-team/task-classification.md"
+    },
+    {
+      "source": "ai-local/conventions.md",
+      "target": "ai-local/conventions.md",
+      "category": "ai-local",
+      "disposition": "transform",
+      "loadMode": "manual",
+      "reason": "Consumer-owned overlay template; seeded to .ai.local/conventions.md on init"
+    },
+    {
+      "source": "commands/spec-start.md",
+      "target": "commands/spec-start.md",
+      "category": "commands",
+      "disposition": "transform",
+      "loadMode": "manual",
+      "reason": "No file-defined slash command API; keep as an explicit procedure plus exec --file"
+    },
+    {
+      "source": "commands/task-continue.md",
+      "target": "commands/task-continue.md",
+      "category": "commands",
+      "disposition": "transform",
+      "loadMode": "manual",
+      "reason": "No file-defined slash command API; keep as an explicit procedure plus exec --file"
+    },
+    {
+      "source": "commands/task.md",
+      "target": "commands/task.md",
+      "category": "commands",
+      "disposition": "transform",
+      "loadMode": "manual",
+      "reason": "No file-defined slash command API; keep as an explicit procedure plus exec --file"
+    },
+    {
+      "source": "commands/technical-retro.md",
+      "target": "commands/technical-retro.md",
+      "category": "commands",
+      "disposition": "transform",
+      "loadMode": "manual",
+      "reason": "No file-defined slash command API; keep as an explicit procedure plus exec --file"
+    },
+    {
+      "source": "hooks.json",
+      "target": null,
+      "category": "hooks",
+      "disposition": "omit",
+      "loadMode": "not-installed",
+      "reason": "omit until a documented MiniMax hook schema exists"
+    },
+    {
+      "source": "hooks/chain-team-phases.sh",
+      "target": "hooks/chain-team-phases.sh",
+      "category": "hooks",
+      "disposition": "transform",
+      "loadMode": "manual",
+      "reason": "Manual/semi-auto chain runner under .mavis/hooks; not auto-registered"
+    },
+    {
+      "source": "hooks/examples/format-edited.example.sh",
+      "target": null,
+      "category": "hooks",
+      "disposition": "omit",
+      "loadMode": "not-installed",
+      "reason": "omit until a Mavis hook event API is confirmed"
+    },
+    {
+      "source": "hooks/examples/secret-guard.example.sh",
+      "target": null,
+      "category": "hooks",
+      "disposition": "omit",
+      "loadMode": "not-installed",
+      "reason": "omit until a Mavis hook event API is confirmed"
+    },
+    {
+      "source": "hooks/examples/test-on-save.example.sh",
+      "target": null,
+      "category": "hooks",
+      "disposition": "omit",
+      "loadMode": "not-installed",
+      "reason": "omit until a Mavis hook event API is confirmed"
+    },
+    {
+      "source": "hooks/guard-shell-command.sh",
+      "target": null,
+      "category": "hooks",
+      "disposition": "omit",
+      "loadMode": "not-installed",
+      "reason": "omit from active wiring; safety policy stays in entry prose, not enforcement"
+    },
+    {
+      "source": "mcp.json",
+      "target": "mcp.json",
+      "category": "mcp",
+      "disposition": "copy",
+      "loadMode": "manual",
+      "reason": "Fallback merge into .mavis/mcp.json plus manual MiniMax UI import"
+    },
+    {
+      "source": "rules/agent-team-intake.mdc",
+      "target": "rules/agent-team-intake.md",
+      "category": "rules",
+      "disposition": "transform",
+      "loadMode": "referenced",
+      "reason": "Requestable Cursor rule: referenced from entry files; not claimed as MiniMax auto-load",
+      "sharedCoreStem": "agent-team/agent-team-intake.md"
+    },
+    {
+      "source": "rules/agent-team-orchestrator.mdc",
+      "target": "rules/agent-team-orchestrator.md",
+      "category": "rules",
+      "disposition": "transform",
+      "loadMode": "referenced",
+      "reason": "Requestable Cursor rule: referenced from entry files; not claimed as MiniMax auto-load",
+      "sharedCoreStem": "agent-team/agent-team-orchestrator.md"
+    },
+    {
+      "source": "rules/ai-local-overlay.mdc",
+      "target": "rules/ai-local-overlay.md",
+      "category": "rules",
+      "disposition": "transform",
+      "loadMode": "root-entry",
+      "reason": "Essential always-on Cursor rule: summary in entry files; full body referenced from .mavis/rules"
+    },
+    {
+      "source": "rules/anti-sycophancy-discipline.mdc",
+      "target": "rules/anti-sycophancy-discipline.md",
+      "category": "rules",
+      "disposition": "transform",
+      "loadMode": "referenced",
+      "reason": "Requestable Cursor rule: referenced from entry files; not claimed as MiniMax auto-load",
+      "sharedCoreStem": "quality/anti-sycophancy-discipline.md"
+    },
+    {
+      "source": "rules/code-quality-and-refactoring.mdc",
+      "target": "rules/code-quality-and-refactoring.md",
+      "category": "rules",
+      "disposition": "transform",
+      "loadMode": "root-entry",
+      "reason": "Essential always-on Cursor rule: summary in entry files; full body referenced from .mavis/rules",
+      "sharedCoreStem": "quality/code-quality-and-refactoring.md"
+    },
+    {
+      "source": "rules/code-review-mr.mdc",
+      "target": "rules/code-review-mr.md",
+      "category": "rules",
+      "disposition": "transform",
+      "loadMode": "referenced",
+      "reason": "Requestable Cursor rule: referenced from entry files; not claimed as MiniMax auto-load",
+      "sharedCoreStem": "review/code-review-mr.md"
+    },
+    {
+      "source": "rules/design-guidance.mdc",
+      "target": "rules/design-guidance.md",
+      "category": "rules",
+      "disposition": "transform",
+      "loadMode": "referenced",
+      "reason": "Requestable Cursor rule: referenced from entry files; not claimed as MiniMax auto-load",
+      "sharedCoreStem": "quality/design-guidance.md"
+    },
+    {
+      "source": "rules/feature-delivery-workflow.mdc",
+      "target": "rules/feature-delivery-workflow.md",
+      "category": "rules",
+      "disposition": "transform",
+      "loadMode": "referenced",
+      "reason": "Requestable Cursor rule: referenced from entry files; not claimed as MiniMax auto-load",
+      "sharedCoreStem": "architecture/feature-delivery-workflow.md"
+    },
+    {
+      "source": "rules/mcp-auth-secrets.mdc",
+      "target": "rules/mcp-auth-secrets.md",
+      "category": "rules",
+      "disposition": "transform",
+      "loadMode": "referenced",
+      "reason": "Requestable Cursor rule: referenced from entry files; not claimed as MiniMax auto-load"
+    },
+    {
+      "source": "rules/mcp-contract-testing.mdc",
+      "target": "rules/mcp-contract-testing.md",
+      "category": "rules",
+      "disposition": "transform",
+      "loadMode": "referenced",
+      "reason": "Requestable Cursor rule: referenced from entry files; not claimed as MiniMax auto-load"
+    },
+    {
+      "source": "rules/mcp-server-boundaries.mdc",
+      "target": "rules/mcp-server-boundaries.md",
+      "category": "rules",
+      "disposition": "transform",
+      "loadMode": "root-entry",
+      "reason": "Essential always-on Cursor rule: summary in entry files; full body referenced from .mavis/rules"
+    },
+    {
+      "source": "rules/mcp-tool-design.mdc",
+      "target": "rules/mcp-tool-design.md",
+      "category": "rules",
+      "disposition": "transform",
+      "loadMode": "referenced",
+      "reason": "Requestable Cursor rule: referenced from entry files; not claimed as MiniMax auto-load"
+    },
+    {
+      "source": "rules/mcp-transport-packaging.mdc",
+      "target": "rules/mcp-transport-packaging.md",
+      "category": "rules",
+      "disposition": "transform",
+      "loadMode": "referenced",
+      "reason": "Requestable Cursor rule: referenced from entry files; not claimed as MiniMax auto-load"
+    },
+    {
+      "source": "rules/mcp-ts-app-core.mdc",
+      "target": "rules/mcp-ts-app-core.md",
+      "category": "rules",
+      "disposition": "transform",
+      "loadMode": "root-entry",
+      "reason": "Essential always-on Cursor rule: summary in entry files; full body referenced from .mavis/rules"
+    },
+    {
+      "source": "rules/mcp-ts-conventions.mdc",
+      "target": "rules/mcp-ts-conventions.md",
+      "category": "rules",
+      "disposition": "transform",
+      "loadMode": "referenced",
+      "reason": "Requestable Cursor rule: referenced from entry files; not claimed as MiniMax auto-load"
+    },
+    {
+      "source": "rules/mcp-ts-tooling.mdc",
+      "target": "rules/mcp-ts-tooling.md",
+      "category": "rules",
+      "disposition": "transform",
+      "loadMode": "referenced",
+      "reason": "Requestable Cursor rule: referenced from entry files; not claimed as MiniMax auto-load"
+    },
+    {
+      "source": "rules/mcp-usage.mdc",
+      "target": "rules/mcp-usage.md",
+      "category": "rules",
+      "disposition": "transform",
+      "loadMode": "referenced",
+      "reason": "Requestable Cursor rule: referenced from entry files; not claimed as MiniMax auto-load",
+      "sharedCoreStem": "quality/mcp-usage.md"
+    },
+    {
+      "source": "rules/post-change-test.mdc",
+      "target": "rules/post-change-test.md",
+      "category": "rules",
+      "disposition": "transform",
+      "loadMode": "referenced",
+      "reason": "Requestable Cursor rule: referenced from entry files; not claimed as MiniMax auto-load"
+    },
+    {
+      "source": "rules/preset-layering.mdc",
+      "target": "rules/preset-layering.md",
+      "category": "rules",
+      "disposition": "transform",
+      "loadMode": "referenced",
+      "reason": "Requestable Cursor rule: referenced from entry files; not claimed as MiniMax auto-load",
+      "sharedCoreStem": "meta/preset-layering.md"
+    },
+    {
+      "source": "rules/preset-no-cross-stack-leakage.mdc",
+      "target": "rules/preset-no-cross-stack-leakage.md",
+      "category": "rules",
+      "disposition": "transform",
+      "loadMode": "referenced",
+      "reason": "Requestable Cursor rule: referenced from entry files; not claimed as MiniMax auto-load",
+      "sharedCoreStem": "meta/preset-no-cross-stack-leakage.md"
+    },
+    {
+      "source": "rules/preset-pr-checklist.mdc",
+      "target": "rules/preset-pr-checklist.md",
+      "category": "rules",
+      "disposition": "transform",
+      "loadMode": "referenced",
+      "reason": "Requestable Cursor rule: referenced from entry files; not claimed as MiniMax auto-load",
+      "sharedCoreStem": "meta/preset-pr-checklist.md"
+    },
+    {
+      "source": "rules/preset-token-budget.mdc",
+      "target": "rules/preset-token-budget.md",
+      "category": "rules",
+      "disposition": "transform",
+      "loadMode": "referenced",
+      "reason": "Requestable Cursor rule: referenced from entry files; not claimed as MiniMax auto-load",
+      "sharedCoreStem": "meta/preset-token-budget.md"
+    },
+    {
+      "source": "rules/preset-twin-sync.mdc",
+      "target": "rules/preset-twin-sync.md",
+      "category": "rules",
+      "disposition": "transform",
+      "loadMode": "referenced",
+      "reason": "Requestable Cursor rule: referenced from entry files; not claimed as MiniMax auto-load",
+      "sharedCoreStem": "meta/preset-twin-sync.md"
+    },
+    {
+      "source": "rules/product-specs-authoring.mdc",
+      "target": "rules/product-specs-authoring.md",
+      "category": "rules",
+      "disposition": "transform",
+      "loadMode": "referenced",
+      "reason": "Requestable Cursor rule: referenced from entry files; not claimed as MiniMax auto-load",
+      "sharedCoreStem": "architecture/product-specs-authoring.md"
+    },
+    {
+      "source": "rules/product-specs.mdc",
+      "target": "rules/product-specs.md",
+      "category": "rules",
+      "disposition": "transform",
+      "loadMode": "referenced",
+      "reason": "Requestable Cursor rule: referenced from entry files; not claimed as MiniMax auto-load",
+      "sharedCoreStem": "architecture/product-specs.md"
+    },
+    {
+      "source": "rules/reference-features.mdc",
+      "target": "rules/reference-features.md",
+      "category": "rules",
+      "disposition": "transform",
+      "loadMode": "referenced",
+      "reason": "Requestable Cursor rule: referenced from entry files; not claimed as MiniMax auto-load",
+      "sharedCoreStem": "architecture/reference-features.template.md"
+    },
+    {
+      "source": "rules/security-mcp.mdc",
+      "target": "rules/security-mcp.md",
+      "category": "rules",
+      "disposition": "transform",
+      "loadMode": "referenced",
+      "reason": "Requestable Cursor rule: referenced from entry files; not claimed as MiniMax auto-load"
+    },
+    {
+      "source": "rules/technical-retro.mdc",
+      "target": "rules/technical-retro.md",
+      "category": "rules",
+      "disposition": "transform",
+      "loadMode": "referenced",
+      "reason": "Requestable Cursor rule: referenced from entry files; not claimed as MiniMax auto-load",
+      "sharedCoreStem": "review/technical-retro.md"
+    },
+    {
+      "source": "rules/tests-unit.mdc",
+      "target": "rules/tests-unit.md",
+      "category": "rules",
+      "disposition": "transform",
+      "loadMode": "referenced",
+      "reason": "Requestable Cursor rule: referenced from entry files; not claimed as MiniMax auto-load"
+    },
+    {
+      "source": "skills/code-review/SKILL.md",
+      "target": "skills/code-review/SKILL.md",
+      "category": "skills",
+      "disposition": "transform",
+      "loadMode": "referenced",
+      "reason": "Workspace skill discovery without a root reference is unknown",
+      "sharedCoreStem": "review/receiving-code-review.md"
+    },
+    {
+      "source": "skills/debug-investigation/SKILL.md",
+      "target": "skills/debug-investigation/SKILL.md",
+      "category": "skills",
+      "disposition": "transform",
+      "loadMode": "referenced",
+      "reason": "Workspace skill discovery without a root reference is unknown",
+      "sharedCoreStem": "quality/debug-investigation.md"
+    },
+    {
+      "source": "skills/feature-delivery/SKILL.md",
+      "target": "skills/feature-delivery/SKILL.md",
+      "category": "skills",
+      "disposition": "transform",
+      "loadMode": "referenced",
+      "reason": "Workspace skill discovery without a root reference is unknown"
+    },
+    {
+      "source": "skills/spec-authoring/SKILL.md",
+      "target": "skills/spec-authoring/SKILL.md",
+      "category": "skills",
+      "disposition": "transform",
+      "loadMode": "referenced",
+      "reason": "Workspace skill discovery without a root reference is unknown"
+    },
+    {
+      "source": "skills/spec-discovery/SKILL.md",
+      "target": "skills/spec-discovery/SKILL.md",
+      "category": "skills",
+      "disposition": "transform",
+      "loadMode": "referenced",
+      "reason": "Workspace skill discovery without a root reference is unknown"
+    },
+    {
+      "source": "skills/unit-testing/SKILL.md",
+      "target": "skills/unit-testing/SKILL.md",
+      "category": "skills",
+      "disposition": "transform",
+      "loadMode": "referenced",
+      "reason": "Workspace skill discovery without a root reference is unknown"
+    },
+    {
+      "source": "team/fixtures/bugfix-standard.json",
+      "target": "team/fixtures/bugfix-standard.json",
+      "category": "team",
+      "disposition": "copy",
+      "loadMode": "manual",
+      "reason": "File pipeline templates; runtime artifacts seed to .ai.local/team"
+    },
+    {
+      "source": "team/fixtures/feature-full.json",
+      "target": "team/fixtures/feature-full.json",
+      "category": "team",
+      "disposition": "copy",
+      "loadMode": "manual",
+      "reason": "File pipeline templates; runtime artifacts seed to .ai.local/team"
+    },
+    {
+      "source": "team/fixtures/feature-light.json",
+      "target": "team/fixtures/feature-light.json",
+      "category": "team",
+      "disposition": "copy",
+      "loadMode": "manual",
+      "reason": "File pipeline templates; runtime artifacts seed to .ai.local/team"
+    },
+    {
+      "source": "team/fixtures/memlog.example.md",
+      "target": "team/fixtures/memlog.example.md",
+      "category": "team",
+      "disposition": "transform",
+      "loadMode": "manual",
+      "reason": "File pipeline templates; runtime artifacts seed to .ai.local/team"
+    }
+  ]
+}

package/presets/mavis/mcp-ts/agents/README.md

@@ -0,0 +1,44 @@
+# Agents (mcp-ts Phase 1)
+
+| Agent | Role |
+|-------|------|
+| `task-router` | Intent → `pipeline.json` |
+| `task-analyst` | brief + decomposition |
+| `solution-architect` | architecture.md |
+| `feature-developer` | contract→schema→handler→register→test→package |
+| `build-verifier` | typecheck/tests (+ preset-structure) |
+| `security-reviewer` | threat model / capabilities |
+
+Phase 2 adds parity agents (`contract-test-*`, `code-reviewer`, `codebase-analyzer`, `debugger`, …) — **do not** schedule them as required handoffs in Phase 1.
+
+## Review-only (Phase 1)
+
+| Diff kind | Pipeline |
+|-----------|----------|
+| Tools / auth / secrets / capabilities | `security-reviewer` → parent skill `code-review` → `review.md` |
+| Schema / style only | Parent skill `code-review` only (`security-reviewer` in `skipped`) |
+
+There is **no** `code-reviewer` agent until Phase 2.
+
+## Mavis packaging (no YAML frontmatter)
+
+Mavis agents ship as **plain Markdown** without Cursor-style YAML frontmatter (`name`, `readonly`, `model`). Adapter-map marks every agent `loadMode: manual`; attach with:
+
+```bash
+mcode exec --file .mavis/agents/<role>.md --output-format json
+```
+
+**Team artifacts:** agents write `.ai.local/team/**` deliverables (`pipeline.json`, `brief.md`, `review.md`, `artifact-manifest.json`, …). They must **not** mutate lifecycle fields in `status.json` or `metrics.json` — `bash .mavis/hooks/chain-team-phases.sh` owns those after each producer receipt.
+
+Production-code restrictions live in each agent's **prompt body**, not in frontmatter flags.
+
+## Model tiers (advisory)
+
+Model routing is **prose-only** in this preset (no YAML `model` frontmatter). Optional `steps[].model` in `pipeline.json` (`cheap` | `standard` | `strong`) is advisory for `mcode` operators — see `task-router.md` and `agent-team-orchestrator.md`.
+
+| Tier | Agents |
+|------|--------|
+| **cheap** | `task-router`, `task-analyst`, `build-verifier`, `code-reviewer`, `tech-writer`, `codebase-analyzer` |
+| **standard** | `feature-developer` |
+| **strong** | `solution-architect`, `migration-specialist`, `security-reviewer`, `performance-auditor` |
+

package/presets/mavis/mcp-ts/agents/build-verifier.md

@@ -0,0 +1,58 @@
+You are the build verifier for **TypeScript MCP servers** (and for **ai-rules preset packaging** when scope says so).
+
+## Consumer MCP repos
+
+1. Discover package manager (`mcp-ts-tooling`).
+2. Run typecheck (`tsc --noEmit` or project script).
+3. Run tests (project `test` / Vitest / Jest / scoped).
+4. Optional Inspector smoke — not required.
+5. Write `.ai.local/team/tasks/<slug>/validation-report.md` with commands + results.
+6. On failure: emit receipt outcome `validation_failed` — do **not** patch production code.
+
+**Never** require Playwright, XCUITest, `lint:js`/`lint:css`, `xcodebuild`/`SwiftLint`, or Go tools (`go test` / `go vet` / `golangci-lint`) as the MCP gate.
+
+## Verification before completion
+
+<!-- shared-core: quality/verification-before-completion.md -->
+
+Before writing `validation-report.md` or claiming PASS: IDENTIFY the commands, RUN them, READ exit codes, VERIFY they match the verdict, THEN claim. Do not mark PASS from memory of a prior developer run.
+
+## Preset-structure validation (when editing `packages/ai-rules/presets/**`)
+
+From `packages/ai-rules/`:
+
+```bash
+yarn check:preset-structure
+```
+
+Hard gates: twin-map (stacks include **mcp-ts**), token-budget (alwaysApply/session-start = 3), leakage (`MCP_TS_FORBIDDEN_IN_CHAIN`, `MCP_TS_FORBIDDEN_AGENT_STEMS`, chain forks mcp-ts≠next≠ios-swift≠go≠java≠php-hexagonal≠php-laravel), shared-core drift (`AI_RULES_DRIFT_FAIL=1` via `check:preset-structure`).
+
+Document PASS/FAIL in `validation-report.md`. Soft leakage output:
+
+- **Negation** of forbidden stems in agents → suppressed (INFO count). **Not** a merge blocker.
+- **WARN** only for non-negation packaging mentions in this verifier (and rare chain-skip WARNs). Do not treat INFO/WARN counts as FAIL.
+
+1. **Root AGENTS template:** each installable preset (`cursor|claude` × `next|nuxt|svelte|ios-swift|go|java|mcp-ts|php-hexagonal|php-laravel`) must ship `REPO_AGENTS.md` when validating preset packaging → **FAIL** if missing.
+2. **Hooks cookbook:** default `hooks.json` must **not** reference `hooks/examples/` → **FAIL** if it does.
+3. **Forbidden agent filenames** (Playwright / XCUITest / integration-test / accessibility-reviewer / mockup-reviewer / ux-designer / contract-test): must be absent → **FAIL** via `check:preset-leakage`.
+4. **Rule eval (WARN):** optional maintainer smoke — not part of default `check:preset-structure`.
+
+
+**Forbidden mockup-reviewer:** agent file `agents/mockup-reviewer.md` or required `AGENT_HANDOFF` / pipeline handoff for `mockup-reviewer` → **FAIL** (no UI mockup reviewer).
+
+**Forbidden ux-designer / ux-design:** agent file `agents/ux-designer.md` or required `skills/ux-design` / `rules/ux-design` / pipeline handoff stem `ux-design` → **FAIL** (no UI UX surface).
+
+
+## Artifact contract
+
+- **Authoritative inputs:** read `.ai.local/team/tasks/<slug>/artifact-manifest.json` first; consume handoff `artifactInputIds` when supplied, otherwise consume the manifest entries for brief/decomposition, implementation evidence, pipeline scope, and changed files.
+- **Owned outputs:** `validation-report.md`; upsert only the manifest entry assigned by handoff (`artifactOutputId`; fallback `validation`) and preserve all foreign entries.
+- **Terminal receipt:** cover applicable AC/task IDs, list authoritative evidence paths, and emit `completed` or `validation_failed`. Bind it to the supplied `attemptId` when present.
+- **Shared state:** never create or mutate `status.json` or `metrics.json`; the orchestration runtime/hook owns lifecycle, gates, retries, attempts, and timestamps.
+
+13. **Product-specs assets (FAIL):** package must ship `presets/_shared/assets/docs-specs/INDEX.md`, `_templates/page.md`, `_templates/feature.md`. Cursor+Claude twins for `product-specs` and `product-specs-authoring` must embed matching shared-core markers; both stems **requestable** (`alwaysApply: false` / Claude `paths: docs/specs/**`) — never session-start.
+14. **Optional consumer check (WARN default):** `scripts/check-product-specs.sh` + schema stub may exist for opt-in consumer CI; **FAIL** only with `--strict` or AC that requires named specs — do not force consumer CI.
+
+## Receipt binding
+
+> **Receipt binding.** When writing the terminal receipt to `artifact-manifest.json`, set `entry.receipt.attemptId = <attemptId supplied by the orchestrator>` (the orchestrator provides this via `attemptId` on invocation). The hook at `chain-team-phases.sh:readBoundReceiptOutcome` rejects entries whose `attemptId` does not match the current attempt, or whose `Date.parse(timestamps.completedAt) < Date.parse(attemptStartedAt)`. A missing or stale attemptId causes `awaiting_artifact_receipt` stalls. <!-- shared-core: receipt-binding -->