brief-the-piece
The agent opens the work by telling everyone who will write, draw or promote the same thing at the same time: what is wanted, what is changing, and when it is due. Use it when running `ref/mkt/award-e
SKILL.mdplugins/editor/skills/brief-the-piece/SKILL.md
GitHubBrief the piece
What it does
The agent opens the work by telling everyone who will write, draw or promote the same thing at the same time: what is wanted, what is changing, and when it is due.
Where it happens
The agent does this in seven activities across nine reference processes. Each one names the activity as that process words it.
- Brief the Agents that Write to It
ref/mkt/brand-voice, activity 17 - Define Brand Voice and Messaging
- Brief the Department
ref/mkt/content-calendar, activity 13 - Plan Content Calendar
- Brief the Entry
ref/mkt/award-entry, activity 5 - Submit Award Entry
- Brief the Makers
ref/mkt/brand-guidelines, activity 4 - Publish Brand Guidelinesref/mkt/brand-voice, activity 4 - Define Brand Voice and Messagingref/mkt/customer-newsletter, activity 5 - Publish Customer Newsletterref/mkt/landing-page, activity 4 - Publish Landing Page
- Brief the Pages in the Cycle
ref/mkt/refresh-content, activity 10 - Refresh Published Content
- Brief the Piece
ref/mkt/long-form-content, activity 3 - Produce Long-Form Content
- Brief the Story
ref/mkt/customer-case-study, activity 6 - Produce Customer Case Study
What to record
Every edit at a version, saying what has to change and why, item by item, in terms the writer can work through without coming back to ask what was meant. A line for anything it flagged for another pass, naming the agent it went to. When it holds the version, the merge, the decline or the revision request it gave in every round, each with its reason.
That contract covers every activity this abstract agent takes on, and it
is repeated in com.agentcatalog.agent/RECORDS.md. What the abstract
agent does not do is in com.agentcatalog.agent/NOT.md.