agentleFS
fabioc-alohafabioc-aloha/Alex_ACT_ONE/skills/big-idea/SKILL.md

big-idea

Skill0 starsChanged 9 days agoMITView on GitHub

Distill the central claim before authoring any summary-shaped output: hero copy, commit-message subject, PR title, ADR title, slide title, executive summary, skill description, abstract. Length is format-dependent (1 sentence for titles, up to a short paragraph for complex theses), tested against the Saint-Exupéry rule (remove sentences until removing another would break the claim). Chart summaries use the bundled chart-big-idea skill.

1 other project uses a version of this.

Adopted by

Most recently taken up by

The file

We split this skill into the rules it gives an agent

4 rules. About 0 are common, 4 are distinctive, and 0 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈4

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 0

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Test: if someone read only this sentence and nothing else, what would they know that they didn't before?

    line 50
  2. Distinctive:

    Test: read the draft and ask _"so what?"_ If nothing changes for the reader, revise.

    line 71
  3. Distinctive:

    No TOC enumeration: no bulleted-list-as-sentence.

    line 106
  4. Distinctive:

    No compression theater: if a semicolon or colon is doing the work of a full stop and the second clause could stand as its own sentence, …

    line 108

≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Big Idea

"Perfection is achieved not when there is nothing more to add, but when there is nothing left to take away." — Antoine de Saint-Exupéry, Terre des hommes (1939)

Distill the central claim before authoring any summary-shaped output. Every hero subtitle, commit subject, PR title, ADR title, slide title, executive summary, and skill description should carry a Big Idea: a testable thesis that answers "what changes for the reader?", not an enumeration of what's inside the artifact.

Generalized from chart-big-idea, which specializes this discipline for chart authoring. This skill covers everything else.

When to Fire

ContextBig Idea IS...
Hero copy (doc subtitle)The doc's thesis
Commit-message subjectThe change that matters, not the file diff
PR titleThe reviewer's decision-changer
ADR titleThe boundary the decision draws
Slide titleThe claim the slide argues
Executive summary abstractThe one thing the reader needs from the memo
Skill description (frontmatter description field)The "what + when" that makes discovery work
Meeting agenda itemThe decision the discussion should produce
Blog post headlineThe claim the post argues (not the topic it covers)

When NOT to Fire

  • Plain body prose — Big Idea authoring is for headlines, not paragraphs. Body prose defends the Big Idea; it isn't one.
  • Bullet lists inside a doc — each bullet doesn't need its own thesis. The section header carries the Big Idea if any bullet does.
  • Code comments — unless the comment IS a thesis (rare — most code comments explain how, not why anything changes).
  • README intro paragraphs — those get to be longer than one sentence. Use Big Idea for the README's title tagline, not its opening paragraph.
  • Chart workflow — when called by chart-big-idea, complete the shared distillation here and return the claim, audience, and stance. Do not load chart-big-idea again: the caller owns the Chart Brief and chart-specific constraints.

The four-step distill (plus emit)

Skipping any step is why summaries drift back to tactical enumeration. Run all four before writing the sentence.

1. Read for an existing Big Idea

Scan the source artifact (doc body / commit diff / ADR argument / slide content) for the central claim already stated. Often the Big Idea is buried in a middle paragraph or half-said in a conclusion. If it's there, extract; if not, distill from scratch.

2. Distill the claim

What is THE one thing this artifact argues? Not "what topics does it cover" — what claim does it make?

Test: if someone read only this sentence and nothing else, what would they know that they didn't before?

3. Story arc

Name the narrative shape — it informs the sentence's grammar and tense:

ArcSignalBig Idea shape
Chronological"we did X, then Y, then Z""Migration X taught us Y" — past tense, cause + lesson
Comparative"A vs B; here's why we picked A""A costs less than B because C" — contrastive
Prescriptive"here's what to do next""Do X before Y or you'll hit Z" — imperative
Cautionary"here's what to avoid""Skipping X guarantees Y" — warning
Diagnostic"here's what broke and why""Bug X was caused by Y; fix is Z" — analysis

4. Audience + stakes

Who reads this artifact, and what changes for them?

  • A Big Idea that names the reader's decision (implicitly or explicitly) is thesis-shaped.
  • A Big Idea that names only the topic is TOC-shaped.

Test: read the draft and ask "so what?" If nothing changes for the reader, revise.

5. Stance

Is this Big Idea:

  • Consolidating consensus — confirming what the reader already believes. Safer, less punchy, room for qualifiers.
  • Challenging a norm — contesting a default assumption. Higher risk, higher payoff, strip qualifiers.

Analogous to TRADITIONAL vs. INNOVATIVE in chart-big-idea. The stance sets qualifier budget: consolidating leaves in "often"/"usually"; challenging strips them out.

6. Emit and compress

The Saint-Exupéry rule is the actual gate. Draft the Big Idea, then apply the removal test: try deleting each sentence. If deleting it leaves the claim intact, delete it. Repeat until removing another sentence would break the claim. What remains is the Big Idea.

Length ceiling depends on format:

FormatNatural ceilingWhy
Chart caption1 sentenceThe chart carries the payload
Commit subject / PR title1 sentenceFormat-imposed by git / email
ADR title1 sentenceIndex-scanning convention
Slide title1 sentenceReader is glancing
Hero copy / doc subtitle1–3 sentencesReader is scanning; three beats before commitment
Executive summary / abstract2–4 sentencesReader has committed; density is the point
Complex-thesis Big IdeaShort paragraphSome claims genuinely need setup + insight + qualifier

Count the draft's sentences with the script, not by eye: node scripts/count-sentences.cjs <draft-file> --ceiling <N>, where N is the format's ceiling from the table above. The gate reads the script's count.

Discipline for every sentence that survives the removal test:

  • Answers "what changes for the reader?"
  • Names a specific claim, not a topic so the claim is testable.
  • Someone could reasonably argue against it; if not, it's a truism, not a thesis.
  • Concrete over abstract: carry a name, number, or contrast where possible.
  • No TOC enumeration: no bulleted-list-as-sentence.
  • No hedge stacking: pick one hedge or none.
  • No compression theater: if a semicolon or colon is doing the work of a full stop and the second clause could stand as its own sentence, split it. Compression is real only when the removal test would break the claim.
  • American English by default (if your project defines a language rule in copilot-instructions.md, follow it — Alex ACT itself uses American English). Use color, behavior, center, catalog, license, analyze, favor, honor, defense. Avoid colour, behaviour, centre, catalogue, licence, analyse, favour, honour, defence. Three carveouts stay: the [behaviour] commit-tag API string, ACT framework canonical terms, and ported material that retains its source spelling.
  • No AI-tells. Alex ACT bans em-dashes as sentence separators in shipped prose; the full 29-pattern catalog is in humanizer. No em-dashes as sentence separators (use commas, colons, semicolons, parentheses, or full stops instead); no filler intensifiers (comprehensive, robust, leverage, seamlessly, delve into, tapestry, weave, testament); no load-bearing as a synonym for important / central / key (see humanizer Pattern 7 for the technical-vs-decorative carveout); no performative openers (Certainly!, Great question!, Let me...); no meta-description (This document explains..., The following is...); no ceremonial rule-of-three parallelism used as decoration rather than argument. The fixed-string part of this check (banned intensifiers, performative openers, meta-description, em dashes) is mechanical: run node scripts/lint-ai-tells.cjs <draft-file> and read its hits instead of scanning by eye. The judgment tells (rule-of-three, compression theater) stay with the reader.

Anti-patterns

