mirror of
https://github.com/github/spec-kit.git
synced 2026-08-03 06:26:30 +08:00
396fc2c240
* docs: reframe SDD positioning, modernize install, and de-duplicate walkthroughs Reframe the landing page so Spec Kit reads as a toolkit for Spec-Driven Development *or your own process* with any AI coding agent, and correct stale claims: context files and git are now opt-in extensions, and the install path uses PyPI (specify-cli). Generalize the landing cards to cover bundles and catalog hosting across all primitives. Restructure the Quick Start into a lean, guided Taskify walkthrough with one command per step (install as a prerequisite, Steps 1-9 aligned with the Full path), and extract the deep per-command detail into two new reference pages: reference/agentic-sdd.md (the /speckit.* SDD process) and reference/agentic-bugfix.md (the bug extension). Retitle the reference overview to "Reference" and group these agentic processes in their own section, distinct from CLI-managed primitives. Remove the duplicated "Detailed Process" walkthrough from README.md (and its TOC entry), repointing readers to the docs-site Quick Start while keeping the concise "Get Started" section as the front door. Assisted-by: GitHub Copilot (model: Claude Opus 4.8, supervised) Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> Copilot-Session: 9d9232f8-ece4-4aa6-a9bd-ff8d74ca1c89 * docs: address review feedback on accuracy and scope - quickstart: correct the git/feature note — resolution reads .specify/feature.json / SPECIFY_FEATURE, not the checked-out branch, so switching branches alone does not switch the active feature. - quickstart + agentic-sdd: add an invocation-style note ($speckit-* for Codex/ZCode, /skill:speckit-* for Kimi) so the agent-neutral commands are executable everywhere. - agentic-sdd: fix the tasks phase structure to match the generator (Setup, Foundational, one phase per user story, final Polish; tests optional within user-story phases). - index: soften the catalog claim (catalogs curate discovery, not an install allow-list) and relabel the "CLI reference" link to "Reference" to match the retitled, broader page. Assisted-by: GitHub Copilot (model: Claude Opus 4.8, supervised) Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> Copilot-Session: 9d9232f8-ece4-4aa6-a9bd-ff8d74ca1c89 * docs: correct feature-resolution override and add bug-command invocation note - quickstart: the previous fix named the wrong override. The active feature *directory* resolves from SPECIFY_FEATURE_DIRECTORY then .specify/feature.json; SPECIFY_FEATURE only supplies the identifier after a directory is resolved. Rewrite the note to point users at .specify/feature.json / SPECIFY_FEATURE_DIRECTORY, and clarify the git extension's branches don't by themselves change the active feature. - agentic-bugfix: add the same invocation-style caveat as the SDD reference ($speckit-bug-* for Codex/ZCode, /skill:speckit-bug-* for Kimi). Assisted-by: GitHub Copilot (model: Claude Opus 4.8, supervised) Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> Copilot-Session: 9d9232f8-ece4-4aa6-a9bd-ff8d74ca1c89 * docs: tighten bug-command contracts and drop numbered-phase examples - agentic-bugfix: don't overstate overwrite protection — an interactive run can overwrite an existing assessment after confirmation; only automated mode refuses and picks a new slug. Correct the verify verdict to the schema's verified/partial/failed (not-run is a per-check status); an unexercised reproduction downgrades the result to partial. - agentic-sdd: the implement examples labeled scoping "Phase 1/2", but the tasks contract reserves Phase 1 for Setup and Phase 2 for Foundational (user stories start at Phase 3). Scope by phase name and user-story content instead to avoid mis-scoping execution. Assisted-by: GitHub Copilot (model: Claude Opus 4.8, supervised) Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> Copilot-Session: 9d9232f8-ece4-4aa6-a9bd-ff8d74ca1c89 --------- Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
85 lines
2.0 KiB
YAML
85 lines
2.0 KiB
YAML
# Home page
|
|
- name: Home
|
|
href: index.md
|
|
|
|
# Getting started section
|
|
- name: Getting Started
|
|
items:
|
|
- name: Installation
|
|
href: installation.md
|
|
- name: Quick Start
|
|
href: quickstart.md
|
|
- name: Upgrade
|
|
href: upgrade.md
|
|
- name: Install uv
|
|
href: install/uv.md
|
|
- name: Install from PyPI
|
|
href: install/pypi.md
|
|
- name: Install with pipx
|
|
href: install/pipx.md
|
|
- name: One-time Usage (uvx)
|
|
href: install/one-time.md
|
|
- name: Enterprise / Air-Gapped
|
|
href: install/air-gapped.md
|
|
|
|
# Reference
|
|
- name: Reference
|
|
items:
|
|
- name: Overview
|
|
href: reference/overview.md
|
|
- name: Core Commands
|
|
href: reference/core.md
|
|
- name: Integrations
|
|
href: reference/integrations.md
|
|
- name: Extensions
|
|
href: reference/extensions.md
|
|
- name: Presets
|
|
href: reference/presets.md
|
|
- name: Workflows
|
|
href: reference/workflows.md
|
|
- name: Bundles
|
|
href: reference/bundles.md
|
|
- name: Agentic SDD
|
|
href: reference/agentic-sdd.md
|
|
- name: Agentic Bug Fix
|
|
href: reference/agentic-bugfix.md
|
|
- name: Authentication
|
|
href: reference/authentication.md
|
|
|
|
# Concepts
|
|
- name: Concepts
|
|
items:
|
|
- name: What is SDD?
|
|
href: concepts/sdd.md
|
|
- name: Spec Persistence Models
|
|
href: concepts/spec-persistence.md
|
|
- name: Handling Complex Features
|
|
href: concepts/complex-features.md
|
|
|
|
# Development workflows
|
|
- name: Development
|
|
items:
|
|
- name: Local Development
|
|
href: local-development.md
|
|
- name: Evolving Specs
|
|
href: guides/evolving-specs.md
|
|
- name: Monorepos
|
|
href: guides/monorepo.md
|
|
|
|
# Community
|
|
- name: Community
|
|
href: community/overview.md
|
|
items:
|
|
- name: Overview
|
|
href: community/overview.md
|
|
- name: Extensions
|
|
href: community/extensions.md
|
|
- name: Presets
|
|
href: community/presets.md
|
|
- name: Bundles
|
|
href: community/bundles.md
|
|
- name: Walkthroughs
|
|
href: community/walkthroughs.md
|
|
- name: Friends
|
|
href: community/friends.md
|