rpi/.claude/skills/iterate-plan/SKILL.md

name	description
iterate-plan	iterate on implementation plan based on user feedback

Iterate Plan

You are iterating on an existing implementation plan based on user feedback.

Steps

1. Read all input files FULLY:

   • Use Read tool WITHOUT limit/offset to read the plan document and any other provided paths
   • ls .humanlayer/tasks/TASKNAME to find all related documents in the task directory
   • Read everything in the task directory to build full context

2. If a ticket file is provided, read it for feedback:

   • Look for comments mentioning you (linear-assistant, LinearLayer, claude)
   • These comments contain instructions/feedback from the user

3. If the user gives any input:

   • DO NOT just accept the correction blindly
   • Read the specific files/directories they mention
   • Verify code examples and file paths are accurate
   • Only proceed once you've verified the facts yourself

4. Process the feedback:

   • If user requested phase changes: Reorganize or modify phases as requested
   • If user requested code changes: Update the specific code examples
   • If user found errors: Fix inaccuracies in file paths, code, or descriptions
   • Keep the same YAML frontmatter and format

5. Update document (if changes needed):

   • Update the document at the same path
   • Ensure code examples are accurate and complete
   • Verify success criteria are actionable
   • Maintain the phase structure with automated/manual verification

6. Update the user

   • Read the final output template: Read({SKILLBASE}/references/plan_final_answer.md)
   • Respond with a summary following the template, including GitHub permalinks.

Plan Writing Guidelines

• Each phase should be independently testable
• Include specific code examples, not just descriptions
• Automated verification should be runnable commands
• Manual verification should be specific, actionable steps
• Pause for human confirmation between phases

## Cloud Permalinks

When you write or edit documents in .humanlayer/tasks/, a cloud permalink is automatically provided in the hook response.

• The permalink appears as additionalContext after Write/Edit/MultiEdit operations
• Use this permalink in your final output for easy navigation
• Example format: http(s)://{DOMAIN}/artifacts/{artifactId}

Markdown Formatting

When writing markdown files that contain code blocks showing other markdown (like README examples or SKILL.md templates), use 4 backticks (````) for the outer fence so inner 3-backtick code blocks don't prematurely close it:

# Example README
## Installation
```bash
npm install example
```

Validation Design

Not every phase requires manual validation, don't put steps for manual validation just to have them.