Incremental Workflow

Implement ONE feature, verify it, commit, and exit. The orchestrator will call you repeatedly for each feature.

Input

You will be given a specific feature ID to implement. Focus ONLY on that feature.

Workflow

1. Ensure Clean State

git status --short

If uncommitted changes exist, commit or discard them first.

2. Start Environment (if needed)

if [ -f init.sh ]; then ./init.sh; fi

3. Get Feature Details

FEATURE_ID="[THE_FEATURE_ID]"  # Use the ID you were given
jq -r '.features[] | select(.id == "'$FEATURE_ID'")' feature_list.json

4. Consult Documentation

BEFORE implementing, check the feature's documentation field:

1. Read the documentation URLs from the feature
2. Use WebFetch to retrieve relevant sections from each URL
3. Focus on:
   • Installation/setup instructions
   • API usage patterns
   • Configuration options
   • Common pitfalls to avoid

This ensures you implement the feature correctly using official guidance.

5. Implement

Write minimal code for THIS feature only, following the patterns from the documentation.

Rules:

• No scope creep
• No "while I'm here" fixes
• No premature optimization
• Focus ONLY on the assigned feature
• Follow official documentation patterns

6. Verify

Test against the feature's verification steps:

1. Read verification steps from the feature
2. Actually perform each step
3. If any fails, fix before proceeding

7. Mark Complete

jq '(.features[] | select(.id == "'$FEATURE_ID'")) |= . + {"passes": true, "completed_at": "'"$(date -Iseconds)"'"}' feature_list.json > tmp.json && mv tmp.json feature_list.json

8. Commit

git add -A
git commit -m "feat($FEATURE_ID): [short description]

Co-Authored-By: Claude <noreply@anthropic.com>"

9. Log Progress

Append to claude-progress.txt:

- [TIMESTAMP] Completed $FEATURE_ID: [description] ([commit hash])

10. Exit

Return to the orchestrator with:

• SUCCESS: Feature ID completed
• BLOCKED: Feature ID blocked, reason: [explanation]

Rules

DO:

• Consult documentation URLs before implementing
• Implement ONLY the assigned feature
• Test before marking complete
• Commit before exiting
• Exit after ONE feature

DON'T:

• Implement multiple features
• Skip reading the documentation
• Mark complete without testing
• Edit feature descriptions (hook blocks this)
• Leave uncommitted changes (hook blocks this)
• Continue to next feature (orchestrator handles that)