Skip to content

docs: explain how Spec Kit dogfoods itself - #4381

Merged
mnriem merged 3 commits into
github:mainfrom
mnriem:mnriem-docs/4353-document-dogfooding
Sep 1, 2026
Merged

docs: explain how Spec Kit dogfoods itself#4381
mnriem merged 3 commits into
github:mainfrom
mnriem:mnriem-docs/4353-document-dogfooding

Conversation

@mnriem

@mnriem mnriem commented Aug 31, 2026

Copy link
Copy Markdown
Collaborator

Summary

  • answer whether Spec Kit uses its own workflow
  • distinguish substantial-feature dogfooding from the normal path for small changes
  • explain why generated dogfooding artifacts usually do not appear in repository history
  • link the contributor workflow and automated feature-assessment workflow

Addresses #4353.

AI disclosure

This documentation update was authored autonomously by GitHub Copilot (GPT-5.6 Sol) on behalf of @mnriem.

Assisted-by: GitHub Copilot (model: GPT-5.6 Sol, autonomous)

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Copilot AI balanced review requested due to automatic review settings August 31, 2026 21:45

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Copilot review overview

🟢 Approval recommended

The documentation accurately reflects the linked workflows and repository configuration.

Review tier: Balanced
Findings: None

What changed in this PR

Documents how Spec Kit selectively dogfoods its workflows while addressing discussion #4353.

Changes:

  • Explains when dogfooding is appropriate.
  • Links contributor guidance and automated feature assessment.
  • Clarifies why generated artifacts are absent from history.
File Description
README.md Adds dogfooding guidance and navigation.

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

Assisted-by: GitHub Copilot (model: GPT-5.6 Sol, autonomous)

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>

Copilot-Session: c4d15814-30af-4ed9-a57e-24d81fbaca4d
Copilot AI review requested due to automatic review settings September 1, 2026 11:38

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Copilot review overview

🟡 Changes recommended

The documentation incorrectly implies all generated agent command files are gitignored.

Once you've addressed the issues Copilot identified, you can request another Copilot review.

Review tier: Balanced
Findings: 1 Low severity

New issues introduced by this change (1)
Severity Finding
Low severity README.md — The default Copilot integration writes generated skills to .github/skills/

Comment thread README.md Outdated
Assisted-by: GitHub Copilot (model: GPT-5.6 Sol, autonomous)

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Copilot AI review requested due to automatic review settings September 1, 2026 12:30
@mnriem

mnriem commented Sep 1, 2026

Copy link
Copy Markdown
Collaborator Author

Addressed the review feedback in 1945a777: the README now lists only the dogfooding paths that are actually gitignored and explains that the ephemeral assessment workflow neither commits nor pushes its generated Copilot skills.\n\nPosted on behalf of @mnriem by GitHub Copilot (model: GPT-5.6 Sol).

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Copilot review overview

🟢 Approval recommended

The documentation accurately reflects the contributor guidance, workflow setup, and ignored artifact paths.

Review tier: Balanced
Findings: None

Issues resolved since last review (1)
Severity Finding
Low severity README.md — The default Copilot integration writes generated skills to .github/skills/View resolved comment

@mnriem
mnriem merged commit f4d583a into github:main Sep 1, 2026
14 checks passed
@mnriem
mnriem deleted the mnriem-docs/4353-document-dogfooding branch September 1, 2026 13:22
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.

2 participants