@event4u/agent-config 2.6.1 → 2.8.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 (164) hide show
  1. package/.agent-src/commands/agent-handoff.md +1 -0
  2. package/.agent-src/commands/agent-status.md +1 -0
  3. package/.agent-src/commands/agents/audit.md +1 -0
  4. package/.agent-src/commands/agents/init.md +1 -0
  5. package/.agent-src/commands/agents/optimize.md +1 -0
  6. package/.agent-src/commands/agents.md +1 -0
  7. package/.agent-src/commands/analyze-reference-repo.md +1 -0
  8. package/.agent-src/commands/bug-fix.md +1 -0
  9. package/.agent-src/commands/bug-investigate.md +1 -0
  10. package/.agent-src/commands/challenge-me/vision.md +1 -0
  11. package/.agent-src/commands/challenge-me/with-docs.md +1 -0
  12. package/.agent-src/commands/challenge-me.md +1 -0
  13. package/.agent-src/commands/chat-history/import.md +1 -0
  14. package/.agent-src/commands/chat-history/learn.md +1 -0
  15. package/.agent-src/commands/chat-history/show.md +1 -0
  16. package/.agent-src/commands/chat-history.md +1 -0
  17. package/.agent-src/commands/check-current-md.md +1 -0
  18. package/.agent-src/commands/commit/in-chunks.md +1 -0
  19. package/.agent-src/commands/commit.md +1 -0
  20. package/.agent-src/commands/compress.md +1 -0
  21. package/.agent-src/commands/context/create.md +1 -0
  22. package/.agent-src/commands/context/refactor.md +1 -0
  23. package/.agent-src/commands/context.md +1 -0
  24. package/.agent-src/commands/cost-report.md +1 -0
  25. package/.agent-src/commands/council/default.md +1 -0
  26. package/.agent-src/commands/council/design.md +1 -0
  27. package/.agent-src/commands/council/optimize.md +1 -0
  28. package/.agent-src/commands/council/pr.md +1 -0
  29. package/.agent-src/commands/council.md +1 -0
  30. package/.agent-src/commands/create-pr/description-only.md +1 -0
  31. package/.agent-src/commands/create-pr.md +1 -0
  32. package/.agent-src/commands/e2e-heal.md +1 -0
  33. package/.agent-src/commands/e2e-plan.md +1 -0
  34. package/.agent-src/commands/estimate-ticket.md +1 -0
  35. package/.agent-src/commands/feature/dev.md +1 -0
  36. package/.agent-src/commands/feature/explore.md +1 -0
  37. package/.agent-src/commands/feature/plan.md +1 -0
  38. package/.agent-src/commands/feature/refactor.md +1 -0
  39. package/.agent-src/commands/feature/roadmap.md +1 -0
  40. package/.agent-src/commands/feature.md +1 -0
  41. package/.agent-src/commands/fix/ci.md +1 -0
  42. package/.agent-src/commands/fix/portability.md +1 -0
  43. package/.agent-src/commands/fix/pr-bot-comments.md +1 -0
  44. package/.agent-src/commands/fix/pr-comments.md +1 -0
  45. package/.agent-src/commands/fix/pr-developer-comments.md +1 -0
  46. package/.agent-src/commands/fix/refs.md +1 -0
  47. package/.agent-src/commands/fix/seeder.md +1 -0
  48. package/.agent-src/commands/fix.md +1 -0
  49. package/.agent-src/commands/grill-me.md +1 -0
  50. package/.agent-src/commands/implement-ticket.md +1 -0
  51. package/.agent-src/commands/jira-ticket.md +1 -0
  52. package/.agent-src/commands/judge/on-diff.md +1 -0
  53. package/.agent-src/commands/judge/solo.md +1 -0
  54. package/.agent-src/commands/judge/steps.md +1 -0
  55. package/.agent-src/commands/judge.md +1 -0
  56. package/.agent-src/commands/memory/add.md +1 -0
  57. package/.agent-src/commands/memory/load.md +1 -0
  58. package/.agent-src/commands/memory/mine-session.md +1 -0
  59. package/.agent-src/commands/memory/promote.md +1 -0
  60. package/.agent-src/commands/memory/propose.md +1 -0
  61. package/.agent-src/commands/memory.md +1 -0
  62. package/.agent-src/commands/mode.md +1 -0
  63. package/.agent-src/commands/module/create.md +1 -0
  64. package/.agent-src/commands/module/explore.md +1 -0
  65. package/.agent-src/commands/module.md +1 -0
  66. package/.agent-src/commands/onboard.md +1 -0
  67. package/.agent-src/commands/optimize/agents-dir.md +1 -0
  68. package/.agent-src/commands/optimize/augmentignore.md +1 -0
  69. package/.agent-src/commands/optimize/rtk.md +1 -0
  70. package/.agent-src/commands/optimize/skills.md +1 -0
  71. package/.agent-src/commands/optimize-prompt.md +1 -0
  72. package/.agent-src/commands/optimize.md +1 -0
  73. package/.agent-src/commands/orchestrate.md +1 -0
  74. package/.agent-src/commands/override/create.md +1 -0
  75. package/.agent-src/commands/override/manage.md +1 -0
  76. package/.agent-src/commands/override.md +1 -0
  77. package/.agent-src/commands/package-reset.md +1 -0
  78. package/.agent-src/commands/package-test.md +1 -0
  79. package/.agent-src/commands/prepare-for-review.md +1 -0
  80. package/.agent-src/commands/project-analyze.md +1 -0
  81. package/.agent-src/commands/project-health.md +1 -0
  82. package/.agent-src/commands/quality-fix.md +1 -0
  83. package/.agent-src/commands/refine-ticket.md +1 -0
  84. package/.agent-src/commands/research/deep.md +1 -0
  85. package/.agent-src/commands/research/report.md +1 -0
  86. package/.agent-src/commands/research.md +1 -0
  87. package/.agent-src/commands/review-changes.md +1 -0
  88. package/.agent-src/commands/review-routing.md +1 -0
  89. package/.agent-src/commands/roadmap/ai-council.md +1 -0
  90. package/.agent-src/commands/roadmap/create.md +1 -0
  91. package/.agent-src/commands/roadmap/process-full.md +1 -0
  92. package/.agent-src/commands/roadmap/process-phase.md +1 -0
  93. package/.agent-src/commands/roadmap/process-step.md +1 -0
  94. package/.agent-src/commands/roadmap.md +1 -0
  95. package/.agent-src/commands/rule-compliance-audit.md +1 -0
  96. package/.agent-src/commands/set-cost-profile.md +1 -0
  97. package/.agent-src/commands/sync-agent-settings.md +1 -0
  98. package/.agent-src/commands/sync-gitignore/fix.md +1 -0
  99. package/.agent-src/commands/sync-gitignore.md +1 -0
  100. package/.agent-src/commands/tests/create.md +1 -0
  101. package/.agent-src/commands/tests/execute.md +1 -0
  102. package/.agent-src/commands/tests.md +1 -0
  103. package/.agent-src/commands/threat-model.md +1 -0
  104. package/.agent-src/commands/update-form-request-messages.md +1 -0
  105. package/.agent-src/commands/upstream-contribute.md +1 -0
  106. package/.agent-src/commands/work.md +1 -0
  107. package/.agent-src/personas/cmo.md +122 -0
  108. package/.agent-src/personas/customer-success-lead.md +126 -0
  109. package/.agent-src/personas/growth-pm.md +134 -0
  110. package/.agent-src/personas/revops.md +125 -0
  111. package/.agent-src/skills/activation-design/SKILL.md +160 -0
  112. package/.agent-src/skills/churn-prevention/SKILL.md +156 -0
  113. package/.agent-src/skills/content-funnel-design/SKILL.md +170 -0
  114. package/.agent-src/skills/deal-qualification-meddic/SKILL.md +165 -0
  115. package/.agent-src/skills/editorial-calendar/SKILL.md +161 -0
  116. package/.agent-src/skills/expansion-playbook/SKILL.md +171 -0
  117. package/.agent-src/skills/forecast-accuracy/SKILL.md +157 -0
  118. package/.agent-src/skills/fundraising-narrative/SKILL.md +189 -0
  119. package/.agent-src/skills/funnel-analysis/SKILL.md +26 -2
  120. package/.agent-src/skills/gtm-launch/SKILL.md +165 -0
  121. package/.agent-src/skills/messaging-architecture/SKILL.md +184 -0
  122. package/.agent-src/skills/onboarding-design/SKILL.md +158 -0
  123. package/.agent-src/skills/pipeline-strategy/SKILL.md +159 -0
  124. package/.agent-src/skills/positioning-strategy/SKILL.md +177 -0
  125. package/.agent-src/skills/retention-loops/SKILL.md +161 -0
  126. package/.agent-src/skills/subagent-orchestration/SKILL.md +1 -1
  127. package/.agent-src/skills/voice-and-tone-design/SKILL.md +163 -0
  128. package/.agent-src/templates/agents/agent-project-settings.example.yml +1 -1
  129. package/.claude-plugin/marketplace.json +17 -2
  130. package/AGENTS.md +4 -4
  131. package/CHANGELOG.md +60 -2257
  132. package/README.md +59 -33
  133. package/docs/architecture/augment-projection.md +70 -0
  134. package/docs/architecture/claude-bundle.md +77 -0
  135. package/docs/architecture/compression.md +67 -0
  136. package/docs/architecture/multi-tool-projection.md +72 -0
  137. package/docs/architecture.md +32 -55
  138. package/docs/archive/CHANGELOG-pre-2.2.0.md +2138 -0
  139. package/docs/archive/CHANGELOG-pre-2.7.0.md +185 -0
  140. package/docs/catalog.md +19 -3
  141. package/docs/contracts/CHANGELOG-conventions.md +121 -0
  142. package/docs/contracts/adr-gtm-context-spine.md +115 -0
  143. package/docs/contracts/command-surface-tiers.md +145 -0
  144. package/docs/contracts/context-spine.md +50 -12
  145. package/docs/contracts/cross-wing-handoff.md +3 -3
  146. package/docs/contracts/mcp-cloud-scope.md +193 -21
  147. package/docs/contracts/mcp-phase-1-scope.md +1 -0
  148. package/docs/contracts/persona-schema.md +20 -3
  149. package/docs/decisions/ADR-007-agent-discovery-scopes.md +67 -0
  150. package/docs/guidelines/gtm-handoff.md +114 -0
  151. package/docs/setup/enterprise-and-offline.md +201 -0
  152. package/docs/setup/per-ide/augment.md +37 -25
  153. package/package.json +1 -1
  154. package/scripts/_bootstrap_tier_frontmatter.py +151 -0
  155. package/scripts/agent-config +146 -83
  156. package/scripts/hermetic-install.sh +235 -0
  157. package/scripts/install.py +8 -1
  158. package/scripts/lint_command_tiers.py +115 -0
  159. package/scripts/lint_context_spine_usage.py +4 -1
  160. package/scripts/mcp_server/__init__.py +5 -0
  161. package/scripts/schemas/command.schema.json +5 -0
  162. package/scripts/schemas/persona.schema.json +5 -0
  163. package/scripts/schemas/skill.schema.json +2 -2
  164. package/scripts/skill_linter.py +177 -3
