π« Toolkit to help you get started with SDD or any other process!
Update files
den (work)36ff7e6505ae
diff --git a/.gitattributes b/.gitattributesindex 94f480de9..6313b56c5 100644--- a/.gitattributes+++ b/.gitattributes@@ -1 +1 @@-* text=auto eol=lf\ No newline at end of file+* text=auto eol=lfdiff --git a/.github/CODEOWNERS b/.github/CODEOWNERSindex 27fe556c5..efb95fc0e 100644--- a/.github/CODEOWNERS+++ b/.github/CODEOWNERS@@ -1,2 +1,3 @@# Global code owner* @localden+diff --git a/.github/workflows/docs.yml b/.github/workflows/docs.ymlindex 92e81a5e6..b2811b43b 100644--- a/.github/workflows/docs.yml+++ b/.github/workflows/docs.yml@@ -65,3 +65,4 @@ jobs:- name: Deploy to GitHub Pagesid: deploymentuses: actions/deploy-pages@v4+diff --git a/.github/workflows/release.yml b/.github/workflows/release.ymlindex 0bede837f..9ad208743 100644--- a/.github/workflows/release.yml+++ b/.github/workflows/release.yml@@ -57,3 +57,4 @@ jobs:run: |chmod +x .github/workflows/scripts/update-version.sh.github/workflows/scripts/update-version.sh ${{ steps.get_tag.outputs.new_version }}+diff --git a/.github/workflows/scripts/check-release-exists.sh b/.github/workflows/scripts/check-release-exists.shindex 161bf208c..88ef174f5 100644--- a/.github/workflows/scripts/check-release-exists.sh+++ b/.github/workflows/scripts/check-release-exists.sh@@ -18,4 +18,4 @@ if gh release view "$VERSION" >/dev/null 2>&1; thenelseecho "exists=false" >> $GITHUB_OUTPUTecho "Release $VERSION does not exist, proceeding..."-fi\ No newline at end of file+fidiff --git a/.github/workflows/scripts/create-github-release.sh b/.github/workflows/scripts/create-github-release.shindex f67ee3df2..1125f5102 100644--- a/.github/workflows/scripts/create-github-release.sh+++ b/.github/workflows/scripts/create-github-release.sh@@ -43,4 +43,4 @@ gh release create "$VERSION" \.genreleases/spec-kit-template-q-sh-"$VERSION".zip \.genreleases/spec-kit-template-q-ps-"$VERSION".zip \--title "Spec Kit Templates - $VERSION_NO_V" \- --notes-file release_notes.md\ No newline at end of file+ --notes-file release_notes.mddiff --git a/.github/workflows/scripts/create-release-packages.sh b/.github/workflows/scripts/create-release-packages.shindex 3e7211ecf..5462a14fd 100644--- a/.github/workflows/scripts/create-release-packages.sh+++ b/.github/workflows/scripts/create-release-packages.sh@@ -237,3 +237,4 @@ doneecho "Archives in $GENRELEASES_DIR:"ls -1 "$GENRELEASES_DIR"/spec-kit-template-*-"${NEW_VERSION}".zip+diff --git a/.github/workflows/scripts/generate-release-notes.sh b/.github/workflows/scripts/generate-release-notes.shindex a26d16b84..eba2340b5 100644--- a/.github/workflows/scripts/generate-release-notes.sh+++ b/.github/workflows/scripts/generate-release-notes.sh@@ -33,4 +33,4 @@ This is the latest set of releases that you can use with your agent of choice. WEOFecho "Generated release notes:"-cat release_notes.md\ No newline at end of file+cat release_notes.mddiff --git a/.github/workflows/scripts/get-next-version.sh b/.github/workflows/scripts/get-next-version.shindex 2be0b6cf8..9770b9fdc 100644--- a/.github/workflows/scripts/get-next-version.sh+++ b/.github/workflows/scripts/get-next-version.sh@@ -21,4 +21,4 @@ PATCH=$((PATCH + 1))NEW_VERSION="v$MAJOR.$MINOR.$PATCH"echo "new_version=$NEW_VERSION" >> $GITHUB_OUTPUT-echo "New version will be: $NEW_VERSION"\ No newline at end of file+echo "New version will be: $NEW_VERSION"diff --git a/.github/workflows/scripts/update-version.sh b/.github/workflows/scripts/update-version.shindex b0dc0e672..12bd9cd1d 100644--- a/.github/workflows/scripts/update-version.sh+++ b/.github/workflows/scripts/update-version.sh@@ -20,4 +20,4 @@ if [ -f "pyproject.toml" ]; thenecho "Updated pyproject.toml version to $PYTHON_VERSION (for release artifacts only)"elseecho "Warning: pyproject.toml not found, skipping version update"-fi\ No newline at end of file+fidiff --git a/.gitignore b/.gitignoreindex 42a1fbbfa..94bed859d 100644--- a/.gitignore+++ b/.gitignore@@ -42,4 +42,4 @@ env/# Spec Kit-specific files.genreleases/*.zip-sdd-*/\ No newline at end of file+sdd-*/diff --git a/AGENTS.md b/AGENTS.mdindex 3a29e253f..52d3d3a07 100644--- a/AGENTS.md+++ b/AGENTS.md@@ -326,3 +326,4 @@ When adding new agents:---*This documentation should be updated whenever new agents are added to maintain accuracy and completeness.*+diff --git a/CHANGELOG.md b/CHANGELOG.mdindex bb47e3656..3ca2ee00f 100644--- a/CHANGELOG.md+++ b/CHANGELOG.md@@ -166,3 +166,4 @@ N/A### ChangedN/A+diff --git a/CODE_OF_CONDUCT.md b/CODE_OF_CONDUCT.mdindex a1f82f0db..6dc4b1210 100644--- a/CODE_OF_CONDUCT.md+++ b/CODE_OF_CONDUCT.md@@ -71,4 +71,4 @@ This Code of Conduct is adapted from the [Contributor Covenant][homepage], versiavailable at [http://contributor-covenant.org/version/1/4][version][homepage]: http://contributor-covenant.org-[version]: http://contributor-covenant.org/version/1/4/\ No newline at end of file+[version]: http://contributor-covenant.org/version/1/4/diff --git a/CONTRIBUTING.md b/CONTRIBUTING.mdindex b5488c804..947480d03 100644--- a/CONTRIBUTING.md+++ b/CONTRIBUTING.md@@ -108,3 +108,4 @@ Please be respectful to maintainers and disclose AI assistance.- [How to Contribute to Open Source](https://opensource.guide/how-to-contribute/)- [Using Pull Requests](https://help.github.com/articles/about-pull-requests/)- [GitHub Help](https://help.github.com)+diff --git a/LICENSE b/LICENSEindex 28a50fa22..a0eb787a8 100644--- a/LICENSE+++ b/LICENSE@@ -19,3 +19,4 @@ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHERLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THESOFTWARE.+diff --git a/README.md b/README.mdindex 60e9e6ca3..8f54afa90 100644--- a/README.md+++ b/README.md@@ -623,3 +623,4 @@ This project is heavily influenced by and based on the work and research of [Joh## π LicenseThis project is licensed under the terms of the MIT open source license. Please refer to the [LICENSE](./LICENSE) file for the full terms.+diff --git a/SECURITY.md b/SECURITY.mdindex 4279c87fb..67a9cbf2c 100644--- a/SECURITY.md+++ b/SECURITY.md@@ -28,4 +28,4 @@ This information will help us triage your report more quickly.## Policy-See [GitHub's Safe Harbor Policy](https://docs.github.com/en/site-policy/security-policies/github-bug-bounty-program-legal-safe-harbor#1-safe-harbor-terms)\ No newline at end of file+See [GitHub's Safe Harbor Policy](https://docs.github.com/en/site-policy/security-policies/github-bug-bounty-program-legal-safe-harbor#1-safe-harbor-terms)diff --git a/SUPPORT.md b/SUPPORT.mdindex 791d0104b..c75ce9bd0 100644--- a/SUPPORT.md+++ b/SUPPORT.md@@ -17,3 +17,4 @@ For help or questions about using this project, please:## GitHub Support PolicySupport for this project is limited to the resources listed above.+diff --git a/docs/.gitignore b/docs/.gitignoreindex 614670d9f..68fec76e3 100644--- a/docs/.gitignore+++ b/docs/.gitignore@@ -6,3 +6,4 @@ obj/# Temporary files*.tmp*.log+diff --git a/docs/README.md b/docs/README.mdindex 5501adf0c..7a155cfa6 100644--- a/docs/README.md+++ b/docs/README.md@@ -31,3 +31,4 @@ To build the documentation locally:## DeploymentDocumentation is automatically built and deployed to GitHub Pages when changes are pushed to the `main` branch. The workflow is defined in `.github/workflows/docs.yml`.+diff --git a/docs/docfx.json b/docs/docfx.jsonindex c59dedbe2..dca3f0f57 100644--- a/docs/docfx.json+++ b/docs/docfx.json@@ -68,3 +68,4 @@}}}+diff --git a/docs/index.md b/docs/index.mdindex 9a10e7ca2..e134404e2 100644--- a/docs/index.md+++ b/docs/index.md@@ -60,3 +60,4 @@ Please see our [Contributing Guide](https://github.com/github/spec-kit/blob/main## SupportFor support, please check our [Support Guide](https://github.com/github/spec-kit/blob/main/SUPPORT.md) or open an issue on GitHub.+diff --git a/docs/installation.md b/docs/installation.mdindex ec3c28967..e7a337008 100644--- a/docs/installation.md+++ b/docs/installation.md@@ -86,3 +86,4 @@ git config --global credential.helper managerecho "Cleaning up..."rm gcm-linux_amd64.2.6.1.deb```+diff --git a/docs/local-development.md b/docs/local-development.mdindex 58f174bef..bed67b3d0 100644--- a/docs/local-development.md+++ b/docs/local-development.md@@ -166,3 +166,4 @@ rm -rf .venv dist build *.egg-info- Open a PR when satisfied- (Optional) Tag a release once changes land in `main`+diff --git a/docs/quickstart.md b/docs/quickstart.mdindex 06d6e04c1..0ad5f6e3c 100644--- a/docs/quickstart.md+++ b/docs/quickstart.md@@ -120,3 +120,4 @@ implement specs/002-create-taskify/plan.md- Read the complete methodology for in-depth guidance- Check out more examples in the repository- Explore the source code on GitHub+diff --git a/docs/toc.yml b/docs/toc.ymlindex ecabd1850..082bb8c86 100644--- a/docs/toc.yml+++ b/docs/toc.yml@@ -15,3 +15,4 @@items:- name: Local Developmenthref: local-development.md+diff --git a/media/bootstrap-claude-code.gif b/media/bootstrap-claude-code.gifindex ba3a7e98a..bf8451753 100644Binary files a/media/bootstrap-claude-code.gif and b/media/bootstrap-claude-code.gif differdiff --git a/media/logo_large.webp b/media/logo_large.webpindex 209e3deef..ce095f721 100644Binary files a/media/logo_large.webp and b/media/logo_large.webp differdiff --git a/media/logo_small.webp b/media/logo_small.webpindex 95b5efc30..e256f4ede 100644Binary files a/media/logo_small.webp and b/media/logo_small.webp differdiff --git a/media/spec-kit-video-header.jpg b/media/spec-kit-video-header.jpgindex 783eee9cd..9a7fa84f6 100644Binary files a/media/spec-kit-video-header.jpg and b/media/spec-kit-video-header.jpg differdiff --git a/media/specify_cli.gif b/media/specify_cli.gifindex 70aae2d64..555baa9bc 100644Binary files a/media/specify_cli.gif and b/media/specify_cli.gif differdiff --git a/memory/constitution.md b/memory/constitution.mdindex 1ed8d77a3..a4670ff46 100644--- a/memory/constitution.md+++ b/memory/constitution.md@@ -47,4 +47,4 @@<!-- Example: All PRs/reviews must verify compliance; Complexity must be justified; Use [GUIDANCE_FILE] for runtime development guidance -->**Version**: [CONSTITUTION_VERSION] | **Ratified**: [RATIFICATION_DATE] | **Last Amended**: [LAST_AMENDED_DATE]-<!-- Example: Version: 2.1.1 | Ratified: 2025-06-13 | Last Amended: 2025-07-16 -->\ No newline at end of file+<!-- Example: Version: 2.1.1 | Ratified: 2025-06-13 | Last Amended: 2025-07-16 -->diff --git a/pyproject.toml b/pyproject.tomlindex 7626dc87e..567d48cd4 100644--- a/pyproject.toml+++ b/pyproject.toml@@ -21,3 +21,4 @@ build-backend = "hatchling.build"[tool.hatch.build.targets.wheel]packages = ["src/specify_cli"]+diff --git a/scripts/bash/check-prerequisites.sh b/scripts/bash/check-prerequisites.shindex 354f3f11c..54f32ec36 100644--- a/scripts/bash/check-prerequisites.sh+++ b/scripts/bash/check-prerequisites.sh@@ -163,4 +163,4 @@ elseif $INCLUDE_TASKS; thencheck_file "$TASKS" "tasks.md"fi-fi\ No newline at end of file+fidiff --git a/scripts/bash/common.sh b/scripts/bash/common.shindex 34e5d4bb7..eeac07d4d 100644--- a/scripts/bash/common.sh+++ b/scripts/bash/common.sh@@ -111,3 +111,4 @@ EOFcheck_file() { [[ -f "$1" ]] && echo " β $2" || echo " β $2"; }check_dir() { [[ -d "$1" && -n $(ls -A "$1" 2>/dev/null) ]] && echo " β $2" || echo " β $2"; }+diff --git a/scripts/bash/create-new-feature.sh b/scripts/bash/create-new-feature.shindex 574e9152d..da7e67917 100644--- a/scripts/bash/create-new-feature.sh+++ b/scripts/bash/create-new-feature.sh@@ -194,3 +194,4 @@ elseecho "FEATURE_NUM: $FEATURE_NUM"echo "SPECIFY_FEATURE environment variable set to: $BRANCH_NAME"fi+diff --git a/scripts/bash/setup-plan.sh b/scripts/bash/setup-plan.shindex 654ba50d7..740a1438c 100644--- a/scripts/bash/setup-plan.sh+++ b/scripts/bash/setup-plan.sh@@ -58,3 +58,4 @@ elseecho "BRANCH: $CURRENT_BRANCH"echo "HAS_GIT: $HAS_GIT"fi+diff --git a/scripts/bash/update-agent-context.sh b/scripts/bash/update-agent-context.shindex 18e36a133..36ba5ad22 100644--- a/scripts/bash/update-agent-context.sh+++ b/scripts/bash/update-agent-context.sh@@ -736,3 +736,4 @@ main() {if [[ "${BASH_SOURCE[0]}" == "${0}" ]]; thenmain "$@"fi+diff --git a/scripts/powershell/check-prerequisites.ps1 b/scripts/powershell/check-prerequisites.ps1index d8ccd1d55..91667e9ef 100644--- a/scripts/powershell/check-prerequisites.ps1+++ b/scripts/powershell/check-prerequisites.ps1@@ -145,4 +145,4 @@ if ($Json) {if ($IncludeTasks) {Test-FileExists -Path $paths.TASKS -Description 'tasks.md' | Out-Null}-}\ No newline at end of file+}diff --git a/scripts/powershell/common.ps1 b/scripts/powershell/common.ps1index c8e34b26b..b0be27354 100644--- a/scripts/powershell/common.ps1+++ b/scripts/powershell/common.ps1@@ -134,3 +134,4 @@ function Test-DirHasFiles {return $false}}+diff --git a/scripts/powershell/create-new-feature.ps1 b/scripts/powershell/create-new-feature.ps1index 3f77c9c4c..83e286aca 100644--- a/scripts/powershell/create-new-feature.ps1+++ b/scripts/powershell/create-new-feature.ps1@@ -207,3 +207,4 @@ if ($Json) {Write-Output "HAS_GIT: $hasGit"Write-Output "SPECIFY_FEATURE environment variable set to: $branchName"}+diff --git a/scripts/powershell/setup-plan.ps1 b/scripts/powershell/setup-plan.ps1index d0ed582fa..db6e9f2d7 100644--- a/scripts/powershell/setup-plan.ps1+++ b/scripts/powershell/setup-plan.ps1@@ -59,3 +59,4 @@ if ($Json) {Write-Output "BRANCH: $($paths.CURRENT_BRANCH)"Write-Output "HAS_GIT: $($paths.HAS_GIT)"}+diff --git a/scripts/powershell/update-agent-context.ps1 b/scripts/powershell/update-agent-context.ps1index bd57db87d..aff39b454 100644--- a/scripts/powershell/update-agent-context.ps1+++ b/scripts/powershell/update-agent-context.ps1@@ -434,3 +434,4 @@ function Main {}Main+diff --git a/spec-driven.md b/spec-driven.mdindex 0e546ff3c..13edc9e3f 100644--- a/spec-driven.md+++ b/spec-driven.md@@ -401,3 +401,4 @@ By embedding these principles into the specification and planning process, SDD eThis isn't about replacing developers or automating creativity. It's about amplifying human capability by automating mechanical translation. It's about creating a tight feedback loop where specifications, research, and code evolve together, each iteration bringing deeper understanding and better alignment between intent and implementation.Software development needs better tools for maintaining alignment between intent and implementation. SDD provides the methodology for achieving this alignment through executable specifications that generate code rather than merely guiding it.+diff --git a/src/specify_cli/__init__.py b/src/specify_cli/__init__.pyindex 57af082ce..65a9f8d4e 100644--- a/src/specify_cli/__init__.py+++ b/src/specify_cli/__init__.py@@ -1123,3 +1123,4 @@ def main():if __name__ == "__main__":main()+diff --git a/templates/agent-file-template.md b/templates/agent-file-template.mdindex 2301e0eaa..f73499792 100644--- a/templates/agent-file-template.md+++ b/templates/agent-file-template.md@@ -20,4 +20,4 @@ Auto-generated from all feature plans. Last updated: [DATE][LAST 3 FEATURES AND WHAT THEY ADDED]<!-- MANUAL ADDITIONS START -->-<!-- MANUAL ADDITIONS END -->\ No newline at end of file+<!-- MANUAL ADDITIONS END -->diff --git a/templates/checklist-template.md b/templates/checklist-template.mdindex 806657da0..1c8b11a18 100644--- a/templates/checklist-template.md+++ b/templates/checklist-template.md@@ -38,3 +38,4 @@- Add comments or findings inline- Link to relevant resources or documentation- Items are numbered sequentially for easy reference+diff --git a/templates/commands/analyze.md b/templates/commands/analyze.mdindex 473339fc2..82957e5ea 100644--- a/templates/commands/analyze.md+++ b/templates/commands/analyze.md@@ -185,3 +185,4 @@ Ask the user: "Would you like me to suggest concrete remediation edits for the t## Context{ARGS}+diff --git a/templates/commands/checklist.md b/templates/commands/checklist.mdindex 036988d0a..0900e33a4 100644--- a/templates/commands/checklist.md+++ b/templates/commands/checklist.md@@ -288,3 +288,4 @@ Sample items:- Correct: Validation of requirement quality- Wrong: "Does it do X?"- Correct: "Is X clearly specified?"+diff --git a/templates/commands/clarify.md b/templates/commands/clarify.mdindex 4eb8e7cd8..65f2536f7 100644--- a/templates/commands/clarify.md+++ b/templates/commands/clarify.md@@ -177,3 +177,4 @@ Behavior rules:- If quota reached with unresolved high-impact categories remaining, explicitly flag them under Deferred with rationale.Context for prioritization: {ARGS}+diff --git a/templates/commands/constitution.md b/templates/commands/constitution.mdindex f6f8b2431..dc0793455 100644--- a/templates/commands/constitution.md+++ b/templates/commands/constitution.md@@ -75,3 +75,4 @@ If the user supplies partial updates (e.g., only one principle revision), stillIf critical info missing (e.g., ratification date truly unknown), insert `TODO(<FIELD_NAME>): explanation` and include in the Sync Impact Report under deferred items.Do not create a new template; always operate on the existing `/memory/constitution.md` file.+diff --git a/templates/commands/implement.md b/templates/commands/implement.mdindex 605559753..6775b8af8 100644--- a/templates/commands/implement.md+++ b/templates/commands/implement.md@@ -123,3 +123,4 @@ You **MUST** consider the user input before proceeding (if not empty).- Report final status with summary of completed workNote: This command assumes a complete task breakdown exists in tasks.md. If tasks are incomplete or missing, suggest running `/tasks` first to regenerate the task list.+diff --git a/templates/commands/plan.md b/templates/commands/plan.mdindex 42bb6023b..2891e221b 100644--- a/templates/commands/plan.md+++ b/templates/commands/plan.md@@ -84,3 +84,4 @@ You **MUST** consider the user input before proceeding (if not empty).- Use absolute paths- ERROR on gate failures or unresolved clarifications+diff --git a/templates/commands/specify.md b/templates/commands/specify.mdindex 3217e87b9..a75ad280d 100644--- a/templates/commands/specify.md+++ b/templates/commands/specify.md@@ -230,3 +230,4 @@ Success criteria must be:- "Database can handle 1000 TPS" (implementation detail, use user-facing metric)- "React components render efficiently" (framework-specific)- "Redis cache hit rate above 80%" (technology-specific)+diff --git a/templates/commands/tasks.md b/templates/commands/tasks.mdindex 05b2effe6..964640096 100644--- a/templates/commands/tasks.md+++ b/templates/commands/tasks.md@@ -130,3 +130,4 @@ Every task MUST strictly follow this format:- Each phase should be a complete, independently testable increment- **Final Phase**: Polish & Cross-Cutting Concerns+diff --git a/templates/plan-template.md b/templates/plan-template.mdindex 70fa8f972..43460c320 100644--- a/templates/plan-template.md+++ b/templates/plan-template.md@@ -102,3 +102,4 @@ directories captured above]|-----------|------------|-------------------------------------|| [e.g., 4th project] | [current need] | [why 3 projects insufficient] || [e.g., Repository pattern] | [specific problem] | [why direct DB access insufficient] |+diff --git a/templates/spec-template.md b/templates/spec-template.mdindex c67d91498..9a83ac680 100644--- a/templates/spec-template.md+++ b/templates/spec-template.md@@ -113,3 +113,4 @@- **SC-002**: [Measurable metric, e.g., "System handles 1000 concurrent users without degradation"]- **SC-003**: [User satisfaction metric, e.g., "90% of users successfully complete primary task on first attempt"]- **SC-004**: [Business metric, e.g., "Reduce support tickets related to [X] by 50%"]+diff --git a/templates/tasks-template.md b/templates/tasks-template.mdindex 66fdd810c..eea131fd0 100644--- a/templates/tasks-template.md+++ b/templates/tasks-template.md@@ -248,3 +248,4 @@ With multiple developers:- Avoid: vague tasks, same file conflicts, cross-story dependencies that break independence+diff --git a/templates/vscode-settings.json b/templates/vscode-settings.jsonindex 388adcec7..d454aa6df 100644--- a/templates/vscode-settings.json+++ b/templates/vscode-settings.json@@ -11,3 +11,4 @@".specify/scripts/powershell/": true}}+