Create targeted brief
create_briefWrite a Markdown brief to hand a scoped task to another agent: set the goal, scope, exclusions, and design basis, while avoiding chat history and out-of-project files.
Instructions
Use when the user wants a scoped task written down for another agent or session: this writes a new brief Markdown record under .notch/briefs/ from the fields you supply and returns the record with its path. It stores only what you pass — it never reads chat history — and it refuses scope files outside the project root or content the secret scanner flags.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| goal | Yes | What the target agent should accomplish; rendered as the brief's goal section. | |
| tags | No | Lowercase slug tags (a-z, 0-9, hyphen) for later filtering; must be unique. | |
| scope | Yes | Boundaries of the work: in-scope topics, in-scope files, and an optional timeframe. | |
| title | Yes | Short human-readable title for the brief; also used to build the stored filename. | |
| actorName | No | Name recorded as the author of this write; defaults to the server's configured actor, or 'mcp-client'. | |
| exclusions | Yes | Out-of-scope items and known pitfalls; rendered as the brief's Known Pitfalls list. | |
| constraints | No | Hard limits the target agent must respect; accepted for compatibility but not written into the record by the MCP server — put binding limits in designBasis or exclusions. | |
| designBasis | Yes | The reasoning and constraints the current design rests on, so the target agent does not relitigate settled ground. | |
| targetAgent | Yes | Agent or role this brief is written for; slugified into the filename and matched exactly by the list_briefs targetAgent filter. | |
| relevantFiles | No | Source links worth reading (kind: file, url, commit, issue, record, command, or repo); file links must resolve inside the project root. | |
| recommendedNextSteps | No | Concrete next actions; rendered as the brief's Recommended Next Steps list. | |
| priorReasoningSummary | Yes | Condensed record of decisions already made and why, carried forward instead of raw conversation. |