Skip to content
Back to skills

Brief

ASecurity

Use when a problem, idea, or change of intent is worth capturing, or the person asks to write it up or file an issue. Never chooses a solution.

  • 9 stars
  • 0 votes
  • 0 copies
  • 0 views
  • Added September 23, 2026
ai-agentsgo

Security analysis

A100/100

Pro scans all 3 files and shows the line behind each finding

Scanned September 25, 2026

npx -y skills add greenfield-inc/agent-farm --skill brief --agent claude-code

Installs into .claude/skills of the current project.

Are you the author of Brief?

Add the live security badge to your README. It updates with every re-scan.

Security grade badge for Brief
[![Security: A — Skills Directory](https://www.skillsdirectory.com/api/skills/greenfield-inc-brief/badge)](https://www.skillsdirectory.com/skills/greenfield-inc-brief)

More formats (shields.io, HTML) on the badges page. Keep it an A: scan every change in CI with Pro.

Download with Pro
SKILL.md
---
name: brief
description: Use when a problem, idea, or change of intent is worth capturing, or the person asks to write it up or file an issue. Never chooses a solution.
---

# Brief

A brief says what is wrong or wanted, for whom, and how a user would know it is solved. It survives a change of approach, because it contains no approach. Alternatives belong in the options document. Steps belong in the plan.

## Capture the intent

- Preserve the person's language and constraints. Ground every statement in a source: the conversation, an issue, a bug report, the code.
- Keep four things visibly apart: facts, decisions already made, proposals, and open questions. Label suspected causes and unmeasured impact as such.
- Capture the trigger: what happened, what was expected, and what it costs. For a new idea, capture the unmet need.
- When the request arrives with a solution attached ("add patches to cut editing costs"), look at the actual behaviour and cost first, and write the problem underneath it.
- Ask what is missing instead of inventing it: what prompted this, who is affected, what a good result would enable, what would make the current approach good enough.
- Read the code or send `investigator` one question when a fact about today's behaviour is needed. Give the child just that question.
- Research settles behaviour, never approach. A researched answer about what a user observes goes in as a labelled proposal with its source, pending the person's confirmation; anything about how it is built is only named here and argued in the options document.

## When intent changes

Revise the same brief. Mark the earlier goal as superseded, cite the decision that replaced it, refresh success and constraints, and add a change-log line. Keep constraints that still hold. If what changed is only the approach, the brief does not change: that belongs in the options document.

## One brief or several

Keep one coherent outcome together. Split work that has independent outcomes, owners, or release timing, and link the shared context.

## Layout

An HTML page for a person, rendered with the `page` house standard. Layout: [references/brief-layout.md](references/brief-layout.md). Someone who was not in the conversation should understand the problem in a minute.

## Save and link

Draft freely during discussion. Save or publish only when the person asks or confirms it is ready. Filing an issue does not mean work starts. When you save, follow [references/saving.md](references/saving.md): the bundle first, the tracker issue when they use one, then read back what you saved.

## Ready check

Before calling it ready, read it as the person who will pick it up: can they say what is wrong, why it matters, how success is observed, and which decisions are still open? Set the status chip accordingly. The planner sends the brief to `socrates` when the person is ready to choose a direction.

## Banned

- An architecture or implementation presented as decided
- Acceptance criteria written as implementation steps
- Work packages, file lists, or a plan

Files in this skill

  • SKILL.md3 KB
  • references/brief-layout.md1.5 KB
  • references/saving.md971 B

Attribution

Is this your skill, or is something wrong with this listing? Request removal or report an issue. Author removals are honored within 72 hours.

View all in ai-agents →

Comments

Loading comments…

Newsletter

Get the weekly list of safe new skills, and the ones we pulled.