Skip to content

Commit db36c90

Browse files
committed
docs: simplify Articles IV, V & VI section to generic descriptions
Remove references to template placeholders, file paths, and commands. Describe each article's typical focus area in generic terms without referencing anything outside spec-driven.md itself.
1 parent 32a90dd commit db36c90

1 file changed

Lines changed: 7 additions & 5 deletions

File tree

spec-driven.md

Lines changed: 7 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -318,15 +318,17 @@ 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-Customizable Standards
321+
#### Articles IV, V & VI: Project-Specific Standards
322322

323-
Articles IV, V, and VI are the primary areas the constitution template reserves for project-specific standards. While the `/speckit.constitution` command lets teams define fewer or more principles than the template provides, these three articles represent the typical customization focus:
323+
Articles IV, V, and VI are reserved for project-specific standards that teams define to suit their domain and operational needs:
324324

325-
- **Article IV** addresses integration concerns—such as integration testing requirements, contract testing across service boundaries, or cross-component communication standards. The constitution template's `[PRINCIPLE_4_NAME]` / `[PRINCIPLE_4_DESCRIPTION]` slot is dedicated to this article, with an example hint of *Integration Testing*.
325+
- **Article IV** typically addresses integration concerns—such as integration testing requirements, contract testing across service boundaries, or cross-component communication standards.
326326

327-
- **Articles V & VI** address operational and lifecycle concerns—such as observability, structured logging, versioning schemes, or breaking-change policies. By default, the template groups these under a single `[PRINCIPLE_5_NAME]` / `[PRINCIPLE_5_DESCRIPTION]` slot. Teams can name and scope this slot however fits their project, or expand to separate articles using `/speckit.constitution`.
327+
- **Article V** typically addresses operational concerns—such as observability, structured logging, or monitoring requirements.
328328

329-
To define these articles for your project, run `/speckit.constitution`—it guides you through populating the principle sections in `.specify/memory/constitution.md`. The `/speckit.analyze` command validates all spec, plan, and task artifacts against every principle in your project constitution, so any rules you define here are automatically applied during analysis.
329+
- **Article VI** typically addresses lifecycle concerns—such as versioning schemes, breaking-change policies, or deprecation strategies.
330+
331+
Teams are free to name and scope these articles however best fits their project. They represent the primary customization points in the constitution where project-specific architectural principles are codified.
330332

331333
#### Articles VII & VIII: Simplicity and Anti-Abstraction
332334

0 commit comments

Comments
 (0)