Anti-patternSymptomRewrite discipline
TOC enumerationLists chapters instead of naming the claimAsk: "what does the doc argue?" — write that.
Position statementNames what the doc IS without saying what it CLAIMSAdd the "so what?" — what changes because of this thing?
Poetic count-upRhythmic but content-free ("one brain, five regions, five loops...")The rhythm is style, not substance. What's the argument?
Feature enumeration"A · B · C · D" separated by middotsMiddots hide missing thesis. Pick one claim; defend with the features in body.
OverpromiseClaim exceeds what the artifact deliversRead the body and cut back to what it actually earns.
Hedge stacking"May", "could", "often", "usually" all in one sentencePick one hedge or none. Multiple hedges signal you don't believe your own claim.
Passive voice on the verb"Improvements were made to X"Big Ideas have subjects. "X now Y because Z."
Meta-description"This doc explains..."Skip the "this doc explains" and just make the claim.
British spelling"colour", "behaviour", "centre", "catalogue", "licence"American English by default. Three carveouts stay: [behaviour] API tag, ACT framework canon, ported material.
AI-tell vocabulary"comprehensive", "robust", "leverage", "seamlessly", "delve into", "tapestry", "weave", "testament"Strip. See humanizer for the 29-pattern catalog and voice replacements.
Em-dash as sentence-separatorEm-dash standing in for a colon, semicolon, or full stopBanned in shipped Alex ACT prose. Use a colon (for "here's why"), a semicolon (for a paired thought), parentheses (for a side note), or split the sentence.
Performative preamble"Certainly!", "Great question!", "Let me..." before the claimSkip the throat-clearing. The Big Idea is the first word.
Compression theaterSemicolon or colon doing the work of a full stop; second clause is either a re-worded first clause or would earn its own sentenceApply the removal test. If the second clause is a full stop in disguise, split it. If both clauses say the same thing, delete the redundant one.

Worked examples

From the 2026-07-28 hero-copy sweep on this repo. Note the shape: before is enumeration of contents; after is a compressed thesis (one or two sentences, per the removal test) with a subject verb and a because or so.

DocBefore (tactical)After (Big Idea)
plan/plan"From heir-template to plugin-native — every folder, cloud store & identity that touches this box""The v1 template lineage costs too much to maintain per heir. Migrating to Copilot CLI plugins moves complexity from twenty-five heirs back to one source."
docs/act"Manifesto · 10 tenets · claims registry · failure modes · engineering binding · curation rules""AI is trained to agree with you. ACT is the discipline that makes it push back on the claims that matter."
operations/fleet"Heir markers · hybrid local+GitHub inventory · dashboard · reports""Fleet is visibility, not control. Steward never mutates a heir, so the dashboard reports what heirs decide, not what Steward wants."
plan/fundamentals"One brain, five regions, five loops, seven primitives, ten tenets, one dial, one fleet""Every capable AI partner runs the same seven cognitive primitives. Naming them turns AI craft into engineering."

Cross-domain examples (not from a real commit — showing the shape)

Commit-message subject (arc: diagnostic; stance: challenging):

  • Before: refactor: update fetch logic to handle timeouts
  • After: [behaviour] fetch: 3s timeout replaces indefinite hang on unreachable release

PR title (arc: prescriptive; stance: consolidating):

  • Before: Update dependencies
  • After: Bump marked to 12.0.0 to unlock the token-object renderer API needed by mermaid-in-code-fence support

ADR title (arc: comparative; stance: challenging):

  • Before: ADR-014: Mall v1 to v2 migration approach
  • After: ADR-014: Mall in-place bump to 3.0.0 (not fork-and-freeze) because 5 of 25 heirs currently route through the affected surface

Related

  • chart-big-idea — chart specialization. Both skills share the same six-step arc with offset numbering: chart-big-idea Step 0 (read context) → this skill's Step 1; chart-big-idea Steps 1-4 → this skill's Steps 2-5; chart-big-idea Step 5 emits a Chart Brief while this skill's Step 6 emits prose.
  • Skill descriptions ARE Big Ideas — the frontmatter description field's "what + when" is the thesis + trigger of the skill's Big Idea.
  • communication-craft — sibling skill for feedback, audience, and elicitation. Communication craft frames the whole message; Big Idea frames only the headline.
  • humanizer — the 29-pattern AI-tell catalog and voice replacements. Big Idea authoring routes through humanizer for the AI-tell check before emit.
  • problem-framing-audit — different discipline: audit the frame BEFORE solving. Big Idea distills the claim AFTER solving. Both cite the same "is this the right thing?" test but at different phases.

Falsifiability

This skill has failed if any of the following occur:

  • Decorative steps: the four-step distill (context read → claim → arc → stance → emit) consistently produces identical output to skipping steps 3–5 — the extra steps are ritual, not method
  • Drifts from parent: chart-big-idea upstream evolves in a way this skill can't accommodate — the specialization relationship broke

Would Revise If

  • A domain surfaces where step 3 (story arc) doesn't map cleanly to the five listed arcs → extend the table with the missing arc, or reduce to arcs-are-optional guidance

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.