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.
- package/README.md +66 -0
- package/package.json +34 -0
- package/src/act.js +61 -0
- package/src/active-context.js +56 -0
- package/src/adapter.js +386 -0
- package/src/cli.js +1893 -0
- package/src/codex-hooks-schema.js +92 -0
- package/src/compile.js +513 -0
- package/src/doctor.js +303 -0
- package/src/due.js +271 -0
- package/src/eval.js +467 -0
- package/src/event.js +212 -0
- package/src/export.js +136 -0
- package/src/guard.js +89 -0
- package/src/hooks.js +230 -0
- package/src/ingest.js +965 -0
- package/src/init.js +150 -0
- package/src/layout.js +394 -0
- package/src/links.js +83 -0
- package/src/lint.js +58 -0
- package/src/profile.js +116 -0
- package/src/prompts.js +26 -0
- package/src/registry.js +190 -0
- package/src/scaffold.js +134 -0
- package/src/search.js +139 -0
- package/src/skill-discovery.js +117 -0
- package/src/skills-bump.js +885 -0
- package/src/skills.js +355 -0
- package/src/subscription.js +5 -0
- package/src/validate.js +152 -0
- package/templates/claude/settings.json +86 -0
- package/templates/codex/INDEX.md +68 -0
- package/templates/codex/seed/ai-practice/compile-dont-just-capture.md +42 -0
- package/templates/codex/seed/ai-practice/design-for-the-distribution.md +42 -0
- package/templates/codex/seed/ai-practice/from-spec-author-to-outcome-curator.md +43 -0
- package/templates/codex/seed/ai-practice/recall-builds-trust-when-calibrated.md +70 -0
- package/templates/codex/seed/ai-practice/the-eval-is-the-spec.md +42 -0
- package/templates/codex/seed/ai-practice/the-gold-dust-leaves-no-trace.md +72 -0
- package/templates/codex/seed/ai-practice/the-model-is-not-the-moat.md +40 -0
- package/templates/codex/seed/ai-practice/when-generation-is-cheap-judgment-is-the-work.md +39 -0
- package/templates/codex/seed/judgment/contextual-stewardship-is-the-senior-skill.md +50 -0
- package/templates/codex/seed/judgment/decision-quality-is-distinct-from-outcome-quality.md +39 -0
- package/templates/codex/seed/judgment/embrace-reality-ego-and-blind-spots.md +38 -0
- package/templates/codex/seed/judgment/groups-seek-consensus-individuals-seek-truth.md +44 -0
- package/templates/codex/seed/judgment/heresies-are-where-the-edge-lives.md +42 -0
- package/templates/codex/seed/judgment/judgment-compounds-through-honest-reflection.md +38 -0
- package/templates/codex/seed/judgment/phronesis-is-judgment-in-the-particular.md +67 -0
- package/templates/codex/seed/judgment/show-me-the-apparatus.md +40 -0
- package/templates/codex/seed/judgment/small-judgment-gaps-compound-under-leverage.md +37 -0
- package/templates/codex/seed/judgment/taste-is-compressed-judgment.md +38 -0
- package/templates/codex/seed/judgment/trust-taste-only-where-feedback-is-valid.md +42 -0
- package/templates/codex/seed/judgment/weigh-the-reasoning-not-the-recommendation.md +43 -0
- package/templates/codex/seed/leadership/a-managers-output-is-the-teams-output.md +35 -0
- package/templates/codex/seed/leadership/most-team-problems-are-structural.md +40 -0
- package/templates/codex/seed/leadership/next-play.md +36 -0
- package/templates/codex/seed/leadership/psychological-safety.md +39 -0
- package/templates/codex/seed/leadership/right-size-your-teams.md +38 -0
- package/templates/codex/seed/leadership/spend-time-on-high-leverage-activities.md +36 -0
- package/templates/codex/seed/leadership/talent-density-is-the-master-variable.md +39 -0
- package/templates/codex/seed/leadership/under-pressure-calm-is-contagious.md +36 -0
- package/templates/codex/seed/leadership/your-best-alternative-is-your-leverage.md +37 -0
- package/templates/codex/seed/pm/a-problem-well-stated-is-half-solved.md +39 -0
- package/templates/codex/seed/pm/a-real-strategy-makes-planning-trivial.md +40 -0
- package/templates/codex/seed/pm/barrels-and-ammunition.md +39 -0
- package/templates/codex/seed/pm/develop-taste-in-your-beliefs.md +38 -0
- package/templates/codex/seed/pm/hire-for-progress.md +44 -0
- package/templates/codex/seed/pm/jobs-are-stable-solutions-churn.md +39 -0
- package/templates/codex/seed/pm/level-by-the-ambiguity-someone-can-own.md +39 -0
- package/templates/codex/seed/pm/listen-before-you-prescribe.md +38 -0
- package/templates/codex/seed/pm/live-in-the-future-and-build-whats-missing.md +38 -0
- package/templates/codex/seed/pm/match-effort-to-leverage.md +37 -0
- package/templates/codex/seed/pm/not-my-fault-but-my-problem.md +40 -0
- package/templates/codex/seed/pm/pick-the-job-then-refuse-everything-outside-it.md +37 -0
- package/templates/codex/seed/pm/retention-sets-the-ceiling.md +38 -0
- package/templates/codex/seed/pm/scale-with-leaders-not-process.md +38 -0
- package/templates/codex/seed/pm/solution-discovery-over-problem-validation.md +38 -0
- package/templates/codex/seed/pm/tenfold-better-on-a-painful-problem.md +40 -0
- package/templates/codex-surface/README.md +73 -0
- package/templates/codex-surface/hooks/_resolve.sh +36 -0
- package/templates/codex-surface/hooks/recall-guard.sh +30 -0
- package/templates/codex-surface/hooks/session-start.sh +18 -0
- package/templates/codex-surface/hooks/session-sweep-precompact.sh +20 -0
- package/templates/codex-surface/hooks/session-sweep-subagent.sh +23 -0
- package/templates/codex-surface/hooks/session-sweep.sh +19 -0
- package/templates/codex-surface/hooks.json +69 -0
- package/templates/domains/pm/AGENTS.md +111 -0
- package/templates/domains/pm/MEMORY.md +7 -0
- package/templates/domains/pm/USER.md +8 -0
- package/templates/phronesis-hooks/compile-active-context.sh +38 -0
- package/templates/phronesis-hooks/recall-guard.sh +103 -0
- package/templates/phronesis-hooks/session-start.sh +90 -0
- package/templates/phronesis-hooks/session-sweep.sh +140 -0
- package/templates/phronesis-hooks/skill-lifecycle.sh +37 -0
- package/templates/skills/compile/SKILL.md +279 -0
- package/templates/skills/compile/evals/rubric.md +75 -0
- package/templates/skills/decision-log/SKILL.md +156 -0
- package/templates/skills/decision-log/evals/rubric.md +97 -0
- package/templates/skills/extract-gold-dust/SKILL.md +311 -0
- package/templates/skills/extract-gold-dust/evals/rubric.md +52 -0
- package/templates/skills/ingest/SKILL.md +204 -0
- package/templates/skills/ingest/evals/rubric.md +117 -0
- package/templates/skills/lint/SKILL.md +246 -0
- package/templates/skills/lint/evals/rubric.md +139 -0
- package/templates/skills/meeting-prep/SKILL.md +195 -0
- package/templates/skills/meeting-prep/evals/rubric.md +93 -0
- package/templates/skills/onboard/SKILL.md +258 -0
- package/templates/skills/onboard/evals/rubric.md +60 -0
- package/templates/skills/prd-draft/SKILL.md +193 -0
- package/templates/skills/prd-draft/evals/rubric.md +38 -0
- package/templates/skills/prep-extraction/SKILL.md +217 -0
- package/templates/skills/prep-extraction/evals/rubric.md +45 -0
- package/templates/skills/recall/SKILL.md +155 -0
- package/templates/skills/recall/evals/rubric.md +37 -0
- package/templates/skills/research/SKILL.md +247 -0
- package/templates/skills/research/evals/rubric.md +139 -0
- package/templates/skills/stakeholder-update/SKILL.md +163 -0
- package/templates/skills/stakeholder-update/evals/rubric.md +111 -0
- package/vendor/core/package.json +25 -0
- package/vendor/core/src/action-registry.js +459 -0
- package/vendor/core/src/action-writers.js +201 -0
- package/vendor/core/src/actions.js +2140 -0
- package/vendor/core/src/active-context.js +167 -0
- package/vendor/core/src/artifacts.js +301 -0
- package/vendor/core/src/content-digest.js +21 -0
- package/vendor/core/src/contract.js +245 -0
- package/vendor/core/src/event-log.js +338 -0
- package/vendor/core/src/guard.js +398 -0
- package/vendor/core/src/hook-executor.js +527 -0
- package/vendor/core/src/index.js +180 -0
- package/vendor/core/src/ingest.js +286 -0
- package/vendor/core/src/install-root.js +42 -0
- package/vendor/core/src/layout.js +13 -0
- package/vendor/core/src/link-index.js +198 -0
- package/vendor/core/src/lint.js +368 -0
- package/vendor/core/src/schedule.js +535 -0
- package/vendor/core/src/search.js +534 -0
- package/vendor/core/src/session-hooks.js +129 -0
- package/vendor/core/src/skill-lifecycle.js +479 -0
- package/vendor/core/src/skill-registry.js +524 -0
- package/vendor/core/src/subscription.js +84 -0
- package/vendor/core/src/validate-object.js +62 -0
- 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?
|