Skip to content

docs(plans): factory milestone 0 and 1 plans for reqdrive - #4

Merged
adbarc92 merged 4 commits into
mainfrom
docs/factory-plans
Oct 8, 2026
Merged

adbarc92 merged 4 commits into
mainfrom
docs/factory-plans

Conversation

@adbarc92

@adbarc92 adbarc92 commented Oct 5, 2026

Copy link
Copy Markdown
Owner

What this adds

Two implementation plans for the factory program, under docs/superpowers/plans/. Documentation only: no code, CI or configuration changes.

Plan File Lines
Milestone 0: foundations 2026-10-04-factory-m0-foundations.md 9,669
Milestone 1: the harness 2026-10-04-factory-m1-harness.md 19,696

The milestone 0 plan archives the Bash implementation, creates the Rust workspace with its test runner, CI and parity check, and ends with a skeleton reqdrive harness that speaks protocol 0.2 on fakes. The milestone 1 plan gives every interface, fake and test for the harness crates in full and leaves the implementations to the lanes, one crate each.

How it was checked

  • Each plan's author built the plan's code in a scratch copy and ran it before writing it down.
  • The milestone 0 plan was compiled against the contract crates as the command-center plans build them. That found three defects, fixed in the third commit.
  • The plans were scanned for secrets and personal identifiers before this push; none found.

Not checked:

  • Nothing has run on GitHub Actions or on Linux. The new CI jobs are untested.
  • Nothing has run against real Docker or the real Claude Code CLI.
  • The conformance kit has never run against the skeleton harness. Each was written against the other's plan. That run is the last task of milestone 0 and is its proof.

For the reviewer

  • The milestone 0 plan depends on the tag contracts-v0.2.0 in command-center, which does not exist yet.
  • The plan contains the full text of a new public page, docs/forms.md, describing the Form and gate-registry formats. The owner approved documenting those formats here on 2026-10-05 (action A5 in the plan).
  • Merging this starts nothing. Each wave waits for the owner's go-ahead.

No issue is closed by this pull request.

Archives the Bash implementation, creates the Rust workspace with its
tiered test runner, CI and registry parity check, and builds a walking
skeleton that passes the conformance kit on protocol 0.2 using fakes.
Wave 0 gives every crate's interface, in-memory fake and contract suite
in full; each lane then gets its tests in full and writes its own
implementation.
…as built

Handles the protocol reader's two new error cases, sends evidence with
a no-change result, and sorts test targets into tiers by the shared
file-name rule. Recompiled against the real contract crates.
@adbarc92
adbarc92 merged commit 328a893 into main Oct 8, 2026
6 checks passed
@adbarc92
adbarc92 deleted the docs/factory-plans branch October 8, 2026 16:59
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