Claude/confirm doc context loading r0 pa5

.github/workflows/scripts/create-github-release.sh

@@ -40,15 +40,11 @@ gh release create "$VERSION" \
   .genreleases/spec-kit-template-roo-ps-"$VERSION".zip \
   .genreleases/spec-kit-template-codebuddy-sh-"$VERSION".zip \
   .genreleases/spec-kit-template-codebuddy-ps-"$VERSION".zip \
-  .genreleases/spec-kit-template-qoder-sh-"$VERSION".zip \
-  .genreleases/spec-kit-template-qoder-ps-"$VERSION".zip \
   .genreleases/spec-kit-template-amp-sh-"$VERSION".zip \
   .genreleases/spec-kit-template-amp-ps-"$VERSION".zip \
   .genreleases/spec-kit-template-shai-sh-"$VERSION".zip \
   .genreleases/spec-kit-template-shai-ps-"$VERSION".zip \
   .genreleases/spec-kit-template-q-sh-"$VERSION".zip \
   .genreleases/spec-kit-template-q-ps-"$VERSION".zip \
-  .genreleases/spec-kit-template-bob-sh-"$VERSION".zip \
-  .genreleases/spec-kit-template-bob-ps-"$VERSION".zip \
   --title "Spec Kit Templates - $VERSION_NO_V" \
   --notes-file release_notes.md

.github/workflows/scripts/create-release-packages.ps1

@@ -14,7 +14,7 @@
 
 .PARAMETER Agents
     Comma or space separated subset of agents to build (default: all)
-    Valid agents: claude, gemini, copilot, cursor-agent, qwen, opencode, windsurf, codex, kilocode, auggie, roo, codebuddy, amp, q, bob, qoder
+    Valid agents: claude, gemini, copilot, cursor-agent, qwen, opencode, windsurf, codex, kilocode, auggie, roo, codebuddy, amp, q
 
 .PARAMETER Scripts
     Comma or space separated subset of script types to build (default: both)
@@ -339,14 +339,6 @@ function Build-Variant {
             $cmdDir = Join-Path $baseDir ".amazonq/prompts"
             Generate-Commands -Agent 'q' -Extension 'md' -ArgFormat '$ARGUMENTS' -OutputDir $cmdDir -ScriptVariant $Script
         }
-        'bob' {
-            $cmdDir = Join-Path $baseDir ".bob/commands"
-            Generate-Commands -Agent 'bob' -Extension 'md' -ArgFormat '$ARGUMENTS' -OutputDir $cmdDir -ScriptVariant $Script
-        }
-        'qoder' {
-            $cmdDir = Join-Path $baseDir ".qoder/commands"
-            Generate-Commands -Agent 'qoder' -Extension 'md' -ArgFormat '$ARGUMENTS' -OutputDir $cmdDir -ScriptVariant $Script
-        }
     }
 
     # Create zip archive
@@ -356,7 +348,7 @@ function Build-Variant {
 }
 
 # Define all agents and scripts
-$AllAgents = @('claude', 'gemini', 'copilot', 'cursor-agent', 'qwen', 'opencode', 'windsurf', 'codex', 'kilocode', 'auggie', 'roo', 'codebuddy', 'amp', 'q', 'bob', 'qoder')
+$AllAgents = @('claude', 'gemini', 'copilot', 'cursor-agent', 'qwen', 'opencode', 'windsurf', 'codex', 'kilocode', 'auggie', 'roo', 'codebuddy', 'amp', 'q')
 $AllScripts = @('sh', 'ps')
 
 function Normalize-List {
@@ -421,4 +413,4 @@ foreach ($agent in $AgentList) {
 Write-Host "`nArchives in ${GenReleasesDir}:"
 Get-ChildItem -Path $GenReleasesDir -Filter "spec-kit-template-*-${Version}.zip" | ForEach-Object {
     Write-Host "  $($_.Name)"
-}
+}

.github/workflows/scripts/create-release-packages.sh

@@ -6,7 +6,7 @@ set -euo pipefail
 # Usage: .github/workflows/scripts/create-release-packages.sh <version>
 #   Version argument should include leading 'v'.
 #   Optionally set AGENTS and/or SCRIPTS env vars to limit what gets built.
-#     AGENTS  : space or comma separated subset of: claude gemini copilot cursor-agent qwen opencode windsurf codex amp shai bob (default: all)
+#     AGENTS  : space or comma separated subset of: claude gemini copilot cursor-agent qwen opencode windsurf codex amp shai (default: all)
 #     SCRIPTS : space or comma separated subset of: sh ps (default: both)
 #   Examples:
 #     AGENTS=claude SCRIPTS=sh $0 v0.2.0
@@ -202,9 +202,6 @@ build_variant() {
     codebuddy)
       mkdir -p "$base_dir/.codebuddy/commands"
       generate_commands codebuddy md "\$ARGUMENTS" "$base_dir/.codebuddy/commands" "$script" ;;
-    qoder)
-      mkdir -p "$base_dir/.qoder/commands"
-      generate_commands qoder md "\$ARGUMENTS" "$base_dir/.qoder/commands" "$script" ;;
     amp)
       mkdir -p "$base_dir/.agents/commands"
       generate_commands amp md "\$ARGUMENTS" "$base_dir/.agents/commands" "$script" ;;
