Files of Writing the kernel
wondelai/
Show the full text163 lines
Writing the Kernel
Table of Contents
- What the Kernel Is
- Diagnosis Craft
- Formulating the Guiding Policy
- Designing Coherent Actions
- The Kernel Template
- Worked Example 1: Seed-Stage Startup
- Worked Example 2: Established Product
- When Is a Kernel Done
What the Kernel Is
The kernel is the minimum viable structure of a strategy: a diagnosis that defines the nature of the challenge, a guiding policy that commits to an overall approach for dealing with it, and a set of coherent actions that carry the policy out. Everything else in a strategy document — market sizing, vision statements, financial projections — is either input to the kernel or decoration around it.
The kernel deliberately excludes things most strategy documents lead with:
| Common plan artifact | What it actually is | Kernel replacement |
|---|---|---|
| Vision statement | A description of a desired future | Diagnosis of what stands between you and any future |
| Mission and values | Identity and conduct norms | Nothing — they are fine, but they are not strategy |
| Goals and targets ("$10M ARR") | Ambitions; outputs of strategy | Guiding policy: the approach that could produce them |
| List of initiatives | Department wish lists | Coherent actions that reinforce one another |
| SWOT grid | Raw material | A judgment about which item on the grid is the challenge |
A kernel fits on one page. If it does not, you have not finished choosing.
Diagnosis Craft
The diagnosis is the most skipped and most valuable element. It is a judgment — a simplification of messy reality that names the critical challenge and, implicitly, what kind of situation you are in. Get it wrong and everything downstream is coordinated effort aimed at the wrong target.
Finding the critical challenge
- Collect the raw mess. List every problem, threat, complaint, and stalled ambition: churn numbers, lost-deal notes, competitor moves, team frustrations. Do not filter yet. Aim for 15-30 items.
- Cluster into candidate challenges. Group items that share a cause. "Sales cycle lengthening," "champions ghosting," and "more stakeholders per deal" might all cluster into "our buyer changed."
- Apply the unlock test. For each candidate ask: if this were solved, how much of the rest of the list gets easier? The critical challenge is upstream of many symptoms.
- Apply the addressability test. Ask: can we act on this with resources we have or can realistically get? "The macro economy" fails; "our onboarding loses technical buyers" passes.
- Choose one. The candidate scoring highest on unlock × addressability is your critical challenge — the crux. Naming two is allowed only if one is clearly sequenced behind the other.
Simplification and the courage to judge
A diagnosis is not a list of facts; it is a claim about which facts matter. "We have 14 problems" is an inventory. "We are a chain-link system stuck at the activation link" is a diagnosis. The simplification feels risky — you are discarding real complexity — but an un-simplified situation cannot be acted on. Write the diagnosis as one falsifiable paragraph, not a slide of bullets.
Diagnosis by analogy
Experienced strategists diagnose by pattern-matching the situation to known structures. Useful patterns:
| Pattern | Signature | What it implies |
|---|---|---|
| Chain-link stuck | Several functions adequate, one weak; global metrics frozen | Fix the weakest link first; ignore global metrics meanwhile |
| Wave of change | Cost structures or rules shifting industry-wide | Position for the attractor state; exploit incumbent inertia |
| Entropy / blur | Overlapping products, drifting prices, fuzzy ownership | Clean house before seeking new advantage |
| Strength-on-strength | You compete head-on where the rival is strongest | Re-segment; find ground where their strength is irrelevant |
| Threshold shortfall | Effort spread thin; nothing reaches visible results | Concentrate; accept being absent elsewhere |
Tests of a good diagnosis
- Names a cause or structure, not a symptom ("activation is broken," not "growth is slow")
- Falsifiable — specific enough that evidence could prove it wrong
- An informed skeptic would accept that the facts support it
- Points toward action without dictating it
- One paragraph, plain language, no fluff
Formulating the Guiding Policy
The guiding policy is the overall approach for overcoming the diagnosed obstacles. It is not a goal (an outcome you want) and not an action (a step you will take). It is a method — guardrails that rule out vast realms of possible action and channel effort toward your sources of power: leverage, asymmetric advantage, a wave you can ride, a rival's inertia.
Drafting procedure:
- Write three to five candidate policies in this form: "We will [approach] by [where/how we concentrate], because [the asymmetry or leverage that makes it work for us specifically]."
- For each candidate, list at least three significant things it rules out. If you cannot, the candidate is a platitude — discard it.
- Check each against the diagnosis: does it actually address the named obstacle, or just sound strategic near it?
- Pick one. Two guiding policies means you have not chosen.
Tests of a good guiding policy:
- Rules out real options people currently want to pursue
- Exploits a named asymmetry — it would be a bad policy for your nearest competitor
- Short enough to repeat in meetings from memory
- Stable for quarters, not days — actions change faster than policy
Designing Coherent Actions
Actions are where strategy becomes visible — and where most documents collapse into a list of independent department initiatives. Coherence means the actions are coordinated: each one makes the others more effective, and none works against another.
Design steps:
- Derive, don't collect. Generate actions only from the guiding policy. Do not import the existing roadmap and relabel it.
- Run the coherence check. For each pair of actions ask: does A make B easier, harder, or neither? A strategy whose actions are all "neither" is a list; any "harder" pair must be resolved now, not discovered in Q3.
- Back each action with resources. Owner, people, budget, start date, done-test. An action nobody is staffed for is a hope.
- Write the stop-doing list. Coherent action includes withdrawal: name the projects, segments, or features being stopped to fund the strategy. If nothing stops, nothing was chosen.
- Make the first step proximate. Something concrete starts within two weeks. Distant-future actions are goals wearing costumes.
The Kernel Template
KERNEL: [name / date / author]
DIAGNOSIS (one paragraph)
The critical challenge is [cause/structure, not symptom].
Evidence: [2-4 facts that support it].
This is a [pattern/analogy] situation.
What would prove this wrong: [signal].
GUIDING POLICY (one or two sentences)
We will [approach] by [concentration], because [our asymmetry].
Therefore we will NOT: [3+ ruled-out options].
COHERENT ACTIONS (3-5, each resourced)
1. [Action] — owner, resources, start, done-test, reinforces #__
2. ...
STOP DOING: [projects/segments/features being withdrawn]
REVIEW: re-test diagnosis on [date / metric trigger].
Worked Example 1: Seed-Stage Startup
Situation: Eight-person startup selling an AI code-review tool. $35K MRR, flat for five months. Self-serve signups convert at 9%; the team is split across building IDE plugins, a GitHub app, and an enterprise pilot. Two competitors are better funded.
Diagnosis: "Growth is flat" is the symptom. The cluster analysis shows: trials stall before the tool sees a real pull request; setup requires CI changes most users abandon; the enterprise pilot consumes 40% of engineering for one logo. The critical challenge: time-to-first-value is ~2 days in a market where rivals demo value in minutes — and our effort is spread across three motions, none past the visibility threshold. Pattern: threshold shortfall plus a weak activation link.
Guiding policy: Win the GitHub-native mid-size team by being the only reviewer that shows a high-quality review on the customer's own code within 10 minutes of install, concentrating everything on that single motion. Therefore we will NOT: pursue enterprise pilots this year, build IDE plugins, or support GitLab/Bitbucket.
Coherent actions:
- Rebuild onboarding to run on a repo's last 20 merged PRs at install — no CI changes (2 engineers, starts Monday; done when median time-to-first-review < 10 min)
- End the enterprise pilot; refund and refer (founder, this week) — frees the 40% that funds action 1
- Retarget all marketing to "first review in 10 minutes," with live public benchmark repos (1 marketer, 2 weeks)
- Instrument the activation funnel install → first review → first comment accepted (1 engineer, 1 week) — the lab for testing the diagnosis
Each action reinforces the others: the pilot's end staffs the rebuild; instrumentation proves or kills the diagnosis; marketing's promise is the product's new behavior.
Worked Example 2: Established Product
Situation: Twelve-year-old field-service management platform, $28M ARR, serving HVAC, plumbing, landscaping, and cleaning companies. Renewals slipping (NRR 96%); a vertical-only HVAC rival wins on "built for HVAC" despite fewer features. Three pricing plans overlap; the roadmap is a union of the four industries' requests.
Diagnosis: Not "the rival is cheaper" — win/loss notes show price is rarely decisive. Twelve years of serving four verticals created entropy and below-threshold quality everywhere: the product is 70% right for each industry while the rival is 95% right for one. Each vertical's requests dilute the others. Pattern: entropy plus strength-on-strength against a focused attacker.
Guiding policy: Re-concentrate as the system of record for mechanical trades (HVAC + plumbing), matching the vertical rival's fit while exploiting our one real asymmetry — ten years of job-cost data — to ship benchmarking no startup can copy. Therefore we will NOT: build for landscaping/cleaning beyond maintenance mode, chase feature parity horizontally, or discount to save renewals.
Coherent actions:
- Split the roadmap: 80% of engineering to mechanical-trades workflows; landscaping/cleaning enter maintenance mode with a 12-month support promise (VP Product, this quarter)
- Ship job-cost benchmarking ("your margin vs. 4,000 mechanical contractors") as the renewal anchor (data team, 2 quarters; done at 30% renewal-conversation usage)
- Collapse three overlapping plans into one mechanical-trades ladder; grandfather others (pricing lead, 6 weeks)
- Retrain sales on a "built for mechanical trades" narrative with benchmark proof (sales enablement, parallel with 2)
The stop-doing list is the strategy: maintenance mode funds the concentration, and the data asymmetry — not nostalgia for breadth — is what the rival cannot follow.
When Is a Kernel Done
- Diagnosis: one falsifiable paragraph a skeptic would sign
- Guiding policy: one approach, three-plus ruled-out options, anchored in a named asymmetry
- Actions: 3-5, mutually reinforcing, each with owner/resources/date/done-test
- Stop-doing list exists and actually frees the resources the actions need
- The whole kernel fits on one page and can be explained aloud in five minutes
- A review trigger is set — date or metric — at which the diagnosis gets re-tested
If the kernel passes all six, you have a strategy. If it fails any one, you have a draft — keep choosing.
| 1 | # Writing the Kernel |
| 2 | |
| 3 | ## Table of Contents |
| 4 | |
| 5 | [What the Kernel Is] |
| 6 | [Diagnosis Craft] |
| 7 | [Formulating the Guiding Policy] |
| 8 | [Designing Coherent Actions] |
| 9 | [The Kernel Template] |
| 10 | [Worked Example 1: Seed-Stage Startup] |
| 11 | [Worked Example 2: Established Product] |
| 12 | [When Is a Kernel Done] |
| 13 | |
| 14 | ## What the Kernel Is |
| 15 | |
| 16 | The kernel is the minimum viable structure of a strategy: a **diagnosis** that defines the nature of the challenge, a **guiding policy** that commits to an overall approach for dealing with it, and a set of **coherent actions** that carry the policy out. Everything else in a strategy document — market sizing, vision statements, financial projections — is either input to the kernel or decoration around it. |
| 17 | |
| 18 | The kernel deliberately excludes things most strategy documents lead with: |
| 19 | |
| 20 | | Common plan artifact | What it actually is | Kernel replacement | |
| 21 | |---------------------|--------------------|--------------------| |
| 22 | | Vision statement | A description of a desired future | Diagnosis of what stands between you and any future | |
| 23 | | Mission and values | Identity and conduct norms | Nothing — they are fine, but they are not strategy | |
| 24 | | Goals and targets ("$10M ARR") | Ambitions; outputs of strategy | Guiding policy: the approach that could produce them | |
| 25 | | List of initiatives | Department wish lists | Coherent actions that reinforce one another | |
| 26 | | SWOT grid | Raw material | A judgment about which item on the grid is *the* challenge | |
| 27 | |
| 28 | A kernel fits on one page. If it does not, you have not finished choosing. |
| 29 | |
| 30 | ## Diagnosis Craft |
| 31 | |
| 32 | The diagnosis is the most skipped and most valuable element. It is a judgment — a simplification of messy reality that names the critical challenge and, implicitly, what kind of situation you are in. Get it wrong and everything downstream is coordinated effort aimed at the wrong target. |
| 33 | |
| 34 | ### Finding the critical challenge |
| 35 | |
| 36 | **Collect the raw mess.** List every problem, threat, complaint, and stalled ambition: churn numbers, lost-deal notes, competitor moves, team frustrations. Do not filter yet. Aim for 15-30 items. |
| 37 | **Cluster into candidate challenges.** Group items that share a cause. "Sales cycle lengthening," "champions ghosting," and "more stakeholders per deal" might all cluster into "our buyer changed." |
| 38 | **Apply the unlock test.** For each candidate ask: *if this were solved, how much of the rest of the list gets easier?* The critical challenge is upstream of many symptoms. |
| 39 | **Apply the addressability test.** Ask: *can we act on this with resources we have or can realistically get?* "The macro economy" fails; "our onboarding loses technical buyers" passes. |
| 40 | **Choose one.** The candidate scoring highest on unlock × addressability is your critical challenge — the crux. Naming two is allowed only if one is clearly sequenced behind the other. |
| 41 | |
| 42 | ### Simplification and the courage to judge |
| 43 | |
| 44 | A diagnosis is not a list of facts; it is a claim about which facts matter. "We have 14 problems" is an inventory. "We are a chain-link system stuck at the activation link" is a diagnosis. The simplification feels risky — you are discarding real complexity — but an un-simplified situation cannot be acted on. Write the diagnosis as one falsifiable paragraph, not a slide of bullets. |
| 45 | |
| 46 | ### Diagnosis by analogy |
| 47 | |
| 48 | Experienced strategists diagnose by pattern-matching the situation to known structures. Useful patterns: |
| 49 | |
| 50 | | Pattern | Signature | What it implies | |
| 51 | |---------|-----------|----------------| |
| 52 | | Chain-link stuck | Several functions adequate, one weak; global metrics frozen | Fix the weakest link first; ignore global metrics meanwhile | |
| 53 | | Wave of change | Cost structures or rules shifting industry-wide | Position for the attractor state; exploit incumbent inertia | |
| 54 | | Entropy / blur | Overlapping products, drifting prices, fuzzy ownership | Clean house before seeking new advantage | |
| 55 | | Strength-on-strength | You compete head-on where the rival is strongest | Re-segment; find ground where their strength is irrelevant | |
| 56 | | Threshold shortfall | Effort spread thin; nothing reaches visible results | Concentrate; accept being absent elsewhere | |
| 57 | |
| 58 | ### Tests of a good diagnosis |
| 59 | |
| 60 | Names a cause or structure, not a symptom ("activation is broken," not "growth is slow") |
| 61 | Falsifiable — specific enough that evidence could prove it wrong |
| 62 | An informed skeptic would accept that the facts support it |
| 63 | Points toward action without dictating it |
| 64 | One paragraph, plain language, no fluff |
| 65 | |
| 66 | ## Formulating the Guiding Policy |
| 67 | |
| 68 | The guiding policy is the overall approach for overcoming the diagnosed obstacles. It is not a goal (an outcome you want) and not an action (a step you will take). It is a method — guardrails that rule out vast realms of possible action and channel effort toward your sources of power: leverage, asymmetric advantage, a wave you can ride, a rival's inertia. |
| 69 | |
| 70 | **Drafting procedure:** |
| 71 | |
| 72 | Write three to five candidate policies in this form: *"We will [approach] by [where/how we concentrate], because [the asymmetry or leverage that makes it work for us specifically]."* |
| 73 | For each candidate, list at least three significant things it **rules out**. If you cannot, the candidate is a platitude — discard it. |
| 74 | Check each against the diagnosis: does it actually address the named obstacle, or just sound strategic near it? |
| 75 | Pick one. Two guiding policies means you have not chosen. |
| 76 | |
| 77 | **Tests of a good guiding policy:** |
| 78 | |
| 79 | Rules out real options people currently want to pursue |
| 80 | Exploits a named asymmetry — it would be a *bad* policy for your nearest competitor |
| 81 | Short enough to repeat in meetings from memory |
| 82 | Stable for quarters, not days — actions change faster than policy |
| 83 | |
| 84 | ## Designing Coherent Actions |
| 85 | |
| 86 | Actions are where strategy becomes visible — and where most documents collapse into a list of independent department initiatives. Coherence means the actions are coordinated: each one makes the others more effective, and none works against another. |
| 87 | |
| 88 | **Design steps:** |
| 89 | |
| 90 | **Derive, don't collect.** Generate actions only from the guiding policy. Do not import the existing roadmap and relabel it. |
| 91 | **Run the coherence check.** For each pair of actions ask: does A make B easier, harder, or neither? A strategy whose actions are all "neither" is a list; any "harder" pair must be resolved now, not discovered in Q3. |
| 92 | **Back each action with resources.** Owner, people, budget, start date, done-test. An action nobody is staffed for is a hope. |
| 93 | **Write the stop-doing list.** Coherent action includes withdrawal: name the projects, segments, or features being stopped to fund the strategy. If nothing stops, nothing was chosen. |
| 94 | **Make the first step proximate.** Something concrete starts within two weeks. Distant-future actions are goals wearing costumes. |
| 95 | |
| 96 | ## The Kernel Template |
| 97 | |
| 98 | |
| 99 | KERNEL: [name / date / author] |
| 100 | |
| 101 | DIAGNOSIS (one paragraph) |
| 102 | The critical challenge is [cause/structure, not symptom]. |
| 103 | Evidence: [2-4 facts that support it]. |
| 104 | This is a [pattern/analogy] situation. |
| 105 | What would prove this wrong: [signal]. |
| 106 | |
| 107 | GUIDING POLICY (one or two sentences) |
| 108 | We will [approach] by [concentration], because [our asymmetry]. |
| 109 | Therefore we will NOT: [3+ ruled-out options]. |
| 110 | |
| 111 | COHERENT ACTIONS (3-5, each resourced) |
| 112 | 1. [Action] — owner, resources, start, done-test, reinforces #__ |
| 113 | 2. ... |
| 114 | STOP DOING: [projects/segments/features being withdrawn] |
| 115 | |
| 116 | REVIEW: re-test diagnosis on [date / metric trigger]. |
| 117 | |
| 118 | |
| 119 | ## Worked Example 1: Seed-Stage Startup |
| 120 | |
| 121 | **Situation:** Eight-person startup selling an AI code-review tool. $35K MRR, flat for five months. Self-serve signups convert at 9%; the team is split across building IDE plugins, a GitHub app, and an enterprise pilot. Two competitors are better funded. |
| 122 | |
| 123 | **Diagnosis:** "Growth is flat" is the symptom. The cluster analysis shows: trials stall before the tool sees a real pull request; setup requires CI changes most users abandon; the enterprise pilot consumes 40% of engineering for one logo. The critical challenge: **time-to-first-value is ~2 days in a market where rivals demo value in minutes — and our effort is spread across three motions, none past the visibility threshold.** Pattern: threshold shortfall plus a weak activation link. |
| 124 | |
| 125 | **Guiding policy:** *Win the GitHub-native mid-size team by being the only reviewer that shows a high-quality review on the customer's own code within 10 minutes of install, concentrating everything on that single motion.* Therefore we will NOT: pursue enterprise pilots this year, build IDE plugins, or support GitLab/Bitbucket. |
| 126 | |
| 127 | **Coherent actions:** |
| 128 | |
| 129 | Rebuild onboarding to run on a repo's last 20 merged PRs at install — no CI changes (2 engineers, starts Monday; done when median time-to-first-review < 10 min) |
| 130 | End the enterprise pilot; refund and refer (founder, this week) — frees the 40% that funds action 1 |
| 131 | Retarget all marketing to "first review in 10 minutes," with live public benchmark repos (1 marketer, 2 weeks) |
| 132 | Instrument the activation funnel install → first review → first comment accepted (1 engineer, 1 week) — the lab for testing the diagnosis |
| 133 | |
| 134 | Each action reinforces the others: the pilot's end staffs the rebuild; instrumentation proves or kills the diagnosis; marketing's promise is the product's new behavior. |
| 135 | |
| 136 | ## Worked Example 2: Established Product |
| 137 | |
| 138 | **Situation:** Twelve-year-old field-service management platform, $28M ARR, serving HVAC, plumbing, landscaping, and cleaning companies. Renewals slipping (NRR 96%); a vertical-only HVAC rival wins on "built for HVAC" despite fewer features. Three pricing plans overlap; the roadmap is a union of the four industries' requests. |
| 139 | |
| 140 | **Diagnosis:** Not "the rival is cheaper" — win/loss notes show price is rarely decisive. Twelve years of serving four verticals created **entropy and below-threshold quality everywhere**: the product is 70% right for each industry while the rival is 95% right for one. Each vertical's requests dilute the others. Pattern: entropy plus strength-on-strength against a focused attacker. |
| 141 | |
| 142 | **Guiding policy:** *Re-concentrate as the system of record for mechanical trades (HVAC + plumbing), matching the vertical rival's fit while exploiting our one real asymmetry — ten years of job-cost data — to ship benchmarking no startup can copy.* Therefore we will NOT: build for landscaping/cleaning beyond maintenance mode, chase feature parity horizontally, or discount to save renewals. |
| 143 | |
| 144 | **Coherent actions:** |
| 145 | |
| 146 | Split the roadmap: 80% of engineering to mechanical-trades workflows; landscaping/cleaning enter maintenance mode with a 12-month support promise (VP Product, this quarter) |
| 147 | Ship job-cost benchmarking ("your margin vs. 4,000 mechanical contractors") as the renewal anchor (data team, 2 quarters; done at 30% renewal-conversation usage) |
| 148 | Collapse three overlapping plans into one mechanical-trades ladder; grandfather others (pricing lead, 6 weeks) |
| 149 | Retrain sales on a "built for mechanical trades" narrative with benchmark proof (sales enablement, parallel with 2) |
| 150 | |
| 151 | The stop-doing list is the strategy: maintenance mode funds the concentration, and the data asymmetry — not nostalgia for breadth — is what the rival cannot follow. |
| 152 | |
| 153 | ## When Is a Kernel Done |
| 154 | |
| 155 | Diagnosis: one falsifiable paragraph a skeptic would sign |
| 156 | Guiding policy: one approach, three-plus ruled-out options, anchored in a named asymmetry |
| 157 | Actions: 3-5, mutually reinforcing, each with owner/resources/date/done-test |
| 158 | Stop-doing list exists and actually frees the resources the actions need |
| 159 | The whole kernel fits on one page and can be explained aloud in five minutes |
| 160 | A review trigger is set — date or metric — at which the diagnosis gets re-tested |
| 161 | |
| 162 | If the kernel passes all six, you have a strategy. If it fails any one, you have a draft — keep choosing. |
| 163 |
Discussion
Browse more free Claude skills.