Agent skill · yonatangross
iterate-plan
Revises a create-plan file from its review comments or new instructions, keeping comments and bumping the revision. Use when a plan got feedback; never to start one.
What it needs
About 2k tokens when loaded.
What this skill does
iterate-plan Revise one plan file. The body is rewritten; the comment block is kept byte for byte, because the review record must outlive every revision. Layout: the create-plan skill's references/artifact-layout.md. Steps 1. Read the plan in full, then the rest of its task directory in NN order (research, earlier plans). List the open comments: 2. Check each comment against the code before acting on it. Open the files it names. A comment can be wrong; if so, say so in a reply instead of changing the plan. 3. Write the revised body to a scratch file: start from the current body (everything between the front matter and <!-- ork:comments -->), apply the changes, keep the phase structure. Do not copy the comment block into it; the script refuses a body that carries one. 4. Write it back through the script, which bumps revision, refreshes sha and updated, and keeps the comments: 5. Answer each comment you addressed with a reply saying what changed. Resolve only when the reviewer asked you to, or when the comment is a factual fix you made: 6. Reply with the path, the new revision and which comments are still open. Do not implement. Rules Never edit the plan file with Write or Edit: one stray write can drop the comment block. Never delete or rewrite a comment, even a wrong one. Reply to it. Iterating an approved plan moves it back to in-review; it needs a new approval. Related /ork:create-plan writes the first revision. /ork:review-artifact-comments works through comments without rewriting the body.
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills yonatangross/iterate-plan--49dc6e