dev-skills

Appearance

Target Convergence Prompt ​

Define the end state, not the steps. Agents iterate until acceptance criteria are met — the same prompt works on the first try or the hundredth.

Pattern ​

Structure prompts with two components:

1. Convergence Loop ​

The convergence loop tells the agent to assess the gap, plan the next change, make it, and repeat until all criteria pass. It works the same whether the agent nails it on the first attempt or needs many iterations.

markdown
## Convergence Loop

On each iteration:

1. **Assess:** Identify the gap between acceptance criteria and current
   state
2. **Plan:** Identify what changes to make next
3. **Edit:** Make the changes
4. **Repeat:** Iterate until acceptance criteria are met

2. Target Definition ​

Target definitions must be declarative — describe the end state, not the action.

markdown
## Target

Goal: User profile page displays name and email

### Acceptance Criteria
- [ ] Route `/profile` exists
- [ ] Page displays user's name
- [ ] Page displays user's email
- [ ] Page has "Edit Profile" link
- [ ] Page uses existing header component
- [ ] Tests cover rendering
- [ ] Page matches existing page styles
- [ ] Edit functionality is NOT implemented (separate task)

Critical Requirements ​

  • Acceptance Criteria is the single place for all evaluation criteria
  • Sort criteria sensibly: by logical order, grouped by topic, or workflow
  • When lists exceed 8 items, use hierarchical structure with section headers
  • Use state-describing words ("exists", "passes") not action verbs
  • Agents must mark criteria complete immediately when working through the prompt. They MUST NOT batch checkbox updates until the end.