bms-speckit-plugin 4.0.2 → 4.1.1

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "bms-speckit",
-  "version": "4.0.0",
+  "version": "4.1.0",
   "description": "Chain-orchestrated development pipeline with per-step error handling. /bms-speckit runs brainstorm → constitution → specify → plan → tasks → analyze → implement → verify.",
   "author": {
     "name": "manoirx"

package/blueprints/bms-speckit-pipeline.yaml

@@ -4,14 +4,18 @@
 # This blueprint defines the chain sequence, I/O contracts, error handling,
 # and timeout constraints for each step. The SKILL.md orchestrator executes
 # this chain via Claude Code's Skill tool.
+#
+# Commit strategy: every artifact-producing step commits and pushes immediately
+# to prevent loss and provide traceability per the project constitution.
 
 id: bms_speckit_development_pipeline
-version: 4.0.0
+version: 4.1.0
 name: BMS Speckit Automated Development Pipeline
 description: >
   Full engineering workflow from requirement to verified implementation.
   Chains brainstorming, constitution, specification, planning, task generation,
   analysis, implementation (TDD), and final verification.
+  Commits after every important step for traceability and safety.
 category: Development
 
 # ─── Chain Sequence ────────────────────────────────────────────────────────────
@@ -30,6 +34,10 @@ chain_sequence:
       requirement: "$ARGUMENTS"
     output:
       artifacts: [detailed_specification]
+    post_action:
+      commit: true
+      message: "feat(speckit): brainstorm — explore requirements and design"
+      push: true
     error_handling:
       on_failure: stop
       max_retries: 1
@@ -80,6 +88,10 @@ chain_sequence:
     input:
       constitution_path: specs/constitution.md
       target_path: CLAUDE.md
+    post_action:
+      commit: true
+      message: "feat(speckit): add constitution and sync CLAUDE.md"
+      push: true
     error_handling:
       on_failure: continue
       max_retries: 1
@@ -98,6 +110,10 @@ chain_sequence:
       requirement: "{{step_1_brainstorm.output}}"
     output:
       artifacts: [specs/*/spec.md]
+    post_action:
+      commit: true
+      message: "feat(speckit): add feature specification"
+      push: true
     error_handling:
       on_failure: stop
       max_retries: 2
@@ -116,6 +132,10 @@ chain_sequence:
       source: "{{step_4_specify.artifacts}}"
     output:
       artifacts: [specs/*/plan.md]
+    post_action:
+      commit: true
+      message: "feat(speckit): add implementation plan"
+      push: true
     error_handling:
       on_failure: stop
       max_retries: 2
@@ -134,6 +154,10 @@ chain_sequence:
       source: "{{step_5_plan.artifacts}}"
     output:
       artifacts: [specs/*/tasks.md]
+    post_action:
+      commit: true
+      message: "feat(speckit): add task list"
+      push: true
     error_handling:
       on_failure: stop
       max_retries: 2
@@ -152,6 +176,10 @@ chain_sequence:
       source: "{{step_6_tasks.artifacts}}"
     output:
       artifacts: [analysis_report]
+    post_action:
+      commit: true
+      message: "feat(speckit): add cross-artifact analysis report"
+      push: true
     error_handling:
       on_failure: continue
       max_retries: 1
@@ -160,23 +188,9 @@ chain_sequence:
         Check spec ↔ plan ↔ tasks consistency. Flag gaps, contradictions,
         and missing test coverage. Non-destructive — report only.
 
-  - step_id: step_8_commit
-    skill_id: internal.git_commit_push
-    action: execute
-    phase: 1
-    description: Commit all specification artifacts and push
-    timeout_seconds: 120
-    error_handling:
-      on_failure: continue
-      max_retries: 1
-    opinionated_prompts:
-      system_context: >
-        Commit all files in specs/ with a descriptive message.
-        Push to remote if configured.
-
   # ── Phase 2: Implementation (main context) ────────────────────────────────
 
-  - step_id: step_9_compact
+  - step_id: step_8_compact
     skill_id: internal.compact
     action: execute
     phase: 2
@@ -186,19 +200,23 @@ chain_sequence:
       on_failure: continue
       max_retries: 0
 
-  - step_id: step_10_implement
+  - step_id: step_9_implement
     skill_id: speckit.implement
     action: execute_loop
     phase: 2
     description: Execute all tasks with TDD workflow via ralph-loop
     timeout_seconds: 3600
     input:
-      tasks_path: "specs/*/tasks.md"
+      tasks_path: "{{step_6_tasks.artifacts}}"
       loop_engine: ralph-loop
       completion_promise: "FINISHED"
       max_iterations: 10
     output:
       artifacts: [source_code, tests, commits]
+    post_action:
+      commit: per_task
+      message: "feat: implement <task_name>"
+      push: true
     error_handling:
       on_failure: continue
       max_retries: 3
@@ -213,12 +231,16 @@ chain_sequence:
         apply improvements, re-run all tests, confirm zero regression.
         Only output FINISHED after everything is validated.
 
-  - step_id: step_11_verify
+  - step_id: step_10_verify
     skill_id: speckit.analyze
     action: execute
     phase: 2
     description: Final validation pass — confirm production-grade quality
     timeout_seconds: 300
+    post_action:
+      commit: true
+      message: "chore(speckit): final verification pass complete"
+      push: true
     error_handling:
       on_failure: stop
       max_retries: 1
@@ -227,6 +249,22 @@ chain_sequence:
         Final gate. Verify all tasks completed, tests passing,
         no regressions, code quality standards met.
 
+  - step_id: step_11_merge
+    skill_id: internal.git_merge_to_main
+    action: execute
+    phase: 2
+    description: Merge feature branch into main
+    timeout_seconds: 120
+    post_action:
+      push: true
+    error_handling:
+      on_failure: stop
+      max_retries: 1
+    opinionated_prompts:
+      system_context: >
+        Switch to main branch, merge the feature branch (fast-forward if possible),
+        push main to remote, then clean up the feature branch.
+
 # ─── Metadata ──────────────────────────────────────────────────────────────────
 
 metadata:
@@ -234,14 +272,15 @@ metadata:
   created_at: "2026-03-29"
   tags: [speckit, tdd, workflow, development, chain, engineering]
   estimated_duration_seconds: 6000
+  commit_strategy: per_step
   phases:
     phase_1:
       name: Specification & Planning
-      steps: [step_1 through step_8]
+      steps: [step_1 through step_7]
       execution: subagent
       reason: Preserve main context window for implementation
     phase_2:
-      name: Implementation & Verification
-      steps: [step_9 through step_11]
+      name: Implementation & Verification & Merge
+      steps: [step_8 through step_11]
       execution: main_context
       reason: Implementation needs full tool access and ralph-loop

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bms-speckit-plugin",
-  "version": "4.0.2",
+  "version": "4.1.1",
   "description": "Chain-orchestrated development pipeline: /bms-speckit takes requirements and runs brainstorm → constitution → specify → plan → tasks → analyze → implement → verify with per-step error handling",
   "files": [
     ".claude-plugin/",

package/skills/bms-speckit-auto/SKILL.md

@@ -15,7 +15,8 @@ Chain blueprint: `blueprints/bms-speckit-pipeline.yaml`
    - `on_failure: stop` → halt the chain and report which step failed
    - `on_failure: continue` → log the failure and proceed to next step
 4. Pass `$ARGUMENTS` (the user's requirement) to step 1 (brainstorm). Step 4 (specify) receives the **output from step 1**, not raw `$ARGUMENTS`
-5. Do NOT ask for confirmation between steps
+5. **Commit and push after every important step** — each artifact-producing step must commit its output before proceeding to the next step
+6. Do NOT ask for confirmation between steps
 
 ---
 
@@ -26,7 +27,7 @@ Chain blueprint: `blueprints/bms-speckit-pipeline.yaml`
 Subagent prompt:
 
 """
-You are running the BMS Speckit specification and planning chain. Execute each step in order using the Skill tool. Do NOT ask for confirmation. Follow error handling policies exactly.
+You are running the BMS Speckit specification and planning chain. Execute each step in order using the Skill tool. Do NOT ask for confirmation. Follow error handling policies exactly. **Commit and push after every important step.**
 
 ### Step 1 — Brainstorm `[on_failure: STOP]`
 - **Skill:** `superpowers.brainstorm`
@@ -34,6 +35,7 @@ You are running the BMS Speckit specification and planning chain. Execute each s
 - **Purpose:** Explore intent, requirements, design alternatives, and edge cases
 - **Output:** Detailed specification document
 - **Timeout:** 300s
+- **Post-action:** Commit all files and push. Message: `feat(speckit): brainstorm — explore requirements and design`
 
 ### Step 2 — Constitution `[on_failure: STOP]`
 - **Skill:** `speckit.constitution`
@@ -44,6 +46,7 @@ You are running the BMS Speckit specification and planning chain. Execute each s
 ### Step 3 — CLAUDE.md Sync `[on_failure: CONTINUE]`
 - **Action:** Read CLAUDE.md and verify it complies with the constitution in `specs/constitution.md`. Update CLAUDE.md if it conflicts with or is missing constitution rules.
 - **Timeout:** 120s
+- **Post-action:** Commit all files and push. Message: `feat(speckit): add constitution and sync CLAUDE.md`
 
 ### Step 4 — Specify `[on_failure: STOP]`
 - **Skill:** `speckit.specify`
@@ -51,6 +54,7 @@ You are running the BMS Speckit specification and planning chain. Execute each s
 - **Output:** `specs/*/spec.md`
 - **Timeout:** 300s
 - **Retry:** up to 2 attempts
+- **Post-action:** Commit all files and push. Message: `feat(speckit): add feature specification`
 
 ### Step 5 — Plan `[on_failure: STOP]`
 - **Skill:** `speckit.plan`
@@ -58,6 +62,7 @@ You are running the BMS Speckit specification and planning chain. Execute each s
 - **Output:** `specs/*/plan.md`
 - **Timeout:** 300s
 - **Retry:** up to 2 attempts
+- **Post-action:** Commit all files and push. Message: `feat(speckit): add implementation plan`
 
 ### Step 6 — Tasks `[on_failure: STOP]`
 - **Skill:** `speckit.tasks`
@@ -65,15 +70,13 @@ You are running the BMS Speckit specification and planning chain. Execute each s
 - **Output:** `specs/*/tasks.md`
 - **Timeout:** 300s
 - **Retry:** up to 2 attempts
+- **Post-action:** Commit all files and push. Message: `feat(speckit): add task list`
 
 ### Step 7 — Analyze `[on_failure: CONTINUE]`
 - **Skill:** `speckit.analyze`
 - **Purpose:** Cross-artifact consistency check (spec ↔ plan ↔ tasks). Non-destructive — report only.
 - **Timeout:** 300s
-
-### Step 8 — Commit & Push `[on_failure: CONTINUE]`
-- **Action:** Commit all files and push to remote if configured.
-- **Timeout:** 120s
+- **Post-action:** Commit all files and push. Message: `feat(speckit): add cross-artifact analysis report`
 
 After all steps complete, return: the feature name, number of tasks created, and the path to tasks.md.
 """
@@ -84,30 +87,41 @@ After all steps complete, return: the feature name, number of tasks created, and
 
 > **Execution context:** Runs in main context after subagent completes.
 
-### Step 9 — Compact `[on_failure: CONTINUE]`
+### Step 8 — Compact `[on_failure: CONTINUE]`
 - **Action:** Run `/compact` to free context window before implementation.
 
-### Step 10 — Implement (loop) `[on_failure: CONTINUE | max_retries: 3]`
+### Step 9 — Implement (loop) `[on_failure: CONTINUE | max_retries: 3]`
 - **Engine:** ralph-loop
+- **Input:** Use the **tasks.md path returned by the Phase 1 subagent** (e.g. `specs/my-feature/tasks.md`). Replace `{TASKS_PATH}` below with the actual path.
 - **Completion promise:** `FINISHED`
 - **Max iterations:** 10
+- **Commit strategy:** Atomic commit after each completed task
 - **Action:** Run:
 
-`/ralph-loop:ralph-loop "systematically execute speckit.implement via the Skill tool to complete every task defined in specs/*/tasks.md with strict adherence to specification requirements, enforce TDD workflow including writing and passing unit, integration, and end-to-end tests before marking any task complete, ensure code quality through linting, static analysis, and consistent architecture with reusable components and centralized business logic, maintain atomic commits after each successful task with clear traceability, avoid requesting confirmation and proceed autonomously, once all tasks are implemented invoke speckit.analyze via the Skill tool to perform a full validation pass, automatically apply all recommended improvements or corrections, re-run all tests to confirm stability and zero regression, and only output <promise>FINISHED</promise> after every task is fully completed, validated, and aligned with production-grade quality standards" --completion-promise "FINISHED" --max-iterations 10`
+`/ralph-loop:ralph-loop "systematically execute speckit.implement via the Skill tool to complete every task defined in {TASKS_PATH} with strict adherence to specification requirements, enforce TDD workflow including writing and passing unit, integration, and end-to-end tests before marking any task complete, ensure code quality through linting, static analysis, and consistent architecture with reusable components and centralized business logic, maintain atomic commits after each successful task with clear traceability, avoid requesting confirmation and proceed autonomously, once all tasks are implemented invoke speckit.analyze via the Skill tool to perform a full validation pass, automatically apply all recommended improvements or corrections, re-run all tests to confirm stability and zero regression, and only output <promise>FINISHED</promise> after every task is fully completed, validated, and aligned with production-grade quality standards" --completion-promise "FINISHED" --max-iterations 10`
+
+### Step 10 — Verify `[on_failure: STOP]`
+- **Skill:** `speckit.analyze`
+- **Purpose:** Final validation — confirm all tasks completed, tests passing, no regressions, code quality standards met.
+- **Timeout:** 300s
+- **Post-action:** Commit all files and push. Message: `chore(speckit): final verification pass complete`
+
+### Step 11 — Merge to Main `[on_failure: STOP]`
+- **Action:** Switch to main branch, merge the feature branch (fast-forward if possible), push main to remote, then clean up the feature branch.
+- **Timeout:** 120s
 
 ---
 
 ## Chain Summary
 
 ```
-Phase 1 (subagent)                    Phase 2 (main context)
-─────────────────────                 ──────────────────────
-Step 1:  brainstorm ──STOP──┐         Step 9:  compact
-Step 2:  constitution ─STOP─┤         Step 10: implement (ralph-loop)
-Step 3:  CLAUDE.md sync ────┤         Step 11: verify (via step 10)
-Step 4:  specify ──────STOP─┤
-Step 5:  plan ─────────STOP─┤
-Step 6:  tasks ────────STOP─┤
-Step 7:  analyze ───────────┤
-Step 8:  commit & push ─────┘
+Phase 1 (subagent)                          Phase 2 (main context)
+──────────────────────────────              ──────────────────────────────
+Step 1: brainstorm ──STOP── commit          Step 8:  compact
+Step 2: constitution ─STOP─┐               Step 9:  implement (ralph-loop)
+Step 3: CLAUDE.md sync ────┘ commit                  commit per task
+Step 4: specify ──────STOP── commit         Step 10: verify ── commit
+Step 5: plan ─────────STOP── commit         Step 11: merge to main + push
+Step 6: tasks ────────STOP── commit
+Step 7: analyze ──────────── commit
 ```