phronesis 1.0.0

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 (142) hide show
  1. package/README.md +66 -0
  2. package/package.json +34 -0
  3. package/src/act.js +61 -0
  4. package/src/active-context.js +56 -0
  5. package/src/adapter.js +386 -0
  6. package/src/cli.js +1893 -0
  7. package/src/codex-hooks-schema.js +92 -0
  8. package/src/compile.js +513 -0
  9. package/src/doctor.js +303 -0
  10. package/src/due.js +271 -0
  11. package/src/eval.js +467 -0
  12. package/src/event.js +212 -0
  13. package/src/export.js +136 -0
  14. package/src/guard.js +89 -0
  15. package/src/hooks.js +230 -0
  16. package/src/ingest.js +965 -0
  17. package/src/init.js +150 -0
  18. package/src/layout.js +394 -0
  19. package/src/links.js +83 -0
  20. package/src/lint.js +58 -0
  21. package/src/profile.js +116 -0
  22. package/src/prompts.js +26 -0
  23. package/src/registry.js +190 -0
  24. package/src/scaffold.js +134 -0
  25. package/src/search.js +139 -0
  26. package/src/skill-discovery.js +117 -0
  27. package/src/skills-bump.js +885 -0
  28. package/src/skills.js +355 -0
  29. package/src/subscription.js +5 -0
  30. package/src/validate.js +152 -0
  31. package/templates/claude/settings.json +86 -0
  32. package/templates/codex/INDEX.md +68 -0
  33. package/templates/codex/seed/ai-practice/compile-dont-just-capture.md +42 -0
  34. package/templates/codex/seed/ai-practice/design-for-the-distribution.md +42 -0
  35. package/templates/codex/seed/ai-practice/from-spec-author-to-outcome-curator.md +43 -0
  36. package/templates/codex/seed/ai-practice/recall-builds-trust-when-calibrated.md +70 -0
  37. package/templates/codex/seed/ai-practice/the-eval-is-the-spec.md +42 -0
  38. package/templates/codex/seed/ai-practice/the-gold-dust-leaves-no-trace.md +72 -0
  39. package/templates/codex/seed/ai-practice/the-model-is-not-the-moat.md +40 -0
  40. package/templates/codex/seed/ai-practice/when-generation-is-cheap-judgment-is-the-work.md +39 -0
  41. package/templates/codex/seed/judgment/contextual-stewardship-is-the-senior-skill.md +50 -0
  42. package/templates/codex/seed/judgment/decision-quality-is-distinct-from-outcome-quality.md +39 -0
  43. package/templates/codex/seed/judgment/embrace-reality-ego-and-blind-spots.md +38 -0
  44. package/templates/codex/seed/judgment/groups-seek-consensus-individuals-seek-truth.md +44 -0
  45. package/templates/codex/seed/judgment/heresies-are-where-the-edge-lives.md +42 -0
  46. package/templates/codex/seed/judgment/judgment-compounds-through-honest-reflection.md +38 -0
  47. package/templates/codex/seed/judgment/phronesis-is-judgment-in-the-particular.md +67 -0
  48. package/templates/codex/seed/judgment/show-me-the-apparatus.md +40 -0
  49. package/templates/codex/seed/judgment/small-judgment-gaps-compound-under-leverage.md +37 -0
  50. package/templates/codex/seed/judgment/taste-is-compressed-judgment.md +38 -0
  51. package/templates/codex/seed/judgment/trust-taste-only-where-feedback-is-valid.md +42 -0
  52. package/templates/codex/seed/judgment/weigh-the-reasoning-not-the-recommendation.md +43 -0
  53. package/templates/codex/seed/leadership/a-managers-output-is-the-teams-output.md +35 -0
  54. package/templates/codex/seed/leadership/most-team-problems-are-structural.md +40 -0
  55. package/templates/codex/seed/leadership/next-play.md +36 -0
  56. package/templates/codex/seed/leadership/psychological-safety.md +39 -0
  57. package/templates/codex/seed/leadership/right-size-your-teams.md +38 -0
  58. package/templates/codex/seed/leadership/spend-time-on-high-leverage-activities.md +36 -0
  59. package/templates/codex/seed/leadership/talent-density-is-the-master-variable.md +39 -0
  60. package/templates/codex/seed/leadership/under-pressure-calm-is-contagious.md +36 -0
  61. package/templates/codex/seed/leadership/your-best-alternative-is-your-leverage.md +37 -0
  62. package/templates/codex/seed/pm/a-problem-well-stated-is-half-solved.md +39 -0
  63. package/templates/codex/seed/pm/a-real-strategy-makes-planning-trivial.md +40 -0
  64. package/templates/codex/seed/pm/barrels-and-ammunition.md +39 -0
  65. package/templates/codex/seed/pm/develop-taste-in-your-beliefs.md +38 -0
  66. package/templates/codex/seed/pm/hire-for-progress.md +44 -0
  67. package/templates/codex/seed/pm/jobs-are-stable-solutions-churn.md +39 -0
  68. package/templates/codex/seed/pm/level-by-the-ambiguity-someone-can-own.md +39 -0
  69. package/templates/codex/seed/pm/listen-before-you-prescribe.md +38 -0
  70. package/templates/codex/seed/pm/live-in-the-future-and-build-whats-missing.md +38 -0
  71. package/templates/codex/seed/pm/match-effort-to-leverage.md +37 -0
  72. package/templates/codex/seed/pm/not-my-fault-but-my-problem.md +40 -0
  73. package/templates/codex/seed/pm/pick-the-job-then-refuse-everything-outside-it.md +37 -0
  74. package/templates/codex/seed/pm/retention-sets-the-ceiling.md +38 -0
  75. package/templates/codex/seed/pm/scale-with-leaders-not-process.md +38 -0
  76. package/templates/codex/seed/pm/solution-discovery-over-problem-validation.md +38 -0
  77. package/templates/codex/seed/pm/tenfold-better-on-a-painful-problem.md +40 -0
  78. package/templates/codex-surface/README.md +73 -0
  79. package/templates/codex-surface/hooks/_resolve.sh +36 -0
  80. package/templates/codex-surface/hooks/recall-guard.sh +30 -0
  81. package/templates/codex-surface/hooks/session-start.sh +18 -0
  82. package/templates/codex-surface/hooks/session-sweep-precompact.sh +20 -0
  83. package/templates/codex-surface/hooks/session-sweep-subagent.sh +23 -0
  84. package/templates/codex-surface/hooks/session-sweep.sh +19 -0
  85. package/templates/codex-surface/hooks.json +69 -0
  86. package/templates/domains/pm/AGENTS.md +111 -0
  87. package/templates/domains/pm/MEMORY.md +7 -0
  88. package/templates/domains/pm/USER.md +8 -0
  89. package/templates/phronesis-hooks/compile-active-context.sh +38 -0
  90. package/templates/phronesis-hooks/recall-guard.sh +103 -0
  91. package/templates/phronesis-hooks/session-start.sh +90 -0
  92. package/templates/phronesis-hooks/session-sweep.sh +140 -0
  93. package/templates/phronesis-hooks/skill-lifecycle.sh +37 -0
  94. package/templates/skills/compile/SKILL.md +279 -0
  95. package/templates/skills/compile/evals/rubric.md +75 -0
  96. package/templates/skills/decision-log/SKILL.md +156 -0
  97. package/templates/skills/decision-log/evals/rubric.md +97 -0
  98. package/templates/skills/extract-gold-dust/SKILL.md +311 -0
  99. package/templates/skills/extract-gold-dust/evals/rubric.md +52 -0
  100. package/templates/skills/ingest/SKILL.md +204 -0
  101. package/templates/skills/ingest/evals/rubric.md +117 -0
  102. package/templates/skills/lint/SKILL.md +246 -0
  103. package/templates/skills/lint/evals/rubric.md +139 -0
  104. package/templates/skills/meeting-prep/SKILL.md +195 -0
  105. package/templates/skills/meeting-prep/evals/rubric.md +93 -0
  106. package/templates/skills/onboard/SKILL.md +258 -0
  107. package/templates/skills/onboard/evals/rubric.md +60 -0
  108. package/templates/skills/prd-draft/SKILL.md +193 -0
  109. package/templates/skills/prd-draft/evals/rubric.md +38 -0
  110. package/templates/skills/prep-extraction/SKILL.md +217 -0
  111. package/templates/skills/prep-extraction/evals/rubric.md +45 -0
  112. package/templates/skills/recall/SKILL.md +155 -0
  113. package/templates/skills/recall/evals/rubric.md +37 -0
  114. package/templates/skills/research/SKILL.md +247 -0
  115. package/templates/skills/research/evals/rubric.md +139 -0
  116. package/templates/skills/stakeholder-update/SKILL.md +163 -0
  117. package/templates/skills/stakeholder-update/evals/rubric.md +111 -0
  118. package/vendor/core/package.json +25 -0
  119. package/vendor/core/src/action-registry.js +459 -0
  120. package/vendor/core/src/action-writers.js +201 -0
  121. package/vendor/core/src/actions.js +2140 -0
  122. package/vendor/core/src/active-context.js +167 -0
  123. package/vendor/core/src/artifacts.js +301 -0
  124. package/vendor/core/src/content-digest.js +21 -0
  125. package/vendor/core/src/contract.js +245 -0
  126. package/vendor/core/src/event-log.js +338 -0
  127. package/vendor/core/src/guard.js +398 -0
  128. package/vendor/core/src/hook-executor.js +527 -0
  129. package/vendor/core/src/index.js +180 -0
  130. package/vendor/core/src/ingest.js +286 -0
  131. package/vendor/core/src/install-root.js +42 -0
  132. package/vendor/core/src/layout.js +13 -0
  133. package/vendor/core/src/link-index.js +198 -0
  134. package/vendor/core/src/lint.js +368 -0
  135. package/vendor/core/src/schedule.js +535 -0
  136. package/vendor/core/src/search.js +534 -0
  137. package/vendor/core/src/session-hooks.js +129 -0
  138. package/vendor/core/src/skill-lifecycle.js +479 -0
  139. package/vendor/core/src/skill-registry.js +524 -0
  140. package/vendor/core/src/subscription.js +84 -0
  141. package/vendor/core/src/validate-object.js +62 -0
  142. package/vendor/core/src/workspace-scan.js +125 -0
