Skip to content

Commit 7fe6448

Browse files
Copilotmnriem
andauthored
docs: document Articles IV, V, VI as project-customizable in spec-driven.md
Agent-Logs-Url: https://github.com/github/spec-kit/sessions/a5a938bd-4400-4deb-bdc8-0109b0bf4ccb Co-authored-by: mnriem <15701806+mnriem@users.noreply.github.com>
1 parent 8112291 commit 7fe6448

1 file changed

Lines changed: 12 additions & 0 deletions

File tree

spec-driven.md

Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -318,6 +318,18 @@ 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
322+
323+
Articles IV, V, and VI address concerns that vary significantly across projects. Unlike Articles I–III and VII–IX—which are fixed in the Spec Kit framework—these three articles are intentionally left for each project to define in its own constitution:
324+
325+
- **Article IV** addresses integration concerns—such as integration testing requirements, contract testing across service boundaries, or cross-component communication standards. The constitution template provides `[PRINCIPLE_4_NAME]` / `[PRINCIPLE_4_DESCRIPTION]` as the placeholder slot for this article, with an example hint of *Integration Testing*.
326+
327+
- **Article V** addresses operational concerns—such as observability, structured logging, or monitoring requirements. Its rules live in the `[PRINCIPLE_5_NAME]` / `[PRINCIPLE_5_DESCRIPTION]` placeholder, with an example hint of *Observability*.
328+
329+
- **Article VI** addresses lifecycle concerns—such as versioning schemes, breaking change policies, or deprecation standards. Like Article V, it is defined within the flexible principle slots in the constitution template, with an example hint of *Versioning & Breaking Changes*.
330+
331+
To define these articles, populate the corresponding principle sections in `.specify/memory/constitution.md` (generated from `templates/constitution-template.md`). The `/speckit.analyze` command dynamically validates compliance against whatever rules your project defines for Articles IV–VI, so teams can tailor these standards to their specific technical and organizational needs without modifying Spec Kit itself.
332+
321333
#### Articles VII & VIII: Simplicity and Anti-Abstraction
322334

323335
These paired articles combat over-engineering:

0 commit comments

Comments
 (0)