Spec-first workflow

Informative guide. This Book page explains Beskid but does not define the standard. For normative requirements, use the Beskid Platform Specification.

Spec leads code: extend or update normative platform-spec text before (or in the same change set as) implementation that changes observable language or platform behavior.

Practical rules

• Do not mark scaffold-only hubs as Standard to win an argument.
• Prefer updating existing feature hubs over spawning duplicate stubs.
• Run openspec validate --all --strict after platform-spec edits, then build the affected implementation and Book site.

Read first

• Specification authority and decisions
• Release and versioning policy
• Chapters 12 and 13