Bootstrap fallow-ts governance #18

Closed

codex wants to merge 0 commits from codex/prewave-governance-bootstrap into main

codex commented

2026-05-16 23:35:36 +02:00

Collaborator

Canary Context Pack

Product story

Before Wave 1 locks output contracts and fixtures, fallow-ts needs the same durable agent-governance anchor that made fallow-py resilient after context compaction. Issue #17 identified this as the first pre-wave blocker.

What changed

Expanded AGENTS.md from a bootstrap stub into a repo runbook for agents.
Added decisions/README.md.
Added ADR 0001 for harness identity.
Added ADR 0002 for the future three-bucket classification commitment.
Added ADR 0003 for schema naming direction before golden output lands.
Added ADR 0004 for mandatory non-author review.

Why it changed

Without these docs, future agents would have to reconstruct repo rules from chat scrollback and issue comments. That is exactly the drift pattern the fallow-py ADR convention prevents.

Files touched

AGENTS.md
decisions/README.md
decisions/0001-brand-identity-harness.md
decisions/0002-three-bucket-classification-commitment.md
decisions/0003-schema-naming-convention.md
decisions/0004-mandatory-non-author-reviewer.md

Relevant context

Refs #17
docs/roadmap.md
docs/next-steps.md
fallow-py ADR 0007, 0009, 0010, 0012

Runtime evidence

npm run build
npm test
git diff --check

Known constraints

This is a governance-only PR. It records target decisions and repo rules; it does not fix parser bugs or change the JSON schema yet.

Explicit out-of-scope

Parser fixes B1-B4 from #17.
Symlink/error handling hardening.
Deterministic root output.
Wave 1 issues #2-#6.

Requested decision

Approve and merge as the first pre-wave PR.

Merge blockers

Factual contradiction with the accepted roadmap, unclear governance obligations, or docs that claim source behavior this PR does not implement.

## Canary Context Pack ### Product story Before Wave 1 locks output contracts and fixtures, fallow-ts needs the same durable agent-governance anchor that made fallow-py resilient after context compaction. Issue #17 identified this as the first pre-wave blocker. ### What changed - Expanded `AGENTS.md` from a bootstrap stub into a repo runbook for agents. - Added `decisions/README.md`. - Added ADR 0001 for harness identity. - Added ADR 0002 for the future three-bucket classification commitment. - Added ADR 0003 for schema naming direction before golden output lands. - Added ADR 0004 for mandatory non-author review. ### Why it changed Without these docs, future agents would have to reconstruct repo rules from chat scrollback and issue comments. That is exactly the drift pattern the fallow-py ADR convention prevents. ### Files touched - `AGENTS.md` - `decisions/README.md` - `decisions/0001-brand-identity-harness.md` - `decisions/0002-three-bucket-classification-commitment.md` - `decisions/0003-schema-naming-convention.md` - `decisions/0004-mandatory-non-author-reviewer.md` ### Relevant context - Refs #17 - `docs/roadmap.md` - `docs/next-steps.md` - fallow-py ADR 0007, 0009, 0010, 0012 ### Runtime evidence - `npm run build` - `npm test` - `git diff --check` ### Known constraints This is a governance-only PR. It records target decisions and repo rules; it does not fix parser bugs or change the JSON schema yet. ### Explicit out-of-scope - Parser fixes B1-B4 from #17. - Symlink/error handling hardening. - Deterministic root output. - Wave 1 issues #2-#6. ### Requested decision Approve and merge as the first pre-wave PR. ### Merge blockers Factual contradiction with the accepted roadmap, unclear governance obligations, or docs that claim source behavior this PR does not implement.

codex added 1 commit

2026-05-16 23:35:36 +02:00

Bootstrap fallow-ts governance

CI / test (push) Successful in 14s

Details

CI / test (pull_request) Successful in 13s

Details

6228f6ccf0

Port the essential fallow-py agent governance into fallow-ts and record the first ADRs for harness identity, classification direction, schema naming, and mandatory non-author review.

Refs #17.

Verified:

- npm run build

- npm test

- git diff --check

codex referenced this pull request

2026-05-16 23:38:29 +02:00

Fix parser import edge cases #19

codex referenced this pull request

2026-05-16 23:42:13 +02:00

Stabilize report identity and root output #21

codex referenced this pull request

2026-05-16 23:51:49 +02:00

Complete Wave 1 contract credibility #22

codex referenced this pull request

2026-05-17 01:15:03 +02:00

Integrate Wave 3 agent review layer #33