elliot-stack 1.0.29 → 1.0.33

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (128) hide show
  1. package/LICENSE +21 -21
  2. package/README.md +5 -0
  3. package/bin/install.cjs +981 -950
  4. package/hooks/repo-search-nudge.js +32 -32
  5. package/package.json +1 -1
  6. package/skills/estack-active-learning-tutor/SKILL.md +339 -339
  7. package/skills/estack-better-title/SKILL.md +64 -64
  8. package/skills/estack-better-title/scripts/rename.sh +55 -55
  9. package/skills/estack-chris-voss/SKILL.md +80 -80
  10. package/skills/estack-chris-voss/references/elliot-notes.md +120 -120
  11. package/skills/estack-chris-voss/references/voss-principles.md +210 -210
  12. package/skills/estack-customer-discovery/SKILL.md +60 -60
  13. package/skills/estack-flight-planner/SKILL.md +332 -332
  14. package/skills/estack-flight-planner/references/config_schema.md +156 -156
  15. package/skills/estack-flight-planner/references/flight_history_schema.md +97 -97
  16. package/skills/estack-flight-planner/references/shuttle_schedules.md +98 -98
  17. package/skills/estack-flight-planner/scripts/check_setup.sh +89 -89
  18. package/skills/estack-flight-planner/scripts/fetch_flights.py +99 -99
  19. package/skills/estack-flight-planner/scripts/filter_flights.py +265 -265
  20. package/skills/estack-flight-planner/scripts/pair_shuttles.py +173 -173
  21. package/skills/estack-github-issue-tracker/SKILL.md +322 -322
  22. package/skills/estack-github-issue-tracker/bin/tracker-tools.cjs +1358 -1358
  23. package/skills/estack-github-issue-tracker/references/gh-cli-patterns.md +124 -124
  24. package/skills/estack-github-issue-tracker/references/result-file-schema.md +156 -156
  25. package/skills/estack-github-issue-tracker/references/tracker-schema.md +96 -96
  26. package/skills/estack-github-issue-tracker/tracker-template.md +58 -58
  27. package/skills/estack-leadership-coach/SKILL.md +235 -0
  28. package/skills/estack-leadership-coach/adding-references.md +280 -0
  29. package/skills/estack-leadership-coach/frameworks/delegation/flows/post-mortem.md +120 -0
  30. package/skills/estack-leadership-coach/frameworks/delegation/flows/pre-delegation.md +138 -0
  31. package/skills/estack-leadership-coach/frameworks/delegation/phases/1-intake.md +145 -0
  32. package/skills/estack-leadership-coach/frameworks/delegation/phases/2-trm-assessment.md +119 -0
  33. package/skills/estack-leadership-coach/frameworks/delegation/phases/3-enrollment.md +132 -0
  34. package/skills/estack-leadership-coach/frameworks/delegation/phases/4-build-brief.md +171 -0
  35. package/skills/estack-leadership-coach/frameworks/delegation/phases/5-monitoring.md +134 -0
  36. package/skills/estack-leadership-coach/frameworks/delegation/phases/6-reverse-delegation.md +118 -0
  37. package/skills/estack-leadership-coach/frameworks/delegation/phases/7-diagnose.md +200 -0
  38. package/skills/estack-leadership-coach/references/.source-files/deci-ryan_self-determination-theory__deci-olafsen-ryan-2017-self-determination-theory-in-work-organizations.md +1881 -0
  39. package/skills/estack-leadership-coach/references/.source-files/deci-ryan_self-determination-theory__gagne-deci-2005-self-determination-theory-and-work-motivation.md +2058 -0
  40. package/skills/estack-leadership-coach/references/.source-files/deci-ryan_self-determination-theory__selfdeterminationtheory-org-theory-overview-page.md +61 -0
  41. package/skills/estack-leadership-coach/references/.source-files/gallup_engagement-research__gallup-3-key-insights-into-the-global-workplace-2024.md +57 -0
  42. package/skills/estack-leadership-coach/references/.source-files/gallup_engagement-research__gallup-managers-account-for-70-percent-of-variance-in-employee-engagement-2015.md +40 -0
  43. package/skills/estack-leadership-coach/references/.source-files/gallup_engagement-research__gallup-state-of-the-global-workplace-2026-global-data-summary.md +73 -0
  44. package/skills/estack-leadership-coach/references/.source-files/gallup_engagement-research__gallup-state-of-the-global-workplace-2026-report-landing.md +42 -0
  45. package/skills/estack-leadership-coach/references/.source-files/hormozi-leila_4-stages__leila-hormozi-the-art-of-delegation-blog-post.md +91 -0
  46. package/skills/estack-leadership-coach/references/.source-files/oncken-wass_monkeys-hbr-1974__oncken-wass-management-time-whos-got-the-monkey-hbr-classic-1974.md +969 -0
  47. package/skills/estack-leadership-coach/references/.source-files/sanchez_main-street-millionaire__codie-sanchez-afford-anything-podcast-ep-565-show-notes.md +89 -0
  48. package/skills/estack-leadership-coach/references/.source-files/sullivan_who-not-how__dan-sullivan-impact-filter-tool-and-guide-booklet.md +565 -0
  49. package/skills/estack-leadership-coach/references/.source-files/van-edwards_cues__vanessa-van-edwards-lewis-howes-school-of-greatness-ep-1231-show-notes.md +122 -0
  50. package/skills/estack-leadership-coach/references/.source-files/van-edwards_cues__vanessa-van-edwards-roger-dooley-cues-interview.md +194 -0
  51. package/skills/estack-leadership-coach/references/deci-ryan_self-determination-theory.md +166 -0
  52. package/skills/estack-leadership-coach/references/doerr_measure-what-matters.md +154 -0
  53. package/skills/estack-leadership-coach/references/ferriss_4hww.md +189 -0
  54. package/skills/estack-leadership-coach/references/gallup_engagement-research.md +105 -0
  55. package/skills/estack-leadership-coach/references/gerber_e-myth-revisited.md +118 -0
  56. package/skills/estack-leadership-coach/references/grove_high-output-management.md +95 -0
  57. package/skills/estack-leadership-coach/references/hormozi-alex_followthrough.md +152 -0
  58. package/skills/estack-leadership-coach/references/hormozi-leila_4-stages.md +146 -0
  59. package/skills/estack-leadership-coach/references/oncken-wass_monkeys-hbr-1974.md +128 -0
  60. package/skills/estack-leadership-coach/references/sanchez_main-street-millionaire.md +196 -0
  61. package/skills/estack-leadership-coach/references/sullivan_who-not-how.md +137 -0
  62. package/skills/estack-leadership-coach/references/van-edwards_cues.md +189 -0
  63. package/skills/estack-migrate-claude-session-history/SKILL.md +226 -0
  64. package/skills/estack-migrate-claude-session-history/references/path-encoding.md +55 -0
  65. package/skills/estack-migrate-claude-session-history/references/troubleshooting.md +96 -0
  66. package/skills/estack-migrate-claude-session-history/scripts/migrate-claude-history.js +1123 -0
  67. package/skills/estack-migrate-claude-session-history/scripts/test-append-note.js +48 -0
  68. package/skills/estack-migrate-claude-session-history/scripts/test-validate-migration.py +326 -0
  69. package/skills/estack-migrate-claude-session-history/scripts/validate-migration.py +493 -0
  70. package/skills/estack-pdf-to-md/SKILL.md +180 -0
  71. package/skills/estack-pdf-to-md/scripts/pdf_to_md.py +596 -0
  72. package/skills/estack-productivity-prioritization-coach/SKILL.md +124 -0
  73. package/skills/estack-productivity-prioritization-coach/sources/01-tony-robbins-rpm.md +39 -0
  74. package/skills/estack-productivity-prioritization-coach/sources/02-justin-sung-task-prioritization.md +34 -0
  75. package/skills/estack-prompt-builder-coach/SKILL.md +81 -81
  76. package/skills/estack-prompt-builder-coach/definition-of-done-generator.md +42 -42
  77. package/skills/estack-prompt-builder-coach/prompt-builder.md +37 -37
  78. package/skills/estack-prompt-builder-coach/task-shaper.md +36 -36
  79. package/skills/estack-prompt-builder-coach/vague-ask-auditor.md +37 -37
  80. package/skills/estack-read-claude-session-history/SKILL.md +204 -204
  81. package/skills/estack-read-claude-session-history/references/jsonl-schema.md +126 -126
  82. package/skills/estack-read-claude-session-history/references/modes.md +423 -423
  83. package/skills/estack-read-claude-session-history/references/recipes.md +271 -271
  84. package/skills/estack-read-claude-session-history/scripts/lib/__init__.py +1 -1
  85. package/skills/estack-read-claude-session-history/scripts/lib/parser.py +460 -460
  86. package/skills/estack-read-claude-session-history/scripts/lib/paths.py +234 -234
  87. package/skills/estack-read-claude-session-history/scripts/lib/search.py +179 -179
  88. package/skills/estack-read-claude-session-history/scripts/lib/subagents.py +88 -88
  89. package/skills/estack-read-claude-session-history/scripts/lib/tools.py +144 -144
  90. package/skills/estack-read-claude-session-history/scripts/read_transcript.py +1776 -1776
  91. package/skills/estack-read-claude-session-history/scripts/tests/conftest.py +40 -40
  92. package/skills/estack-read-claude-session-history/scripts/tests/fixtures/README.md +20 -20
  93. package/skills/estack-read-claude-session-history/scripts/tests/fixtures/all-noise.jsonl +4 -4
  94. package/skills/estack-read-claude-session-history/scripts/tests/fixtures/basic-session.jsonl +2 -2
  95. package/skills/estack-read-claude-session-history/scripts/tests/fixtures/engagement-gaps.jsonl +9 -9
  96. package/skills/estack-read-claude-session-history/scripts/tests/fixtures/engagement-noise.jsonl +7 -7
  97. package/skills/estack-read-claude-session-history/scripts/tests/fixtures/engagement-parallel-a.jsonl +3 -3
  98. package/skills/estack-read-claude-session-history/scripts/tests/fixtures/engagement-parallel-b.jsonl +3 -3
  99. package/skills/estack-read-claude-session-history/scripts/tests/fixtures/engagement-waiting.jsonl +5 -5
  100. package/skills/estack-read-claude-session-history/scripts/tests/fixtures/interrupted.jsonl +2 -2
  101. package/skills/estack-read-claude-session-history/scripts/tests/fixtures/multi-compact.jsonl +8 -8
  102. package/skills/estack-read-claude-session-history/scripts/tests/fixtures/pending-user.jsonl +2 -2
  103. package/skills/estack-read-claude-session-history/scripts/tests/fixtures/subagent-no-meta/subagents/agent-aaa.jsonl +2 -2
  104. package/skills/estack-read-claude-session-history/scripts/tests/fixtures/subagent-no-meta.jsonl +2 -2
  105. package/skills/estack-read-claude-session-history/scripts/tests/fixtures/subagent-parent/subagents/agent-xyz123.jsonl +2 -2
  106. package/skills/estack-read-claude-session-history/scripts/tests/fixtures/subagent-parent/subagents/agent-xyz123.meta.json +1 -1
  107. package/skills/estack-read-claude-session-history/scripts/tests/fixtures/subagent-parent.jsonl +4 -4
  108. package/skills/estack-read-claude-session-history/scripts/tests/fixtures/time-spread.jsonl +6 -6
  109. package/skills/estack-read-claude-session-history/scripts/tests/fixtures/timeline-day-test.jsonl +5 -5
  110. package/skills/estack-read-claude-session-history/scripts/tests/fixtures/tool-zoo.jsonl +10 -10
  111. package/skills/estack-read-claude-session-history/scripts/tests/fixtures/truncated.jsonl +2 -2
  112. package/skills/estack-read-claude-session-history/scripts/tests/fixtures/unicode.jsonl +2 -2
  113. package/skills/estack-read-claude-session-history/scripts/tests/fixtures/with-advisor.jsonl +3 -3
  114. package/skills/estack-read-claude-session-history/scripts/tests/fixtures/with-compact.jsonl +5 -5
  115. package/skills/estack-read-claude-session-history/scripts/tests/fixtures/with-thinking.jsonl +2 -2
  116. package/skills/estack-read-claude-session-history/scripts/tests/test_backup_roots.py +56 -56
  117. package/skills/estack-read-claude-session-history/scripts/tests/test_engagement.py +239 -239
  118. package/skills/estack-read-claude-session-history/scripts/tests/test_json_format.py +201 -201
  119. package/skills/estack-read-claude-session-history/scripts/tests/test_modes.py +199 -199
  120. package/skills/estack-read-claude-session-history/scripts/tests/test_parser.py +195 -195
  121. package/skills/estack-read-claude-session-history/scripts/tests/test_paths.py +133 -133
  122. package/skills/estack-read-claude-session-history/scripts/tests/test_search.py +78 -78
  123. package/skills/estack-read-claude-session-history/scripts/tests/test_subagents.py +43 -43
  124. package/skills/estack-read-claude-session-history/scripts/tests/test_timeline.py +179 -179
  125. package/skills/estack-read-claude-session-history/scripts/tests/test_timezone_and_project.py +212 -212
  126. package/skills/estack-read-claude-session-history/scripts/tests/test_tools.py +80 -80
  127. package/skills/estack-repo-search/SKILL.md +65 -65
  128. package/skills/estack-vscode-file-recovery/SKILL.md +188 -0
