Skip to content

docs(governance): 📝 add operational implementation plan with exit gates and stop conditions#49

Merged
justapithecus merged 4 commits intomainfrom
worktree-andrew/docs/governance/implementation-plan
Mar 18, 2026
Merged

docs(governance): 📝 add operational implementation plan with exit gates and stop conditions#49
justapithecus merged 4 commits intomainfrom
worktree-andrew/docs/governance/implementation-plan

Conversation

@justapithecus
Copy link
Member

Summary

Adds IMPLEMENTATION_PLAN.md as the operational companion to MILESTONE_PLAN.md. Where the milestone plan defines what to build per phase, this document defines how to verify it works, when to stop, and where to dogfood.

Highlights

  • Schema freeze ritual: canonical JSON fixtures for Finding and Report committed in Phase 0 as regression guardrails
  • Phase 1 narrowed to 3 adapters (gitleaks, golangci-lint, generic) to prove the contract before expanding
  • Phase 1.5 added: Semgrep adapter + Futureson side-effect mediation spike — earliest external dogfood
  • Exit gates per phase: measurable criteria (wall-clock regression <20%, prompt size <30% growth, backward compat tests)
  • Product-level stop condition: if tools don't improve signal density after Phase 3, stop expanding adapters
  • Evidence digest: formalized compressed finding format for prompt reinjection (not raw tool output)
  • Stage cap: default bundles ≤3 stages, enforced by tests
  • Output discipline: human-readable output grouped by source type, not fully intermixed
  • contract_refs timeline: functional from Phase 2, not deferred to Phase 5

Test plan

  • Review Phase 0 acceptance criteria against CONTRACT_FINDINGS
  • Review Phase 1 scope narrowing rationale
  • Review Phase 1.5 spike design and Futureson questions
  • Review performance gates and kill criteria
  • Review evidence digest requirements
  • Review dogfood schedule for feasibility
  • Verify MILESTONE_PLAN updates are consistent with IMPLEMENTATION_PLAN

🤖 Generated with Claude Code

justapithecus and others added 4 commits March 18, 2026 11:04
…es and stop conditions

IMPLEMENTATION_PLAN.md is the operational companion to MILESTONE_PLAN.
It encodes what the milestone plan does not:

- Concrete acceptance criteria per phase
- Schema freeze ritual (canonical JSON fixtures in Phase 0)
- Test strategies with specific test patterns
- Exit gates with measurable criteria
- Dogfood schedule (Bonsai self-dogfood + Futureson manual spike)
- Kill criteria for staged execution (>30% wall-clock regression)
- Product-level stop condition for adapter expansion
- Evidence digest requirement for prompt reinjection
- Stage cap enforcement (≤3 stages in default bundles)
- Output discipline (grouped by source type, not fully intermixed)
- contract_refs timeline (functional from Phase 2, not Phase 5)

Also updates MILESTONE_PLAN:
- Phase 1 narrowed to 3 adapters (gitleaks, golangci-lint, generic)
- Phase 1.5 added: Semgrep adapter + Futureson spike
- Version mapping updated

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
…y milestone labels

- Version mapping: labels are internal milestones, not release tags.
  Actual releases use strict vX.Y.Z per CONTRACT_RELEASE.
- Futureson dogfood: advisory (recommended signal), not mandatory
  (release-blocking gate). Bonsai's roadmap must be reproducible
  from this repo alone.
- Self-dogfood (Bonsai) remains mandatory at every phase.
- Phase 6 prereqs: Bonsai self-dogfood is sufficient; external repo
  dogfood is recommended but not required.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
…e residual external gate

- ADR_0006 + CONTRACT_TOOLS: Phase 1 is now 3 adapters (gitleaks,
  golangci-lint, generic). Semgrep and test-runner listed under
  Phase 1.5, matching MILESTONE_PLAN.
- Phase 2 dogfood: no longer claims mixed tool+skill output — that
  requires Phase 3 staged executor. Phase 2 only proves skill
  findings are in unified schema.
- Stop condition: "Bonsai and Futureson" → "Bonsai (and optionally
  external repos)". External dogfood is advisory throughout.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
…plementation plan

CONTRACT_POLICY_EXECUTION and ADR_0005 still said ≤4 stages while
IMPLEMENTATION_PLAN enforced ≤3 via tests. Unified to ≤3 everywhere.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@justapithecus justapithecus merged commit 360049b into main Mar 18, 2026
6 checks passed
@justapithecus justapithecus deleted the worktree-andrew/docs/governance/implementation-plan branch March 18, 2026 15:47
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant