Repository navigation
docs(plan): requirements slice 1 — requirement checks and test generators in every port - #406
Merged
Merged
Conversation
…-test generators in every port Implementation plan only, no code. Covers the two shared corpora (requirement-check and requirement-test identity) run by the TypeScript reference, the requirement gate in each port's verify, a requirement-tests generator per port (pytest, JUnit, xUnit) with project-owned witness functions, the three seams (per-member grain, a renderer hook that receives the requirement digest, a require-implementers switch), and the ADR and docs change that reverses the TypeScript-only decision.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What this is
An implementation plan, and nothing else. One new file:
docs/superpowers/plans/2026-10-05-requirements-slice-1-checks-and-test-generators.md. No code, no fixtures, no doc edits.What the plan covers
Slice 1 of the requirements work: every port runs the requirement gate and scaffolds tests from requirements.
requirement-check-conformance(metadata in, diagnostics and summary counts out, 42 cases) andrequirement-test-identity-conformance(metadata in, test identities, skip states and digests out, 16 cases).verify: Python, Java (Kotlin inherits the Maven goal) and C#. The gate-code table is taken fromrequirement-check.ts, with each code's condition, order, message text and path format.requirement-testsgenerator per port: pytest, JUnit for Java and Kotlin, xUnit for C#. The generated file is fully machine-owned and each test calls a project-owned witness function. No three-way merge is ported.--require-implementersswitch that makes "nothing implements" an error.requirement.*node, a list of unverified items, and nine open questions with the plan's assumed default for each.Order
Corpora and the TypeScript seams first, then Python and Java in parallel, then C# and Kotlin.
Not in this slice
Publishing requirements across repositories, inherited requirements, the Python publisher and
depscommands, transitive dependencies, and the response-model items.How it was checked
Every cited path, function and test file was read or located at
5153aa9dc, or is marked UNVERIFIED and listed. The two worked digests were computed; the first was confirmed a second way withsha256sum. No test suite was run, because the change is one Markdown file.Decisions for the reviewer
The plan's "Open questions" section holds them. The three that change the most work: