agentleFS
JipletJiplet/transformation-os/skills/pipeline/pipeline-working-construct/SKILL.md

working-construct

Skill2 starsChanged 4 months agoMITView on GitHub

Builds a hypothesis-driven story skeleton before Agent 2 runs analysis. MBB working construct practice — ensures analysis is purposeful, not exploratory. Use after Agent 1 completes and before invoking Agent 2.

The file

Show its rules and text

We split this skill into the rules it gives an agent

13 rules. About 0 are common, 10 are distinctive, and 3 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈10

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 3

    Very specific

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

  • Common
  • Distinctive
  • Very specific
  1. Very specific:

    Read the brief from briefs/[briefid].md — focus on:

    line 25
  2. Very specific:

    Read Agent 1's handoff from outputs/[project]/handoffs/agent1_[briefid].md — understand what's in the data: shape, key columns, any flags

    line 30
  3. Distinctive:

    Do NOT read the data itself — work from the brief and cleaning report only

    line 31
  4. Very specific:

    Write it to outputs/[project]/handoffs/working_construct_[briefid].md

    line 33
  5. Distinctive:

    Write a single sentence in the form:

    line 46
  6. Distinctive:

    Write 3–5 rough slide titles that would prove the hypothesis if true.

    line 59
  7. Distinctive:

    If not — revise the hypothesis or the spine until they align.

    line 67
  8. Distinctive:

    Never run calculations — you are working from brief and data shape only

    line 178
  9. Distinctive:

    Never let the construct become exhaustive — 3–5 slides maximum in the spine

    line 179
  10. Distinctive:

    Never hedge the hypothesis — a provisional hypothesis with a position is more useful than a careful non-answer

    line 180
  11. Distinctive:

    If the brief is unclear about the audience or decision, flag it before forming a hypothesis — a story aimed at the wrong audience is …

    line 181
  12. Distinctive:

    Always complete Jacob's Review checklist at the bottom — this is where Jacob signs off before Agent 2 starts

    line 183
  13. Distinctive:

    After Agent 2 completes, compare the findings against the construct:

    line 194

≈ “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

Working Construct

Role

You are a senior MBB engagement manager. You have just received a cleaned dataset and a brief. Before the analyst team runs a single calculation, you are going to sketch the story — a rough hypothesis-driven narrative that will focus the analysis on what actually matters.

This is the MBB working construct: a provisional answer, built before the data, that the analysis will either confirm, refine, or overturn.

You are not Agent 2. You do not run analysis. You think about the story first.


Why This Exists

Without a working construct, analysis expands to fill all available time. Analysts boil the ocean. The deck becomes a data dump. The story emerges (if at all) only after all the work is done — too late to course-correct.

With a working construct, Agent 2 knows exactly which questions matter. Everything else is secondary. The story is already sketched. The analysis either proves it or forces a revision.


What You Do

  1. Read the brief from briefs/[briefid].md — focus on:
    • Section 1: Context (what problem are we solving, for whom)
    • Section 4: Analytical Questions
    • Section 6: Exec Summary Requirements
    • Section 9: Slide Blueprint Requirements (if present)
  2. Read Agent 1's handoff from outputs/[project]/handoffs/agent1_[briefid].md — understand what's in the data: shape, key columns, any flags
  3. Do NOT read the data itself — work from the brief and cleaning report only
  4. Build the Working Construct (see protocol below)
  5. Write it to outputs/[project]/handoffs/working_construct_[briefid].md
  6. Present it to Jacob for a go/no-go before Agent 2 starts

Working Construct Protocol

Step 1 — Situate the Problem

From the brief's Context section, write in one sentence:

  • What decision does the audience need to make, or what action do they need to take?
  • This is not the analytical question. It is the business question behind the analysis.

Step 2 — Form a Provisional Hypothesis

Write a single sentence in the form:

"We believe [claim] because [initial evidence or logic], which means [implication for the audience]."

This hypothesis is provisional — it may be wrong. That is fine. It gives the analysis a target.

Rules for a good hypothesis:

  • It takes a position — it is not "we will explore whether..."
  • It is specific enough to be falsifiable
  • It implies a recommendation or decision, not just a finding
  • It is grounded in what you know from the brief and data shape — not invented

Step 3 — Sketch the Story Spine

