← All Semantic Contracts

Implement Next

The implementation loop for each issue

A semantic contract: vocabulary your project supplies itself — ready to drop into your CLAUDE.md / AGENTS.md.

    For each issue:

  • Create a feature branch for the EPIC
  • Select next issue from backlog (respect dependencies)
  • Analyze and document analysis as a comment on the issue
  • Implement using TDD (London or Chicago School as appropriate)
  • Each test references its Use Case ID for traceability
  • Beyond example-based tests, write invariant tests: name the property that connects a calculation's inputs to its output and test it over a range of values. Ask which of these tests would still fail if a change altered the units, the granularity, or the cardinality of an input
  • Commit with Conventional Commits, reference issue number
  • Verify the spec and architecture docs against the code: for each structural claim, confirm it still holds. Correct the document, never the code
  • When EPIC is complete, create a Pull Request

Related Anchors