# Iterate Research

> Re-checks a create-research file when a claim is challenged or the question widens, citing file:line afresh. Use after review comments on research.

- Skill: `yonatangross/iterate-research` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx get-skill add yonatangross/iterate-research`
- Raw SKILL.md: https://api.skillmd.com/api/skills/yonatangross/iterate-research/raw
- Safety review: pending (external: skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Research & Search
- Author: yonatangross (https://skillmd.com/u/yonatangross)
- Updated: 2026-11-18
- Page: https://skillmd.com/skills/yonatangross/iterate-research

---


# iterate-research

Revise one research file. The body is rewritten from fresh reading of the code; the comment block is
kept byte for byte. Layout: the create-plan skill's `references/artifact-layout.md`.

## Steps

1. **Read the research in full** and list its open comments:

   ```bash
   node "${CLAUDE_SKILL_DIR}/scripts/artifact.mjs" list --file <research> --open
   ```

2. **Re-check every challenged claim in the code**, at the current commit. If the code moved since
   the artifact's `sha`, say which findings changed.
3. **New questions** get the same method as create-research: parallel `Explore` agents by area,
   citations checked by you.
4. **Write the revised body** to a scratch file (no comment block in it) and write it back:

   ```bash
   node "${CLAUDE_SKILL_DIR}/scripts/artifact.mjs" iterate --file <research> --body /tmp/research-body.md
   ```

5. **Reply to each comment you addressed** (`reply`, or `resolve` when the reviewer asked or the
   comment was a factual correction you made), then answer with the path, the revision and the
   comments still open.

## Rules

- Same rules as create-research: describe, cite, no recommendations.
- Never edit the file with Write or Edit, and never delete a comment.

## Related Skills

- `/ork:create-research` writes the first revision. `/ork:review-artifact-comments` handles comments without a
  rewrite.