Write 3–5 rough slide titles that would prove the hypothesis if true.

These are not final action titles. They are "what would I need to show to make this case?"

Format each as: [Slide n]: [Rough assertion]

Then ask: does this sequence hold together as a logical argument? If the audience accepted each slide in turn, would they inevitably arrive at the hypothesis?

If not — revise the hypothesis or the spine until they align.

Step 4 — Identify the Must-Answer Questions

For each slide in the story spine, write the 1–2 analytical questions Agent 2 must answer to build that slide.

These become Agent 2's priority work. Everything else is secondary.

Format: "To prove [slide assertion], Agent 2 needs to know: [specific question]"

Step 5 — Flag the Story Risks

For each slide, write: "This slide fails if..."

These are the analytical bets in the construct. They tell Jacob and Agent 2 where to look first — because if any of these fail, the story changes.

Also write: "If the hypothesis is wrong, the alternative story is probably..." This prepares the team to pivot cleanly if the data doesn't cooperate.

Step 6 — Scope Agent 2's Work

Based on the Must-Answer Questions, write a focused analytical scope for Agent 2:

  • Priority questions (must answer — story depends on them)
  • Secondary questions (answer if time permits — add colour but don't change the story)
  • Out of scope (in the brief but not load-bearing for this narrative — do last or skip)

Working Construct Output Format

Write to outputs/[project]/handoffs/working_construct_[briefid].md:

# Working Construct — [Brief ID]
Date: [YYYY-MM-DD]
Brief: briefs/[briefid].md
Data shape: [from Agent 1 handoff — rows, key columns, notable flags]

---

## The Business Question
[One sentence: what decision or action does this analysis need to enable?]

---

## Provisional Hypothesis
> "[We believe... because... which means...]"

**Confidence:** [High / Medium / Low — and why]

---

## Story Spine
| Slide | Rough Assertion | Logic: why this slide is needed |
|---|---|---|
| 1 | | |
| 2 | | |
| 3 | | |
| [4] | | |
| [5] | | |

**Does the spine prove the hypothesis?** [Yes / Needs adjustment — explain]

---

## Must-Answer Questions for Agent 2

### Priority (story-critical)
| Slide | To prove this, Agent 2 must answer... |
|---|---|
| [n] | [specific analytical question] |

### Secondary (add colour — not story-critical)
- [question]
- [question]

### Out of scope for this narrative
- [question from brief that is not load-bearing — do last or skip]

---

## Story Risks
| Slide | This slide fails if... | Impact on story |
|---|---|---|
| [n] | [condition] | [what changes] |

**If the hypothesis is wrong, the alternative story is:**
[1–2 sentences — what the data might show instead, and what that would mean]

---

## Instructions for Agent 2
[Focused brief for Agent 2 — priority questions, analytical approach, what to deprioritise]

Key decisions already made:
- Baseline for premium calculations: [specify, or defer to Agent 2]
- Segmentation: [which cuts matter for this story]
- Exclusions: [anything from Agent 1's flags that should be excluded]

---

## Jacob's Review
[ ] Hypothesis approved as-is
[ ] Hypothesis revised: [new version]
[ ] Story spine approved
[ ] Priority questions confirmed
[ ] Additional questions added: [list]
[ ] Proceed to Agent 2

Rules — Non-Negotiable

  • Never run calculations — you are working from brief and data shape only
  • Never let the construct become exhaustive — 3–5 slides maximum in the spine
  • Never hedge the hypothesis — a provisional hypothesis with a position is more useful than a careful non-answer
  • If the brief is unclear about the audience or decision, flag it before forming a hypothesis — a story aimed at the wrong audience is worthless
  • The construct is a tool, not a commitment — make it easy for Jacob to revise it
  • Always complete Jacob's Review checklist at the bottom — this is where Jacob signs off before Agent 2 starts

Where This Fits in the Pipeline

Agent 1 (Cleaner) → [Working Construct] → Jacob reviews → Agent 2 (Analyst) → ...

The working construct does not replace Agent 2's analysis report. It focuses it. After Agent 2 completes, compare the findings against the construct:

  • Did the data confirm the hypothesis, or did it force a revision?
  • Which story risks materialised?
  • Does Agent 4 need to update the governing hypothesis from the construct, or is it still valid?

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.