name: oqc-mvp description: Implement the OQC Digital-Twin Control Co-design MVP in this repo. Use ONLY when working on deliverables defined in docs/PROJECT_SPEC.md (digital twin, control sweeps, HDL feedforward, drift automation). Do NOT use for unrelated refactors.
When to use
Use this skill when the task is explicitly part of docs/PROJECT_SPEC.md.
Operating rules (must follow)
- Always read docs/PROJECT_SPEC.md first and follow its DoD.
- Prefer small, verifiable commits.
- Do not add heavy dependencies unless required for a deliverable.
- After multi-file changes, run (or request permission if needed):
- make test (or pytest)
- make lint
- Every deliverable must have a reproducible command under scripts/ or Makefile.
- Never claim a feature is done without producing its artifact under assets/ or hdl/ and updating docs/EVIDENCE_PACK.md.
Standard workflow
- Explore: locate the best integration points in src/ (avoid duplication).
- Implement: add minimal code to satisfy a single deliverable.
- Verify: run required commands and confirm artifacts exist.
- Document: update docs/EVIDENCE_PACK.md with reproduction steps.
Required commands checklist
- Python: make test, make lint, python scripts/generate_control_sweeps.py
- HDL: make -C hdl sim