| name | build-plan |
| description | Internal Harness instruction source for build-plan. Route through visible Harness aliases or hook contracts instead of invoking directly. |
Build Plan
References
Read these first:
../../../.agents/references/workflow-guide.md../../../.agents/references/contract-gating-rule.md../../../.agents/references/code-style.md../../../.agents/references/ubiquitous-language.md../../../.agents/references/language-policy.md../../../.agents/references/documentation-evidence-rule.md../../../.agents/references/documentation-style.md../../../.agents/references/project-map-rule.md../../../.agents/references/research-supervision-patterns.md../../../.agents/references/research-supervision/experiment-and-build-canvas.md../../../.agents/references/research-supervision/ai-assisted-research-workflow.md../../../.agents/references/run-artifact-contract.md../../../.agents/references/sliced-commit-rule.md./references/implementation-roadmap.md./references/project-map-schema.json../../../PROJECT_STATE.json../../../docs/Technical_Spec.md if it exists../../../docs/Refined_Idea.md if it exists../../../docs/Dataset_Stats.md if it exists../../../docs/Baseline_Report.md if it exists../../../docs/10_contract/Evaluation_Contract.md if it exists../../../docs/10_contract/Baseline_Contract.md if it exists../../../docs/20_facts/Project_Glossary.md if it exists../../../docs/20_facts/Codebase_Map.md if it exists
When To Use
Use this skill for WF7 when the user wants the implementation roadmap and stable project blueprint.
This skill does not choose the architecture. WF6 $refine-arch owns architecture decisions; WF7 translates those decisions into implementation order, files, tests, and stable map entries.
Required Work
- Read the technical spec, refined idea, dataset stats, baseline report, and baseline/evaluation contracts or protocol.
- Convert the approved architecture into a stable file tree that separates research code from baselines.
- Write
project_map.json using the canonical schema and stable/volatile policy.
- Write or refresh
docs/20_facts/Codebase_Map.md as the human-readable
companion to project_map.json, covering stable directories, module
responsibilities, public interfaces, entry points, and maintenance owners.
- Write
docs/Implementation_Roadmap.md using the canonical template.
- Include:
- vertical slices ordered by dependency and user/research outcome
- smallest runnable slice path and first feedback command per slice
- an explicit
minimal_runnable_slice_set that distinguishes foundation
slices from the smallest runnable smoke/eval/training-ready path
- a
Slice Trace block for each slice
- module pseudocode
- shared interfaces and contracts between modules
- expected function/class signatures for stable files
- input/output shape and data-type constraints
- config schema
- file ownership and dependency order
- a test plan with Red/Green/Refactor or smoke feedback for each slice
- training pipeline with smoke test
- run artifact bundle layout and
run_manifest fields
- validation checkpoints
- complexity budget for public APIs, new terms, dependencies, and files per slice
- commit boundary and suggested semantic commit message for each completed slice
git_snapshot.py expectations
- Refine
docs/20_facts/Project_Glossary.md from the WF6 seed, stable file
tree, shared interfaces, config keys, metrics, errors, and tests. Do not
introduce vocabulary outside the approved architecture or roadmap scope;
record disputed terms as proposed terms.
- Update
PROJECT_STATE.json with roadmap, project-map, and codebase-map artifacts.
- Run
python tooling/evidence/check_workflow_state.py --workspace-root .
when PROJECT_STATE.json or project_map.json changed, and report the gate
ledger.
Output Rules
- Use
./references/implementation-roadmap.md.
- Use
./references/project-map-schema.json.
- Apply
../../../.agents/references/project-map-rule.md when deciding what belongs in project_map.json.
- Keep
docs/20_facts/Codebase_Map.md synchronized with project_map.json.
project_map.json remains the machine-readable stable implementation map;
Codebase_Map.md is the operator-facing current fact document.
- Include evidence sources for all source docs, discovered stable files, entry scripts, and interface assumptions.
- Include
application_codebase_language_updates so WF8/WF10 can read stable
Domain Term to Code Term decisions from docs/20_facts/Project_Glossary.md.
- Include commit slices that map one-to-one with roadmap slices unless a
documented cross-cutting reason makes a combined commit safer.
- Mark foundation-only slices clearly. A foundation slice can be accepted as a
Commit Slice, but it must not be described as enough for
build_ready_for_iterate unless it also provides the canonical runnable
smoke/eval/training entrypoint and run-artifact bundle required by WF9.
- Do not introduce new architecture choices here. WF7 may refine implementation details, module interfaces, configuration fields, validation checks, and coding constraints needed to execute the approved architecture efficiently. If the roadmap requires a different architecture, stop and route back to WF6 or a design review.
- After
docs/Implementation_Roadmap.md, docs/20_facts/Project_Glossary.md,
or docs/20_facts/Codebase_Map.md is finalized for the stage, invoke
$docs-site or report docs_site_boundary_report /
docs_site_render_or_NOT_RUN. Do not render after temporary draft edits.
- Treat template wording as structure-only; localize headings and narrative text according to
../../../.agents/references/language-policy.md unless a field is explicitly English-only.
Codex Adaptation
- Treat natural-language requests as the canonical
$build-plan flow.
- Preserve the separation between main research code and baselines.
- Preserve the staged training-pipeline design, including the smoke-test stage and
git_snapshot expectations.
Execution Rule
Use the local prompt, roadmap template, schema, project-map rule, and language policy as the source of truth for WF7.
Do not mark WF7 complete without reporting the project-map and workflow-state
gate results, or NOT_RUN if the checks could not execute.
