Skip to content

Commit 6cf5f36

Browse files
author
yann lei
committed
docs: clarify project-defined constitution articles
1 parent 13b8db2 commit 6cf5f36

1 file changed

Lines changed: 6 additions & 0 deletions

File tree

spec-driven.md

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -318,6 +318,12 @@ No implementation code shall be written before:
318318

319319
This completely inverts traditional AI code generation. Instead of generating code and hoping it works, the LLM must first generate comprehensive tests that define behavior, get them approved, and only then generate implementation.
320320

321+
#### Articles IV, V & VI: Project-Defined Governance
322+
323+
Articles IV, V, and VI are intentionally defined by each project's constitution rather than prescribed by Spec Kit. The constitution template provides placeholder slots and example concerns such as integration testing, observability, versioning, and breaking changes, but teams replace those placeholders with the principles that match their system and organization.
324+
325+
This keeps the nine-article structure stable while allowing each project to encode its own non-negotiable standards. For one project, Article IV might govern security and access boundaries; for another, it might define integration test requirements. The `/speckit.analyze` command evaluates the concrete constitution in the project, so these project-defined articles participate in compliance checks just like the built-in examples.
326+
321327
#### Articles VII & VIII: Simplicity and Anti-Abstraction
322328

323329
These paired articles combat over-engineering:

0 commit comments

Comments
 (0)