approve-brief

Validates project briefs and gates pipeline from BRIEF_DRAFT to BRIEF_APPROVED.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This policy ensures project briefs meet the quality gate and properly transitions the pipeline from BRIEF_DRAFT to BRIEF_APPROVED, preventing incomplete briefs from advancing.

Core Features & Use Cases

  • Quality gate checks ensure all 13 sections are present or marked as TBD.
  • Stage transition from BRIEF_DRAFT to BRIEF_APPROVED unlocks /build-scope-of-work and continues the workflow.
  • Audit log updates and session-state maintenance provide traceability and reliability.

Quick Start

Run /approve-brief to lock the brief and advance to BRIEF_APPROVED.

Frequently Asked Questions about approve-brief

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

FAQPage Schema
How do I gate a project brief from draft to approved status in a pipeline?

To gate a project brief from draft to approved, the pipeline validates completion of all 13 brief sections, updates the session-state, and appends audit logs to ensure traceability before transitioning the brief to BRIEF_APPROVED.

What happens to incomplete project briefs during pipeline stage transition?

Incomplete project briefs fail the quality gate and the pipeline refuses to transition them from BRIEF_DRAFT to BRIEF_APPROVED if the 13 sections are missing or still contain placeholders.

Do I need a specific session state file to approve a project brief?

Yes, approving a project brief requires access to the session-memory/SESSION-STATE.md file and the brief HTML located at scope-of-work/<slug>-project-brief.html to validate and unlock the next pipeline steps.

How does approving a brief unlock the next steps in project management?

Approving a brief transitions the pipeline stage to BRIEF_APPROVED, which immediately unlocks the /build-scope-of-work command and reveals other valid downstream commands to continue the project workflow.

Can I mark brief sections as TBD to pass the project brief quality gate?

Yes, the brief quality gate allows sections to be marked as TBD, but it will strictly refuse approval if any of the 13 required sections are entirely missing or still contain unaddressed placeholders.

Why is audit logging important when locking project briefs?

Audit logging is important when locking project briefs because it appends traceability records to the session-state, ensuring reliable tracking of the BRIEF_DRAFT to BRIEF_APPROVED transition for project management compliance.