@@ -0,0 +1,280 @@
1
+ # How to add a reference file to the knowledge vault
2
+
3
+ <primary_outcome>
4
+ A new file in `references/` that contains live-fetched, properly cited source material — plus every placeholder link and "Real-world case" block in the skill that points to it has been updated to use the verified content from that file. After this task is complete, the user can ask the coach about that source mid-session and get a grounded answer with a real URL.
5
+ </primary_outcome>
6
+
7
+ This file is the playbook for populating the knowledge vault. The user triggers it by saying something like *"I want to add a reference source"* or *"Let's build the reference for [author/work]."* When that happens, load this file and follow it step by step.
8
+
9
+ ---
10
+
11
+ ## Hard rules (apply throughout — never violated)
12
+
13
+ 1. **Live-fetch every fact.** Use `WebSearch`, `WebFetch`, or `mcp__claude_ai_Supadata__supadata_transcript` (for YouTube, Instagram, TikTok, and all other social media) every single session you build a reference. Never recall content from training memory and present it as sourced. This rule comes from the user's global CLAUDE.md and is not negotiable.
14
+ 2. **Cite real URLs only.** Every reference file ends with a Sources section that contains URLs fetched this session. A name without a URL is a fabricated citation — do not write one.
15
+ 3. **Do not paraphrase quotes.** If you put text in quote marks, it must be a verbatim extract from the fetched source. Otherwise drop the quotes and frame as synthesis.
16
+ 4. **Note the fetch date.** Every reference file's frontmatter records the date the material was fetched. Source content drifts; the fetch date is how the user knows how fresh the snapshot is.
17
+ 5. **If you can't fetch it, say so.** Books that aren't online verbatim, paywalled articles, deleted videos — these can't be sourced live. Tell the user, and propose pulling from interviews / talks / podcast appearances by the same author that *are* accessible OR ask the user to provide the source. Do not fabricate to fill the gap.
18
+
19
+ ---
20
+
21
+ ## Workflow (six steps — run in order)
22
+
23
+ ### Step 1 — Confirm scope with the user (ask 1–3 questions, then stop)
24
+
25
+ Before fetching anything, get explicit on:
26
+
27
+ 1. **Which source?** Specific book, article, talk, video, podcast episode — with title and author.
28
+ 2. **Which type of reference?**
29
+ - **Extraction** — verbatim quotes/passages organized for retrieval (best for talks, interviews, articles, video transcripts)
30
+ - **Synthesis** — organized key takeaways drawn from longer material (best for books, multi-source bodies of work)
31
+ 3. **Which phases / placeholders should this reference feed?** (Optional but helpful — narrows the synthesis.) For example: *"This Grove reference should feed the Phase 2 TRM case placeholder and the Phase 5 midpoint-review placeholder."*
32
+
33
+ Stop and wait for the answers. Do not start fetching yet.
34
+
35
+ ### Step 2 — Live-fetch the source material
36
+
37
+ Pick the right tool for the source type:
38
+
39
+ | Source type | Tool | Notes |
40
+ |---|---|---|
41
+ | YouTube video / talk | `mcp__claude_ai_Supadata__supadata_transcript` | Returns the full transcript. Capture the URL and the video ID. |
42
+ | Article on a public site | `WebFetch` or `mcp__claude_ai_Supadata__supadata_scrape` | Fetch the page and pull the prose. |
43
+ | Web search to locate authoritative sources | `WebSearch` | Use when the user names a concept but not a specific URL. |
44
+ | Podcast episode | Check if the podcast has a transcript page; fetch that with `WebFetch`. Otherwise look for show notes / quoted passages from secondary coverage. | Note: audio-only without transcript ≠ fetchable. |
45
+ | Book | Look for: official author talks on the book's themes, interviews with the author, publisher excerpts, the author's own essays summarizing the book. Cite each fetched piece. | Do not fabricate page numbers or "quotes from the book" without a verifiable source. |
46
+
47
+ If the first fetch is thin, do additional fetches. A good reference file synthesizes 2–4 sources, not 1.
48
+
49
+ ### Step 3 — Decide the type and pick the template
50
+
51
+ Pick **extraction** or **synthesis** based on what you fetched and what the user asked for. Both templates are below — use the matching one.
52
+
53
+ If the source is a single article or talk → extraction.
54
+ If the source is a book or a body of work → synthesis.
55
+ If both apply (e.g., a book with multiple author talks) → synthesis as the primary structure, with key extractions embedded.
56
+
57
+ ### Step 4 — Create the reference file
58
+
59
+ **Location:** `~/.claude/skills/leadership-coach/references/<filename>.md`
60
+
61
+ **Filename convention:** `<author-lastname>_<work-shortname>.md` — lowercase, hyphens not underscores within name parts, single underscore between author and work. Examples already in the skill:
62
+
63
+ - `grove_high-output-management.md`
64
+ - `hormozi-leila_4-stages.md`
65
+ - `oncken-wass_monkeys-hbr-1974.md`
66
+
67
+ Match the existing filenames exactly when you're populating a placeholder — the link path in the placeholder is the contract.
68
+
69
+ Create the file using the appropriate template from the **Templates** section below.
70
+
71
+ ### Step 5 — Wire it up across the skill
72
+
73
+ A new reference file is only useful if the existing placeholders find it. After creating the file, do a complete sweep:
74
+
75
+ 1. **Search every phase file** for the filename you just created. Each match is either:
76
+ - A "Going deeper" link block at the bottom of the phase → no change needed, the link already points correctly
77
+ - A "Real-world case" placeholder pointing to this reference → **replace the placeholder block with verified case material from the new reference file**
78
+ 2. **Search `SKILL.md`** for any inline mention of the author / work that the new reference covers. If a paraphrased claim or quote in `SKILL.md` is now backed by your verified source, update it to match the source's actual wording. If it doesn't match, hedge it or remove it — do not bend the source to fit the existing prose.
79
+ 3. **Search flow files** (`flows/pre-delegation.md`, `flows/post-mortem.md`). Less common, but check.
80
+
81
+ For each "Real-world case" placeholder you replace:
82
+
83
+ - Pull 1–2 paragraphs from the reference file's body — verbatim where you can, synthesized where you must
84
+ - Keep the section header as `## Real-world case: <descriptive title>` (drop the `(placeholder — fill in during reference build)` marker)
85
+ - Include the source URL inline or as a footnote: *"From Grove, *High Output Management*, p. 142 — see [reference](../../../references/grove_high-output-management.md)"*
86
+ - Do **not** add invented specifics. If the reference has no verbatim case with the dialogue/metrics that would make the section pop, write a short principle illustration grounded in what *is* in the reference, and accept that it's less dramatic than the placeholder hoped for.
87
+
88
+ ### Step 6 — Verify (acceptance self-audit)
89
+
90
+ Before declaring done, confirm:
91
+
92
+ - [ ] Reference file exists at the expected path with the expected filename
93
+ - [ ] Frontmatter includes `name`, `author`, `work`, `type` (extraction/synthesis), `last_fetched` date, and `sources` (URLs)
94
+ - [ ] Every fact, quote, and statistic in the file is traceable to a URL in the Sources section
95
+ - [ ] Every "Real-world case" placeholder that points to this reference has been replaced with verified content OR explicitly left as a placeholder with a note explaining why (e.g., "verified content available but not yet drafted")
96
+ - [ ] Every "Going deeper" link block in phase files that references this file still resolves correctly
97
+ - [ ] No hedged or fabricated content has been smuggled in — if the source doesn't say it, the reference file doesn't say it
98
+ - [ ] Filename in the file matches the link paths used by placeholders
99
+
100
+ Report back to the user with: (a) which reference was built, (b) which placeholders / cross-references were updated, (c) any placeholders that were *not* updated and why, (d) any source material the user might want to add later to fill gaps.
101
+
102
+ ---
103
+
104
+ ## Templates
105
+
106
+ ### Template A — Extraction reference
107
+
108
+ Use for articles, talks, interviews, video transcripts — anything where you can pull verbatim text.
109
+
110
+ ```markdown
111
+ ---
112
+ name: <author-lastname>_<work-shortname>
113
+ title: <Full title of the work>
114
+ author: <Author name(s)>
115
+ work_type: <article | talk | interview | podcast | video transcript>
116
+ type: extraction
117
+ last_fetched: <YYYY-MM-DD>
118
+ sources:
119
+ - <URL 1>
120
+ - <URL 2>
121
+ ---
122
+
123
+ # <Author> — *<Work title>*
124
+
125
+ ## Overview
126
+
127
+ <2–3 sentence framing of what this work covers and why it matters for leadership coaching. No fabrication — only what's actually in the fetched material.>
128
+
129
+ ## Why this is in the vault
130
+
131
+ <1 paragraph: which phases / coaching moves draw on this work, and what specific principle it backs.>
132
+
133
+ ## Key extractions
134
+
135
+ > "<Verbatim quote 1>"
136
+ > — <Source location: timestamp / paragraph / page number if available>
137
+
138
+ > "<Verbatim quote 2>"
139
+ > — <Source location>
140
+
141
+ (Pull 5–15 strong extractions. Each one is verbatim. Each one cites where in the source it came from.)
142
+
143
+ ## Notable cases / illustrations from the source
144
+
145
+ <If the source contains specific case material — a story the author tells, a study they cite, a scenario they walk through — extract it here. Each one is faithful to the source.>
146
+
147
+ ### <Case 1 title>
148
+
149
+ <Faithful retelling, with direct quotes where possible. Cite the location in the source.>
150
+
151
+ ## Where this is used in the skill
152
+
153
+ - `phases/<file>.md` — <which placeholder / "Going deeper" block uses this>
154
+ - `SKILL.md` — <if applicable>
155
+
156
+ ## Sources (live-fetched on <YYYY-MM-DD>)
157
+
158
+ - [<Title of source>](<URL>)
159
+ - [<Title of source>](<URL>)
160
+ ```
161
+
162
+ ### Template B — Synthesis reference
163
+
164
+ Use for books, multi-source bodies of work, or any case where you're synthesizing from several fetched pieces.
165
+
166
+ ```markdown
167
+ ---
168
+ name: <author-lastname>_<work-shortname>
169
+ title: <Full title of the work or body of work>
170
+ author: <Author name(s)>
171
+ work_type: <book | body of work>
172
+ type: synthesis
173
+ last_fetched: <YYYY-MM-DD>
174
+ sources:
175
+ - <URL 1>
176
+ - <URL 2>
177
+ - <URL 3>
178
+ ---
179
+
180
+ # <Author> — *<Work title>*
181
+
182
+ ## Overview
183
+
184
+ <2–3 sentence framing.>
185
+
186
+ ## Why this is in the vault
187
+
188
+ <1 paragraph: which phases / coaching moves draw on this work.>
189
+
190
+ ## Synthesis — core principles
191
+
192
+ ### Principle 1: <name>
193
+
194
+ <2–3 paragraph synthesis of the principle, drawn from the fetched sources. Use direct quotes where the source language is sharp; paraphrase where you're integrating across sources. Every claim should be defensible against the Sources section below.>
195
+
196
+ ### Principle 2: <name>
197
+
198
+ <...>
199
+
200
+ ### Principle 3: <name>
201
+
202
+ <...>
203
+
204
+ (3–6 principles total. Don't pad.)
205
+
206
+ ## Verbatim extracts (when sources support them)
207
+
208
+ > "<Quote>"
209
+ > — <Source URL or title>
210
+
211
+ (Include verbatim extracts only where you actually fetched the verbatim text. If you're synthesizing from interview snippets and don't have a clean quote, skip this section.)
212
+
213
+ ## Notable cases / illustrations
214
+
215
+ <If the fetched sources contain specific cases — a story the author tells in an interview, a case study from a talk — extract them faithfully here. Each one cites where it came from.>
216
+
217
+ ### <Case 1 title>
218
+
219
+ <Faithful retelling.>
220
+
221
+ ## Where this is used in the skill
222
+
223
+ - `phases/<file>.md` — <which placeholder uses this>
224
+ - `SKILL.md` — <if applicable>
225
+
226
+ ## Sources (live-fetched on <YYYY-MM-DD>)
227
+
228
+ - [<Title>](<URL>)
229
+ - [<Title>](<URL>)
230
+
231
+ ## Known gaps
232
+
233
+ <Optional. If the user might later want to deepen this reference: name the gap. Example: "Did not fetch the original *High Output Management* text — only Grove talks and secondary summaries. Future pass could add direct chapter excerpts if obtainable.">
234
+ ```
235
+
236
+ ---
237
+
238
+ ## Cross-reference map (where to look when wiring up)
239
+
240
+ For convenience, here's where each existing reference filename is mentioned in the skill body. When you build a new reference, update *all* the locations that point to it.
241
+
242
+ | Reference file | Mentioned in |
243
+ |---|---|
244
+ | `grove_high-output-management.md` | `phases/1-intake.md`, `phases/2-trm-assessment.md`, `phases/4-build-brief.md`, `phases/5-monitoring.md`, `phases/7-diagnose.md` |
245
+ | `gerber_e-myth-revisited.md` | `phases/1-intake.md`, `phases/7-diagnose.md` |
246
+ | `hormozi-leila_4-stages.md` | `phases/2-trm-assessment.md`, `phases/7-diagnose.md` |
247
+ | `hormozi-alex_followthrough.md` | `phases/4-build-brief.md`, `phases/7-diagnose.md` |
248
+ | `doerr_measure-what-matters.md` | `phases/4-build-brief.md`, `phases/5-monitoring.md`, `phases/7-diagnose.md` (primary); `phases/1-intake.md`, `phases/3-enrollment.md` (secondary) |
249
+ | `sullivan_who-not-how.md` | `phases/1-intake.md`, `phases/3-enrollment.md`, `phases/4-build-brief.md`, `phases/7-diagnose.md` |
250
+ | `sanchez_main-street-millionaire.md` | `phases/2-trm-assessment.md`, `phases/7-diagnose.md` |
251
+ | `ferriss_4hww.md` | `phases/1-intake.md` |
252
+ | `oncken-wass_monkeys-hbr-1974.md` | `phases/6-reverse-delegation.md`, `phases/7-diagnose.md` |
253
+ | `deci-ryan_self-determination-theory.md` | `phases/3-enrollment.md`, `phases/7-diagnose.md` |
254
+ | `gallup_engagement-research.md` | `phases/3-enrollment.md` |
255
+ | `van-edwards_cues.md` | `phases/5-monitoring.md` |
256
+
257
+ If you add a reference not on this list, append it to this map after you finish the wire-up so future passes have an accurate index.
258
+
259
+ ---
260
+
261
+ ## Pre-empted shortcuts
262
+
263
+ - **Don't research from memory and dress it up as sourced.** Every claim needs a URL fetched this session.
264
+ - **Don't fabricate page numbers, timestamps, or quote locations.** If you don't know where the quote came from, omit the location citation.
265
+ - **Don't write a "Notable case" with invented dialogue.** If the source contains the case, extract it. If it doesn't, leave the section empty or skip it.
266
+ - **Don't skip the cross-reference sweep.** A reference file that exists but isn't wired up adds zero value to coaching.
267
+ - **Don't bend the source to fit existing skill prose.** If the inline content in a phase file disagrees with what the source actually says, fix the phase file — not the reference.
268
+ - **Don't build references the user didn't ask for.** This task is triggered by the user. Don't preemptively add references to "round out the vault" — that's how scope creep starts.
269
+
270
+ ---
271
+
272
+ ## When the user says "add a reference source"
273
+
274
+ 1. Ask the Step 1 questions. Stop and wait.
275
+ 2. Once the user answers, fetch the source material (Step 2).
276
+ 3. Confirm with the user: *"I fetched [N] sources for [author/work]. Building as a [extraction / synthesis]. Going to populate [N] placeholders in [phase files]. Sound right?"*
277
+ 4. Build the reference file (Step 4).
278
+ 5. Sweep and wire up (Step 5).
279
+ 6. Run the acceptance audit (Step 6).
280
+ 7. Report back with what changed and any gaps.
@@ -0,0 +1,120 @@
1
+ # Post-mortem flow
2
+
3
+ <primary_outcome>
4
+ The user finishes this flow with a written diagnosis: which of the five structural gaps caused the failure, the principle behind it, the specific moment in the prior handoff where the gap opened, and a concrete corrective move. The diagnosis closes with an offer to re-run the pre-delegation flow using the gap as the starting correction. If the user accepts, the pre-delegation flow runs immediately with the existing context.
5
+ </primary_outcome>
6
+
7
+ This flow runs when a delegation already happened and went wrong. The work came back broken, late, or off-target — or it didn't come back at all. The user is here for the diagnosis, not to recover the lost work.
8
+
9
+ ---
10
+
11
+ ## When to run this flow
12
+
13
+ - The user describes a handoff that already happened and failed
14
+ - The work came back below the bar, late, or in the wrong direction
15
+ - The user finds themselves redoing work they delegated
16
+ - The user keeps getting pulled back into something they thought they'd handed off
17
+ - Trust between user and owner is fraying after the delegation
18
+
19
+ If the user hasn't handed off the work yet, use `pre-delegation.md` instead.
20
+
21
+ ---
22
+
23
+ ## Phase sequence
24
+
25
+ This flow runs only Phase 7, but Phase 7 produces the full diagnosis.
26
+
27
+ | # | Phase | Output the phase must produce |
28
+ |---|---|---|
29
+ | 7 | `../phases/7-diagnose.md` | Named structural gap (1 of 5) + named failure mode + specific principle explaining why the gap caused the failure + one corrective move |
30
+
31
+ After Phase 7, deliver the diagnosis artifact using the template below, then offer the pre-delegation re-run.
32
+
33
+ ---
34
+
35
+ ## How to run this flow without re-traumatizing the user
36
+
37
+ The user often arrives frustrated, embarrassed, or angry — at themselves, at the owner, or both. Coach with that in mind:
38
+
39
+ - **Lead with the system, not the person.** Almost every delegation failure is structural, not character-based. If you find yourself building a case against the owner, you've drifted. Bring it back to which of the five gaps opened.
40
+ - **Don't pile on.** The user already knows it went wrong. They don't need a lecture on what they should have done. They need a diagnosis they can use next time.
41
+ - **The owner is not in the room.** Be careful with claims about the owner's intent. Stick to observable behavior.
42
+ - **It's almost never 'they're not capable.'** Wrong TRM calibration looks like incapability but is actually the user applying their general impression of the person to a task type the person hadn't done before.
43
+
44
+ ---
45
+
46
+ ## Pre-empted shortcuts
47
+
48
+ - **Don't diagnose before asking the diagnostic questions.** It's tempting to pattern-match on the first sentence the user says ("they didn't do what I wanted"). Run the questions from Phase 7 — the surface story usually hides the actual gap.
49
+ - **Don't pick the first gap that fits.** Multiple gaps often co-occur. Name the *primary* gap — the one that, if fixed, would have prevented the failure. Mention secondary gaps but don't dilute the diagnosis.
50
+ - **Don't recommend a "have a talk with them" as the corrective move.** That's not a fix — it's a deflection. The corrective move is a structural change: a named authority level, an externalized success criterion, a check-in cadence, a written brief.
51
+
52
+ ---
53
+
54
+ ## Artifact template — Diagnosis
55
+
56
+ When Phase 7 produces its output, deliver the artifact as a markdown block exactly like this:
57
+
58
+ <template>
59
+
60
+ ```markdown
61
+ # Delegation Post-Mortem
62
+
63
+ **Situation:** <one-sentence description of what was delegated and to whom>
64
+ **What went wrong:** <one-sentence description of the failure, in observable terms>
65
+ **Team mode:** <Hierarchical | Flat>
66
+
67
+ ---
68
+
69
+ ## The gap
70
+ **<Enrollment | Authority | Context | Success criteria | Accountability diffusion (flat teams)>**
71
+
72
+ <2–4 sentences naming where in the prior handoff this gap opened — the specific moment or omission. Quote the user's own words when possible.>
73
+
74
+ ## The principle behind it
75
+ <1–2 sentences of theory with attribution. Why this gap reliably causes this kind of failure.>
76
+
77
+ ## The failure mode this maps to
78
+ <From the failure-mode table in Phase 7 — name the row that matches.>
79
+
80
+ ## The corrective move
81
+ <One concrete, structural change that, if applied next time, prevents this gap from opening. Not "talk to them" — a specific brief element, authority level, or check-in.>
82
+
83
+ ## Secondary gaps (if any)
84
+ <Optional. Other gaps that also opened, but were not the primary cause. One line each.>
85
+ ```
86
+
87
+ </template>
88
+
89
+ ---
90
+
91
+ ## Closing offer (always include after the diagnosis)
92
+
93
+ After the diagnosis is delivered, ask the user:
94
+
95
+ > *Want to run the pre-delegation flow now, starting from the corrected gap? We'll skip what you already know about the situation and focus on building the brief / authority level / check-in structure that wasn't there last time.*
96
+
97
+ If the user accepts: load `pre-delegation.md` and resume at the phase that maps to the diagnosed gap, carrying forward the task / owner / timeline / team-mode already established:
98
+
99
+ | Primary gap | Resume at |
100
+ |---|---|
101
+ | Enrollment | Phase 3 (run all four moves) |
102
+ | Authority | Phase 4, element 5 (then continue to 5 and 6) |
103
+ | Context | Phase 3 Move 1 → Phase 4, element 2 (then continue) |
104
+ | Success criteria | Phase 4, element 3 (then continue to 5 and 6) |
105
+ | Accountability diffusion | Phase 1 (owner-selection) → Phase 4, element 6 |
106
+
107
+ After resuming at the gap's phase, run forward to the end of the flow. Don't skip the artifact assembly — the corrected brief is the point.
108
+
109
+ If the user declines: deliver the diagnosis and stop. Do not push.
110
+
111
+ ---
112
+
113
+ ## Acceptance self-audit (run before delivering the diagnosis)
114
+
115
+ - [ ] The named gap is one of the five (Enrollment / Authority / Context / Success criteria / Accountability diffusion)
116
+ - [ ] The principle is attributed to a specific source (Grove, Hormozi, Sullivan, Oncken/Wass, etc.)
117
+ - [ ] The failure mode named maps to a row in the Phase 7 failure-mode table
118
+ - [ ] The corrective move is structural, not relational
119
+ - [ ] The offer to re-run pre-delegation is present
120
+ - [ ] The diagnosis does not blame the owner where the gap is structural
@@ -0,0 +1,138 @@
1
+ # Pre-delegation flow
2
+
3
+ <primary_outcome>
4
+ The user finishes this flow with two things in hand: (1) a complete Delegation Brief in markdown, ready to share with the person taking the work, and (2) enrollment talking points for the sit-down conversation that happens before the brief is shared. If the user leaves without both of those, the flow is not complete.
5
+ </primary_outcome>
6
+
7
+ This flow runs when the user has not yet handed off the work and wants to set the delegation up correctly. It orchestrates Phases 1 through 6 in order, then assembles the artifact.
8
+
9
+ ---
10
+
11
+ ## When to run this flow
12
+
13
+ - The user is preparing to delegate something they currently own
14
+ - They want help deciding whether/how/to whom to delegate
15
+ - They want to write a brief but don't know what should be in it
16
+ - They've tried to delegate the work before and want to start over with structure
17
+
18
+ If the work has already been handed off and went sideways, use `post-mortem.md` instead.
19
+
20
+ ---
21
+
22
+ ## Phase sequence
23
+
24
+ Each phase has its own file in `../phases/`. Load and follow each one in order. Do not jump ahead — a phase is incomplete until it produces the output the phase declares.
25
+
26
+ | # | Phase | Output the phase must produce |
27
+ |---|---|---|
28
+ | 1 | `phases/1-intake.md` | Named task, named owner (or owner-selection logic for flat teams), timeline; filter decision (Eliminate / Automate / Delegate / hold); resistance pattern named if present |
29
+ | 2 | `phases/2-trm-assessment.md` | Task-Relevant Maturity for this person on this task (Low / Medium / High) + Hormozi progression stage (Investigation / Informed Progress / Informed Results / Complete Ownership) |
30
+ | 3 | `phases/3-enrollment.md` | Enrollment talking points: the problem, why-them, the energizing question, the needs question |
31
+ | 4 | `phases/4-build-brief.md` | The brief: What, Why, Success Looks Like, Constraints, Authority Level (1–5), Reciprocal Commitments (flat teams) |
32
+ | 5 | `phases/5-monitoring.md` | Check-in schedule with cadence calibrated to TRM, and what each check-in will cover |
33
+ | 6 | `phases/6-reverse-delegation.md` | A named protocol for what the owner does when they hit a roadblock — preventing monkey-transfer back to the user |
34
+
35
+ After Phase 6, deliver the artifact using the template below. Do not declare the session done until the artifact is in the conversation.
36
+
37
+ ---
38
+
39
+ ## Compressed path
40
+
41
+ If all four conditions are true (trusted peer or proven high-TRM teammate, low public visibility, short timeline, low cost of failure), run a four-step compressed path instead:
42
+
43
+ 1. Confirm the deliverable in one sentence (Phase 1 + 4 condensed)
44
+ 2. Name "why you" in one sentence (Phase 3 Move 2 only — the other three moves are skipped)
45
+ 3. Name the authority level out loud (Phase 4, element 5)
46
+ 4. Set one check-in (Phase 5)
47
+
48
+ Then deliver a shortened brief with What / Why You / Authority Level / One Check-In filled in. Skip Moves 1, 3, 4 of enrollment and skip full reciprocal commitments. Mention briefly that the compressed path is being used and why.
49
+
50
+ If at any point a condition turns out to be false (the timeline grew, the visibility expanded), drop back to the full flow.
51
+
52
+ ---
53
+
54
+ ## Pre-empted shortcuts
55
+
56
+ - **Don't lecture all 6 phases up front.** The user will check out. Run phases one at a time.
57
+ - **Don't fill in the brief from your assumptions.** If the user couldn't articulate Success Looks Like, do not generate it. Push the question back until they have it.
58
+ - **Don't skip enrollment because "they're already on board."** Enrollment is not the user's belief about the owner's buy-in — it's the talking points the user will use in the actual conversation. Always produce them.
59
+ - **Don't deliver the brief without check-ins on the calendar.** A brief without a check-in schedule is abdication waiting to happen.
60
+
61
+ ---
62
+
63
+ ## Artifact template — Delegation Brief
64
+
65
+ When all six phases are complete, deliver the artifact as a markdown block exactly like this. Fill in every field with the specific content captured during the phases.
66
+
67
+ <template>
68
+
69
+ ```markdown
70
+ # Delegation Brief
71
+
72
+ **Task:** <one-sentence deliverable from Phase 1 + Phase 4 ①>
73
+ **Owner:** <named person from Phase 1>
74
+ **Timeline:** <from Phase 1>
75
+ **Team mode:** <Hierarchical | Flat — detected during the session>
76
+
77
+ ---
78
+
79
+ ## Why this matters
80
+ <from Phase 4 ②: the actual problem being solved, who it's for, what goes wrong if it's late or off>
81
+
82
+ ## Why this owner
83
+ <from Phase 3 ②: specific reason they were chosen — not "they're great">
84
+
85
+ ## Success looks like
86
+ <from Phase 4 ③: concrete description of done, with the standard externalized. Excellent / Acceptable / Poor distinctions if surfaced.>
87
+
88
+ ## Constraints
89
+ <from Phase 4 ④: non-negotiables — timeline, budget, stakeholders to involve, decisions they can't make alone>
90
+
91
+ ## Authority level
92
+ **Level <1–5> — <Name>**
93
+ <one-line description of what that level means in this specific situation>
94
+
95
+ ## Check-in schedule
96
+ <from Phase 5: actual cadence, e.g., "Early-stage alignment check on <date>, midpoint review on <date>, final delivery on <date>". Each check-in says what it covers.>
97
+
98
+ ## When the owner hits a roadblock
99
+ <from Phase 6: the named protocol — what they do, how they bring it to the user, what the user will/won't take back>
100
+
101
+ ## Reciprocal commitments
102
+ <Flat teams only — from Phase 4 ⑥: what the user/team owes the owner: blockers they'll clear, stakeholders they'll handle, decisions they'll stay out of>
103
+ ```
104
+
105
+ ---
106
+
107
+ # Enrollment talking points
108
+
109
+ **To use before sharing the brief — these are for the sit-down conversation.**
110
+
111
+ > **The problem we're solving:** <from Phase 3 ①>
112
+ >
113
+ > **Why it matters right now:** <stakes, urgency, downstream impact>
114
+ >
115
+ > **Why you're the right person for this:** <specific, not generic — from Phase 3 ②>
116
+ >
117
+ > **What part of this energizes you?** <ask in the conversation, listen to the answer — Phase 3 ③>
118
+ >
119
+ > **What would help you do your best work?** <ask, listen — Phase 3 ④>
120
+
121
+ </template>
122
+
123
+ ---
124
+
125
+ ## Acceptance self-audit (run before declaring the session done)
126
+
127
+ Before delivering the artifact, silently verify all of these. If any is false, return to the relevant phase rather than ship a half-done brief.
128
+
129
+ - [ ] The deliverable is specific enough that a stranger could tell if it was met
130
+ - [ ] Success Looks Like is concrete — not "polished" or "high-quality" or "good"
131
+ - [ ] The authority level is named explicitly with a number and a name
132
+ - [ ] At least one check-in is on a calendar date, not "we'll figure it out"
133
+ - [ ] If flat team: reciprocal commitments are filled in with specific items
134
+ - [ ] The roadblock protocol from Phase 6 is named (not "they'll come to me")
135
+ - [ ] Enrollment talking points include a specific "why you" — not a generic compliment
136
+ - [ ] The user has not said "change outcome" without being re-routed
137
+
138
+ When all are true, deliver the artifact and then ask: *"Want to walk through how to actually open the enrollment conversation, or are you good to go?"*