Revise a materially wrong accepted or delivered-but-unarchived contract in Codex, including when the user corrects, rejects, removes, or replaces accepted behavior, while updating affected decisions, acceptance, optional work notes, and any conditional ADR.
Installs into .claude/skills of the current project.
Are you the author of Spec Revise?
Add the live security badge to your README. It updates with every re-scan.
[](https://www.skillsdirectory.com/skills/shrekshrek-spec-revise-project-workflow)
---
name: spec-revise
description: "Revise a materially wrong accepted or delivered-but-unarchived contract in Codex, including when the user corrects, rejects, removes, or replaces accepted behavior, while updating affected decisions, acceptance, optional work notes, and any conditional ADR."
---
# Spec Revise (Codex)
Match the user's language and preserve file language. Read [`../../../../docs/actions/spec-revise.md`](../../../../docs/actions/spec-revise.md) completely before acting; it owns the revision workflow and contract.
- Resolve the feature under canonical record/lifecycle rules. Read applicable root/nested `AGENTS.md`, recomputing applicability when module scope changes.
- Resolve the plugin root as the nearest ancestor of this skill containing `.codex-plugin/plugin.json`; when
canonical `ADR_REQUIRED` applies, search only relevant ADR metadata/references and instantiate the bundled
`template/docs/adr/0000-template.md`.
- Apply the canonical revision workflow under the current authorization.
- At the narrowed canonical boundary, dispatch a fresh subagent for
[`decision-completeness-auditor`](../../../../docs/reviewers/decision-completeness-auditor.md), with fallback
under the shared execution contract. Blocking or unreliable audit evidence prevents apply.
- Apply the authorized revision without restoring via checkout, rewriting unrelated history, or committing.
Report the canonical revision result and applicable `Reviewer execution` without adding an adapter-specific schema.
