docs: document Articles IV, V & VI as project-customizable in spec-driven.md by Copilot · Pull Request #2467 · github/spec-kit

Copilot · 2026-05-06T13:51:17Z

spec-driven.md claimed "nine articles" but only documented six — Articles IV, V, and VI were silently missing between Article III and Articles VII & VIII.

Changes

spec-driven.md — adds #### Articles IV, V & VI: Project-Specific Standards between Article III and Articles VII & VIII:
- Identifies each article's typical domain: IV → integration concerns, V → operational concerns, VI → lifecycle concerns
- Notes these are reserved for project-specific standards that teams define to suit their needs
- Describes the articles in generic terms without referencing template internals or other files

…ven.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>

Copilot

Copilot's findings

Files reviewed: 1/1 changed files
Comments generated: 3

mnriem · 2026-05-06T19:21:50Z

@copilot apply changes based on the comments in this thread

Agent-Logs-Url: https://github.com/github/spec-kit/sessions/2501d2e9-fbcf-4d44-afe1-1fa19f1a0a24 Co-authored-by: mnriem <15701806+mnriem@users.noreply.github.com>

Copilot · 2026-05-06T19:24:19Z

@copilot apply changes based on the comments in this thread

Applied all three review comments in d4ec0b7:

Removed the "fixed in the Spec Kit framework" framing — the section now describes IV–VI as the typical customization focus areas while noting that /speckit.constitution lets teams define fewer or more principles than the template.
Collapsed Article V and VI into a single bullet that correctly reflects the template grouping them under one [PRINCIPLE_5_NAME] / [PRINCIPLE_5_DESCRIPTION] slot by default, with a note that teams can expand to separate articles via /speckit.constitution.
Reworded the /speckit.analyze sentence to say it validates all spec/plan artifacts against every principle in the project constitution, rather than implying article-number-specific logic.

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.

Copilot

Copilot's findings

Files reviewed: 1/1 changed files
Comments generated: 2

mnriem · 2026-05-07T16:29:37Z

@copilot apply changes based on the comments in this thread

Agent-Logs-Url: https://github.com/github/spec-kit/sessions/1bb2bc87-968a-46f4-baac-054590a024db Co-authored-by: mnriem <15701806+mnriem@users.noreply.github.com>

Copilot · 2026-05-07T16:31:02Z

@copilot apply changes based on the comments in this thread

Applied both in 5c64bbf:

Broadened the intro phrase to "domain, operational, and lifecycle needs" so it covers all three article types (IV, V, and VI).
Fixed the grammar to "however fits their project best".

Copilot

Copilot's findings

Files reviewed: 1/1 changed files
Comments generated: 2

Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>

Copilot

Copilot's findings

Files reviewed: 1/1 changed files
Comments generated: 2


+#### Articles IV, V & VI: Project-Specific Standards
+
+Articles IV, V, and VI are reserved for project-specific standards that teams define to suit their domain, operational, and lifecycle needs:


Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>

Copilot

Copilot's findings

Files reviewed: 1/1 changed files
Comments generated: 1

Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>

Copilot

Copilot's findings

Files reviewed: 1/1 changed files
Comments generated: 1

Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>

Copilot

Copilot's findings

Files reviewed: 1/1 changed files
Comments generated: 3

+#### Project-Specific Standards: Common Constitution Areas
+



+#### Project-Specific Standards: Common Constitution Areas
+
+Project-specific standards are defined by each team in their constitution via `/speckit.constitution`. A project may define fewer or more principles than any default template, but in many constitutions these standards often cover areas such as integration, operations, and lifecycle expectations:


+
+- **Article VI** may address lifecycle concerns—such as versioning schemes, breaking-change policies, or deprecation strategies.
+
+These article numbers are illustrative rather than reserved slots. Teams are free to define, name, scope, add, remove, or reorder principles in whatever way best fits their project, with `/speckit.constitution` serving as the mechanism for codifying those project-specific architectural standards.


Initial plan

8112291

Copilot AI self-assigned this May 6, 2026

Copilot AI review requested due to automatic review settings May 6, 2026 13:51

Copilot AI assigned mnriem May 6, 2026

Copilot AI review requested due to automatic review settings May 6, 2026 13:51

Copilot started work on behalf of mnriem May 6, 2026 13:51 View session

Copilot AI linked an issue May 6, 2026 that may be closed by this pull request

docs: Document Articles IV, V, VI as project-customizable in spec-driven.md #2466

Open

docs: document Articles IV, V, VI as project-customizable in spec-dri…

7fe6448

…ven.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>

Copilot AI requested review from Copilot and removed request for Copilot May 6, 2026 13:54

Copilot AI changed the title ~~[WIP] Document Articles IV, V, VI as project-customizable in spec-driven.md~~ docs: document Articles IV, V & VI as project-customizable in spec-driven.md May 6, 2026

Copilot AI requested a review from mnriem May 6, 2026 13:55

Copilot finished work on behalf of mnriem May 6, 2026 13:55

mnriem marked this pull request as ready for review May 6, 2026 16:38

mnriem requested review from Copilot and removed request for Copilot May 6, 2026 16:38

