Intent Review

What it does

The Intent Review skill provides an interactive, section-level approval process for Intent files. It helps AI agents manage and track changes to these files by guiding users through a review workflow. The tool identifies sections within a file and prompts the user to approve, lock (requiring explicit human agreement), or skip them, ensuring consistency and controlled modifications. This is particularly useful in development workflows where clear approval processes are needed for specific code sections.

When to use it

• Reviewing newly created Intent files after generation by tools like intent-interview.
• Approving changes made to existing Intent files before they are integrated into a larger system.
• Ensuring that critical sections of an Intent file (e.g., module boundaries, data structures) adhere to defined standards and require explicit approval.
• Managing development workflows where modifications need to be tracked and approved by specific individuals.
• Batch reviewing multiple Intent files within a project using the /intent-review --all command.

Key capabilities

• Section-level approval: Reviews Intent documents at a granular section level.
• Three states: Manages sections with statuses of LOCKED (requires human confirmation), REVIEWED (allows modification with notification), and DRAFT (free to modify).
• Interactive review prompts: Uses AskUserQuestion to present each unmarked section for approval, offering options to lock, review, or skip.
• Automated marking: Automatically adds markers (::: locked, ::: reviewed, ::: draft) to Intent files based on user choices.
• History tracking: Provides a history of changes and approvals for each section using /intent-review --history.

Example prompts

• /intent-review src/core/intent/INTENT.md - Reviews a specific Intent file.
• /intent-review (when in the src/chambers/terminal directory) - Reviews the default Intent file within the current module.
• /intent-review --all - Reviews all Intent files in the project.

Tips & gotchas

• The skill prioritizes finding Intent files first by user-specified path, then intent/INTENT.md in the current directory, and finally INTENT.md in the current directory.
• LOCKED sections require explicit human approval for any modifications. Be mindful of this when making changes.
• The skill can detect if a LOCKED section has been modified and will prompt for acceptance of those changes before proceeding.