Specs¶

Specs live in the project wiki, not in this repository.

A spec is a point-in-time decision record — written once, true of a moment, read later for its conclusions. Keeping them here buried the living documentation they sat beside, so they moved. Contributor guides, engineering standards and testing conventions stay in docs/, because those change with the code.

Referring to a spec¶

By number and name — "0002, the minisign artefact signing spec" — never by date. The number is a stable handle; a date is not something anyone remembers.

Writing a new one¶

Claim the next number first, then draft against the canonical shape. See the spec-driven-development skill in the phpboyscout marketplace.