A6 from the 2026-05-16 BDD/Gherkin/XP loop audit: intent-issue.md and
slice-validation.md placeholders pointed pre-mortem evidence at
.agents/research/*.md, but /pre-mortem writes
.agents/council/YYYY-MM-DD-pre-mortem-*.md. Fixes copy drift that
taught new loop users the wrong artifact path.
Closes soc-z3qo.5
Introduce the CDLC operating loop as the execution discipline that runs
through the existing DDD/hexagonal seams, refactor 15 process skills to
billboard shape per the agreed tier line caps, and land the DDD frontmatter
v2 backfill (consumes/produces/context_rel) that was in flight on this
branch.
Doctrine + templates:
- docs/architecture/operating-loop.md: operational spine (BDD intent ->
vertical slices -> conflict-free wave -> bead acceptance -> evidence)
- docs/templates/intent-issue.md: BDD-shaped intent issue template
- docs/templates/slice-validation.md: per-slice validation plan template
- docs/cdlc.md: new section linking the conceptual seven phases to the
operating loop; operating-loop.md added to companion docs
- docs/templates/README.md + docs/documentation-index.md: catalog updates
- GOALS.md Directive #12: BDD intent + vertical slice decomposition gate
- .agents/research/2026-05-15-cdlc-dojo-doctrine.md (gitignored, local-only):
compact doctrine source for the maintainer
Process-skill sweep (15 skills):
- "Loop position" section added to: rpi, discovery, plan, implement, crank,
validation, brainstorm, pre-mortem, council, swarm, autodev, post-mortem,
forge, retro, vibe.
- Billboard refactor: bulk procedural content extracted from SKILL.md to
per-skill references/*.md for discovery, validation, implement, crank,
swarm, post-mortem, vibe (5,632 -> 3,205 SKILL.md lines, -43%, with
every new references/*.md linked back from its SKILL.md per the repo
gate).
- Restored ACT.3/ACT.4 sections in post-mortem after the billboard pass to
keep validate-next-work-contract-parity.sh green.
Validation:
- tests/skills/lint-skills.sh: all 15 PASS within declared tier caps
- scripts/audit-codex-parity.sh: PASS for all 15
- scripts/validate-next-work-contract-parity.sh: PASS
- scripts/pre-push-gate.sh --fast: PASS (0 failures, 50 skipped)
- cli/embedded mirror synced via 'cd cli && make sync-hooks'
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
The dream-end-user-coverage gate (GOALS.md Directive #8 / soc-hxnr.6) demands
a stock schedule example, but its previous canonical at .agents/schedule.yaml.example
is gitignored under the no-tracked-agents policy — so the gate had no
propagatable file to assert on and stayed red across environments.
Promote the example to docs/templates/schedule.yaml.example (alongside the
existing operator-facing templates), update the gate to prefer that path and
fall back to the operator's runtime .agents/ copy, and re-anchor the
testdata mirror's source-of-truth comment.
Add TestParser_StockExampleMirrorMatchesCanonical to lock the mirror to the
canonical via the parser — drift in name/cron/job_type fails the build, so
operators always get the same schedules the parser tests cover.
docs/INDEX.md (contract catalog) and docs/index.md (MkDocs landing) shared the
same case-folded name on case-insensitive filesystems, leaving the working tree
in a phantom-modified state and breaking contract-compatibility-gate when the
script read whichever file the OS resolved at run time.
Resolves TASK-1 + TASK-2 of .agents/plans/2026-04-26-resolve-docs-index-case-collision.md:
- Move catalog content from HEAD:docs/INDEX.md into docs/documentation-index.md
- Repoint contract validators (scripts/check-contract-compatibility.sh,
scripts/contract-orphans-allowlist.txt) and their tests at the new path
- Update navigation references across README.md, AGENTS.md, CLAUDE.md, and the
docs/ tree (newcomer-guide, CONTRIBUTING, CI-CD, plans/, positioning/,
templates/, contract examples)
- Replace stale docs/README.md mentions in CLAUDE.md / AGENTS.md / repo-execution
profile example with docs/index.md (the actual MkDocs landing)
Verification:
- bash scripts/check-contract-compatibility.sh -> 0 failures, 24 contracts catalogued
- bash tests/scripts/test-contract-compatibility-gate.sh -> 7/7 PASS (verified pre-rebase)
- bash tests/skills/test-repo-native-orchestration.sh -> 28/28 PASS (verified pre-rebase)
- git ls-files | awk casefold-dup scan -> empty
TASK-3 (casefold-collision guard script) and TASK-4 (worktree disposition) from
the plan remain to be done in a follow-up.
Bo