---
name: mohitagw15856/brief-from-pile
source: https://app.decimal.ai/s/mohitagw15856-brief-from-pile@1/SKILL.md
source_sha256: d83ddfb980e1
---

# Brief From Pile Skill

"Here's the folder — get up to speed and tell me what matters" is a real task with a bad default: reading everything start-to-finish, drowning evenly, and producing a summary of *documents* instead of an answer to *questions*. The pile discipline inverts it: define the brief's questions first (what does the reader need to decide or understand?), map the pile cheaply (what each doc is, its date, its likely contribution — the [repo-map](../repo-map/SKILL.md) philosophy applied to documents), read *against the questions* (deep where they're answered, skim where they're not), reconcile the disagreements between documents (piles always disagree — dates usually explain it), and keep the provenance trail, because a brief that can't say "per the Q3 postmortem" gets re-derived by the first skeptic.

## What This Skill Produces

- **The pile map** — every document: what it is, date, author-context, and its likely contribution to the questions
- **The extraction** — findings organized by the brief's questions (never by source document), each with its citation
- **The reconciliation** — where documents conflict: the resolution (usually recency or authority) or the honest open question
- **The brief + the honesty ledger** — the deliverable, plus what was skimmed/skipped and what the pile simply doesn't contain

## Required Inputs

Ask for these if not provided:
- **The pile** — the documents (or their contents); the map works on what's actually there
- **The reader and their questions** — who is this for and what must they decide/understand ("the new lead needs: state of the project, open risks, why past decisions were made") — without questions, the output is a book report
- **The pile's history, if known** — why these documents accumulated, which are drafts vs. finals ([doc-versioning-discipline](../doc-versioning-discipline/SKILL.md) status often missing — the map infers and flags)
- **The deadline and depth** — an afternoon's brief reads differently than a week's; the map allocates reading time by expected contribution

## Framework: The Pile Rules

1. **Questions before reading:** the brief's 3–5 questions get written first — they convert reading from absorption into *search*, and they're the only defense against the pile's own emphasis (piles over-represent whatever got documented most, which is rarely what matters most).
2. **Map cheaply, then allocate:** ten minutes of skimming headers/dates/intros produces the map; reading time then allocates by expected contribution — the two load-bearing docs get real reads, the six status updates get scans, the duplicates get one representative. Even coverage is the pile's trap.
3. **Extract to questions with citations:** every finding files under a question with its source pinned ("risk: the vendor contract auto-renews in Sept [Contract-notes.doc, p2]") — the citation trail is what makes the brief *checkable*, and checkable briefs end debates that summarized ones start ([citation-hygiene](../citation-hygiene/SKILL.md) internal rules).
4. **Reconcile conflicts explicitly:** piles disagree — the deck says launch in Q2, the memo says Q3. Resolution order: recency (was the older superseded?) → authority (whose call was it?) → if unresolvable, the conflict *is a finding* ("sources disagree on the launch date; the latest signal is Q3 [memo, June] but no decision record exists"). Silent averaging of conflicts is how briefs launder confusion into false confidence.
5. **The honesty ledger closes it:** what was read deeply, skimmed, skipped (with reasons), and — most valuable — *what the questions needed that the pile doesn't contain* ("nothing documents why vendor B was rejected — recommend asking [person]"). The gaps are findings; the [session-handoff](../session-handoff/SKILL.md) stranger-test applies: the reader should never need to ask what the ledger should have said.

## Output Format

# Brief: [pile] → for [reader] — their questions: [list]

## The Pile Map
| Doc | What it is | Date | Contribution | Read depth |
|---|---|---|---|---|

## The Brief (by question)
**Q1: […]** — [findings with citations] 
**Q2: […]** — […]
[Conflicts: the reconciliation or the open-question finding]

## The Honesty Ledger
[Read/skimmed/skipped · what the pile doesn't contain · the ask-a-human list]

## Quality Checks

- [ ] The questions were written before the reading started
- [ ] Reading depth followed the map's contribution estimates
- [ ] Every finding carries its document citation
- [ ] Conflicts were reconciled by stated logic or reported as findings
- [ ] The ledger names the gaps and the skips honestly

## Anti-Patterns

- [ ] Do not read evenly — the pile's volume distribution is not its importance distribution
- [ ] Do not organize the brief by document — the reader has questions, not a filing fetish
- [ ] Do not average conflicting sources — reconcile or report; blend is betrayal
- [ ] Do not cite nothing — an uncited brief is one skeptic away from being re-done
- [ ] Do not hide what wasn't read — the ledger converts a limitation into a map for the reader