review-brief

Edit selected sections of a Project Brief with versioning and audit logging.

Updated Apr 26, 2026
One-click install
npx skills add https://github.com/aoecosystem/project-foundations --skill review-brief
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: review-brief
Source: https://github.com/aoecosystem/project-foundations/tree/main/.cursor/skills/review-brief
Command: npx skills add https://github.com/aoecosystem/project-foundations --skill review-brief

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill enables iterative, section-level edits to a previously completed Project Brief without restarting the interview flow.

Core Features & Use Cases

  • Section-level edits: modify a specific part of the filled brief while preserving the existing structure and styling.
  • Versioning and auditing: each save bumps the brief version and appends an audit log entry to SESSION-STATE.md.
  • Stage-aware operation: enforces BRIEF_DRAFT or BRIEF_APPROVED gating and handles reversibility for approved briefs.
  • Pre-flight and drift checks: performs artifact hash comparison and manual-edit protocol before any changes.

Quick Start

Run /review-brief <section> to start editing that section of your filled brief.

Frequently Asked Questions about review-brief

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I edit a filled project brief without restarting the interview?

To edit a filled project brief without restarting the interview, use section-level editing to modify specific parts while preserving the existing structure, styling, and other completed sections.

Can I modify a section of an approved project brief?

Yes, you can modify a section of an approved project brief. The stage-aware operation enforces BRIEF_DRAFT or BRIEF_APPROVED gating and handles reversibility for approved briefs during the section editing process.

Does editing a project brief keep an audit log of changes?

Editing a project brief maintains an audit log by bumping the brief version and appending an audit log entry to SESSION-STATE.md on every save, ensuring all iterative modifications are tracked.

What is section-level brief editing and when do I need it?

Section-level brief editing is the ability to modify a specific part of a filled project brief while preserving its structure. You need it when making targeted updates without restarting the entire interview flow.

Are there pre-flight checks before modifying a project brief section?

Yes, pre-flight checks are performed before modifying a project brief section. The system conducts artifact hash comparison and manual-edit protocol validation to ensure data integrity before applying any changes.