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,44 @@
1
+ ---
2
+ type: codex-principle-seed
3
+ name: groups-seek-consensus-individuals-seek-truth
4
+ title: Groups Seek Consensus; Truth-Seeking Needs Structure
5
+ created: 2026-06-24
6
+ exposure: shareable
7
+ stance: adopted
8
+ provenance:
9
+ authored_by: seed
10
+ ---
11
+
12
+ > **Groups optimize for consensus; only individuals and small, structured teams reliably
13
+ > seek truth.**
14
+
15
+ This is structural, not a moral failing. Groups require cohesion to function, and cohesion
16
+ requires shared narratives. When a truth conflicts with the group's narrative, the group
17
+ tends to reject the truth before it rejects itself. Large institutions drift toward worse
18
+ explanations over time because they optimize for internal alignment, not external accuracy.
19
+
20
+ But the fix is not "work alone." Truth-seeking has working machinery, and it is a *group*
21
+ discipline built to defeat the group's own pull. Two practitioners from different
22
+ high-feedback domains converged on the same apparatus: an explicit charter of accuracy,
23
+ accountability, and openness to disagreement; quarantine protocols (describe a decision
24
+ without first revealing the outcome or your own belief, so the group doesn't infect itself);
25
+ and stress-testing views against the smartest people who *disagree*, caring about their
26
+ reasoning rather than their seniority. Both reduce to *reasoning to be accurate, not to be
27
+ right*. Teams structured for accuracy beat lone independents — what corrupts truth is
28
+ unstructured cohesion-seeking, not collaboration itself.
29
+
30
+ One trap this machinery is built against: the illusion of validity — confidence tracks the
31
+ coherence of your story, not the quality of your evidence, so you cannot validate a belief
32
+ from the inside. The premortem (imagine the plan has already failed, and write down why)
33
+ manufactures the outside view and the dissent the group won't otherwise generate.
34
+
35
+ *Test: when did your team last change a fundamental belief because of evidence? If the
36
+ honest answer is "never," it is consensus-seeking, not truth-seeking.*
37
+
38
+ *Sources: Naval Ravikant; the truth-seeking apparatus of Annie Duke and Ray Dalio.*
39
+
40
+ ## Interview Prompt
41
+
42
+ When your team confronts an uncomfortable truth, what actually happens — does it get
43
+ examined or smoothed over? Describe the last time evidence changed a belief your group held,
44
+ and what made that possible.
@@ -0,0 +1,42 @@
1
+ ---
2
+ type: codex-principle-seed
3
+ name: heresies-are-where-the-edge-lives
4
+ title: Heresies Are Where the Edge Lives
5
+ created: 2026-06-24
6
+ exposure: shareable
7
+ stance: adopted
8
+ provenance:
9
+ authored_by: seed
10
+ ---
11
+
12
+ > **Cross "true vs false" with "spreadable vs non-spreadable," and the competitive edge lives
13
+ > in the true-but-unspreadable quadrant — the heresies.**
14
+
15
+ Four quadrants:
16
+
17
+ > - **True + spreadable** — conventional wisdom. Already known; no edge.
18
+ > - **False + spreadable** — what spreads because it confirms what people want to believe.
19
+ > - **True + non-spreadable** — heresies. True but threatening to group identity. *This is
20
+ > where competitive advantage lives.*
21
+ > - **False + non-spreadable** — nonsense. Ignored and harmless.
22
+
23
+ What spreads is what confirms existing beliefs or provokes emotion, largely regardless of
24
+ truth value — so heresies don't spread (too threatening) and conventional wisdom doesn't need
25
+ to (already known). The strategic move is to seek out heresies: ideas that make smart people
26
+ uncomfortable but that you can't find a good argument against. They are disproportionately
27
+ likely to be both true and valuable precisely because the social cost of believing them keeps
28
+ competitors away. In product strategy, the most valuable insights are often the things the
29
+ market "knows" are wrong — "people won't pay for X" is frequently conventional wisdom that a
30
+ heretical builder disproves.
31
+
32
+ *Diagnostic: what do you believe about your domain that you'd be reluctant to say out loud to
33
+ your peers — not because it's edgy, but because you can't find a good counter-argument and it
34
+ would make them uncomfortable? That list is your candidate-heresy portfolio.*
35
+
36
+ *Source: Naval Ravikant.*
37
+
38
+ ## Interview Prompt
39
+
40
+ What's something you believe about your market or product that most people in your field
41
+ would push back on — but you can't find a good argument against? What would it mean if you're
42
+ right?
@@ -0,0 +1,38 @@
1
+ ---
2
+ type: codex-principle-seed
3
+ name: judgment-compounds-through-honest-reflection
4
+ title: Judgment Compounds Through Honest Reflection
5
+ created: 2026-06-24
6
+ exposure: shareable
7
+ stance: adopted
8
+ provenance:
9
+ authored_by: seed
10
+ ---
11
+
12
+ > **Judgment is experience plus honest reflection, compounded over many iterations.**
13
+
14
+ You can't shortcut judgment. It requires making decisions, observing outcomes, and
15
+ honestly evaluating what worked and why — not rationalizing after the fact. The honest
16
+ part is the whole game. Most people accumulate experience without accumulating judgment
17
+ because they never honestly assess their mistakes: they explain them away, blame
18
+ circumstances, or avoid the domains where they failed. Judgment compounds only when the
19
+ feedback loop is honest. This is why some people have twenty years of judgment and others
20
+ have one year of judgment repeated twenty times.
21
+
22
+ The unit of learning is iterations, not hours. The ten-thousand-hours meme has the
23
+ variable wrong. An iteration is: do something, reflect honestly on the outcome, change
24
+ something, try again. Time without honest reflection just repeats the same mistake.
25
+ Deliberate iteration with real feedback develops judgment in far fewer cycles than any
26
+ time-based model predicts.
27
+
28
+ *Diagnostic: are you measurably better at decisions in your domain than a year ago? Can
29
+ you name specific beliefs you've updated because an outcome proved you wrong? If not,
30
+ you're collecting experience, not compounding judgment.*
31
+
32
+ *Source: Naval Ravikant.*
33
+
34
+ ## Interview Prompt
35
+
36
+ Think of a recent decision in your work that didn't go the way you expected. Looking back,
37
+ are you reflecting honestly on why — or quietly explaining it away? Name one belief you've
38
+ actually changed because an outcome proved you wrong.
@@ -0,0 +1,67 @@
1
+ ---
2
+ type: codex-principle-seed
3
+ name: phronesis-is-judgment-in-the-particular
4
+ title: "Phronesis: Judgment in the Particular"
5
+ created: 2026-07-02
6
+ exposure: shareable
7
+ stance: adopted
8
+ provenance:
9
+ authored_by: seed
10
+ ---
11
+
12
+ > **Judgment lives in the particular case, not in the rule that gestures at it. The
13
+ > work is perceiving what this situation calls for, when no rule fits cleanly and no
14
+ > past case maps.**
15
+
16
+ Aristotle split practical intelligence three ways, and the product is named for one
17
+ of them. *Techne* knows the procedure: it makes a product to spec, and you grade it
18
+ against the product. *Sophia* knows the principle: the eternal, the general, the
19
+ true-everywhere. *Phronesis* knows the moment: the right thing to do here, now, with
20
+ these people, where the material is contingent and no procedure closes the gap. This
21
+ workspace is built for the third one. The software is *techne*, a made thing with
22
+ skills and loops. The codex holds *sophia*, the principles you have adopted. Neither
23
+ is the judgment. The judgment is the act of bringing both to bear on the case in
24
+ front of you.
25
+
26
+ The defining move is the priority of the particular. No rule is fine-grained enough
27
+ to settle the case, so the grasp of the particular outranks the grasp of the rule.
28
+ Aristotle's own test: knowing "light meats are wholesome" produces no health; knowing
29
+ *which* meat is light does. Phronesis is not deduction. It is a trained perception
30
+ built only from experience, the compressed residue of many seen cases, which is why a
31
+ young person can be a brilliant mathematician but not yet practically wise. The
32
+ capacity is accumulated, not derived. It is also why catching your cases and
33
+ returning the relevant one is phronetic work: it feeds the perception that only
34
+ experience builds.
35
+
36
+ Skill alone is not wisdom. Aristotle names *deinotes*, cleverness: the bare ability
37
+ to find effective means to any end, good or bad. Phronesis contains cleverness but
38
+ adds the right aim, and without a rightly-ordered end, cleverness is only cleverness.
39
+ That is the line between practical wisdom and mere expertise, and it is the line a
40
+ bare model cannot cross on its own, because a model supplies means, not ends. The
41
+ product holds both halves on purpose. The raw and compiled layers hold the perception
42
+ (your cases, your caught decisions). The codex holds the aim (your taste, your
43
+ validated principles, what you actually value). Retrieval without the codex would be
44
+ *deinotes*: fast, fluent, aimless. The codex is what makes it wisdom instead of clever
45
+ recall.
46
+
47
+ The last move is the sharpest. The standard of a right call is not a formula but a
48
+ person: the good choice is the one the practically wise person, the *phronimos*, would
49
+ make. There is no algorithm for it. This is why the workspace seeds from operators who
50
+ already have phronesis in a domain, borrowed exemplars rather than invented rules, and
51
+ why it never claims judgment of its own. The system perceives which piece matters and
52
+ pairs your particulars with your principles. The call stays yours. A tool that dressed
53
+ rule-following as judgment would be selling the opposite of the thing it is named for.
54
+
55
+ *Diagnostic: when you reach for the right move, notice whether you are applying a rule
56
+ or reading a case. If a rule settles it cleanly, that is techne and it can be written
57
+ down. The moments where the rule runs out and you decide anyway are your phronesis.
58
+ Those are the ones worth catching.*
59
+
60
+ *Source: Aristotle, Nicomachean Ethics, Book VI (and II.6 for the phronimos as the
61
+ standard of the mean).*
62
+
63
+ ## Interview Prompt
64
+
65
+ Where in your work does the rule run out? Name a recent call where no procedure or
66
+ past case quite fit and you had to read the specific situation and decide. What did
67
+ you see that told you which way to go?
@@ -0,0 +1,40 @@
1
+ ---
2
+ type: codex-principle-seed
3
+ name: show-me-the-apparatus
4
+ title: Show Me the Apparatus
5
+ created: 2026-06-24
6
+ exposure: shareable
7
+ stance: adopted
8
+ provenance:
9
+ authored_by: seed
10
+ ---
11
+
12
+ > **A stated value isn't real until there's enforced machinery that makes betraying it
13
+ > structurally impossible — not merely discouraged.**
14
+
15
+ The diagnostic separates real commitments from slogans. A company files its quarterly report
16
+ on time because there is a massive, expensive apparatus that guarantees it — ask the
17
+ probability and the answer is 100%. Ask the probability that it never cuts a corner on
18
+ quality, safety, performance, design, or innovation, and the honest answer is "well, 90%."
19
+ The gap between 100% and 90% is the gap between what is load-bearing (backed by machinery)
20
+ and what is merely aspirational (backed by intentions). The values organizations claim
21
+ loudest and protect least — safety, performance, quality, design, innovation — are exactly
22
+ the ones no expensive apparatus enforces, so they're the first cut under pressure.
23
+
24
+ For any value you or your organization claims, ask: what is the apparatus? Not the slogan,
25
+ not the all-hands speech, not the value painted on the wall — the enforced machinery that
26
+ makes betraying it structurally impossible. If you can't name it, the value is aspirational,
27
+ and under pressure it will be the first thing to go. A value defended only by good intentions
28
+ is a control that can be quietly bypassed; a value defended by gates, owners, and
29
+ accountability is one that actually holds.
30
+
31
+ *Diagnostic: run this on your own roadmap. Which of your stated quality or safety commitments
32
+ have explicit gates, owners, and accountability — and which are just things you say you care
33
+ about? The second list is what you'll quietly cut the next time you're behind.*
34
+
35
+ *Source: Eric Ries.*
36
+
37
+ ## Interview Prompt
38
+
39
+ Name a value you or your team claims to hold. What's the actual enforced machinery that makes
40
+ betraying it impossible — or is it, honestly, just something you say you care about?
@@ -0,0 +1,37 @@
1
+ ---
2
+ type: codex-principle-seed
3
+ name: small-judgment-gaps-compound-under-leverage
4
+ title: Small Judgment Gaps Compound Under Leverage
5
+ created: 2026-06-24
6
+ exposure: shareable
7
+ stance: adopted
8
+ provenance:
9
+ authored_by: seed
10
+ ---
11
+
12
+ > **With leverage, a small difference in judgment produces an enormous difference in
13
+ > outcome.**
14
+
15
+ In a world without leverage, the gap between good and great judgment barely matters — you
16
+ dig one ditch or two. With leverage — code, media, capital, automation — that same judgment
17
+ gap produces tenfold or hundredfold outcome differences. Slightly better judgment about what
18
+ to build reaches millions more people; slightly better judgment about timing captures a
19
+ winner-take-all market. This is why judgment is the skill to develop above all others: it is
20
+ the multiplier on everything else you do.
21
+
22
+ The corollary is that as leverage rises, the *return* on improving your judgment rises with
23
+ it — and so does the cost of a judgment error, because leverage amplifies bad calls just as
24
+ faithfully as good ones. The operator with high leverage and mediocre judgment is not safe;
25
+ they are efficiently amplifying their mistakes.
26
+
27
+ *Diagnostic: where are you adding leverage (tools, capital, automation, audience) without a
28
+ matching investment in the judgment that aims it? That gap is where leverage turns from a
29
+ multiplier into a magnifier of error.*
30
+
31
+ *Source: Naval Ravikant.*
32
+
33
+ ## Interview Prompt
34
+
35
+ Where in your work does a small difference in judgment get multiplied into a large
36
+ difference in outcome? And where are you adding leverage faster than you're sharpening the
37
+ judgment that points it?
@@ -0,0 +1,38 @@
1
+ ---
2
+ type: codex-principle-seed
3
+ name: taste-is-compressed-judgment
4
+ title: Taste Is Compressed Judgment
5
+ created: 2026-06-24
6
+ exposure: shareable
7
+ stance: adopted
8
+ provenance:
9
+ authored_by: seed
10
+ ---
11
+
12
+ > **Taste is judgment you can no longer articulate.**
13
+
14
+ Taste is the late stage of judgment. When you've iterated enough, pattern recognition
15
+ becomes so fast and integrated that the reasoning goes subconscious — you "just know" the
16
+ answer. This isn't mystical; it's compressed computation. A senior practitioner who looks
17
+ at a draft and says "this isn't right" without being able to explain why is running
18
+ thousands of prior cases through unconscious pattern matching.
19
+
20
+ The progression has rough stages. First you reason through each decision with explicit
21
+ logic. Then your subconscious starts supplementing the reasoning and you can still say why.
22
+ Then "it doesn't feel right" becomes a valid and reliable signal that you can't fully
23
+ explain. Finally your whole body reacts — wisdom lodged below thought. Most masters of a
24
+ craft operate in the last two stages.
25
+
26
+ Two failure modes guard the principle. Taste can look like arrogance to people who haven't
27
+ developed it, so it has to be earned, not asserted. And taste without continued learning
28
+ calcifies into dogma. The test of real taste is that it still updates: someone with
29
+ genuine taste changes their mind against strong enough counter-evidence, even when they
30
+ can't articulate why the old read was wrong.
31
+
32
+ *Source: Naval Ravikant.*
33
+
34
+ ## Interview Prompt
35
+
36
+ Where in your work do you "just know" the right call without being able to fully explain
37
+ it? And when did you last change one of those gut judgments because the evidence forced you
38
+ to?
@@ -0,0 +1,42 @@
1
+ ---
2
+ type: codex-principle-seed
3
+ name: trust-taste-only-where-feedback-is-valid
4
+ title: Trust Taste Only Where Feedback Is Valid
5
+ created: 2026-06-24
6
+ exposure: shareable
7
+ stance: adopted
8
+ provenance:
9
+ authored_by: seed
10
+ ---
11
+
12
+ > **Trained intuition is real — but only where the environment is regular and the feedback
13
+ > is fast and clear. Everywhere else, confidence is not a signal.**
14
+
15
+ Taste develops under two conditions: a high-validity environment (stable, learnable
16
+ regularities between cues and outcomes) and enough practice with rapid, unequivocal
17
+ feedback. Where both hold — chess, surgery, a well-instrumented product loop — intuition is
18
+ genuine recognition. Where they fail — "wicked" environments, long-horizon forecasting,
19
+ anywhere feedback is delayed, sparse, or ambiguous — confident intuition is the *illusion of
20
+ validity*, and the felt confidence is no signal at all. Confidence tracks the internal
21
+ coherence of your story, not the quality of your evidence; redundant and flimsy evidence
22
+ still produces high confidence.
23
+
24
+ So the discipline is to audit the *environment and your learning history*, never the
25
+ feeling. Before trusting a gut call, ask: is this domain regular enough that valid cues
26
+ exist, and have I had many reps with fast, clear feedback in it? If either answer is no,
27
+ force the model, the outside view, or a premortem instead of trusting taste. This is also
28
+ the boundary on deliberate practice — reps only build taste where the feedback is valid;
29
+ grinding in a wicked environment manufactures confidence without skill. Roadmap and
30
+ long-horizon forecasting are closer to low-validity than they feel.
31
+
32
+ *Diagnostic: sort your domains into "fast, clear feedback" and "slow or murky feedback."
33
+ Trust your gut in the first; distrust it and scaffold the decision in the second — no matter
34
+ how confident it feels.*
35
+
36
+ *Sources: Daniel Kahneman and Gary Klein.*
37
+
38
+ ## Interview Prompt
39
+
40
+ In which parts of your work do you get fast, clear feedback on whether a call was right —
41
+ and in which is the feedback slow or murky? Where might you be trusting a confident gut in a
42
+ domain that doesn't actually feed it good signal?
@@ -0,0 +1,43 @@
1
+ ---
2
+ type: codex-principle-seed
3
+ name: weigh-the-reasoning-not-the-recommendation
4
+ title: Weigh the Reasoning, Not the Recommendation
5
+ created: 2026-06-24
6
+ exposure: shareable
7
+ stance: adopted
8
+ provenance:
9
+ authored_by: seed
10
+ ---
11
+
12
+ > **Every advisor is a pattern-matching system trained on a particular corpus of experience.
13
+ > Their recommendation is calibrated for their context; the reasoning is the part that
14
+ > transfers.**
15
+
16
+ When a respected operator gives you advice, the recommendation is the output of *their*
17
+ system applied to *your* inputs — calibrated for their corpus, their stage, their failures.
18
+ The reasoning behind it — why they reached that conclusion, what trade-offs they saw, what
19
+ pattern they're matching against — is the part worth extracting. The recommendation often
20
+ doesn't transfer; the reasoning often does. The classic case is a leader who eliminated an
21
+ entire role at their company: the recommendation may not transfer to yours, but *why* they
22
+ did it is highly informative — and may yield a different action in your context.
23
+
24
+ The operational move: when an advisor recommends X, the next question is "why did you reach
25
+ that conclusion?" — not "should I do X?" Then back-propagate. What corpus is this advisor
26
+ pattern-matching against? What features of their corpus does the recommendation depend on?
27
+ Do those features exist in yours? If yes for all the load-bearing features, it likely
28
+ transfers. If no for any, extract the reasoning and modify the recommendation. If no for
29
+ most, the recommendation doesn't transfer — but the underlying mechanism still might, if you
30
+ can find its analog in your situation.
31
+
32
+ The failure modes this guards against: *cargo-cult adoption* (taking advice as-is because
33
+ the source is high-status), *cargo-cult rejection* (discarding it as-is because the source
34
+ has a different context, when the reasoning was transferable), and *status-weighted updating*
35
+ (weighting by the advisor's status rather than the reasoning's transferability, which leaves
36
+ your beliefs lurching as you move between high-status sources).
37
+
38
+ *Source: Howie Liu.*
39
+
40
+ ## Interview Prompt
41
+
42
+ Think of advice you recently got from someone you respect. What was the *reasoning* behind
43
+ it — and do the conditions that made it right for them actually hold in your situation?
@@ -0,0 +1,35 @@
1
+ ---
2
+ type: codex-principle-seed
3
+ name: a-managers-output-is-the-teams-output
4
+ title: A Manager's Output Is the Team's Output
5
+ created: 2026-06-24
6
+ exposure: shareable
7
+ stance: adopted
8
+ provenance:
9
+ authored_by: seed
10
+ ---
11
+
12
+ > **A manager's output is the output of their team plus the output of the teams they
13
+ > influence — not the work they personally produce.**
14
+
15
+ This is the line that separates a manager from a senior individual contributor. Your own
16
+ skills and knowledge are worth almost nothing on their own; they count only insofar as
17
+ they raise the performance of the people around you. Knowing more about the work than
18
+ anyone else in the building produces zero output until you can transfer that knowledge
19
+ into the organization. The job is no longer measured by how much you personally make, but
20
+ by how much your team makes because of you.
21
+
22
+ The corollary reorders how you spend a day: every hour should be judged by its *leverage*
23
+ — how much team output it produces — not by how busy or productive it felt. A manager can
24
+ have a full, satisfying day of personal work and move the team's output not at all.
25
+
26
+ *Diagnostic: at the end of a busy day, ask whether your hours raised what your team can
27
+ produce — or only what you produced. If the honest answer is the latter, you spent the
28
+ day as a contributor, not as a manager.*
29
+
30
+ *Source: Andy Grove.*
31
+
32
+ ## Interview Prompt
33
+
34
+ Looking back on your last week, how much of what you produced actually multiplied through
35
+ your team — versus work you could have done just as well in any individual role?
@@ -0,0 +1,40 @@
1
+ ---
2
+ type: codex-principle-seed
3
+ name: most-team-problems-are-structural
4
+ title: Most Team Problems Are Structural, Not Personal
5
+ created: 2026-06-24
6
+ exposure: shareable
7
+ stance: adopted
8
+ provenance:
9
+ authored_by: seed
10
+ ---
11
+
12
+ > **When something is wrong on a team, diagnose top-down — most problems that look like
13
+ > people problems are structural problems wearing a people-problem costume.**
14
+
15
+ The default instinct when a team struggles is to go straight to the individuals: they are
16
+ not getting along, that one is not pulling their weight. Invert it. Picture four layers
17
+ beneath the surface — structural (goals, roles, expectations), dynamics (how the team
18
+ decides, resolves conflict, meets), interpersonal (specific relationships), and
19
+ intrapersonal (one person's capacity or motivation). Start at the top and only go deeper
20
+ when the layer above is genuinely clean. Snorkel before you scuba. The large majority of
21
+ what looks like underperformance turns out to be unclear goals, ambiguous roles, or an
22
+ undefined definition of success.
23
+
24
+ The reason leaders skip to the bottom is that people-layer interventions feel productive —
25
+ you had a conversation, something happened — while confronting structural debt feels like
26
+ admitting you did not set things up well. If you do nothing else as a manager, make roles
27
+ and expectations clear and shared; that alone resolves a surprising fraction of what gets
28
+ mislabeled as a performance problem.
29
+
30
+ *Diagnostic: the next time you think "X is the problem on this team," check first whether
31
+ the goals are clear and shared, the roles explicit, and success defined in writing —
32
+ before you conclude the problem is a person.*
33
+
34
+ *Source: Molly Graham.*
35
+
36
+ ## Interview Prompt
37
+
38
+ Think of someone on your team who seems to be underperforming. Before you reached that
39
+ conclusion, how clear and shared were their goals, their role, and the definition of what
40
+ success looks like?
@@ -0,0 +1,36 @@
1
+ ---
2
+ type: codex-principle-seed
3
+ name: next-play
4
+ title: Next Play
5
+ created: 2026-06-24
6
+ exposure: shareable
7
+ stance: adopted
8
+ provenance:
9
+ authored_by: seed
10
+ ---
11
+
12
+ > **After an error, the compounding error — the defensive overcorrection that follows —
13
+ > usually does more damage than the original. Make the mistake, forget it, run the next
14
+ > play.**
15
+
16
+ A player who clanks a shot tends to overplay the next possession to compensate, and the
17
+ overcompensation draws the foul that actually costs the game. The same reflex runs through
18
+ teams: after an unforced error come the defensive reviews, the blame postmortems, the
19
+ performative caution — and that wave of compensation costs more than the miss it was meant
20
+ to answer. The discipline is not to skip the lesson; it is to take the lesson without the
21
+ penance, and re-orient immediately on the next move.
22
+
23
+ Naming the move — "next play" — is what creates the gap between the error and the decision
24
+ that follows it, so the next decision is made fresh instead of in the shadow of the last
25
+ one.
26
+
27
+ *Diagnostic: after your team's last unforced error, did the following weeks fill with
28
+ extra reviews, individual blame, and performative humility from leaders? If so, the
29
+ compounding error cost you more than the original ever did.*
30
+
31
+ *Sources: Mike Krzyzewski; Brian Halligan.*
32
+
33
+ ## Interview Prompt
34
+
35
+ Think about the last real mistake your team made. What did the days after it look like —
36
+ and did the response end up costing you more than the mistake itself?
@@ -0,0 +1,39 @@
1
+ ---
2
+ type: codex-principle-seed
3
+ name: psychological-safety
4
+ title: Psychological Safety
5
+ created: 2026-06-24
6
+ exposure: shareable
7
+ stance: gravity
8
+ provenance:
9
+ authored_by: seed
10
+ ---
11
+
12
+ > **The single largest factor in team effectiveness is psychological safety — a shared
13
+ > belief that the team is safe for interpersonal risk-taking.**
14
+
15
+ It is not an individual feeling but a team-level property: the confidence that speaking
16
+ up, admitting a mistake, asking for help, or challenging a decision will not lead to
17
+ embarrassment, rejection, or punishment. Where it is present, people surface errors early,
18
+ ask the questions that prevent disasters, and experiment. Where it is absent, they hide
19
+ problems until the problems are too large to hide. Safety drives *learning behavior*, and
20
+ learning behavior is what drives performance — the safety itself does not satisfy the
21
+ customer, it enables the team to do the things that do.
22
+
23
+ Guard against the four misreadings. It is not cohesiveness — cohesive groups can suppress
24
+ dissent, which is the opposite of safety. It is not niceness, not lowered standards, not
25
+ comfort with the status quo. The most common failure is to hear "psychological safety" and
26
+ install politeness, which produces an artificial harmony that quietly kills candor. High
27
+ standards and high safety are complements, not opposites: safety is what turns candor into
28
+ a learning input rather than a threat.
29
+
30
+ *Diagnostic: when someone on your team last made a real mistake, did they bring it to you
31
+ early — or did you find out late, from somewhere else? A team that hides errors is
32
+ reporting its climate, not its competence.*
33
+
34
+ *Source: Amy Edmondson.*
35
+
36
+ ## Interview Prompt
37
+
38
+ On your team, what actually happens when someone admits a mistake, asks for help, or
39
+ disagrees with you in front of others? Walk through the last time it happened.
@@ -0,0 +1,38 @@
1
+ ---
2
+ type: codex-principle-seed
3
+ name: right-size-your-teams
4
+ title: Right-Size Your Teams
5
+ created: 2026-06-24
6
+ exposure: shareable
7
+ stance: adopted
8
+ provenance:
9
+ authored_by: seed
10
+ ---
11
+
12
+ > **The fundamental lever of organizational design is team sizing: build small, stable,
13
+ > autonomous teams — large enough to gel and survive a departure, small enough to move
14
+ > fast.**
15
+
16
+ Most recurring structural questions — how many teams, a new team or an existing one, where
17
+ the boundary falls — reduce to sizing. A useful range: a manager can actively support
18
+ roughly six to eight people before degrading into a reactive coach-and-safety-net who is
19
+ too busy to invest in anyone. Below about four, a group stops behaving like a team at all
20
+ — it becomes a leaky abstraction over a set of individuals, fragile enough that one
21
+ departure tips it from momentum back into toil, and you find yourself reasoning about
22
+ every vacation and on-call shift one person at a time.
23
+
24
+ Two companions make sizing durable. Drive the design from the structure, not the key
25
+ individuals — fit the org to particular personalities and you buy frequent reorgs and
26
+ organizational debt as those people move on. And protect teams that have gelled: groups
27
+ that have worked together a long time are extraordinarily productive, while constant
28
+ membership churn means a team never gels at all.
29
+
30
+ *Diagnostic: if you have to reason about every vacation and on-call shift individually,
31
+ your "team" is too small to be a team — it is a set of individuals wearing a team's name.*
32
+
33
+ *Source: Will Larson.*
34
+
35
+ ## Interview Prompt
36
+
37
+ Look at how your teams are sized right now. Where is one too small to survive a single
38
+ departure, or too large for everyone to move together — and what is keeping it that shape?
@@ -0,0 +1,36 @@
1
+ ---
2
+ type: codex-principle-seed
3
+ name: spend-time-on-high-leverage-activities
4
+ title: Spend Your Time on High-Leverage Activities
5
+ created: 2026-06-24
6
+ exposure: shareable
7
+ stance: adopted
8
+ provenance:
9
+ authored_by: seed
10
+ ---
11
+
12
+ > **Leverage is output divided by the time the activity took — so spend your scarce hours
13
+ > on the acts whose effect multiplies across many people.**
14
+
15
+ Three things raise a manager's productivity: doing activities faster, raising the leverage
16
+ of each activity, or shifting the mix toward higher-leverage ones. High-leverage acts
17
+ share a shape — one action that affects many people (a training everyone attends, a
18
+ process everyone uses), a brief action with a long-running effect (a sentence that
19
+ redirects a project for months), or being the one person who can supply a particular
20
+ skill at a particular moment.
21
+
22
+ The underused half of the idea is that leverage runs *negative*. Meddling, waffling on a
23
+ decision people are waiting for, and demoralizing behavior all *subtract* from team
24
+ output. A leader can put in a full, energetic day and end it having produced net-negative
25
+ leverage — busy, and worse than absent.
26
+
27
+ *Diagnostic: find the single activity whose effect ripples across the most people — a
28
+ decision others are blocked on, a process everyone will use, an hour spent teaching. Then
29
+ look at what you actually spent today on instead.*
30
+
31
+ *Source: Andy Grove.*
32
+
33
+ ## Interview Prompt
34
+
35
+ Which of the things you do regularly has the widest ripple across other people's work —
36
+ and honestly, how much of your week actually goes to it?