The method

How a regulated-grade app gets built by AI.

The same spec-driven discipline used in regulated engineering, adapted so that an AI author and a single human reviewer can ship a real application responsibly.

The lifecycle of one change
01
Propose
An OpenSpec change defines the requirements; their IDs are allocated in the registry.
02
Approve
The owner approves every proposal before implementation begins.
03
Implement
Claude builds against the spec on a branch; main stays green.
04
Prove
Every requirement gets automated tests tagged with its ID.
05
Gate
Full test suite, traceability and dependency checks, and a multi-angle review of the diff.
06
Release
A CHANGELOG entry, an annotated tag, and a GitHub Release — minted together.
01A requirement registry

Every behavior foragerr is meant to have is written down first, with a stable ID. IDs are allocated in the registry when a change is proposed, and a commit hook rejects any commit citing an ID that is not registered.

IDs allocated before code
Never reused or renumbered
Enforced by the commit hook
02End-to-end traceability

Each requirement links to the spec that defines it, the tagged tests that prove it, and the commits that built it. The matrix is regenerated from repository state — spec headings, test tags, commit trailers — and inconsistencies fail the run.

Requirement → spec → test → commit
Generated, not asserted
Gaps are visible, not hidden
03Per-change review gates

The owner approves every proposal before implementation begins, and no change merges until its gate passes: the full test suite green, traceability and dependency checks at zero, and a multi-angle review of the diff.

Owner approval before code
Full suite + consistency checks
Multi-angle diff review
04Release records

Every tagged release carries the same four artifacts: a CHANGELOG entry citing the requirements it moved, an annotated tag, the pushed history, and a GitHub Release. Tags are immutable — a mistake gets a new patch release, never a moved tag.

CHANGELOG + tag + GitHub Release
Requirement refs in every entry
Tags are immutable
How to weigh this

foragerr is young, its code is AI-authored, and no human has read every line. The registry, traceability matrix, review gates, and release records here show exactly how it was made — not a claim that it is flawless. Discipline is the point; perfection is not the claim.