@@ -0,0 +1,39 @@
1
+ ---
2
+ type: codex-principle-seed
3
+ name: talent-density-is-the-master-variable
4
+ title: Talent Density Is the Master Variable
5
+ created: 2026-06-24
6
+ exposure: shareable
7
+ stance: adopted
8
+ provenance:
9
+ authored_by: seed
10
+ ---
11
+
12
+ > **Talent density is the master variable: in creative work the best are many times more
13
+ > productive than the average, so one outstanding person outperforms two adequate ones —
14
+ > and the bar a team tolerates becomes the bar it meets.**
15
+
16
+ In procedural work the best are perhaps twice as good as the average; in creative,
17
+ inventive work the gap is an order of magnitude. When individual output varies that
18
+ widely, *who* is on the team dominates *how* the team is run — density beats process, and
19
+ headcount is not the lever it appears to be. A high performer raises everyone around them;
20
+ a tolerated low performer drags the whole team down and teaches it what is acceptable. The
21
+ discipline is to raise talent density faster than complexity grows, so the organization
22
+ can run on judgment and freedom rather than on rules written to contain its weakest work.
23
+
24
+ The mechanism that maintains density is honest assessment: would you fight to keep each
25
+ person if they tried to leave? Anyone you would not is a slot better opened. This only
26
+ works alongside psychological safety — high standards without safety produce fear and
27
+ politics, not performance. High standards and safety together produce the candor-driven
28
+ performance the whole model is after.
29
+
30
+ *Diagnostic: would you enthusiastically re-hire everyone on your team today? Each person
31
+ you would hesitate over is quietly teaching the rest where the real bar sits.*
32
+
33
+ *Source: Reed Hastings and Patty McCord.*
34
+
35
+ ## Interview Prompt
36
+
37
+ If everyone on your team had to re-interview today, who would you fight hard to keep — and
38
+ what is the presence, or absence, of your strongest people teaching everyone else about
39
+ the standard?
@@ -0,0 +1,36 @@
1
+ ---
2
+ type: codex-principle-seed
3
+ name: under-pressure-calm-is-contagious
4
+ title: Under Pressure, Your Calm Is Contagious
5
+ created: 2026-06-24
6
+ exposure: shareable
7
+ stance: adopted
8
+ provenance:
9
+ authored_by: seed
10
+ ---
11
+
12
+ > **Under pressure your own state is contagious before your words are. Steady yourself
13
+ > first — the room catches your calm or your panic within the first minute.**
14
+
15
+ The highest-stakes rooms are lost not by being wrong but by arriving wound-up: racing in
16
+ late, over-intense, transmitting an urgency that the other people absorb and mirror. The
17
+ target is not a better script but a lower heart rate. Arrive with a minute to spare so the
18
+ room settles onto your nervous system rather than the reverse; and when you do slip,
19
+ apologize in one line and move on — the elaborate, flustered apology keeps your own pulse
20
+ high and prevents the other side from letting it go, when they were ready to.
21
+
22
+ When you do speak, compress to the one thing that must land. Pressure pushes you to hedge
23
+ every claim until nothing is left to act on; a short, clear, true statement reads as
24
+ command, while an over-explained one reads as panic. Clarity, under stress, is a kindness
25
+ to the people who have to act on what you say.
26
+
27
+ *Diagnostic: just after a high-stakes moment, notice your own state. If your pulse is
28
+ still racing, the room felt that too — and that, more than your words, is what the people
29
+ in it will remember.*
30
+
31
+ *Source: Sam Lessin.*
32
+
33
+ ## Interview Prompt
34
+
35
+ Recall a high-pressure moment you led people through. What state were you actually
36
+ transmitting to the room — and how did that shape what happened next?
@@ -0,0 +1,37 @@
1
+ ---
2
+ type: codex-principle-seed
3
+ name: your-best-alternative-is-your-leverage
4
+ title: Your Best Alternative Is Your Leverage
5
+ created: 2026-06-24
6
+ exposure: shareable
7
+ stance: adopted
8
+ provenance:
9
+ authored_by: seed
10
+ ---
11
+
12
+ > **Your real power in any negotiation is your best alternative to making a deal. The
13
+ > ability to walk away is the source of leverage; without it you are not negotiating, you
14
+ > are asking permission.**
15
+
16
+ When your needs are already met, you negotiate from strength and can hold your position;
17
+ when you are desperate, you concede to authority. This is why it is easier to find a job
18
+ while you still have one, and why the side with a credible alternative sets the floor for
19
+ the whole conversation. Strengthening your alternative — before you ever sit down — does
20
+ more for your position than any tactic at the table.
21
+
22
+ Two habits protect that leverage. Do not let haste betray it: urgency benefits the other
23
+ side, and slowing down signals that you are not cornered. And where you can, let the other
24
+ side name the first number — the party that anchors early sets the ceiling, and you learn
25
+ more from what they offer than from what you demand.
26
+
27
+ *Diagnostic: before any negotiation or hard ask, name your best alternative if you walk
28
+ away. If you do not have one — or know you will not actually use it — you do not yet have
29
+ leverage, and the move is to build the alternative, not to push harder.*
30
+
31
+ *Source: Roger Fisher and William Ury, the BATNA concept.*
32
+
33
+ ## Interview Prompt
34
+
35
+ Think of a negotiation or hard ask in front of you right now. What is your honest best
36
+ alternative if you walk away — and how much does having, or lacking, that alternative
37
+ change how you will show up?
@@ -0,0 +1,39 @@
1
+ ---
2
+ type: codex-principle-seed
3
+ name: a-problem-well-stated-is-half-solved
4
+ title: A Problem Well Stated Is a Problem Half Solved
5
+ created: 2026-06-24
6
+ exposure: shareable
7
+ stance: adopted
8
+ provenance:
9
+ authored_by: seed
10
+ ---
11
+
12
+ > **The constraint on learning is rarely more tests — it's a problem stated clearly enough
13
+ > that a test can resolve it.**
14
+
15
+ It's tempting to treat experimentation as a throughput game: run more tests, learn more. But
16
+ you can run a dozen tests against a misformulated problem and get a dozen wrong answers
17
+ faster. The binding constraint is usually understanding — naming the real problem precisely
18
+ enough that a test can actually resolve it. A single well-aimed question that reframes the
19
+ problem often makes the solution write itself, after every test aimed at the wrong framing
20
+ came back flat.
21
+
22
+ This is why experiments are instruments for finding out you're wrong, not for confirming
23
+ you're right. A test that no possible result could change is theater; the one worth running is
24
+ the smallest test whose outcome would actually move your decision. The leverage sits upstream
25
+ of the test — in the qualitative work of stating the problem honestly — because the test only
26
+ multiplies whatever understanding you bring to it.
27
+
28
+ *Diagnostic: look at your last several tests. How many were preceded by a step that actually
29
+ defined the problem being tested — a real conversation, a close look at where people get stuck
30
+ — versus jumping straight to variants of a guess? If most skipped that step, you're testing
31
+ guesses faster, not learning.*
32
+
33
+ *Source: Charles Kettering.*
34
+
35
+ ## Interview Prompt
36
+
37
+ Think of a problem you've been running at without progress. Have you actually stated it
38
+ precisely — or are you testing variations of a guess? Describe a time when restating the
39
+ problem made the answer obvious.
@@ -0,0 +1,40 @@
1
+ ---
2
+ type: codex-principle-seed
3
+ name: a-real-strategy-makes-planning-trivial
4
+ title: A Real Strategy Makes Planning Trivial
5
+ created: 2026-06-24
6
+ exposure: shareable
7
+ stance: adopted
8
+ provenance:
9
+ authored_by: seed
10
+ ---
11
+
12
+ > **When you have a real, aligned strategy, planning collapses to a short exercise. When
13
+ > planning is painful, the problem isn't the process — it's a missing or unshared strategy
14
+ > upstream.**
15
+
16
+ A leader with a genuine product strategy can do annual planning in a few days; peers without
17
+ one burn four to six weeks in spreadsheet hell — dependency mapping, false-precision debates
18
+ over whether it's eight engineers or nine, stakeholder theater — and then forget the plan a
19
+ month later and execute off a different list anyway. The friction isn't a planning-tooling
20
+ problem you can fix with a better template. It's the absence of the upstream thing that would
21
+ make the choices obvious. A strategy is what lets you quickly dismiss even positive-return
22
+ work that doesn't serve it; without one, every option looks defensible and nothing settles.
23
+
24
+ This makes planning friction a *diagnostic*. When the plan won't come together — when the
25
+ debates loop, when everyone is working from a slightly different list — don't grind harder on
26
+ the planning. Treat the pain as the signal that the strategy is missing, or that you haven't
27
+ actually achieved alignment on it. Fix that, and planning becomes a formality rather than a
28
+ season.
29
+
30
+ *Diagnostic: if planning is a recurring slog, stop debugging the process and ask whether a
31
+ clear, agreed-upon strategy actually exists. The slog is usually a missing strategy wearing a
32
+ planning problem's clothes.*
33
+
34
+ *Source: Shreyas Doshi.*
35
+
36
+ ## Interview Prompt
37
+
38
+ When your team plans, is it a quick formality or a drawn-out fight? If it's a fight, what
39
+ would have to be true upstream — about your strategy or your alignment on it — for the plan to
40
+ settle itself?
@@ -0,0 +1,39 @@
1
+ ---
2
+ type: codex-principle-seed
3
+ name: barrels-and-ammunition
4
+ title: Barrels and Ammunition
5
+ created: 2026-06-24
6
+ exposure: shareable
7
+ stance: adopted
8
+ provenance:
9
+ authored_by: seed
10
+ ---
11
+
12
+ > **The number of people who can independently drive an initiative from inception to success
13
+ > — the "barrels" — sets how many things your organization can do in parallel. Everyone else
14
+ > is ammunition.**
15
+
16
+ Hiring more people without growing the count of barrels just stacks ammunition behind the
17
+ same initiatives: more coordination cost, no more output. Barrels are rare. Even famously
18
+ talent-dense organizations have only a handful, and most very good companies have about two.
19
+ The test is simple to state and hard to pass: "There's a hill — get us over it." Someone who
20
+ can take an ambiguous goal, accumulate the resources, motivate the people, measure progress,
21
+ and deliver the outcome come hell or high water is a barrel. Anything less, however capable,
22
+ is ammunition.
23
+
24
+ The practical consequence shows up when headcount doubles and throughput doesn't. The reflex
25
+ is to question execution or motivation; the real answer is almost always that you added
26
+ ammunition, not barrels. Growing the number of people who can own an outcome end-to-end — by
27
+ finding them, developing them, and actually handing them the initiative — is the constraint
28
+ that determines how many things you can do at once.
29
+
30
+ *Diagnostic: when more people haven't produced more output, count your barrels, not your
31
+ headcount. If the barrel count didn't rise, you bought coordination cost, not throughput.*
32
+
33
+ *Source: Keith Rabois.*
34
+
35
+ ## Interview Prompt
36
+
37
+ How many people on your team could take an ambiguous goal and carry it all the way to a
38
+ delivered outcome without you steering? What would it take to turn one more of your people
39
+ into that kind of owner?
@@ -0,0 +1,38 @@
1
+ ---
2
+ type: codex-principle-seed
3
+ name: develop-taste-in-your-beliefs
4
+ title: Develop Taste in Your Beliefs
5
+ created: 2026-06-24
6
+ exposure: shareable
7
+ stance: adopted
8
+ provenance:
9
+ authored_by: seed
10
+ ---
11
+
12
+ > **Taste isn't only about recognizing good design — it's about the quality of the beliefs
13
+ > you choose to hold. Evaluate the idea separately from the social proof wrapping it.**
14
+
15
+ We get seduced by the packaging around ideas rather than the ideas themselves: by vivid
16
+ metaphors (a phrase wins because it's catchy, not because it's true), by alliteration ("fail
17
+ fast" would never have caught on as "fail slowly"), by authority bias (a famous founder said
18
+ it, so it must apply to your context), and by complicated charts we don't actually
19
+ understand. Each of these is social proof masquerading as substance. The discipline is to
20
+ strip the packaging and judge what's underneath.
21
+
22
+ Real taste is the ability to recognize quality *before* the scoreboard confirms it. Calling
23
+ a now-celebrated leader a genius today takes nothing — the results are public record.
24
+ Recognizing it years earlier, before the consensus formed, took genuine judgment. The person
25
+ didn't change in the interval; what changed was who could see it early. That early seeing —
26
+ believing the right thing before it's safe and obvious — is what taste in beliefs actually
27
+ buys you, and it's a different muscle from admiring something after it has already won.
28
+
29
+ *Diagnostic: when a framework or strategic bet attracts you, ask — am I drawn to the idea
30
+ itself, or to the metaphor, the authority, or the popularity around it? Strip all three and
31
+ see whether the claim still stands on its own.*
32
+
33
+ *Source: Shreyas Doshi.*
34
+
35
+ ## Interview Prompt
36
+
37
+ Think of a belief currently shaping your strategy. How much of your confidence comes from the
38
+ idea itself versus the vividness, the authority, or the popularity of where you first heard it?
@@ -0,0 +1,44 @@
1
+ ---
2
+ type: codex-principle-seed
3
+ name: hire-for-progress
4
+ title: Hire for Progress, Not for Features
5
+ created: 2026-06-24
6
+ exposure: shareable
7
+ stance: adopted
8
+ provenance:
9
+ authored_by: seed
10
+ ---
11
+
12
+ > **People don't buy products — they hire them to make progress in a circumstance. The
13
+ > unit of analysis is the job, not the customer's demographics or the product's features.**
14
+
15
+ A job is what someone is really trying to accomplish in a given situation — from "pass the
16
+ time while waiting in line" to "transition into a new life." When a product does that job
17
+ well, the customer hires it again; when it does the job badly, they fire it and look for an
18
+ alternative. The decisive shift is to reason from the progress someone is struggling to
19
+ make, not from "who is my customer and what features do they want."
20
+
21
+ The circumstance matters more than the customer's characteristics. Demographics correlate
22
+ with behavior but don't cause it — two people who look nothing alike on paper may hire the
23
+ same product for the same job, and one person hires different products for the same job in
24
+ different circumstances. The trap of abundant data is that it pulls teams toward correlation
25
+ ("customers like this one also bought…") when they need causation ("what progress was this
26
+ person trying to make?"). Defining the job by its circumstance is what restores causal
27
+ reasoning. It's also why you can ship a functionally correct product nobody hires: jobs are
28
+ never only functional — they carry social and emotional weight, and missing that dimension
29
+ misses the job.
30
+
31
+ A clear understanding of the job becomes a kind of spec — it lets you design and make
32
+ trade-offs without guessing, because you know what the customer is actually trying to get
33
+ done rather than what they happen to look like.
34
+
35
+ *Diagnostic: for your product, finish this sentence in the customer's own words — "I hire
36
+ this to ______ when ______." If all you can describe is who the customer is or which
37
+ features they touch, you haven't found the job yet.*
38
+
39
+ *Source: Clayton Christensen.*
40
+
41
+ ## Interview Prompt
42
+
43
+ What is a customer of yours actually trying to get done in the moment they reach for what
44
+ you've built — and how much of that job is emotional or social rather than purely functional?
@@ -0,0 +1,39 @@
1
+ ---
2
+ type: codex-principle-seed
3
+ name: jobs-are-stable-solutions-churn
4
+ title: Jobs Are Stable; Solutions Churn
5
+ created: 2026-06-24
6
+ exposure: shareable
7
+ stance: adopted
8
+ provenance:
9
+ authored_by: seed
10
+ ---
11
+
12
+ > **The job a customer is trying to get done stays remarkably constant over time; the
13
+ > products hired to do it change constantly. Anchor strategy to the durable job, not the
14
+ > current solution.**
15
+
16
+ People have wanted to enjoy music for as long as there has been music; the solution churned
17
+ through records, cassettes, CDs, downloads, and streaming while the underlying job held
18
+ still. This is the most useful asymmetry in the framework: solutions, technologies, and
19
+ competitors are transient, but the job endures. A roadmap anchored to a current solution
20
+ inherits the solution's expiration date. A roadmap anchored to the job survives the next
21
+ technology shift, because the thing it serves doesn't move.
22
+
23
+ The same stability redraws your competitive set. If the unit is the job, your competition is
24
+ everything a customer could hire to make that progress — a rival in an entirely different
25
+ category, a makeshift workaround, or simply doing nothing at all. Defining competitors by the
26
+ job rather than the category is what keeps you from being blindsided by something that looks
27
+ nothing like you but does the same job better — or by the customer who just keeps coping with
28
+ the status quo because no option is worth the switch.
29
+
30
+ *Diagnostic: state the job your product does in one solution-free sentence, then list
31
+ everything a customer could hire for it — rivals, substitutes, hacks, and inaction. The
32
+ threats you'd never have listed by category are usually where displacement comes from.*
33
+
34
+ *Source: Tony Ulwick.*
35
+
36
+ ## Interview Prompt
37
+
38
+ What is the enduring job underneath your product that will still exist when today's
39
+ technology is obsolete — and who or what else is currently being hired to do it?
@@ -0,0 +1,39 @@
1
+ ---
2
+ type: codex-principle-seed
3
+ name: level-by-the-ambiguity-someone-can-own
4
+ title: Level by the Ambiguity Someone Can Own
5
+ created: 2026-06-24
6
+ exposure: shareable
7
+ stance: adopted
8
+ provenance:
9
+ authored_by: seed
10
+ ---
11
+
12
+ > **A person's real level is the size of the ambiguous, undefined problem you can hand them
13
+ > and walk away from.**
14
+
15
+ Seniority is not years or title; it is how much ambiguity someone can absorb without needing
16
+ the strategy supplied from above. The great filter in most careers is the jump from executing
17
+ well-defined work to owning the definition itself — taking a problem that arrives as a vague,
18
+ unowned mess and resolving it into a plan, and then into results. People who only execute
19
+ compound into strong operators; people who learn to own ambiguity compound into leaders. You
20
+ develop someone toward the second by handing them genuinely complex surfaces to own, with real
21
+ autonomy, and letting them grow into the scope.
22
+
23
+ The hiring corollary is to bet on slope over credentials — on how fast someone is climbing
24
+ into larger ambiguity, not on the polish of what they've already collected. The willingness to
25
+ take a role you're not yet qualified for, fall for a while, and climb out is exactly where
26
+ outsized growth comes from. Beware the asymmetry: a polished outsider's limits are hidden by
27
+ the interview, while a high-slope insider's limits are visible because you've watched them
28
+ work — which biases you toward the wrong one unless you correct for it.
29
+
30
+ *Diagnostic: for each person you're leveling or hiring, ask how large a problem you could hand
31
+ them with no definition and no oversight before they stall. That boundary is their real level
32
+ — and their growth is whether it's moving outward.*
33
+
34
+ *Sources: Casey Winters; Molly Graham.*
35
+
36
+ ## Interview Prompt
37
+
38
+ How much ambiguity can you take on before you need someone above you to define the problem?
39
+ Describe the most undefined, unowned problem you've turned into a real outcome on your own.
@@ -0,0 +1,38 @@
1
+ ---
2
+ type: codex-principle-seed
3
+ name: listen-before-you-prescribe
4
+ title: Listen Before You Prescribe
5
+ created: 2026-06-24
6
+ exposure: shareable
7
+ stance: adopted
8
+ provenance:
9
+ authored_by: seed
10
+ ---
11
+
12
+ > **When you step into a new leadership role, listen first and synthesize what you heard into
13
+ > a shared, public set of observations — before announcing priorities from instinct.**
14
+
15
+ The disciplined sequence is weeks of structured listening before any prescription. Ask
16
+ everyone the same few questions — how the organization fits together, what is going well,
17
+ what most needs to change — and gather enough conversations that patterns emerge rather than
18
+ anecdotes. Then write the synthesis down and share it openly. That observations document does
19
+ three things at once: it forces you to turn dozens of conversations into coherent themes, it
20
+ signals to the organization that you actually listened, and it becomes the anchor everyone
21
+ defers back to when later decisions get contested.
22
+
23
+ The failure modes it replaces are the common ones. Less-disciplined leaders announce
24
+ priorities in week one — fast, confident, and uninformed — or they avoid committing to
25
+ anything for six months and leave the team rudderless. Listening first, then publishing what
26
+ you heard, is what earns the right to prescribe. The writing is the leadership act, not a
27
+ report on it.
28
+
29
+ *Diagnostic: early in a new role, ask whether you could write a synthesis of what's going on
30
+ that your team would read and recognize as true. If you can't yet, you've been talking more
31
+ than listening — and you haven't earned the prescription.*
32
+
33
+ *Source: Sriram Krishnan.*
34
+
35
+ ## Interview Prompt
36
+
37
+ If you joined a new team tomorrow, what questions would you ask everyone before proposing a
38
+ single change — and would you have the discipline to publish what you heard before acting on it?
@@ -0,0 +1,38 @@
1
+ ---
2
+ type: codex-principle-seed
3
+ name: live-in-the-future-and-build-whats-missing
4
+ title: Live in the Future and Build What's Missing
5
+ created: 2026-06-24
6
+ exposure: shareable
7
+ stance: adopted
8
+ provenance:
9
+ authored_by: seed
10
+ ---
11
+
12
+ > **The best ideas are noticed, not brainstormed — by people living at the leading edge of a
13
+ > change.**
14
+
15
+ Good ideas aren't thought up at a whiteboard; they're noticed by people who already live in a
16
+ changed world and see what's obviously missing from it. Someone at the frontier of a
17
+ fast-moving field — as a builder or as a heavy user — feels gaps that people who haven't lived
18
+ through the change literally cannot see yet. The recipe compresses to: live in the future,
19
+ then build what's missing. An even better version is to build what seems *interesting*,
20
+ because the things that look like toys to outsiders often have everything an idea needs except
21
+ a track record, and the importance shows up later.
22
+
23
+ The counter-pattern is the made-up idea — the plausible-sounding concept you reasoned into
24
+ existence rather than noticed. These survive precisely because you can imagine *someone* using
25
+ them, and they dissolve on contact with real users, who all say "I could see using something
26
+ like that" and then never do. Noticed ideas come from lived friction; invented ideas come
27
+ from imagining other people's lives.
28
+
29
+ *Diagnostic: for your current idea, can you point to the specific moment you noticed the gap
30
+ in your own life or work — or did you reason your way to it because it sounded like a good
31
+ business? The first kind has a witness; the second kind only has an argument.*
32
+
33
+ *Source: Paul Graham.*
34
+
35
+ ## Interview Prompt
36
+
37
+ Where are you living at the leading edge of a change most people haven't caught up to yet —
38
+ and what feels obviously missing to you there that doesn't exist yet?
@@ -0,0 +1,37 @@
1
+ ---
2
+ type: codex-principle-seed
3
+ name: match-effort-to-leverage
4
+ title: Match Effort to Leverage
5
+ created: 2026-06-24
6
+ exposure: shareable
7
+ stance: adopted
8
+ provenance:
9
+ authored_by: seed
10
+ ---
11
+
12
+ > **Match your effort to the leverage of the task, not to the task itself.**
13
+
14
+ Not every task deserves the same quality bar. A few are high-leverage — they return ten to a
15
+ hundred times the effort you put in, and they deserve your best hours and your inner
16
+ perfectionist. Most are neutral — they return roughly what you invest, so do them adequately
17
+ and move on. A third kind is pure overhead — it returns less than you put in, so do it at the
18
+ minimum quality that clears the bar.
19
+
20
+ The non-obvious part: the same activity can be high-leverage, neutral, or overhead depending
21
+ on context. Notes from a routine status meeting are overhead — send them the moment it ends.
22
+ Notes from a contentious decision meeting are high-leverage — spend the hours to make the
23
+ language airtight, because a misread there costs weeks. Perfectionists burn themselves out by
24
+ treating every task as high-leverage; the discipline is permission to be deliberately
25
+ mediocre exactly where mediocrity is free.
26
+
27
+ *Diagnostic: look at where your best hours actually went last week. Were they spent on the
28
+ two or three things that compounded, or spread evenly across everything in the inbox? Any
29
+ low-leverage task that got your perfectionism was effort stolen from a high-leverage one.*
30
+
31
+ *Source: Shreyas Doshi.*
32
+
33
+ ## Interview Prompt
34
+
35
+ Think about how your effort is spread across a typical week. Which tasks quietly deserve far
36
+ more care than you give them — and which are you over-polishing when "good enough" would cost
37
+ you nothing?
@@ -0,0 +1,40 @@
1
+ ---
2
+ type: codex-principle-seed
3
+ name: not-my-fault-but-my-problem
4
+ title: Not My Fault, but It Is My Problem
5
+ created: 2026-06-24
6
+ exposure: shareable
7
+ stance: adopted
8
+ provenance:
9
+ authored_by: seed
10
+ ---
11
+
12
+ > **When a decision-maker doesn't buy your idea, treat it as your problem to solve — not their
13
+ > failure to understand.**
14
+
15
+ If a leader doesn't approve your idea, the satisfying story is that they didn't get it. The
16
+ useful stance is the opposite: it's not your fault, but it is your problem. They operate with
17
+ fragmented context — their attention jumps between unrelated problems like a strobe light —
18
+ and with constraints you can't see (budget, pressure from above, commitments you weren't in
19
+ the room for), and they're optimizing for the whole while you optimize for your part. Walking
20
+ in to get approval is the mistake; walk in to learn what would strengthen the plan and to find
21
+ out what they actually doubt.
22
+
23
+ Managing up is managing the decision and the context around it, not just presenting a
24
+ recommendation. Part of the job is learning how a given person's judgment activates — whether
25
+ they move on data, on customer stories, on design, on the numbers — and bringing the case in
26
+ that form. Owning that gap, instead of assigning blame for it, is the shift from junior to
27
+ senior. And once a call is made, the same ownership means committing to make it work rather
28
+ than relitigating it.
29
+
30
+ *Diagnostic: after a proposal doesn't land, listen to your own explanation. Are you describing
31
+ why they failed to understand — or asking what context you failed to supply, and what doubt
32
+ you failed to answer? The first keeps you stuck; the second is the move.*
33
+
34
+ *Source: Jessica Fain.*
35
+
36
+ ## Interview Prompt
37
+
38
+ Think of a time a decision-maker didn't back your idea. Did you treat it as their failure to
39
+ get it, or as a gap in how you made the case — and what would change if you assumed the
40
+ second?
@@ -0,0 +1,37 @@
1
+ ---
2
+ type: codex-principle-seed
3
+ name: pick-the-job-then-refuse-everything-outside-it
4
+ title: Pick the Job, Then Refuse Everything Outside It
5
+ created: 2026-06-24
6
+ exposure: shareable
7
+ stance: adopted
8
+ provenance:
9
+ authored_by: seed
10
+ ---
11
+
12
+ > **Strategy is choosing one job to do and declining everything outside it — especially the
13
+ > lucrative, adjacent, tempting things you'd be good at.**
14
+
15
+ Anyone can pick a focus; the discipline is *applying* it as a binary filter over the constant
16
+ stream of adjacent-but-misaligned opportunities. Turn the jobs-to-be-done lens on your own
17
+ offering: name the single job you exist to do, and let every build-or-decline decision flow
18
+ from that one choice. A partnership that pays well but serves a different job is a decline. A
19
+ move you'd execute beautifully but that doesn't advance the chosen job is a decline. When
20
+ your strategy compresses to one crisp sentence, the compromises become visibly obvious — you
21
+ can see, in the moment, that an opportunity is off-strategy even when it's attractive on its
22
+ own terms.
23
+
24
+ The hardest version is refusing something genuinely lucrative. Operators walk away from
25
+ "opportunity of a lifetime" offers precisely because taking them would dilute the one job
26
+ their work is built around. That refusal is not a cost of the strategy; it *is* the strategy.
27
+ A focus you never decline anything for isn't a strategy — it's a preference.
28
+
29
+ *Diagnostic: can you name the specific thing you would refuse even though it's lucrative and
30
+ you'd be good at it? If not, you've picked a vibe, not a job.*
31
+
32
+ *Source: Lenny Rachitsky.*
33
+
34
+ ## Interview Prompt
35
+
36
+ What is the one job your product or team exists to do — and what attractive, profitable
37
+ opportunity have you turned down (or should you) because it falls outside that job?
@@ -0,0 +1,38 @@
1
+ ---
2
+ type: codex-principle-seed
3
+ name: retention-sets-the-ceiling
4
+ title: Retention Sets the Ceiling
5
+ created: 2026-06-24
6
+ exposure: shareable
7
+ stance: adopted
8
+ provenance:
9
+ authored_by: seed
10
+ ---
11
+
12
+ > **Retention sets a hard ceiling on how large you can become; acquisition only fills a bucket
13
+ > that retention keeps from leaking.**
14
+
15
+ There's a simple, brutal formula: new customers per period divided by your churn rate is the
16
+ maximum number of customers you will ever have. Add a hundred a month against five percent
17
+ monthly churn and you will never exceed two thousand — because cancellations grow in
18
+ proportion to the base (five percent of a bigger number is a bigger number) while acquisition
19
+ grows only as fast as you can improve it, which is slow and linear. Cancellations always
20
+ overtake acquisition eventually. That is why growth slows, and why retention sits upstream of
21
+ everything else.
22
+
23
+ The corollary is about what compounds. Acquisition you have to keep buying decays the moment
24
+ you stop paying for it; loops you build into the product — word of mouth, referral, usage that
25
+ pulls in more usage — compound on themselves. Pouring acquisition spend into a product that
26
+ leaks just raises your cost per customer on a treadmill. Fix the leak first; a loop on top of
27
+ a product people stay in is the only growth that doesn't decay.
28
+
29
+ *Diagnostic: compute your ceiling right now — new customers per period over churn rate. If
30
+ that number is smaller than your ambition, retention is your single most important problem, no
31
+ matter what else is on the roadmap.*
32
+
33
+ *Source: Jason Cohen.*
34
+
35
+ ## Interview Prompt
36
+
37
+ If you divide the customers you add each month by the rate at which they leave, what's the
38
+ largest you could ever become? And does that ceiling match the size of your ambition?