@@ -0,0 +1,189 @@
1
+ ---
2
+ name: fundraising-narrative
3
+ description: "Use when shaping a capital-raise pitch — why-now / why-us / why-this framing, market-size reasoning, traction-story construction. Triggers on 'tighten the pitch', 'why-now is weak'."
4
+ status: active
5
+ tier: senior
6
+ source: package
7
+ domain: product
8
+ context_spine: [product, customer-segment]
9
+ ---
10
+
11
+ # fundraising-narrative
12
+
13
+ ## When to use
14
+
15
+ - A founder is preparing a capital-raise pitch and the why-now is borrowed from a deck template instead of earned from the segment-shift the team actually rides.
16
+ - A deck is landing as "interesting but not now" with investors and the team needs to diagnose whether the gap is *why-now*, *why-us*, or *why-this*.
17
+ - A traction story is being built from screenshots instead of from a coherent leading-indicator arc that explains why the next stage is reachable.
18
+
19
+ Do NOT use to manage the investor-CRM pipeline (out of scope), run
20
+ the data-room (out of scope), or draft the internal vision anchor
21
+ the org rallies behind (route to Wing-4 `vision-articulation` — the
22
+ external pitch under capital constraint and the internal anchor
23
+ are siblings, not the same artefact).
24
+
25
+ ## Cognition cluster
26
+
27
+ - **Mental model 1 — First-principles thinking.** *Why-now* is
28
+ the load-bearing claim and the one most often borrowed. Build
29
+ it from the segment-shift up — what changed in the world, the
30
+ customer, the technology — not from a deck template. See
31
+ [`docs/contracts/mental-models.md`](../../../docs/contracts/mental-models.md) § 1.
32
+ - **Mental model 9 — Hypothesis-driven development.** A pitch is
33
+ a falsifiable hypothesis: *if X is true, our round closes.*
34
+ Name the X. Investors who disagree with the hypothesis are not
35
+ rejecting taste — they are rejecting the falsifiable claim. See
36
+ `mental-models.md` § 9.
37
+ - **Mental model 16 — Leading vs. lagging indicators.** Revenue
38
+ is lagging; activation, retention curve, and qualified-pipeline
39
+ velocity are leading. The traction story leads with the leading
40
+ signals; revenue is the receipt, not the argument. See
41
+ `mental-models.md` § 16.
42
+ - **Mental model 30 — Inversion.** Run the round-failure
43
+ premortem before the deck locks: *which investor heard what we
44
+ did not say.* Inversion surfaces the claim the deck assumes the
45
+ room already shares and probably does not. See
46
+ `mental-models.md` § 30.
47
+ - **Context-spine — product + customer-segment.** Read **product**
48
+ for the proofs the traction story can actually back; read
49
+ **customer-segment** for the TAM/SAM argument that survives a
50
+ bottom-up scrutiny. See
51
+ [`context-spine`](../../../docs/contracts/context-spine.md).
52
+
53
+ ## Procedure
54
+
55
+ ### Step 0: Inherit the positioning frame and vision anchor
56
+
57
+ Identify the locked positioning anchors from
58
+ [`positioning-strategy`](../positioning-strategy/SKILL.md) and the internal vision
59
+ anchor from `vision-articulation` if it exists. The fundraising
60
+ narrative is the *external pitch under capital constraint*; it
61
+ inherits the internal frame, it does not re-invent it. A pitch
62
+ that contradicts the internal anchor will fracture on the first
63
+ hire after the round closes.
64
+
65
+ ### Step 1: Analyze the inherited why-now
66
+
67
+ Read the current why-now claim. Three checks: *is this a market
68
+ shift, a customer shift, or a technology shift?* *Did the shift
69
+ happen in the last 24 months?* *Would the segment recognise the
70
+ shift without prompting?* A why-now that fails two of three is
71
+ template-borrowed. Name what the inherited deck is leaning on.
72
+
73
+ ### Step 2: Build why-now from first principles
74
+
75
+ Strip the inherited claim. Rebuild from the segment-shift up:
76
+
77
+ - **Market shift.** What changed in the buyer's environment that
78
+ was not true 24 months ago? (Regulation, budget cycle, channel
79
+ collapse, competitive exit.)
80
+ - **Customer shift.** What changed in how the ICP measures the
81
+ problem? (New KPI, new buying committee, new procurement gate.)
82
+ - **Technology shift.** What is feasible now that was not? (Cost
83
+ curve, model capability, infrastructure unlock.)
84
+
85
+ Pick the *one* shift the segment would name without prompting.
86
+ That is the why-now spine. The others are supporting context.
87
+
88
+ ### Step 3: Construct why-us under capital constraint
89
+
90
+ Why-us is *unfair advantage under the next 18 months of capital*,
91
+ not credentials. Three anchors:
92
+
93
+ - **Earned access.** The audience the team can already reach that
94
+ the next funded peer cannot.
95
+ - **Earned proof.** The reference customer or load-bearing
96
+ retention curve the team owns now.
97
+ - **Capital fit.** What the round buys that competitors cannot buy
98
+ in the same window. *"More engineers"* is not capital fit;
99
+ *"distribution lead-time the round protects"* is.
100
+
101
+ ### Step 4: Build the traction story from leading indicators
102
+
103
+ Order the traction story leading-first:
104
+
105
+ 1. **Activation curve.** Time-to-first-value trend across cohorts.
106
+ 2. **Retention curve.** Cohort retention at the load-bearing
107
+ milestone, ideally non-trivial — not week 1.
108
+ 3. **Pipeline velocity.** Qualified-pipeline movement, not raw
109
+ pipeline volume.
110
+ 4. **Revenue.** The receipt, last in the sequence — not first.
111
+
112
+ A traction story that opens on revenue assumes the room already
113
+ believes the leading signals; the deck must earn that belief.
114
+
115
+ ### Step 5: Validate against the round-failure premortem
116
+
117
+ Validate the narrative on three checks:
118
+
119
+ 1. **Premortem coverage.** Run *"the round did not close because…"*
120
+ with five failure modes. Verify the deck explicitly neutralises
121
+ the top three or accepts-with-mitigation; unnamed failure modes
122
+ are silent rejection routes.
123
+ 2. **Falsifiable hypothesis.** Confirm the pitch is the form
124
+ *"if X, then our round closes."* A pitch that cannot be
125
+ disagreed with is also a pitch that cannot be agreed with.
126
+ 3. **Internal-external consistency.** Diff the external pitch
127
+ against the internal vision anchor. Contradictions kill the
128
+ first post-round hire round; name them now.
129
+
130
+ ### Step 6: Hand back
131
+
132
+ Hand the artefacts to the founder for delivery, to
133
+ `messaging-architecture` for the post-round message-stack refresh
134
+ (why-now often shifts the primary message), and to
135
+ `vision-articulation` (Wing-4) for the internal-anchor diff if
136
+ contradictions surfaced.
137
+
138
+ ## Related Skills
139
+
140
+ **WHEN to use this**
141
+
142
+ - The unit of work is the why-now / why-us / why-this triad under capital constraint, not a single deck slide.
143
+ - A diagnosed pitch gap needs a structured rebuild, not slide-polish.
144
+ - The traction story is being built screenshot-first; reorder it leading-first.
145
+
146
+ **WHEN NOT to use this**
147
+
148
+ - Internal vision-anchor authoring for org alignment — route to Wing-4 `vision-articulation`.
149
+ - Message-stack work post-round — route to [`messaging-architecture`](../messaging-architecture/SKILL.md).
150
+ - Positioning the category and segment — route to [`positioning-strategy`](../positioning-strategy/SKILL.md) first.
151
+ - Investor-CRM pipeline or data-room operations — out of scope.
152
+
153
+ ## When the agent should load this
154
+
155
+ - "Tighten the why-now for the seed round."
156
+ - "Bau mir die Traction-Story für den Pitch."
157
+ - "Investors keep saying 'interesting but not now' — diagnose."
158
+ - "Run the round-failure premortem on the deck."
159
+ - "Why-us reads as a credentials list — rebuild under capital constraint."
160
+
161
+ ## Output
162
+
163
+ 1. **`why-now-spine.md`** — the one market / customer / technology shift the segment names without prompting, with the 24-month evidence trail.
164
+ 2. **`why-us-anchors.md`** — earned-access · earned-proof · capital-fit, each with a load-bearing artefact citation.
165
+ 3. **`traction-arc.md`** — activation → retention → pipeline-velocity → revenue, leading-first ordering with the leading-indicator threshold per step.
166
+ 4. **`round-failure-premortem.md`** — five failure modes with neutraliser-or-accept verdict, internal-external consistency diff appended.
167
+
168
+ ## Gotcha
169
+
170
+ - Why-now is the most-borrowed claim in pitches because it is the hardest to earn from first principles — the room can tell.
171
+ - Capital-fit collapses to *"hire more"* when the team has not thought through what the round protects from competitors; protect-language is the discipline.
172
+ - Internal-external contradictions read as charm in the room and as betrayal at the post-round all-hands.
173
+
174
+ ## Do NOT
175
+
176
+ - Do NOT carry the internal vision anchor verbatim into the pitch — internal anchor is rally; external pitch is hypothesis under capital constraint.
177
+ - Do NOT lead the traction story with revenue when the leading signals are the actual argument.
178
+ - Do NOT make the why-now a template-shaped *"AI changes everything"* — the segment will know.
179
+ - Do NOT manage CRM or data-room operations from this skill; out of scope.
180
+
181
+ ## Runnable example
182
+
183
+ Mid-market HR analytics tool raising Series A, positioning locked (retention beats acquisition):
184
+
185
+ - Why-now spine — *customer shift*: HR directors now own a board-quarter retention KPI (was true on 30 % of ICP boards 24 months ago, now 70 %; verified via 14 ICP board-decks reviewed).
186
+ - Why-us anchors — *earned access*: 200-strong HR-director community already engaged. *Earned proof*: cohort-retention curve at week-12 holding at 78 % across 9 design-partner cohorts. *Capital-fit*: round protects 18 months of distribution lead-time before two funded peers reach the same segment.
187
+ - Traction arc — activation (time-to-first-cohort-roll-up: 14 → 6 days across last 4 cohorts) → retention (78 % week-12 cohort) → pipeline-velocity (qualified-pipeline movement at 2.4× quarter-on-quarter) → revenue (the receipt).
188
+ - Round-failure premortem — top three failure modes neutralised in deck; one accepted-with-mitigation (we are pre-revenue at enterprise tier — mitigated by 3 named pilot LOIs).
189
+ - Hand-off → founder for delivery; `messaging-architecture` queued for post-round refresh.
@@ -5,6 +5,7 @@ status: active
5
5
  tier: senior
