---
category: index
bucket: decisions
generated: true
---

# Decisions Index

Generated by `goat-flow index`; do not edit by hand. Each row below maps one Architectural Decision Record with its current status to its source file with a grep-friendly `(search: "...")` anchor. Re-run `goat-flow index` after adding, editing, renaming, or resolving entries - `goat-flow stats --check` fails while this file is stale. Live entry counts and freshness come from `goat-flow stats`.

- [ADR-001: Remove confusion-log.md from the workflow](ADR-001-remove-confusion-log.md) (search: "# ADR-001: Remove confusion-log.md from the workflow") - Accepted, 2026-03-21 - Remove `confusion-log.md` from the workflow entirely and do not resurrect it as a first-class learning-loop surface.
- [ADR-002: Replace goat-preflight skill with goat-security](ADR-002-replace-preflight-with-security-skill.md) (search: "# ADR-002: Replace goat-preflight skill with goat-security") - Accepted, 2026-03-22 - Remove goat-preflight from the expected skills list.
- [ADR-003: Replace inline setup skeletons with reference-based prompts](ADR-003-reference-based-setup-prompts.md) (search: "# ADR-003: Replace inline setup skeletons with reference-based prompts") - Accepted, 2026-03-28 - Replace inline skeleton generation with reference-based prompts that point agents at template files.
- [ADR-004: Config File and Directory-Based Learning Loop](ADR-004-config-file-and-directory-learning-loop.md) (search: "# ADR-004: Config File and Directory-Based Learning Loop") - Accepted, 2026-03-31 - Adopt a YAML config file at `.goat-flow/config.yaml` with explicit paths for learning-loop sources:
- [ADR-005: No implementation skill - extend existing skills instead](ADR-005-no-implementation-skill.md) (search: "# ADR-005: No implementation skill - extend existing skills instead") - Accepted (partial)., 2026-04-03 - Option C/D combined.
- [ADR-006: Autonomous skill mode via complexity-conditional ceremony](ADR-006-autonomous-skill-mode.md) (search: "# ADR-006: Autonomous skill mode via complexity-conditional ceremony") - Accepted, 2026-04-03 - Two mechanisms, not a flag:
- [ADR-007: Extract shared skill conventions to .goat-flow/skill-docs/skill-conventions.md](ADR-007-extract-skill-conventions.md) (search: "# ADR-007: Extract shared skill conventions to .goat-flow/skill-docs/skill-conventions.md") - Accepted, 2026-04-06 - Extract shared conventions from inline in each skill to a single file: `.goat-flow/skill-docs/skill-conventions.md`.
- [ADR-008: Instruction budget constraint - why 125 lines, why it matters](ADR-008-instruction-budget-constraint.md) (search: "# ADR-008: Instruction budget constraint - why 125 lines, why it matters") - Accepted, 2026-04-06 - CLAUDE.md (and equivalent instruction files) MUST stay under 150 lines.
- [ADR-009: Skill consolidation and canonical-skill doctrine](ADR-009-skill-consolidation.md) (search: "# ADR-009: Skill consolidation and canonical-skill doctrine") - Accepted, 2026-04-06 - A skill must have at least one of:
- [ADR-010: Setup file ownership - what setup can and cannot touch](ADR-010-setup-file-ownership.md) (search: "# ADR-010: Setup file ownership - what setup can and cannot touch") - Accepted, 2026-04-06 - Setup only creates/edits files in `.goat-flow/`.
- [ADR-011: Multi-perspective critique (goat-critique) is a core feature, not optional ceremony](ADR-011-critique-mob-core-features.md) (search: "# ADR-011: Multi-perspective critique (goat-critique) is a core feature, not optional ceremony") - Accepted (updated 2026-04-18; historical Mob Elaboration references removed after the 2026-04-15 amendment), 2026-04-10 - 1.
- [ADR-012: Expand quality checks from 15 to 26](ADR-012-quality-checks-expansion.md) (search: "# ADR-012: Expand quality checks from 15 to 26") - Accepted, 2026-04-12 - Add 11 new quality checks that close the gap between the article's claims and the audit's actual coverage.
- [ADR-013: Remove scanner/rubric system, drive setup from audit](ADR-013-remove-scanner-system.md) (search: "# ADR-013: Remove scanner/rubric system, drive setup from audit") - Accepted, 2026-04-13 - Delete the scanner/rubric system entirely.
- [ADR-014: Treat `toolchain` and `ask_first` as optional project calibration](ADR-014-optional-project-calibration-config.md) (search: "# ADR-014: Treat `toolchain` and `ask_first` as optional project calibration") - Implemented, 2026-04-15 - For 1.1.0:
- [ADR-015: Remove stop-lint.sh from goat-flow core](ADR-015-remove-stop-lint-from-core.md) (search: "# ADR-015: Remove stop-lint.sh from goat-flow core") - Implemented, 2026-04-15 - Remove `stop-lint.sh` from goat-flow core for v1.1.0:
- [ADR-016: Cold-path truth maintenance](ADR-016-cold-path-truth-maintenance.md) (search: "# ADR-016: Cold-path truth maintenance") - Accepted, 2026-04-15 - Accept that cold-path content requires automated truth-checking, not just manual maintenance.
- [ADR-017: Active-Plan Marker for `.goat-flow/plans/.active`](ADR-017-active-plan-marker.md) (search: "# ADR-017: Active-Plan Marker for `.goat-flow/plans/.active`") - Superseded by ADR-033, 2026-04-17 - Adopt Option B - marker file `.goat-flow/plans/.active`.
- [ADR-018: No standalone goat-verify skill; use shared Proof Gate](ADR-018-no-goat-verify-skill.md) (search: "# ADR-018: No standalone goat-verify skill; use shared Proof Gate") - Implemented, 2026-04-18 - 1.
- [ADR-019: Rename `goat-sbao` to `goat-critique` and `goat-test` to `goat-qa`](ADR-019-rename-sbao-to-critique-and-test-to-qa.md) (search: "# ADR-019: Rename `goat-sbao` to `goat-critique` and `goat-test` to `goat-qa`") - Accepted, 2026-04-18 - 1.
- [ADR-020: Add Copilot CLI as a first-class supported agent](ADR-020-add-copilot-cli.md) (search: "# ADR-020: Add Copilot CLI as a first-class supported agent") - Accepted, 2026-04-18 - Treat `copilot` as a first-class `AgentId` and ship full runtime parity in the same wave:
- [ADR-021: goat-critique is full delegated mode only (no quick/inline fallback)](ADR-021-goat-critique-full-mode-only.md) (search: "# ADR-021: goat-critique is full delegated mode only (no quick/inline fallback)") - Accepted, 2026-04-19 - 1. goat-critique runs in one mode: full delegated. 5 phases, 2-3 sub-agents by default; optionally 4 when cross-model spawning is available (see critique improvement plan M1/M5).
- [ADR-022: Canonical source for agent identity](ADR-022-agent-authority-canonical-source.md) (search: "# ADR-022: Canonical source for agent identity") - Accepted, 2026-04-19 - Hybrid authority with a single compile-time source of truth for identity and a single runtime source for the materialised tuple:
- [ADR-023: Reference-pack budget tiers split by load pattern](ADR-023-reference-pack-budget-tiers.md) (search: "# ADR-023: Reference-pack budget tiers split by load pattern") - Accepted, 2026-04-20 - Split the budget by load pattern:
- [ADR-024: Semantic anchors over line numbers in evidence](ADR-024-semantic-anchors-over-line-numbers.md) (search: "# ADR-024: Semantic anchors over line numbers in evidence") - Accepted, 2026-04-24 - Ban line numbers from footgun and lesson evidence.
- [ADR-025: Block all git push from agents](ADR-025-block-all-git-push.md) (search: "# ADR-025: Block all git push from agents") - Accepted, 2026-04-26 - Block all git push commands from agents, at both the settings layer and the hook layer.
- [ADR-026: Keep workspace boundary audit check path-agnostic](ADR-026-keep-workspace-boundary-path-agnostic.md) (search: "# ADR-026: Keep workspace boundary audit check path-agnostic") - Accepted, 2026-05-01 - Keep the `boundary-guidance-present` check in the harness, but make the expected remediation path-agnostic.
- [ADR-027: Remove DDT layer reference packs](ADR-027-remove-ddt-layer-reference-packs.md) (search: "# ADR-027: Remove DDT layer reference packs") - Accepted, 2026-05-02 - Remove the `ddt-layer/` directory entirely.
- [ADR-028: Treat GitHub CLI as mostly read-only, except issue and pull request comments](ADR-028-github-cli-mostly-read-only-except-comments.md) (search: "# ADR-028: Treat GitHub CLI as mostly read-only, except issue and pull request comments") - Accepted, 2026-05-20 - Goat-flow treats GitHub CLI use by agents as mostly read-only by default, with a narrow exception for GitHub issue and pull request comments.
- [ADR-029: Two-ceiling runaway protection for orchestrated long-lived resources](ADR-029-two-ceiling-runaway-protection.md) (search: "# ADR-029: Two-ceiling runaway protection for orchestrated long-lived resources") - Accepted, 2026-05-25 - For any orchestrated long-lived resource that has its own TTL or cleanup mechanism, the consumer that operates *against* that resource must have its own ceiling, set strictly shorter than the…
- [ADR-030: Replace Gemini with Antigravity as the fourth supported runtime](ADR-030-replace-gemini-with-antigravity.md) (search: "# ADR-030: Replace Gemini with Antigravity as the fourth supported runtime") - Accepted, 2026-05-24 - Canonical agents are:
- [ADR-031: Single canonical commit-conventions doc at docs/coding-standards/git-commit.md](ADR-031-single-canonical-commit-doc.md) (search: "# ADR-031: Single canonical commit-conventions doc at docs/coding-standards/git-commit.md") - Accepted, 2026-05-29 - Commit conventions live in exactly one file: `docs/coding-standards/git-commit.md`.
- [ADR-032: Scope gruff-code-quality hook binary discovery to standard install locations](ADR-032-scope-gruff-hook-binary-discovery.md) (search: "# ADR-032: Scope gruff-code-quality hook binary discovery to standard install locations") - Accepted, 2026-06-01 - `discover_binary()` searches only standard per-ecosystem install locations:
- [ADR-033: .goat-flow Directory Restructure](ADR-033-goat-flow-directory-restructure.md) (search: "# ADR-033: .goat-flow Directory Restructure") - Accepted, 2026-06-07 - Adopt the new installed layout:
- [ADR-034: Stamp a version into shipped hooks and enforce it in the audit](ADR-034-stamp-and-enforce-hook-version.md) (search: "# ADR-034: Stamp a version into shipped hooks and enforce it in the audit") - Accepted, 2026-06-08 - 1.
- [ADR-035: Generated learning-loop indexes for cold-agent discoverability](ADR-035-learning-loop-index.md) (search: "# ADR-035: Generated learning-loop indexes for cold-agent discoverability") - Accepted, 2026-06-10 - Generated per-bucket `INDEX.md` files for `.goat-flow/learning-loop/{footguns,lessons,patterns,decisions}/`, produced by the `goat-flow index` CLI command (`src/cli/learning-loop-index/`) and…
- [ADR-037: Ship post-turn safety only](ADR-037-separate-post-turn-safety-from-validation.md) (search: "# ADR-037: Ship post-turn safety only") - Accepted, 2026-06-12 - Ship one goat-flow post-turn hook: `post-turn-safety`.
- [ADR-038: Plan Checkbox Guard](ADR-038-plan-checkbox-guard.md) (search: "# ADR-038: Plan Checkbox Guard") - Superseded by ADR-039, 2026-06-14 - goat-flow ships `plan-checkbox-guard.sh` as a separate Stop hook for supported Stop agents.
- [ADR-039: Remove Plan Checkbox Guard](ADR-039-remove-plan-checkbox-guard.md) (search: "# ADR-039: Remove Plan Checkbox Guard") - Accepted, 2026-06-14 - Remove `plan-checkbox-guard.sh` from shipped goat-flow hooks.
