brainstorming
brainstorming
You MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation).
suede-newsroomSuede-owned editorial pipeline for agent-run content: six roles with written contracts, one inspectable record that travels between them, and a distribution stage that gives every asset its own argument instead of a shorter draft. Use when content agents return generic, duplicated, or unsourced work, when one flagship piece has to carry a week of distributi…
Independent GitHub snapshot · Automated classification · Original documentation governs
Six chatbots pointed at the same brand are not a content team. A newsroom is the loop that connects them, and every arrow in it is a handoff with a contract:
idea -> research -> angle -> flagship -> distribution -> review -> performance -> playbooks
Break one arrow and the failure is predictable, not mysterious:
| Broken arrow | What ships instead |
|---|---|
| research never reaches the strategist | a generic angle any competitor could have written |
| the writer never sees the evidence packet | claims that drift one step past what the source says |
| distribution starts from the finished draft | five surfaces carrying the same shortened article |
| performance never reaches the playbooks | the same mistake repeated at a higher cadence |
This skill owns the pipeline: who decides what, what travels between them, and
how one idea becomes several assets that argue different things. Read
.agents/product-marketing.md first if it exists: it holds product, audience,
positioning, and proof, and nothing here restates it.
Founder-led mode. When the recurring source is a founder interview, voice note, or operator debrief, or when personal and company accounts need different jobs, read references/founder-content-loop.md before Step 1. It adds an intake contract and account lanes to this pipeline; the six role contracts, evidence gates, collision checks, approval boundary, and Keep/Test/Stop thresholds below remain unchanged.
One record per campaign at .agents/newsroom/<slug>.md. It is the only thing
that has to survive between roles, sessions, and restarts.
A conversation between roles has two failure modes a file does not: context dies on restart, and the next role has to infer which sentences were load-bearing. The record gives each role a predictable input and lets a human audit a campaign without reopening six sessions.
Keep it narrow, decisions and the evidence behind them. Drafts live beside it, not in it. The template and per-stage completion rules are in references/campaign-record.md.
The fastest way to ruin a multi-agent content team is to hand every role the same instruction: make great content. Each role gets one decision, one artifact, and a named point where it stops.
| Role | Owns | Returns | Hands to |
|---|---|---|---|
| Signal scout | whether an idea has a reason to exist now | scored candidates | researcher |
| Researcher | what is verified versus inferred | evidence packet | strategist |
| Strategist | the single editorial angle | angle brief | writer |
| Writer | the deepest version of the idea | flagship piece | distribution |
| Distribution | what each surface argues | asset set with entryways | editor |
| Editor | whether the package holds together | approve, revise, or reject | human |
Every contract fills five fields: owns, reads, returns, must
not, done when. Full text for all six, with the must not and done when
clauses, is in references/role-contracts.md. Copy
them in verbatim; a paraphrased must not is how a writer starts picking angles.
Thresholds that make the contracts checkable:
what the sources do not prove list.A stage is complete when every field it owns is filled and readable by the next role: not drafted, not discussed. Written into the record.
Return-to-sender. When a field the current stage needs is empty, the role sends the record back and names the field. It does not fill the gap with a plausible assumption. A pipeline whose roles patch each other's gaps produces confident output with no traceable source, which is worse than a stalled campaign because nothing signals the problem.
Halt format. Stop. Name the empty field and the stage that owns it in one line. Offer the human these options and wait: (1) supply the field now, (2) send the record back one stage for another attempt, (3) narrow the campaign until the field is unnecessary, or (4) kill it. Do not advance the record, and do not present a partial package as complete.
Two returns on the same field means the pipeline cannot supply it. Escalate rather than attempting a third pass: a third attempt on the same gap is where fabrication starts.
This is the stage that fails most often, and it fails quietly.
An article does not become a short post by losing 1,500 words, and a newsletter does not become a carousel because its paragraphs were laid onto slides. Both moves produce assets carrying the same argument at different lengths: which is why a week of them reads like one post repeated.
Work from the angle brief, not the finished draft. A draft carries one argument, so anything derived from it inherits that argument. Reading the draft first is the mechanism that produces shortened articles.
| Entryway | The argument it makes | Needs |
|---|---|---|
| Proof | this is real, and here is the artifact | something a stranger can check |
| Mechanism | here is why it works | a causal chain, not a description |
| Workflow | you can run this today | ordered steps someone could follow |
| Risk | here is what breaks, and when | a named failure mode with its trigger |
| Result | here is what it produced | an outcome plus its conditions |
| Critique | the common approach is worse than it looks | the real default, and how it fails |
| Compression | here is the whole shape | the idea reduced to one line or image |
One entryway per asset. An asset carrying two is a shortened article wearing a label. An entryway the source cannot supply is unavailable, report it and say what evidence would unlock it, rather than inventing an artifact to fill it.
Worked examples, surface fit, and the failure mode each entryway falls into are in references/entryways.md.
Three checks, one point each, run against the whole set:
| Check | Passes when |
|---|---|
| New information | it carries a claim, step, number, or object no other asset carries |
| Second reader | someone who already read the flagship still gets something; "more at the link" is not something |
| Removal | deleting it costs the campaign a specific, nameable thing |
3 ships. 2 goes back for revision, naming the failed check. 0–1 gets cut, and say what the set loses, usually nothing.
Reduce each asset to one sentence first; comparing full drafts hides collisions.
Halt format. Stop. Name the two assets, the collision type, and the shared sentence. Offer: (1) reassign one to an unused entryway, (2) cut the weaker and say what the set loses, or (3) record it as a deliberate repeat with a reason. Wait. Do not resolve a collision by rewording: the claim underneath is what collides.
Fewer surfaces than entryways is normal. Three assets with three distinct entryways beats seven assets with two.
The first version prepares everything and publishes nothing. The human approves the angle, the flagship draft, every consequential factual claim, every public post, any change to voice or offer, and any performance lesson before it becomes a standing rule.
Each approval and rejection is a labelled example of the human's judgment. When the same decision comes back the same way three campaigns running, move it into the editor's review rules so it is applied before the human sees the package.
Move publishing authority only when both hold: the queue has produced no revisions for three consecutive campaigns, and a wrong post is recoverable by deleting it. Autonomy should remove repeated decisions, not remove taste.
Reporting numbers is not learning. After each campaign log the signal, angle, entryway, surface, reach, meaningful engagement, and the goal-linked action. Then have the editor return three lists:
| List | Bar to qualify |
|---|---|
| Keep | held across two or more campaigns and still matches strategy |
| Test | one promising result: a hypothesis, run it again |
| Stop | failed twice, duplicated another asset, or cost more than it returned |
Every proposal names the campaigns supporting it. One strong result is a Test, never a Keep. The human approves before any rule changes. Without this arrow, every campaign starts from the same generic prompt forever.
Log by entryway, not only by surface, over a few campaigns that reveals which door the audience actually walks through, which is more useful than which platform performed.
Six roles is the model, not a hosting requirement.
| Host | Roles map to | What breaks |
|---|---|---|
| One session | one pass per role, record reread between | role bleed: it edits its own draft |
| Subagents | one per role, dispatched in stage order | cost, if each drags full context |
| Separate profiles | one per role, isolated memory | drift, if they coordinate by chat |
| One person | one sitting per role, in order | nothing; this is the honest first week |
Two rules survive every host. Conversation coordinates; files carry state. And isolate role memory where the host allows it: one shared memory turns six specialists back into one generalist that has read everything and distinguishes nothing.
Stand up scout, researcher, and editor first, and run three real ideas through them. Add the strategist once two of three evidence packets need no rework, the writer once the briefs constrain a draft without further questions, and distribution once one flagship has shipped and been measured.
The first useful version returns one researched opportunity, one angle brief, and one approval-ready post with a source attached. That is already more than most content operations produce.
Avoid "fully autonomous media company", "content on autopilot", "replaces a marketing team", "repurpose", "atomize", and "one piece into fifty posts". The first three hide the approval steps; the last three describe reformatting, and naming the work that way produces the work. Say which argument each asset makes.
suede-content-strategy. That skill decides what it operates on; this one
decides how it moves.suede-social. Instagram-specific programs -> use
suede-instagram-growth.suede-marketing-loops.suede-ship-copy.
A single shorter surface -> use suede-copy.suede-clip-to-guide.suede-deslop.suede-analytics.suede-ad-creative.suede-agent-teams. This skill covers editorial lanes, not repository lanes.suede-content-strategy and suede-social: route role contracts, the
handoff record, and entryway assignment back here.