6
6
  source: package
7
7
  domain: product
8
+ context_spine: [product, customer-segment, funnel-stage]
8
9
  ---
9
10
 
10
11
  # funnel-analysis
@@ -17,6 +18,29 @@ domain: product
17
18
 
18
19
  Do NOT use for ranking features, valuation, or OKR decomposition (see Related Skills). Funnel analysis is a **diagnostic**, not a roadmap.
19
20
 
21
+ ## Cognition cluster
22
+
23
+ - **Mental model 16 — Leading vs. lagging indicators.** Paid is
24
+ lagging; activation is leading; signup is upstream of both. A
25
+ funnel decision built on the lagging stage can only confirm the
26
+ miss; the leading stage names the binding fix. See
27
+ [`docs/contracts/mental-models.md`](../../../docs/contracts/mental-models.md) § 16.
28
+ - **Mental model 13 — Occam's razor.** When a stage drops, the
29
+ simpler explanation usually wins: *"acquisition mix shifted"*
30
+ beats *"users no longer understand the product."* Pick the simpler
31
+ cause; it changes the move. See `mental-models.md` § 13.
32
+ - **Mental model 3 — Pareto (80/20).** Drops are almost never
33
+ uniform across segments; ~20 % of the segment × stage cells carry
34
+ ~80 % of the loss. Segment before treating the average as
35
+ actionable. See `mental-models.md` § 3.
36
+ - **Context-spine — product + customer-segment + funnel-stage.**
37
+ Read the **product** slot for what activation can actually mean
38
+ in-product (the activation event must be shippable), the
39
+ **customer-segment** slot for which segments' switch-events the
40
+ funnel is built for, and the **funnel-stage** slot for the
41
+ position of each stage relative to the buying journey. See
42
+ [`context-spine`](../../../docs/contracts/context-spine.md).
43
+
20
44
  ## Procedure
