A command for changing the active issue’s approved scope after work has started. It records the reason, updates the allowed and required files and checks, and requires verification and review again.

Use it when the specification needs new files, checks, or restrictions during a build. Run it before repeating issue verification and review.

It prevents the implementation from silently drifting away from the specification. It keeps a permanent record of what changed while preserving the review limit.

issue-amend — Command for coding agents by assafkip: A command for changing the active issue’s approved scope…

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods

npx agentmods add commands/assafkip/prd-os/issue-amend

Clone the repo

git clone --depth 1 https://github.com/assafkip/prd-os

Or install prd-os, the plugin that ships this one along with the rest of its 1 skill, 14 commands.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

README.md

[![agentmods](https://agentmods.dev/badge/commands/assafkip/prd-os/issue-amend.svg)](https://agentmods.dev/commands/assafkip/prd-os/issue-amend)

Your own site

<a href="https://agentmods.dev/commands/assafkip/prd-os/issue-amend"><img src="https://agentmods.dev/badge/commands/assafkip/prd-os/issue-amend.svg" alt="Measured on agentmods" height="20"></a>

Per session 26 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.

When invoked 598 The whole file, excluding the scripts and references it only reads on demand.

Security scan A 0 findings. Scan, not verified.

Origin 97% copy Near-identical to another mod in the catalogue.

Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

Model	Per session	Once invoked
Fable 5	$0.00026	$0.00598
Opus 5	$0.00013	$0.00299
Sonnet 5	$0.00005	$0.00120
Haiku 4.5	$0.00003	$0.00060

Measured 4d ago against content hash 9d710f9a87c5, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

issue-amend scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 4d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

Origin

This is a copy

97% identical to issue-amend — 2 lines differ, which has more behind it and is treated as the original. This page carries a canonical link to it rather than competing with it.

plugins/prd-os/commands/issue-amend.md · 39 lines

What it actually says

Use this when you realize mid-build that the spec was wrong. The flow:

The founder edits the issue spec in example-project/.q-system/issues/<id>.md (or the instance-equivalent path). Typical edits: widen allowed_files, adjust required_checks, add a new disallowed_files entry.
Run amend with a short reason explaining what changed and why:
```
python3 "${CLAUDE_PLUGIN_ROOT}/scripts/issue_runner.py" amend \
  --reason "realized the bug also lives in helpers/*, widening scope"
```
The runner does four things:
- Re-reads the spec from disk.
- Re-snapshots allowed_files, required_checks, and disallowed_files into state.
- Clears receipts.verified and receipts.reviewed (forces re-verify + re-review).
- Appends an entry to state.amendments with timestamp, reason, old snapshot, new snapshot.
What amend does NOT change:
- review_rounds counter (the cap still governs; amending does not reset review budget).
- Spec status (stays in-progress).
- findings_triaged receipt (that receipt only matters at closeout).
Exit 0 means the amendment is logged. Exit 2 means either no active issue or missing --reason.
Re-run /issue-verify to regenerate the verified receipt against the new scope. Then /issue-review for the reviewed receipt. The runner's review-rounds cap still applies; amending does not grant extra review budget. If a full standard + adversarial pair already ran pre-amend, ISSUE_ALLOW_REVIEW_REPEAT=1 is the override knob.
On /issue-closeout, close flushes all entries from state.amendments into an ## Amendments section at the bottom of the spec file. That becomes the permanent audit record. After close, the spec shows exactly what was amended, when, why, and what the scope looked like before and after each amendment.

Guardrails:

Amend is for genuine mid-build spec corrections. It is not a retry button after a bad review. If the issue as specified was fine but the implementation was wrong, fix the implementation. Do not amend.
Amend requires a non-empty --reason. Empty strings are rejected.
Amend does not create or modify files other than .claude/state/active-issue.json. The spec edit is a separate manual step before amend.
Repeated amendments are fine. Each one records its own before/after snapshot and adds its own entry to the permanent footer on close.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

4d ago First seen · 39 lines · 26 tokens per session scan A 9d710f9a87c5

Subscribe to this mod's changes

issue-amend is a command published in the GitHub repository assafkip/prd-os (10 stars, last pushed 2mo ago), licensed MIT. It adds 26 tokens to every session and 598 once invoked, about $0.0001 per session on Opus 5. A static security scan graded it A with 0 findings. It is 97% identical to issue-amend, differing in 2 lines, and is treated as a copy.

Project management ai-workflow claude-code founder-tools prd product-management

issue-amend

Getting it into your agent

Wrote this? Show the measurements

What it costs to keep this loaded

Grade A, and why

Nothing flagged

This is a copy

What it actually says

What this file has done since we first saw it

Other commands, from other repositories

bug-report

phase-scope

prd

retro

status

todo