@ghostwater/soulforge 0.1.0

package/workflows/feature-dev/workflow.yml

@@ -0,0 +1,169 @@
+# Soulforge Feature Development Workflow
+# Uses Claude Code for implementation, with orchestrator review checkpoints.
+id: feature-dev
+name: Feature Development
+version: 1
+description: |
+  Story-based development pipeline with pluggable executors.
+  Planner decomposes tasks → orchestrator reviews → Claude Code implements →
+  verifier checks → integration testing → PR → final review.
+
+defaults:
+  executor: claude-code
+  model: opus
+  timeout: 600
+  max_retries: 2
+
+steps:
+  - id: plan
+    executor: claude-code
+    model: opus
+    workdir: "{{workdir}}"
+    input: |
+      You are working in {{workdir}}. A git branch has already been created for you.
+
+      Decompose the following task into ordered user stories for autonomous execution.
+
+      TASK:
+      {{task}}
+
+      Instructions:
+      1. Explore the codebase to understand the stack, conventions, and patterns
+      2. Break the task into small user stories (max 20)
+      3. Order by dependency: schema/DB first, backend, frontend, integration
+      4. Each story must fit in one developer session (one context window)
+      5. Every acceptance criterion must be mechanically verifiable
+      6. Always include "Typecheck passes" as the last criterion in every story
+      7. Every story MUST include test criteria
+
+      Reply with:
+      STATUS: done
+      STORIES_JSON: [ ... array of story objects ... ]
+    expects: "STATUS: done"
+
+  - id: review-plan
+    executor: self
+    input: |
+      Review the planned stories before execution begins.
+      STORIES: {{stories_json}}
+
+  - id: implement
+    executor: claude-code
+    model: opus
+    workdir: "{{workdir}}"
+    type: loop
+    loop:
+      over: stories
+      completion: all_done
+      fresh_session: true
+      verify_each: true
+      verify_step: verify
+    input: |
+      Implement the following user story.
+
+      TASK (overall): {{task}}
+      WORKDIR: {{workdir}}
+      BUILD_CMD: {{build_cmd}}
+      TEST_CMD: {{test_cmd}}
+
+      CURRENT STORY:
+      {{current_story}}
+
+      COMPLETED STORIES:
+      {{completed_stories}}
+
+      STORIES REMAINING: {{stories_remaining}}
+
+      VERIFY FEEDBACK (if retrying):
+      {{verify_feedback}}
+
+      Instructions:
+      1. Pull latest on the branch
+      2. Implement this story only
+      3. Write tests for this story
+      4. Run typecheck / build
+      5. Run tests
+      6. Commit: feat: {{current_story_id}} - {{current_story_title}}
+
+      Reply with:
+      STATUS: done
+      CHANGES: what you implemented
+      TESTS: what tests you wrote
+    expects: "STATUS: done"
+
+  - id: verify
+    executor: claude-code
+    model: opus
+    workdir: "{{workdir}}"
+    input: |
+      Verify the developer's work on this story.
+
+      WORKDIR: {{workdir}}
+      CHANGES: {{changes}}
+      TEST_CMD: {{test_cmd}}
+
+      CURRENT STORY:
+      {{current_story}}
+
+      Check:
+      1. Code exists (not just TODOs or placeholders)
+      2. Each acceptance criterion is met
+      3. Tests were written
+      4. Tests pass (run {{test_cmd}})
+      5. Typecheck passes
+
+      Reply with:
+      STATUS: done
+      VERIFIED: What you confirmed
+
+      Or if incomplete:
+      STATUS: retry
+      ISSUES:
+      - What's missing
+    expects: "STATUS: done"
+
+  - id: test
+    executor: claude-code
+    model: opus
+    workdir: "{{workdir}}"
+    input: |
+      Run integration and E2E tests.
+
+      TASK: {{task}}
+      WORKDIR: {{workdir}}
+      TEST_CMD: {{test_cmd}}
+
+      1. Run the full test suite
+      2. Look for integration issues between stories
+      3. Check error handling and edge cases
+
+      Reply with:
+      STATUS: done
+      RESULTS: What you tested and outcomes
+    expects: "STATUS: done"
+
+  - id: pr
+    executor: claude-code
+    model: opus
+    workdir: "{{workdir}}"
+    input: |
+      Create a pull request.
+
+      TASK: {{task}}
+      WORKDIR: {{workdir}}
+      CHANGES: {{changes}}
+
+      Create a PR with gh pr create.
+
+      Reply with:
+      STATUS: done
+      PR: URL to the pull request
+    expects: "STATUS: done"
+
+  - id: final-review
+    executor: self
+    input: |
+      Final review before merge.
+      PR: {{pr}}
+      TASK: {{task}}
+      CHANGES: {{changes}}