Copilot started reviewing on behalf of mnriem May 6, 2026 16:39 View session

mnriem requested review from Copilot and removed request for Copilot May 6, 2026 19:05

Copilot started reviewing on behalf of mnriem May 6, 2026 19:06 View session

Copilot AI reviewed May 6, 2026

View reviewed changes

Comment thread spec-driven.md Outdated

Comment thread spec-driven.md Outdated

Comment thread spec-driven.md Outdated

Copilot started work on behalf of mnriem May 6, 2026 19:22 View session

docs: fix Articles IV–VI section based on review feedback

d4ec0b7

Agent-Logs-Url: https://github.com/github/spec-kit/sessions/2501d2e9-fbcf-4d44-afe1-1fa19f1a0a24 Co-authored-by: mnriem <15701806+mnriem@users.noreply.github.com>

Copilot finished work on behalf of mnriem May 6, 2026 19:25

mnriem requested a review from Copilot May 6, 2026 19:29

Copilot started reviewing on behalf of mnriem May 6, 2026 19:30 View session

docs: simplify Articles IV, V & VI section to generic descriptions

db36c90

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.

mnriem requested a review from Copilot May 7, 2026 12:58

mnriem approved these changes May 7, 2026

View reviewed changes

Copilot started reviewing on behalf of mnriem May 7, 2026 12:59 View session

Copilot AI reviewed May 7, 2026

View reviewed changes

Comment thread spec-driven.md Outdated

Comment thread spec-driven.md Outdated

Copilot started work on behalf of mnriem May 7, 2026 16:29 View session

docs: fix intro phrase scope and grammar in Articles IV-VI section

5c64bbf

Agent-Logs-Url: https://github.com/github/spec-kit/sessions/1bb2bc87-968a-46f4-baac-054590a024db Co-authored-by: mnriem <15701806+mnriem@users.noreply.github.com>

Copilot finished work on behalf of mnriem May 7, 2026 16:31

Copilot AI requested a review from mnriem May 7, 2026 16:31

mnriem requested a review from Copilot May 7, 2026 17:32

Copilot started reviewing on behalf of mnriem May 7, 2026 17:33 View session

Copilot AI reviewed May 7, 2026

View reviewed changes

Comment thread spec-driven.md Outdated

Comment thread spec-driven.md Outdated

Potential fix for pull request finding

bfedd3a

Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>

Copilot AI review requested due to automatic review settings May 7, 2026 17:36

Copilot started reviewing on behalf of mnriem May 7, 2026 17:36 View session

Copilot AI reviewed May 7, 2026

View reviewed changes

Comment thread spec-driven.md Outdated

#### Articles IV, V & VI: Project-Specific Standards

Articles IV, V, and VI are reserved for project-specific standards that teams define to suit their domain, operational, and lifecycle needs:

Comment thread spec-driven.md Outdated

Potential fix for pull request finding

9e60e01

Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>

Copilot AI review requested due to automatic review settings May 7, 2026 18:25

Copilot started reviewing on behalf of mnriem May 7, 2026 18:26 View session

Copilot AI reviewed May 7, 2026

View reviewed changes

Comment thread spec-driven.md Outdated

Potential fix for pull request finding

6195109

Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>

Copilot AI review requested due to automatic review settings May 7, 2026 18:40

Copilot started reviewing on behalf of mnriem May 7, 2026 18:40 View session

Copilot AI reviewed May 7, 2026

View reviewed changes

Comment thread spec-driven.md Outdated

Potential fix for pull request finding

550aaac

Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>

Copilot AI review requested due to automatic review settings May 8, 2026 19:07

Copilot started reviewing on behalf of mnriem May 8, 2026 19:08 View session

Copilot AI reviewed May 8, 2026

View reviewed changes


		#### Articles IV, V & VI: Project-Specific Standards

		Articles IV, V, and VI are reserved for project-specific standards that teams define to suit their domain, operational, and lifecycle needs:


		#### Project-Specific Standards: Common Constitution Areas

		Project-specific standards are defined by each team in their constitution via `/speckit.constitution`. A project may define fewer or more principles than any default template, but in many constitutions these standards often cover areas such as integration, operations, and lifecycle expectations:


		- Article VI may address lifecycle concerns—such as versioning schemes, breaking-change policies, or deprecation strategies.

		These article numbers are illustrative rather than reserved slots. Teams are free to define, name, scope, add, remove, or reorder principles in whatever way best fits their project, with `/speckit.constitution` serving as the mechanism for codifying those project-specific architectural standards.

Conversation

Copilot AI commented May 6, 2026 • edited by mnriem Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Changes

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Copilot's findings

Uh oh!

Uh oh!

Uh oh!

Uh oh!

mnriem commented May 6, 2026

Uh oh!

Copilot AI commented May 6, 2026

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Copilot's findings

Uh oh!

Uh oh!

Uh oh!

mnriem commented May 7, 2026

Uh oh!

Copilot AI commented May 7, 2026

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Copilot's findings

Uh oh!

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Copilot's findings

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Copilot's findings

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Copilot's findings

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Copilot's findings

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

Copilot AI commented May 6, 2026 •

edited by mnriem

Loading