@@ -214,16 +211,13 @@ build_variant() {
     q)
       mkdir -p "$base_dir/.amazonq/prompts"
       generate_commands q md "\$ARGUMENTS" "$base_dir/.amazonq/prompts" "$script" ;;
-    bob)
-      mkdir -p "$base_dir/.bob/commands"
-      generate_commands bob md "\$ARGUMENTS" "$base_dir/.bob/commands" "$script" ;;
   esac
   ( cd "$base_dir" && zip -r "../spec-kit-template-${agent}-${script}-${NEW_VERSION}.zip" . )
   echo "Created $GENRELEASES_DIR/spec-kit-template-${agent}-${script}-${NEW_VERSION}.zip"
 }
 
 # Determine agent list
-ALL_AGENTS=(claude gemini copilot cursor-agent qwen opencode windsurf codex kilocode auggie roo codebuddy amp shai q bob qoder)
+ALL_AGENTS=(claude gemini copilot cursor-agent qwen opencode windsurf codex kilocode auggie roo codebuddy amp shai q)
 ALL_SCRIPTS=(sh ps)
 
 norm_list() {

README.md

@@ -246,27 +246,103 @@ specify check
 
 After running `specify init`, your AI coding agent will have access to these slash commands for structured development:
 
-#### Core Commands
+#### Core Workflow Commands
 
 Essential commands for the Spec-Driven Development workflow:
 
 | Command                 | Description                                                              |
 | ----------------------- | ------------------------------------------------------------------------ |
 | `/speckit.constitution` | Create or update project governing principles and development guidelines |
+| `/speckit.idea`         | Transform raw ideas into structured vision documents with feature decomposition |
 | `/speckit.specify`      | Define what you want to build (requirements and user stories)            |
+| `/speckit.clarify`      | Clarify underspecified areas (recommended before `/speckit.plan`)        |
 | `/speckit.plan`         | Create technical implementation plans with your chosen tech stack        |
 | `/speckit.tasks`        | Generate actionable task lists for implementation                        |
 | `/speckit.implement`    | Execute all tasks to build the feature according to the plan             |
+| `/speckit.validate`     | Run integration tests by executing acceptance scenarios                  |
+| `/speckit.fix`          | Diagnose and fix bugs by analyzing gaps between spec and implementation  |
 
-#### Optional Commands
+#### Quick Change Command
 
-Additional commands for enhanced quality and validation:
+For small modifications without the full workflow overhead:
 
-| Command              | Description                                                                                                                          |
-| -------------------- | ------------------------------------------------------------------------------------------------------------------------------------ |
-| `/speckit.clarify`   | Clarify underspecified areas (recommended before `/speckit.plan`; formerly `/quizme`)                                                |
-| `/speckit.analyze`   | Cross-artifact consistency & coverage analysis (run after `/speckit.tasks`, before `/speckit.implement`)                             |
-| `/speckit.checklist` | Generate custom quality checklists that validate requirements completeness, clarity, and consistency (like "unit tests for English") |
+| Command            | Description                                                                      |
+| ------------------ | -------------------------------------------------------------------------------- |
+| `/speckit.change`  | Apply focused changes (bug fixes, spec tweaks, user feedback, refinements)       |
+
+Use `/speckit.change` when:
+- Fixing a bug (code doesn't match spec)
+- Tweaking a spec (clarify wording, add edge case)
+- Responding to user feedback
+- Making small refinements or polish
+
+#### Quality & Analysis Commands
+
+| Command                    | Description                                                                      |
+| -------------------------- | -------------------------------------------------------------------------------- |
+| `/speckit.analyze`         | Cross-artifact consistency & coverage analysis                                   |
+| `/speckit.review`          | Code quality analysis, technical debt detection, actionable recommendations      |
+| `/speckit.checklist`       | Generate quality checklists ("unit tests for English")                           |
+| `/speckit.learn`           | Analyze codebase to update architecture registry + module CLAUDE.md files        |
+| `/speckit.merge`           | Merge feature branch to main, consolidate docs to /docs                          |
+
+#### Setup & Configuration Commands
+
+| Command                       | Description                                                                 |
+| ----------------------------- | --------------------------------------------------------------------------- |
+| `/speckit.setup`              | **Orchestrator** - runs all setup-xxx sub-commands                          |
+| `/speckit.setup-constitution` | Create/update project constitution                                          |
+| `/speckit.setup-docs`         | Initialize /docs domain structure (from-code/from-docs/from-specs)          |
+| `/speckit.setup-skills`       | Configure skills based on detected frameworks                               |
+| `/speckit.setup-agents`       | Generate specialized subagents                                              |
+| `/speckit.setup-mcp`          | Configure MCP server for testing/automation                                 |
+
+#### Utility Commands
+
+| Command                 | Description                                                                      |
+| ----------------------- | -------------------------------------------------------------------------------- |
+| `/speckit.breakdown`    | Create detailed task plans phase-by-phase                                        |
+| `/speckit.taskstoissues`| Convert tasks.md to GitHub issues                                                |
+
+### Workflow Overview
+
+Spec Kit supports two main workflows:
+
+```
+┌─────────────────────────────────────────────────────────────────────────────┐
+│                           FULL WORKFLOW (New Features)                       │
+│                                                                              │
+│   idea ──► specify ──► clarify ──► plan ──► tasks ──► implement ──► validate│
+│     │         │           │          │        │           │            │     │
+│     ▼         ▼           ▼          ▼        ▼           ▼            ▼     │
+│  idea.md   spec.md    (updates)   plan.md  tasks.md    code         report   │
+│            + checklist            research.md                                │
+│                                   data-model.md                              │
+│                                   contracts/                                 │
+└─────────────────────────────────────────────────────────────────────────────┘
+
+┌─────────────────────────────────────────────────────────────────────────────┐
+│                         QUICK WORKFLOW (Small Changes)                       │
+│                                                                              │
+│                              /speckit.change                                 │
+│                                    │                                         │
+│               ┌────────────────────┼────────────────────┐                    │
+│               │                    │                    │                    │
+│               ▼                    ▼                    ▼                    │
+│           Bug Fix            Spec Tweak           User Feedback              │
+│               │                    │                    │                    │
+│               ▼                    ▼                    ▼                    │
+│          Fix code           Edit spec.md          Apply change               │
+│               │                    │                    │                    │
+│               └────────────────────┴────────────────────┘                    │
+│                                    │                                         │
+│                                    ▼                                         │
+│                            Update traceability                               │
+│                            (tasks.md, spec.md)                               │
+└─────────────────────────────────────────────────────────────────────────────┘
+```
+
+See [Workflow Guide](./docs/workflows.md) for detailed workflow documentation.
 
 ### Environment Variables
 

docs/index.md

@@ -12,6 +12,7 @@ Spec-Driven Development **flips the script** on traditional software development
 
 - [Installation Guide](installation.md)
 - [Quick Start Guide](quickstart.md)
+- [Workflow Guide](workflows.md) - Full and quick change workflows
 - [Upgrade Guide](upgrade.md)
 - [Local Development](local-development.md)
 

docs/quickstart.md

@@ -149,16 +149,50 @@ Finally, implement the solution:
 /speckit.implement
 ```
 
+## Quick Changes (Bug Fixes, Tweaks, Feedback)
+
+For small modifications, use `/speckit.change` instead of the full workflow:
+
+```bash
+# Bug fix
+/speckit.change The login button doesn't work on mobile
+
+# Spec tweak
+/speckit.change Add requirement for email validation format
+
+# User feedback
+/speckit.change Users are confused by the Submit button - need better feedback
+
+# Refinement
+/speckit.change Improve error messages in the payment flow
+```
+
+**When to use `/speckit.change`:**
+- Bug fixes (code doesn't match spec)
+- Spec clarifications (add edge case, clarify wording)
+- User feedback responses
+- Small refinements and polish
+
+**When to use full workflow:**
+- New features
+- Changes affecting multiple user stories
+- Architectural changes
+- New data models or APIs
+
+See the [Workflow Guide](./workflows.md) for more details.
+
 ## Key Principles
 
 - **Be explicit** about what you're building and why
 - **Don't focus on tech stack** during specification phase
 - **Iterate and refine** your specifications before implementation
 - **Validate** the plan before coding begins
+- **Use `/speckit.change` for small modifications** - don't over-engineer
 - **Let the AI agent handle** the implementation details
 
 ## Next Steps
 
+- Read the [Workflow Guide](./workflows.md) for detailed workflow documentation
 - Read the [complete methodology](../spec-driven.md) for in-depth guidance
 - Check out [more examples](../templates) in the repository
 - Explore the [source code on GitHub](https://github.com/github/spec-kit)

docs/toc.yml

@@ -9,6 +9,8 @@
       href: installation.md
     - name: Quick Start
       href: quickstart.md
+    - name: Workflows
+      href: workflows.md
     - name: Upgrade
       href: upgrade.md