21
45
 
22
46
  ### Step 0: Inspect
@@ -40,7 +64,7 @@ Do NOT use for ranking features, valuation, or OKR decomposition (see Related Sk
40
64
 
41
65
  1. The right benchmark is **your own funnel one quarter ago**, not industry averages. Industry averages mix verticals so coarsely they're useless for action.
42
66
  2. For each stage: is current rate within ±2 percentage points of trailing-quarter median? If not, that stage is the primary suspect.
43
- 3. If multiple stages drift simultaneously, the cause is upstream (acquisition mix change, broken instrumentation), not the stage itself.
67
+ 3. If multiple stages move off-band simultaneously, the cause is upstream (acquisition mix change, broken instrumentation), not the stage itself.
44
68
 
45
69
  ### Step 4: Segment the broken stage
46
70
 
@@ -98,4 +122,4 @@ Do NOT use for ranking features, valuation, or OKR decomposition (see Related Sk
98
122
 
99
123
  1. **`funnel-table.md`** — 5-stage funnel with cohort rates, 95% CI, and 12-week trend (sparkline or compact ASCII). One row per cohort week or month.
100
124
  2. **`segment-breakdown.md`** — table of the broken stage segmented by channel · device · plan · geo. Rates with CIs. Suspect segments highlighted.
101
- 3. **`hypothesis-list.md`** — top 3 for the broken segment-stage with cheapest-falsification experiment per cause and an explicit prediction for the next measurement.
125
+ 3. **`hypothesis-list.md`** — top 3 causes for the broken segment-stage with cheapest-falsification experiment per cause and an explicit prediction for the next measurement.
@@ -0,0 +1,165 @@
1
+ ---
2
+ name: gtm-launch
3
+ description: "Use when sequencing a launch — alpha / beta / GA waves, audience-by-wave logic, narrative beats per wave, engineering-readiness gates. Triggers on 'plan the launch', 'sequence GA'."
4
+ status: active
5
+ tier: senior
6
+ source: package
7
+ domain: product
8
+ context_spine: [product, customer-segment, channel-stage]
9
+ ---
10
+
11
+ # gtm-launch
12
+
13
+ ## When to use
14
+
15
+ - A product, feature, or major capability is approaching ship-readiness and the team needs a wave plan (alpha → beta → GA) keyed to audience and proof, not a date on a calendar.
16
+ - A launch is being planned date-first; the team needs to invert and plan readiness-first so an unmet gate stops a wave instead of leaking past it.
17
+ - A previous launch landed soft and the retro names "no audience-by-wave logic" or "narrative beats unclear per wave" as the cause.
18
+
19
+ Do NOT use to write announcement copy (route to `release-comms`),
20
+ lock the message stack (route to `messaging-architecture`), or plan
21
+ post-launch retention loops (route to `retention-loops`).
22
+
23
+ ## Cognition cluster
24
+
25
+ - **Mental model 10 — Reversible vs. irreversible decisions.** A GA
26
+ wave is largely irreversible: rolling back narrative and audience
27
+ expectations after public launch costs more than re-shipping the
28
+ product. Alpha and beta are reversible; treat them as the
29
+ decision-quality buffer. See
30
+ [`docs/contracts/mental-models.md`](../../../docs/contracts/mental-models.md) § 10.
31
+ - **Mental model 29 — Premortem.** Before the wave plan locks, write
32
+ the post-mortem of the launch as if it failed. The premortem
33
+ surfaces the gates that need to hold; the wave plan is the inverse
34
+ of that list. See `mental-models.md` § 29.
35
+ - **Mental model 16 — Leading vs. lagging indicators.** Engineering-
36
+ readiness signals (error rate, latency, support-load) are leading;
37
+ pipeline lift is lagging. A wave plan that gates on lagging signals
38
+ ships into a soft floor. See `mental-models.md` § 16.
39
+ - **Context-spine — product + customer-segment + channel-stage.**
40
+ Read the **product** slot for shippable scope, the
41
+ **customer-segment** slot for who hears the launch on which wave,
42
+ and the **channel-stage** slot for where each wave's audience lives
43
+ in the awareness → decision arc. See
44
+ [`context-spine`](../../../docs/contracts/context-spine.md).
45
+
46
+ ## Procedure
47
+
48
+ ### Step 0: Inherit the message stack
49
+
50
+ Identify the locked `primary-message.md`, `supporting-proofs.md`, and
51
+ `audience-matrix.md` from [`messaging-architecture`](../messaging-architecture/SKILL.md).
52
+ If the stack is missing or unstable, stop and route back. A launch
53
+ plan without a locked message stack ships three different stories at
54
+ three different surfaces.
55
+
56
+ ### Step 1: Run the premortem
57
+
58
+ Write the launch post-mortem **as if it has already failed**. Three
59
+ prompts: *"what did the segment hear that we did not say,"* *"what
60
+ broke in the first 48 hours,"* *"what did the alternative say first
61
+ and louder."* The premortem produces the failure-mode list the wave
62
+ plan must neutralise.
63
+
64
+ ### Step 2: Define the gates per wave
65
+
66
+ For each wave (alpha · beta · GA), define **entry gates** and **exit
67
+ gates**:
68
+
69
+ - *Alpha entry:* engineering-readiness signal threshold (error rate,
70
+ latency, instrumentation coverage). *Exit:* < N support tickets
71
+ per 100 sessions on the load-bearing flow.
72
+ - *Beta entry:* alpha exit + audience-matrix proof exists for the
73
+ beta audience. *Exit:* leading indicator (activation, time-to-
74
+ first-value) clears threshold per `mental-models.md § 16`.
75
+ - *GA entry:* beta exit + narrative beats locked for the public
76
+ segment. *Exit:* not applicable — GA is irreversible; the next
77
+ wave is *post-launch retention*, handed to `retention-loops`.
78
+
79
+ ### Step 3: Sequence the audience waves
80
+
81
+ Audience waves are not seniority waves. They are **proof waves**.
82
+ Each wave's audience is whichever segment generates the proof the
83
+ *next* wave needs. Order:
84
+
85
+ 1. *Alpha audience* — the segment where the team can sit next to
86
+ the user. Proof: load-bearing flow does not break under real use.
87
+ 2. *Beta audience* — the segment whose adoption is the credibility
88
+ anchor for GA. Proof: a quotable reference and an activation
89
+ curve.
90
+ 3. *GA audience* — the full ICP segment from the `customer-segment`
91
+ slot. Proof: pipeline lift, narrative pickup, retention curve.
92
+
93
+ ### Step 4: Assign narrative beats per wave
94
+
95
+ Each wave gets a narrative beat — the **one** thing the audience
96
+ remembers. Alpha beat = trust signal (we are not winging it). Beta
97
+ beat = proof signal (it works for someone like you). GA beat = the
98
+ primary message from `messaging-architecture` Step 1. Beats stack;
99
+ they do not contradict.
100
+
101
+ ### Step 5: Validate the plan against the premortem
102
+
103
+ Validate each premortem failure mode against the wave plan: verify a
104
+ specific gate or beat neutralises it. Any failure mode without an
105
+ explicit neutraliser is a known leak — name it, do not bury it.
106
+ Validation passes only when every premortem item is either
107
+ neutralised or accepted-with-mitigation.
108
+
109
+ ### Step 6: Hand back
110
+
111
+ Hand the artefacts to [`release-comms`](../release-comms/SKILL.md)
112
+ for announcement-surface drafting, to
113
+ [`editorial-calendar`](../editorial-calendar/SKILL.md) for cadence
114
+ mapping, and to [`launch-readiness`](../launch-readiness/SKILL.md)
115
+ for the merge-day checklist.
116
+
117
+ ## Related Skills
118
+
119
+ **WHEN to use this**
120
+
121
+ - The unit of work is the wave plan (alpha · beta · GA) with gates and beats, not a single announcement.
122
+ - A launch needs readiness-gated sequencing instead of calendar-driven sequencing.
123
+ - The team can name the message stack but not which audience hears which beat in which wave.
124
+
125
+ **WHEN NOT to use this**
126
+
127
+ - Writing the announcement copy or press surface — route to [`release-comms`](../release-comms/SKILL.md).
128
+ - Locking the primary message and proofs — route to [`messaging-architecture`](../messaging-architecture/SKILL.md).
129
+ - Pre-merge ops checklist (rollout, rollback, monitoring) — route to [`launch-readiness`](../launch-readiness/SKILL.md).
130
+ - Post-launch retention design — route to [`retention-loops`](../retention-loops/SKILL.md).
131
+
132
+ ## When the agent should load this
133
+
134
+ - "Plan the launch waves for the new pricing tier."
135
+ - "Wir starten den GA — gib mir die Alpha-Beta-GA Sequenz."
136
+ - "What are the entry gates for the beta wave?"
137
+ - "Premortem the launch and rebuild the wave plan from the failure list."
138
+ - "Sequence the audience waves around the proof we still need."
139
+
140
+ ## Output
141
+
142
+ 1. **`launch-premortem.md`** — three failure modes per prompt, ranked by carrying cost, each tagged with the wave that owns the neutraliser.
143
+ 2. **`wave-plan.md`** — three waves (alpha · beta · GA) with entry / exit gates, audience, leading-indicator threshold per wave.
144
+ 3. **`narrative-beats.md`** — one beat per wave (trust → proof → primary-message), with the line the team will not contradict on any surface during that wave.
145
+
146
+ ## Gotcha
147
+
148
+ - Calendar-driven launches confuse a date with a gate. A date does not signal readiness; a gate does. The wave plan must hold even if the date slips two weeks.
149
+ - "Friends-and-family alpha" is alpha-shaped theatre — it produces the wrong proof for the next wave. Recruit an alpha audience that exposes the load-bearing flow.
150
+ - A premortem that produces only three failure modes was rushed; push for ten and keep the load-bearing three.
151
+
152
+ ## Do NOT
153
+
154
+ - Do NOT write the announcement copy here — copy lives in `release-comms` downstream of locked beats.
155
+ - Do NOT collapse alpha and beta to save calendar time — alpha and beta produce different proofs.
156
+ - Do NOT lock GA without an explicit retention-loops handoff; an unowned post-launch fortnight is where most launches soften.
157
+
158
+ ## Runnable example
159
+
160
+ Mid-market HR analytics tool launching workforce-analytics layer:
161
+
162
+ - Premortem: (a) CFOs hear "another tool" not "retention saving"; (b) HRIS plug-in misconfigured under load; (c) reference customer quote not contractually approved by GA.
163
+ - Wave plan — *Alpha:* 3 design-partner HR directors, gate = HRIS plug-in error-rate < 1 % under load. *Beta:* 10 HR leaders matching ICP, gate = activation curve hits 5 cohort-roll-ups per week. *GA:* full ICP segment, gate = quoted reference contractually approved.
164
+ - Narrative beats — *Alpha:* "we sat next to you while it worked." *Beta:* "an HR director like you saved 7 hours last board-quarter." *GA:* primary message from `messaging-architecture` Step 1.
165
+ - Hand-off → `release-comms` drafts the GA-wave surface; `retention-loops` owns the 30-day post-GA cohort.
@@ -0,0 +1,184 @@
1
+ ---
2
+ name: messaging-architecture
3
+ description: "Use when shaping the primary message, supporting proofs, and audience-by-message matrix from a locked positioning frame — before any copy or launch beat. Triggers on 'tighten the message stack'."
4
+ status: active
5
+ tier: senior
6
+ source: package
7
+ domain: product
8
+ context_spine: [product, customer-segment]
9
+ ---
10
+
11
+ # messaging-architecture
12
+
13
+ ## When to use
14
+
15
+ - Positioning is locked (four anchors + assumption ledger) and the next artefact — launch deck, homepage, sales narrative — needs a load-bearing message stack instead of one-off copy.
16
+ - A team is shipping copy faster than it is shipping shared meaning; lines diverge across surfaces and the segment cannot recognise itself.
17
+ - An audience-by-message matrix is missing and the same primary message is being shouted at three audiences who hear three different things.
18
+
19
+ Do NOT use to write the copy itself (downstream of this skill),
20
+ peer-vs-peer comparison (route to `competitive-positioning`), or
21
+ launch sequencing (route to `gtm-launch`).
22
+
23
+ ## Cognition cluster
24
+
25
+ - **Mental model 15 — Signal vs. noise.** Every message lands inside
26
+ an inbox that is already full. The primary message must clear the
27
+ segment's noise floor, not just be true. Estimate the noise before
28
+ drafting; without it, every line looks distinctive in the doc and
29
+ forgettable in market. See
30
+ [`docs/contracts/mental-models.md`](../../../docs/contracts/mental-models.md) § 15.
31
+ - **Mental model 30 — Inversion.** Ask *"what is the strongest
32
+ message a credible alternative would land against us?"* The answer
33
+ exposes the proofs the message stack must carry, not the words.
34
+ See `mental-models.md` § 30.
35
+ - **Context-spine — product + customer-segment.** Read the **product**
36
+ slot for the proofs the team can actually back; read the
37
+ **customer-segment** slot for the buyer's listening posture.
38
+ Architecture that exceeds the proofs available is fiction. See
39
+ [`context-spine`](../../../docs/contracts/context-spine.md).
40
+
41
+ ## Procedure
42
+
43
+ ### Step 0: Inherit the positioning frame
44
+
45
+ Open the `positioning.md` artefact ([`positioning-strategy`](../positioning-strategy/SKILL.md)
46
+ Step 1 output). If the four anchors are missing or contested, stop
47
+ and route back. Messaging architecture without a locked positioning
48
+ frame is decoration — it will be rewritten the next quarter.
49
+
50
+ ### Step 1: Identify the primary message
51
+
52
+ Identify the **one** sentence — the load-bearing claim
53
+ that, if the segment remembered nothing else, would still trigger
54
+ the right switch event. Structure:
55
+
56
+ *"For \<segment\>, \<category\> that \<load-bearing benefit\>,
57
+ instead of \<alternative\>."*
58
+
59
+ The benefit must be the **switch-event benefit** — what changes the
60
+ day they buy — not a feature list and not a brand attribute.
61
+
62
+ ### Step 2: Stack the supporting proofs
63
+
64
+ Three proofs, ranked. Each proof is a sentence the team can defend
65
+ with evidence (data, demo, reference, contract clause). Proofs that
66
+ need adjective amplification (*"truly seamless"*, *"radically
67
+ simple"*) are not proofs — they are the gap a proof would fill.
68
+
69
+ Rank the proofs by **closing weight**: how much each moves the
70
+ buyer's decision from *no* to *yes*. The order is the order of
71
+ appearance in every downstream surface.
72
+
73
+ ### Step 3: Build the audience-by-message matrix
74
+
75
+ Audiences are not segments — they are roles inside the segment
76
+ (economic buyer, champion, end-user, finance, security). For each
77
+ audience, fill: **what they fear · what they hope · what proof
78
+ clears each.** The matrix forces the team to confront the surfaces
79
+ where the primary message lands wrong on a role even when right on
80
+ the segment.
81
+
82
+ ### Step 4: Validate against the noise floor and the inversion test
83
+
84
+ Validate the stack on three checks:
85
+
86
+ 1. **Noise floor.** For the primary message, name three lines a
87
+ credible peer says today. If the primary message would not be
88
+ distinguishable when read alongside them, it is below the noise
89
+ floor — sharpen or drop.
90
+ 2. **Inversion.** Write the strongest counter-message a credible
91
+ alternative would land against us. Confirm at least one supporting
92
+ proof neutralises it; if none does, the stack is missing a proof.
93
+ 3. **Proof-coverage.** For every fear / hope cell in the matrix,
94
+ verify a proof exists. Cells without a proof are explicit gaps,
95
+ not silent omissions.
96
+
97
+ ### Step 5: Hand back
98
+
99
+ Hand the three artefacts (see `## Output`) to
100
+ [`gtm-launch`](../gtm-launch/SKILL.md) for launch-wave sequencing,
101
+ [`editorial-calendar`](../editorial-calendar/SKILL.md) for cadence
102
+ mapping, or [`fundraising-narrative`](../fundraising-narrative/SKILL.md)
103
+ for capital-raising framing. Do **not** write the copy here — copy
104
+ production is a downstream artefact.
105
+
106
+ ## Related Skills
107
+
108
+ **WHEN to use this**
109
+
110
+ - The unit of work is the message stack (primary + proofs + matrix), not a copy block.
111
+ - Positioning is locked and downstream surfaces need a shared anchor.
112
+ - Cross-audience messaging has scattered and the team cannot name a primary.
113
+
114
+ **WHEN NOT to use this**
115
+
116
+ - Locking the four-anchor positioning frame — route to
117
+ [`positioning-strategy`](../positioning-strategy/SKILL.md).
118
+ - Peer-vs-peer ours-vs-theirs verdict table — route to
119
+ [`competitive-positioning`](../competitive-positioning/SKILL.md).
120
+ - Launch-wave audience sequencing — route to
121
+ [`gtm-launch`](../gtm-launch/SKILL.md).
122
+ - Voice attribute selection or tone-by-context matrix — route to
123
+ [`voice-and-tone-design`](../voice-and-tone-design/SKILL.md).
124
+
125
+ ## When the agent should load this
126
+
127
+ - "Lock the message stack before we draft the launch deck."
128
+ - "Wir brauchen eine primary message, keine Tagline."
129
+ - "Build the audience-by-message matrix for the security buyer."
130
+ - "Are our three proofs distinguishable from \<incumbent\>'s lines?"
131
+ - "Inversion-check our messaging against the alternative."
132
+ - "Our message has scattered across landing pages — re-anchor it."
133
+
134
+ ## Output
135
+
136
+ 1. **`primary-message.md`** — one sentence in the segment / category
137
+ / benefit / alternative shape, plus the load-bearing word and
138
+ why it is load-bearing.
139
+ 2. **`supporting-proofs.md`** — three proofs ranked by closing
140
+ weight, each with the evidence the team can defend it with.
141
+ 3. **`audience-matrix.md`** — one row per audience: fear · hope ·
142
+ proof-that-clears-each · primary-message variant if reframing is
143
+ needed.
144
+
145
+ ## Gotcha
146
+
147
+ - A primary message everyone in the room agrees with on first read
148
+ is usually below the noise floor — agreement is consensus, not
149
+ distinctiveness.
150
+ - Proofs that need adjectives are signals of a missing proof; replace
151
+ the adjective with the evidence or remove the line.
152
+ - The audience matrix tempts the team to multiply primary messages.
153
+ Resist: the segment receives one primary; the matrix shapes
154
+ emphasis, not substitution.
155
+
156
+ ## Do NOT
157
+
158
+ - Do NOT write copy in this skill — copy lives downstream.
159
+ - Do NOT inflate the stack beyond three proofs; a stack of seven is
160
+ a wishlist, not architecture.
161
+ - Do NOT skip the noise-floor check; an internally distinctive
162
+ message is not the same as a market-distinctive one.
163
+
164
+ ## Runnable example
165
+
166
+ Mid-market HR analytics tool, positioning locked (segment: HR leaders
167
+ at 200–2000-person growing companies; alternative: spreadsheet +
168
+ HRIS report; PoV: retention beats acquisition):
169
+
170
+ - Primary message: *"For HR leaders at growing 200–2000-person
171
+ companies, the workforce-analytics layer that turns the
172
+ board-quarter retention conversation into a one-click roll-up,
173
+ instead of a spreadsheet rebuild every quarter."*
174
+ - Proofs ranked by closing weight: (1) cohort attrition by tenure
175
+ band in < 5 clicks (demo); (2) plugs into the existing HRIS,
176
+ not a replacement (architecture diagram); (3) board-quarter
177
+ rebuild collapses from \~ 8 hours to \~ 1 hour (reference
178
+ customer, contractually quoted).
179
+ - Audience matrix — *Champion (HR director):* fear = another tool
180
+ to maintain; hope = looks competent to CEO; proof = HRIS
181
+ plug-in. *Economic buyer (CFO / COO):* fear = soft ROI; hope =
182
+ retention saving; proof = reference quote with hours saved.
183
+ - Hand-off → `gtm-launch` sequences launch waves around the
184
+ retention-conversation moment in board-quarter cadence.