Skip to content

docs: document Articles IV, V & VI as project-customizable in spec-driven.md#2467

Open
Copilot wants to merge 12 commits intomainfrom
copilot/docs-spec-driven-update-articles-iv-v-vi
Open

docs: document Articles IV, V & VI as project-customizable in spec-driven.md#2467
Copilot wants to merge 12 commits intomainfrom
copilot/docs-spec-driven-update-articles-iv-v-vi

Conversation

Copy link
Copy Markdown
Contributor

Copilot AI commented May 6, 2026

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

Copilot AI self-assigned this May 6, 2026
Copilot AI review requested due to automatic review settings May 6, 2026 13:51
Copilot AI review requested due to automatic review settings May 6, 2026 13:51
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 mnriem marked this pull request as ready for review May 6, 2026 16:38
@mnriem mnriem requested review from Copilot and removed request for Copilot May 6, 2026 16:38
@mnriem mnriem requested review from Copilot and removed request for Copilot May 6, 2026 19:05
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot's findings

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

Comment thread spec-driven.md Outdated
Comment thread spec-driven.md Outdated
Comment thread spec-driven.md Outdated
@mnriem
Copy link
Copy Markdown
Collaborator

mnriem commented May 6, 2026

@copilot apply changes based on the comments in this thread

Copy link
Copy Markdown
Contributor Author

Copilot AI commented May 6, 2026

@copilot apply changes based on the comments in this thread

Applied all three review comments in d4ec0b7:

  1. 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.
  2. 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.
  3. 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.

Copy link
Copy Markdown
Contributor Author

Copilot AI commented May 6, 2026

@copilot apply changes based on the comments in this thread

Applied both in 32a90dd:

  1. Removed the [PRINCIPLE_5_*] example hint entirely — the "(V. Observability, VI. Versioning & Breaking Changes, VII. Simplicity)" text was causing the inconsistency by implying Article VII belongs to the customizable slot. The bullet now simply describes the slot as grouping Articles V & VI concerns by default, without anchoring to a specific example that conflicts with the separately-documented Articles VII & VIII section.
  2. Updated the /speckit.analyze sentence to say "spec, plan, and task artifacts" to accurately reflect all three core artifacts the command covers.

Copilot finished work on behalf of mnriem May 6, 2026 21:35
@mnriem mnriem requested a review from Copilot May 6, 2026 21:36
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot's findings

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

Comment thread spec-driven.md Outdated
Comment thread spec-driven.md Outdated
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 mnriem requested a review from Copilot May 7, 2026 12:58
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot's findings

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

Comment thread spec-driven.md Outdated
Comment thread spec-driven.md Outdated
@mnriem
Copy link
Copy Markdown
Collaborator

mnriem commented May 7, 2026

@copilot apply changes based on the comments in this thread

Copy link
Copy Markdown
Contributor Author

Copilot AI commented May 7, 2026

@copilot apply changes based on the comments in this thread

Applied both in 5c64bbf:

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

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 mnriem requested a review from Copilot May 7, 2026 17:32
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot's findings

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

Comment thread spec-driven.md Outdated
Comment thread spec-driven.md Outdated
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
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot's findings

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

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
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
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot's findings

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

Comment thread spec-driven.md Outdated
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
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot's findings

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

Comment thread spec-driven.md
Comment on lines +321 to +331
#### Articles IV, V & VI: Project-Specific Standards

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

- **Article IV** typically addresses integration concerns—such as integration testing requirements, contract testing across service boundaries, or cross-component communication standards.

- **Article V** typically addresses operational concerns—such as observability, structured logging, or monitoring requirements.

- **Article VI** typically addresses lifecycle concerns—such as versioning schemes, breaking-change policies, or deprecation strategies.

Teams are free to name and scope these articles in whatever way best fits their project. They represent the primary customization points in the constitution where project-specific architectural principles are codified.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

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

3 participants