prd-agent-brief

Generate formal sub-agent invocation briefs with safety constraints and ownership contracts.

2|Updated Mar 23, 2026
One-click install
npx skills add https://github.com/yesplease-studio/prd-please --skill prd-agent-brief
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: prd-agent-brief
Source: https://github.com/yesplease-studio/prd-please/tree/main/skills/prd-agent-brief
Command: npx skills add https://github.com/yesplease-studio/prd-please --skill prd-agent-brief

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill automates the creation of a formal sub-agent invocation brief, unifying safety contracts, ownership rules, and permission envelopes so orchestrators can spawn sub-agents with confidence and traceability.

Core Features & Use Cases

  • Automatic brief generation from a standard template that enforces file-ownership, runaway mitigation, and role-based permissions.
  • Slot collection and validation to ensure all required fields (task, role, project_scope, may_write, may_not_touch, token_budget, context_pack, success_criteria) are present before composition.
  • Operational readiness for spawns in the build loop or when prep for prd-validator/prd-learner invocations.

Quick Start

Provide the task, role, and project scope to generate the brief.

Frequently Asked Questions about prd-agent-brief

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

FAQPage Schema
How do I generate a sub-agent brief with safety constraints and file ownership rules?

To generate a sub-agent brief, provide the task, role, and project scope. The system collects required slots like file ownership, token budgets, and success criteria, then fills a fixed prompt template to output a ready-to-submit invocation brief.

What is a sub-agent invocation brief and when do I need one?

A sub-agent invocation brief is a formal prompt that binds an orchestrator to safety constraints and ownership contracts. You need one when spawning implementation, validator, or learner sub-agents within a build loop to ensure traceability and safe execution.

How do I enforce token budgets and file permissions when spawning sub-agents?

You enforce token budgets and file permissions by generating a formal brief that validates file ownership, sets permission envelopes, and defines runaway mitigation rules before the sub-agent is spawned in the build loop.

Can I use sub-agent briefs for validator and learner sub-agents?

Yes, you can use sub-agent briefs for validator and learner sub-agents. The brief generation process applies to any sub-agent invocation within a build loop, ensuring all required metadata and safety contracts are present.

What are the limitations of automated sub-agent brief generation?

The brief generation requires all mandatory slots—including task, role, may_write, may_not_touch, and context_pack—to be present before composition. It cannot generate a valid brief if any required metadata field is missing or invalid.