Implementing Review Feedback

Workflow

1. Parse Reviewer Notes

• Split numbered lists and bullets
• Extract distinct change requests
• Clarify ambiguous items BEFORE starting

2. Create Todo List

Use TodoWrite for each feedback item:

• One todo per change
• Mark first as in_progress before starting
• Only ONE in_progress at any time

3. Implement Systematically

For each todo:

Locate:

• Grep for functions/classes
• Glob for files by pattern
• Read current implementation

Change:

• Use Edit tool
• Follow CLAUDE.md conventions
• Preserve existing functionality

Verify:

• Check syntax
• Run relevant tests
• Confirm reviewer's intent addressed

Update:

• Mark todo completed IMMEDIATELY
• Move to next (one in_progress only)

4. Validate

After all changes:

ruff check --fix && ruff format
pytest {affected_tests}

5. Commit and Push (if requested)

git add -A
git commit -m "fix: Address review feedback for task-{id}

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>"
git push

6. Task Completion (if --auto-complete)

# Without review bypass
ft task complete {task_id}

# With review bypass
ft task complete {task_id} --skip-review

Edge Cases

Find the Stupid

Converted and distributed by TomeVault — claim your Tome and manage your conversions.