startup-ideation-kit 2.0.0 → 3.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (28) hide show
  1. package/README.md +2 -2
  2. package/bin/cli.js +30 -23
  3. package/package.json +1 -1
  4. package/skills/sk-competitors/SKILL.md +19 -1
  5. package/skills/sk-competitors/references/competitive-analysis-framework.md +125 -0
  6. package/skills/sk-competitors/references/research-scaling.md +17 -0
  7. package/skills/sk-competitors/references/research-synthesis.md +77 -0
  8. package/skills/sk-competitors/references/research-wave-1-profiles-pricing.md +16 -0
  9. package/skills/sk-competitors/references/research-wave-2-sentiment-mining.md +10 -0
  10. package/skills/sk-competitors/references/research-wave-3-gtm-signals.md +16 -0
  11. package/skills/sk-offer/SKILL.md +1 -0
  12. package/skills/sk-pitch/SKILL.md +1 -0
  13. package/skills/sk-positioning/SKILL.md +2 -0
  14. package/skills/startupkit/SKILL.md +1 -1
  15. package/skills/startupkit/templates/competitors-template.md +43 -0
  16. package/skills/startupkit/templates/diverge-template.md +179 -0
  17. package/skills/startupkit/templates/lead-strategy-template.md +215 -0
  18. package/skills/startupkit/templates/money-model-template.md +282 -0
  19. package/skills/startupkit/templates/niche-template.md +203 -0
  20. package/skills/startupkit/templates/offer-template.md +243 -0
  21. package/skills/startupkit/templates/one-pager-template.md +125 -0
  22. package/skills/startupkit/templates/pitch-template.md +48 -0
  23. package/skills/startupkit/templates/positioning-template.md +51 -0
  24. package/skills/startupkit/templates/session-template.md +74 -0
  25. package/skills/startupkit/templates/skills-match-template.md +160 -0
  26. package/skills/startupkit/templates/validation-template.md +273 -0
  27. package/templates/competitive-analysis-template.md +305 -0
  28. package/templates/competitors-template.md +19 -3
package/README.md CHANGED
@@ -50,11 +50,11 @@ You don't have to follow them in order. Jump to any phase, revisit previous ones
50
50
  npx skills add mohamedameen-io/StartupKit
51
51
  ```
52
52
 
53
- That's it. The skills are installed into your project and ready to use.
53
+ That's it. The skills are installed globally (`~/.claude/skills/`) and available in any Claude Code session.
54
54
 
55
55
  ### Then brainstorm
56
56
 
57
- 1. Open Claude Code in your project directory
57
+ 1. Open Claude Code in any directory
58
58
  2. Run `/startupkit` to create a new brainstorming session
59
59
  3. Work through the phases at your own pace -- Claude guides you with questions and frameworks
60
60
  4. Each phase saves its output as a structured markdown file in `workspace/sessions/your-session/`
package/bin/cli.js CHANGED
@@ -1,6 +1,7 @@
1
1
  #!/usr/bin/env node
2
2
 
3
3
  const fs = require("fs");
4
+ const os = require("os");
4
5
  const path = require("path");
5
6
 
6
7
  const SKILLS = [
@@ -23,6 +24,7 @@ const TEMPLATES = [
23
24
  "diverge-template.md",
24
25
  "niche-template.md",
25
26
  "competitors-template.md",
27
+ "competitive-analysis-template.md",
26
28
  "positioning-template.md",
27
29
  "offer-template.md",
28
30
  "validation-template.md",
@@ -40,10 +42,13 @@ function printUsage() {
40
42
  startupkit - Interactive startup ideation kit for Claude Code
41
43
 
42
44
  Usage:
43
- npx startupkit init Install skills and templates into current directory
45
+ npx startupkit init Install skills globally and templates locally
44
46
  npx startupkit uninstall Remove installed skills and templates
45
47
  npx startupkit help Show this help message
46
48
 
49
+ Skills and templates are installed globally (~/.claude/skills/) so they work
50
+ in any project. Session output is saved in the current working directory.
51
+
47
52
  After installing, open Claude Code and run /startupkit to begin.
48
53
  `);
49
54
  }
@@ -64,6 +69,7 @@ function copyDir(src, dest) {
64
69
 
65
70
  function init() {
66
71
  const cwd = process.cwd();
72
+ const home = os.homedir();
67
73
  const pkgRoot = path.resolve(__dirname, "..");
68
74
  const skillsSrc = path.join(pkgRoot, "skills");
69
75
  const templatesSrc = path.join(pkgRoot, "templates");
@@ -71,45 +77,45 @@ function init() {
71
77
  let installed = 0;
72
78
  let skipped = 0;
73
79
 
74
- // Install skills
80
+ // Install skills globally (~/.claude/skills/)
81
+ const skillsDest = path.join(home, ".claude", "skills");
75
82
  for (const skill of SKILLS) {
76
83
  const src = path.join(skillsSrc, skill);
77
- const dest = path.join(cwd, ".claude", "skills", skill);
84
+ const dest = path.join(skillsDest, skill);
78
85
  if (fs.existsSync(path.join(dest, "SKILL.md"))) {
79
- console.log(` skip .claude/skills/${skill}/SKILL.md (already exists)`);
86
+ console.log(` skip ~/.claude/skills/${skill}/SKILL.md (already exists)`);
80
87
  skipped++;
81
88
  } else {
82
89
  copyDir(src, dest);
83
- console.log(` add .claude/skills/${skill}/SKILL.md`);
90
+ console.log(` add ~/.claude/skills/${skill}/SKILL.md`);
84
91
  installed++;
85
92
  }
86
93
  }
87
94
 
88
- // Install templates
89
- const templatesDest = path.join(cwd, "workspace", "templates");
95
+ // Install templates into startupkit skill directory
96
+ const templatesDest = path.join(skillsDest, "startupkit", "templates");
90
97
  fs.mkdirSync(templatesDest, { recursive: true });
91
98
  for (const template of TEMPLATES) {
92
99
  const src = path.join(templatesSrc, template);
93
100
  const dest = path.join(templatesDest, template);
94
101
  if (fs.existsSync(dest)) {
95
- console.log(` skip workspace/templates/${template} (already exists)`);
102
+ console.log(` skip ~/.claude/skills/startupkit/templates/${template} (already exists)`);
96
103
  skipped++;
97
104
  } else {
98
105
  fs.copyFileSync(src, dest);
99
- console.log(` add workspace/templates/${template}`);
106
+ console.log(` add ~/.claude/skills/startupkit/templates/${template}`);
100
107
  installed++;
101
108
  }
102
109
  }
103
110
 
104
- // Create sessions directory
105
- const sessionsDir = path.join(cwd, "workspace", "sessions");
106
- fs.mkdirSync(sessionsDir, { recursive: true });
107
-
108
111
  console.log(`
109
112
  Done! ${installed} files installed, ${skipped} skipped.
110
113
 
114
+ Skills and templates installed globally to ~/.claude/skills/.
115
+ Available in any Claude Code session.
116
+
111
117
  Next steps:
112
- 1. Open Claude Code in this directory
118
+ 1. Open Claude Code in any directory
113
119
  2. Run /startupkit to create a new brainstorming session
114
120
  3. Follow the phases: /sk-diverge -> /sk-niche -> /sk-competitors -> ...
115
121
  `);
@@ -117,24 +123,25 @@ function init() {
117
123
 
118
124
  function uninstall() {
119
125
  const cwd = process.cwd();
126
+ const home = os.homedir();
120
127
  let removed = 0;
121
128
 
129
+ // Remove global skills
122
130
  for (const skill of SKILLS) {
123
- const dir = path.join(cwd, ".claude", "skills", skill);
131
+ const dir = path.join(home, ".claude", "skills", skill);
124
132
  if (fs.existsSync(dir)) {
125
133
  fs.rmSync(dir, { recursive: true });
126
- console.log(` remove .claude/skills/${skill}/`);
134
+ console.log(` remove ~/.claude/skills/${skill}/`);
127
135
  removed++;
128
136
  }
129
137
  }
130
138
 
131
- for (const template of TEMPLATES) {
132
- const file = path.join(cwd, "workspace", "templates", template);
133
- if (fs.existsSync(file)) {
134
- fs.unlinkSync(file);
135
- console.log(` remove workspace/templates/${template}`);
136
- removed++;
137
- }
139
+ // Remove templates from startupkit skill directory
140
+ const templateDir = path.join(home, ".claude", "skills", "startupkit", "templates");
141
+ if (fs.existsSync(templateDir)) {
142
+ fs.rmSync(templateDir, { recursive: true });
143
+ console.log(` remove ~/.claude/skills/startupkit/templates/`);
144
+ removed++;
138
145
  }
139
146
 
140
147
  console.log(`\n Done! ${removed} files removed.\n`);
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "startup-ideation-kit",
3
- "version": "2.0.0",
3
+ "version": "3.0.0",
4
4
  "description": "Interactive 11-phase startup ideation kit powered by Claude Code skills. Brainstorm, score, research competitors, position, build offers, validate, model revenue, plan leads, match AI skills, pitch investors, and export -- using frameworks from $100M Offers, April Dunford, and more.",
5
5
  "bin": {
6
6
  "startupkit": "./bin/cli.js"
@@ -99,6 +99,10 @@ This skill requires WebSearch for real data. If WebSearch is unavailable or deni
99
99
 
100
100
  > **Reference:** Read `references/research-principles.md` before starting any wave. It defines source quality tiers, cross-referencing rules, and how to handle data gaps.
101
101
 
102
+ ### Competitive Analysis Framework
103
+
104
+ > **Reference:** Read `references/competitive-analysis-framework.md` for tier-scaled analytical dimensions that enrich competitor profiles and synthesis outputs across all research tiers. This framework adds moat assessment, strategic vulnerability mapping, and (for Deep tier) standalone competitor dossiers.
105
+
102
106
  ### Wave 1: Competitor Profiles + Pricing Intelligence
103
107
 
104
108
  > **Reference:** Read `references/research-wave-1-profiles-pricing.md` for agent templates.
@@ -191,17 +195,30 @@ Every deliverable file must start with a standardized header: `# {Title}: {produ
191
195
  - Key vulnerability to exploit
192
196
  - Churn signals (why their customers leave)
193
197
 
198
+ **Standard + Deep — Strategic analysis sections in `competitors-report.md`:**
199
+ Moat Durability Assessment table, GTM Whitespace analysis, and Strategic Vulnerability Map are added to the competitors-report. See `references/competitive-analysis-framework.md` for table formats.
200
+
201
+ **Deep tier only — `workspace/sessions/{name}/03-competitors/competitor-dossiers/{competitor-name}.md`:**
202
+ For the top 2-3 highest-threat competitors, produce a structured competitive dossier with deeper strategic intelligence. These go beyond battle cards to cover company foundation, product architecture, inferred ICP, GTM deconstruction, strategic vulnerabilities, and future trajectory. See `references/competitive-analysis-framework.md` for the 7-section dossier structure.
203
+
194
204
  ### Summary File
195
205
 
196
206
  After completing synthesis, generate a summary file at `workspace/sessions/{name}/03-competitors.md` containing:
197
207
 
198
208
  - **Executive Summary**: 5 sentences covering the competitive landscape
199
- - **Key Competitors** table: Name | Stage | Strength | Weakness | Threat Level (H/M/L)
209
+ - **Key Competitors** table: Name | Stage | Moat | Strength | Weakness | Threat Level (H/M/L)
200
210
  - **Strategic Opportunity**: Single strongest opportunity with evidence
201
211
  - **Strategic Risk**: Single biggest risk with evidence
202
212
  - **Pricing Landscape Summary**: Market price range, dominant value metric, pricing whitespace
203
213
  - **Full Deliverables**: Links to the files in `03-competitors/` subdirectory
204
214
 
215
+ When research depth is Standard or Deep, also include:
216
+ - **Moat Durability Assessment**: Table with moat type, durability, and eroding factor per competitor
217
+ - **GTM Whitespace**: Underexploited channels and content gaps across the landscape
218
+
219
+ When research depth is Deep, also include:
220
+ - **Competitor Dossiers**: Links to `03-competitors/competitor-dossiers/` for top 2-3 threat competitors
221
+
205
222
  This summary file is what downstream phases (positioning, offer, pitch) will read. Keep it concise and data-dense.
206
223
 
207
224
  ### Raw Data
@@ -266,6 +283,7 @@ Read only what you need for the current phase.
266
283
  | `research-synthesis.md` | After all waves complete | ~231 | How to synthesize + battle card template |
267
284
  | `research-scaling.md` | After intake, before Phase 2 | ~80 | Complexity scoring, tier definitions, wave configurations |
268
285
  | `verification-agent.md` | After synthesis | ~85 | Verification protocol, universal + skill-specific checks |
286
+ | `competitive-analysis-framework.md` | Before starting any wave | ~120 | Tier-scaled analytical dimensions, dossier structure, section-to-wave mapping |
269
287
 
270
288
  ---
271
289
 
@@ -0,0 +1,125 @@
1
+ # Competitive Analysis Framework
2
+
3
+ Reference for applying the competitive analysis template (`templates/competitive-analysis-template.md`) across research tiers. Read this before starting research waves.
4
+
5
+ ## Tier-Scaled Dimensions
6
+
7
+ ### All Tiers (Light, Standard, Deep)
8
+
9
+ Every competitor profile must include these additional dimensions beyond the standard profile fields:
10
+
11
+ | Dimension | Description | Source |
12
+ |-----------|------------|--------|
13
+ | **Moat Type** | Primary competitive moat: network effects, switching costs, data moat, brand, scale, IP/patents, regulatory, or none | Wave 1 (A1) |
14
+ | **Key Vulnerability** | Single biggest weakness that could be exploited | Wave 1 (A1) + Wave 2 (B1/B2) |
15
+ | **Primary Moat Durability** | How long before the moat erodes: <1 year, 1-3 years, 3-5 years, 5+ years | Wave 3 (C2) |
16
+
17
+ These fields feed into the Moat Durability Assessment table in the competitors-report during synthesis.
18
+
19
+ ### Standard + Deep Tiers
20
+
21
+ Enhanced profile dimensions for each competitor:
22
+
23
+ | Dimension | Description | Source |
24
+ |-----------|------------|--------|
25
+ | **Founding Narrative** | When founded, key pivots, near-death experiences, founding thesis | Wave 1 (A1) |
26
+ | **Leadership Signals** | Founder/C-suite backgrounds, public thought leadership, influence | Wave 1 (A1) |
27
+ | **Funding Trajectory** | All rounds, investors, rationale per round, valuation signals | Wave 1 (A1) |
28
+ | **IP Signals** | Patents, trademarks, proprietary technology claims | Wave 1 (A1) |
29
+ | **Inferred ICP** | Who they target based on messaging, case studies, reviews, job postings | Wave 2 (B1/B2) |
30
+ | **GTM Whitespace** | Channels they underexploit, content gaps, partnership opportunities | Wave 3 (C1/C2) |
31
+ | **M&A Signals** | Acquisition history, acquisition target indicators, strategic partnerships | Wave 3 (C2) |
32
+ | **Revenue Model Evolution** | Pricing changes over time, monetization experiments | Wave 1 (A2) + Wave 3 (C2) |
33
+ | **Customer Concentration Risk** | Reliance on specific segments or large accounts | Wave 2 (B1/B2) + Wave 3 (C2) |
34
+
35
+ ### Deep Tier Only
36
+
37
+ Produce standalone **Competitor Dossiers** for the top 2-3 highest-threat competitors (those rated "High" in the threat assessment from Wave 1).
38
+
39
+ **Competitor Selection:** After Wave 1 completes and threat levels are assigned, identify the top 2-3 "High" threat competitors for dossier treatment. If fewer than 2 are rated "High," include the highest-rated "Medium" competitors to reach 2.
40
+
41
+ **Dossier Structure:**
42
+
43
+ ```
44
+ # Competitive Dossier: {competitor-name}
45
+ *Skill: sk-competitors | Generated: {date} | Depth: Deep*
46
+
47
+ ## 1. Company Foundation & Strategic Position
48
+ - Founding narrative, pivots, key milestones
49
+ - Leadership profiles and public influence
50
+ - Funding history with rationale per round
51
+ - IP portfolio and strategic moat assessment
52
+
53
+ ## 2. Product & Value Proposition Architecture
54
+ - Product/service suite breakdown
55
+ - Key differentiators and limitations
56
+ - Technical architecture (what's externally observable)
57
+ - Integration ecosystem and API strategy
58
+ - Pricing model, psychology, and evolution
59
+
60
+ ## 3. Target Customer Profile (Inferred)
61
+ - Primary and secondary customer segments
62
+ - Firmographic, technographic, and behavioral signals
63
+ - Pain points they address (from their messaging and case studies)
64
+ - Customer journey touchpoints (from their website and content)
65
+
66
+ ## 4. Customer Voice & Market Sentiment
67
+ - Review analysis patterns (praise themes, complaint themes)
68
+ - Community sentiment and forum discussions
69
+ - NPS/satisfaction signals (if publicly available)
70
+ - Analyst report mentions and industry perception
71
+
72
+ ## 5. GTM Strategy & Revenue Engine
73
+ - Sales motion (self-serve vs. sales-led vs. hybrid)
74
+ - Primary acquisition channels and content strategy
75
+ - Partnership and channel programs
76
+ - Marketing positioning and messaging analysis
77
+
78
+ ## 6. Strategic Vulnerabilities & Risks
79
+ - Competitive threats they face
80
+ - Market and regulatory risks
81
+ - Operational weaknesses (inferred from reviews, hiring, public signals)
82
+ - Technology risks and technical debt signals
83
+
84
+ ## 7. Future Trajectory & Growth Signals
85
+ - Product roadmap signals (changelogs, job postings, announcements)
86
+ - Market expansion indicators (new geographies, segments)
87
+ - M&A likelihood (as acquirer or target)
88
+ - Platform/ecosystem ambitions
89
+
90
+ ## Red Flags
91
+ {Critical issues that directly impact competitive strategy}
92
+
93
+ ## Yellow Flags
94
+ {Concerns worth monitoring}
95
+
96
+ ## Data Gaps
97
+ {What could not be determined — be explicit}
98
+
99
+ ## Sources
100
+ {All sources cited with dates}
101
+ ```
102
+
103
+ **Output path:** `workspace/sessions/{name}/03-competitors/competitor-dossiers/{competitor-name}.md`
104
+
105
+ ## Section-to-Wave Mapping
106
+
107
+ | Template Section | Wave | Agents | Tier |
108
+ |---|---|---|---|
109
+ | I: Company Foundation & Positioning | Wave 1 | A1, A3 | Standard+ |
110
+ | II: Value Prop & Product Deep Dive | Wave 1 + Wave 3 | A1, A2, C3 | Standard+ (Deep for full depth) |
111
+ | III: ICP & Persona (inferred) | Wave 2 | B1, B2 | Standard+ |
112
+ | IV: Customer Voice & Sentiment | Wave 2 | B1, B2, B3 | All (B3 Deep only) |
113
+ | V: GTM Strategy & Revenue Engine | Wave 3 | C1, C2 | Standard+ |
114
+ | VII: Strategic Vulnerabilities | Synthesis | — | All (basic), Standard+ (full) |
115
+ | VIII: Future Vision & Growth | Wave 3 | C2 | Standard+ |
116
+
117
+ ## Synthesis Integration
118
+
119
+ During synthesis, the framework adds these outputs to the competitors-report (all tiers):
120
+
121
+ 1. **Moat Durability Assessment** table — one row per competitor
122
+ 2. **GTM Whitespace** section — channels and content gaps across the landscape (Standard+)
123
+ 3. **Strategic Vulnerability Map** — per-competitor risk matrix (Standard+)
124
+
125
+ For Deep tier, assemble the dossier files AFTER synthesis of the main deliverables. The dossiers draw from all raw files — no additional research needed.
@@ -69,6 +69,11 @@ The agent counts shown should reflect the actual numbers for this skill (see Wav
69
69
 
70
70
  **Total: 3 agents** (vs. 6 Standard), 2-3 search rounds per agent
71
71
 
72
+ **Analytical Framework Additions (Light):**
73
+ - Each competitor profile includes: moat type, key vulnerability, moat durability signal
74
+ - Competitors-report includes condensed Moat Durability Assessment table
75
+ - See `competitive-analysis-framework.md` for dimension definitions
76
+
72
77
  ### Standard (5-7 score, default)
73
78
 
74
79
  No changes to current wave structure:
@@ -76,6 +81,12 @@ No changes to current wave structure:
76
81
  - Wave 2: 2 agents (B1, B2)
77
82
  - Wave 3: 2 agents (C1, C2)
78
83
 
84
+ **Analytical Framework Additions (Standard):**
85
+ - Each competitor profile includes: moat type, key vulnerability, founding narrative, leadership signals, funding trajectory, IP signals, inferred ICP
86
+ - Competitors-report includes: Moat Durability Assessment table, GTM Whitespace section, Strategic Vulnerability mapping
87
+ - Battle cards enriched with strategic vulnerability section
88
+ - See `competitive-analysis-framework.md` for dimension definitions
89
+
79
90
  **Total: 6 agents**, 3-4 search rounds per agent
80
91
 
81
92
  ### Deep (8-9 score or user override)
@@ -95,6 +106,12 @@ No changes to current wave structure:
95
106
  - C2: Strategic & Growth Signals (unchanged)
96
107
  - C3: Tech Stack & Product Analysis (NEW: analyze competitors' technology choices, API ecosystems, integration depth, and technical moats)
97
108
 
109
+ **Analytical Framework Additions (Deep):**
110
+ - All Standard additions apply
111
+ - Produce standalone Competitor Dossiers for top 2-3 highest-threat competitors during synthesis
112
+ - Dossiers follow the 7-section structure defined in `competitive-analysis-framework.md`
113
+ - Output: `03-competitors/competitor-dossiers/{competitor-name}.md`
114
+
98
115
  **Total: 9 agents**, 5-6 search rounds per agent
99
116
 
100
117
  ## PROGRESS.md
@@ -179,6 +179,83 @@ Based on the matrix, the clearest paths to differentiation:
179
179
 
180
180
  ---
181
181
 
182
+ ---
183
+
184
+ ## Strategic Analysis Framework (All Tiers)
185
+
186
+ After completing the main deliverables, add these strategic analysis sections to `competitors-report.md`:
187
+
188
+ ### Moat Durability Assessment (All Tiers)
189
+
190
+ Add this table to the competitors-report, drawing from moat data collected in Wave 1 profiles and Wave 3 strategic signals:
191
+
192
+ ```
193
+ ## Moat Durability Assessment
194
+
195
+ | Competitor | Primary Moat | Durability | Eroding Factor | Confidence |
196
+ |-----------|-------------|------------|----------------|------------|
197
+ | {name} | {moat type} | {<1yr / 1-3yr / 3-5yr / 5+yr} | {what could erode it} | {H/M/L} |
198
+ ```
199
+
200
+ Moat types: network effects, switching costs, data moat, brand, scale, IP/patents, regulatory, none.
201
+
202
+ ### GTM Whitespace (Standard + Deep)
203
+
204
+ Add this section to the competitors-report, drawing from Wave 3 GTM analysis:
205
+
206
+ ```
207
+ ## GTM Whitespace
208
+
209
+ **Underexploited channels:**
210
+ - {channel} — {why it's open, which competitors ignore it}
211
+
212
+ **Content gaps:**
213
+ - {topic area} — {no competitor covers this well, estimated search demand}
214
+
215
+ **Partnership opportunities:**
216
+ - {partner type} — {untapped partnership that could provide distribution}
217
+ ```
218
+
219
+ ### Strategic Vulnerability Map (Standard + Deep)
220
+
221
+ Add this section to the competitors-report:
222
+
223
+ ```
224
+ ## Strategic Vulnerability Map
225
+
226
+ | Competitor | Vulnerability Type | Description | Exploitability | Confidence |
227
+ |-----------|-------------------|-------------|---------------|------------|
228
+ | {name} | {product/GTM/financial/operational/talent} | {specific vulnerability} | {H/M/L} | {H/M/L} |
229
+ ```
230
+
231
+ ---
232
+
233
+ ## Deep Tier: Competitor Dossiers
234
+
235
+ When research depth is Deep, produce structured dossiers for the top 2-3 highest-threat competitors AFTER completing all other synthesis deliverables.
236
+
237
+ ### Assembly Protocol
238
+
239
+ 1. Identify top 2-3 "High" threat competitors from Wave 1 profiles
240
+ 2. Read ALL raw files in `raw/` for data on these competitors
241
+ 3. Also draw from the synthesized competitors-report, pricing-landscape, and battle cards
242
+ 4. Assemble each dossier following the 7-section structure in `competitive-analysis-framework.md`
243
+ 5. Save to `competitor-dossiers/{competitor-name}.md`
244
+
245
+ ### What Goes in a Dossier vs. a Battle Card
246
+
247
+ | Aspect | Battle Card | Dossier |
248
+ |--------|------------|---------|
249
+ | **Length** | 1 page | 5-15 pages |
250
+ | **Purpose** | Quick reference for sales/positioning | Strategic intelligence for founders making product/pricing/positioning decisions |
251
+ | **Audience** | Anyone on the team | Founders, CRO, product leads |
252
+ | **Update frequency** | Each research run | Quarterly deep refresh |
253
+ | **Key question** | "How do I win against them?" | "What is their full strategic position and trajectory?" |
254
+
255
+ Dossiers DO NOT replace battle cards. Both are produced for Deep-tier competitors.
256
+
257
+ ---
258
+
182
259
  ## Post-Synthesis Verification
183
260
 
184
261
  After writing all deliverables and battle cards, run the Verification Agent protocol. See `references/verification-agent.md` for the full process. The verification step checks all deliverables for unlabeled claims, internal contradictions, confidence rating consistency, and startup-competitors-specific coherence (battle card vs. report consistency, matrix vs. profiles alignment, pricing landscape vs. profiles consistency, cross-deliverable opportunity/risk traceability).
@@ -81,6 +81,22 @@ For EACH competitor, build a complete profile:
81
81
  ### Threat Level: Low / Medium / High
82
82
  - {why — with evidence}
83
83
 
84
+ #### Competitive Analysis Framework Additions
85
+
86
+ **All tiers — add to every competitor profile:**
87
+ - **Moat Type:** What is their primary competitive moat? (network effects / switching costs / data moat / brand / scale / IP-patents / regulatory / none)
88
+ - **Key Vulnerability:** What is their single biggest exploitable weakness? (be specific — not just "small team" but "3-person engineering team with no ML expertise attempting to compete on AI features")
89
+
90
+ **Standard + Deep tiers — add to every competitor profile:**
91
+ - **Founding Narrative:** When founded, by whom, original thesis, key pivots, any near-death experiences
92
+ - **Leadership Signals:** Founder/CEO background, public thought leadership, conference presence, advisory network
93
+ - **Funding Trajectory:** All rounds with dates, amounts, key investors, and stated use of funds
94
+ - **IP Signals:** Patents filed/granted, trademarks, proprietary technology claims, open-source contributions
95
+
96
+ **Deep tier — add to top 3 competitors:**
97
+ - **Technical Architecture (external signals):** Tech stack (from job postings, BuiltWith, Wappalyzer), infrastructure choices, API maturity, integration depth
98
+ - **Integration Ecosystem:** Supported integrations, marketplace/app store presence, developer program, API documentation quality
99
+
84
100
  ---
85
101
 
86
102
  After all profiles:
@@ -79,6 +79,16 @@ Reasons people leave this competitor:
79
79
  - {reason 2 — with evidence}
80
80
  - {reason 3 — with evidence}
81
81
 
82
+ #### Competitive Analysis Framework Additions
83
+
84
+ **Standard + Deep tiers — add to sentiment analysis:**
85
+ - **Inferred ICP Extraction:** From competitor reviews, case studies, and testimonials, infer who their ideal customer is:
86
+ - What industries/segments are reviewers from?
87
+ - What company sizes mention them most?
88
+ - What job titles write reviews?
89
+ - What use cases are most commonly praised?
90
+ - Build an "inferred customer persona" for each competitor based on who actually uses and reviews their product
91
+
82
92
  ---
83
93
 
84
94
  After all competitors:
@@ -158,6 +158,22 @@ For EACH competitor:
158
158
  - **Tech bets:** {AI, mobile, API, integrations — what are they investing in?}
159
159
  - **Platform plays:** {trying to become a platform? Building ecosystem?}
160
160
 
161
+ #### Competitive Analysis Framework Additions
162
+
163
+ **All tiers — add to strategic signals:**
164
+ - **Primary Moat Durability Signal:** Based on all evidence, how durable is each competitor's moat? (<1 year / 1-3 years / 3-5 years / 5+ years). What single factor most threatens it?
165
+
166
+ **Standard + Deep tiers — add to strategic signals:**
167
+ - **M&A Signals:** Acquisition history, strategic partnerships that suggest acquisition interest, investor profiles that suggest exit orientation
168
+ - **Platform Ambitions:** API ecosystem growth, developer program investment, marketplace/app store plans, partner program evolution
169
+ - **Revenue Model Evolution:** Historical pricing changes, new monetization experiments, freemium strategy shifts
170
+ - **Customer Concentration Risk:** Evidence of reliance on specific segments, enterprise vs. SMB mix signals, geographic concentration
171
+
172
+ **Deep tier — add to GTM analysis (C1):**
173
+ - **Sales Motion Detail:** Self-serve vs. sales-led vs. PLG indicators (from job postings, pricing page design, demo request flows)
174
+ - **Channel Saturation Score:** For each major acquisition channel, estimate competitor saturation (high/medium/low) based on ad presence, content volume, SEO footprint
175
+ - **Partnership Ecosystem Map:** Technology partners, implementation partners, referral programs, co-marketing evidence
176
+
161
177
  ---
162
178
 
163
179
  After all competitors:
@@ -20,6 +20,7 @@ You are the offer architect. Your job is to guide the user through building a Gr
20
20
  4. Read `workspace/sessions/{name}/03-competitors.md` if it exists and extract:
21
21
  - The pricing landscape summary (market price range, value metric, whitespace)
22
22
  - Top competitor strengths for the Commodity Check
23
+ - If `03-competitors.md` contains a "Moat Durability Assessment" table, extract moat types for the Commodity Check — competitors with eroding moats (<1yr durability) are weaker threats to differentiate against
23
24
  5. Confirm the Gold niche (and positioning if available) with the user.
24
25
 
25
26
  ## Step 1: Six P's One-Pager
@@ -49,6 +49,7 @@ Before asking questions, ask the user for their session name, then read ALL avai
49
49
  **From Phase 3 (Competitors):**
50
50
  - `workspace/sessions/{name}/03-competitors.md` -- Competitive landscape summary
51
51
  - `workspace/sessions/{name}/03-competitors/battle-cards/` -- Per-competitor battle cards (for Q&A prep)
52
+ - If `workspace/sessions/{name}/03-competitors/competitor-dossiers/` directory exists, read the dossiers for deeper competitive framing in Q&A preparation — dossiers contain strategic vulnerabilities and future trajectory that strengthen "why us" answers
52
53
 
53
54
  **From Phase 4 (Positioning):**
54
55
  - `workspace/sessions/{name}/04-positioning.md` -- Positioning summary with elevator pitch
@@ -44,6 +44,8 @@ If `03-competitors.md` exists, extract:
44
44
  - Key competitors and their strengths/weaknesses
45
45
  - Pricing landscape (market price range, value metrics, whitespace)
46
46
  - Strategic opportunities and risks
47
+ - If `03-competitors.md` contains a "Moat Durability Assessment" section, extract moat types and durability ratings — use these to identify positioning angles that exploit competitors' eroding moats
48
+ - If `03-competitors.md` contains a "GTM Whitespace" section, extract underexploited channels — use these to inform the positioning strategy's channel differentiation
47
49
 
48
50
  If battle cards exist, read them to seed the competitive alternatives map.
49
51
 
@@ -26,7 +26,7 @@ You are the entry point for the Startup Ideation Kit. Your job is to manage brai
26
26
  ### Creating a new session:
27
27
  1. Ask for a session name (kebab-case, e.g., `ai-coaching-biz`)
28
28
  2. Create the folder `workspace/sessions/{name}/`
29
- 3. Copy `workspace/templates/session-template.md` to `workspace/sessions/{name}/00-session.md`
29
+ 3. Copy the `templates/session-template.md` file (located in this skill's directory) to `workspace/sessions/{name}/00-session.md`
30
30
  4. Fill in the session name and today's date
31
31
  5. Show the progress dashboard
32
32
 
@@ -0,0 +1,43 @@
1
+ # Phase 3: Competitive Research
2
+
3
+ > **Session:** [session-name]
4
+ > **Date:** [YYYY-MM-DD]
5
+ > **Research Depth:** [Light / Standard / Deep]
6
+ > **Competitors Profiled:** [X]
7
+
8
+ ---
9
+
10
+ ## Executive Summary
11
+
12
+ [5-sentence competitive landscape overview]
13
+
14
+ ## Key Competitors
15
+
16
+ | Competitor | Stage | Strength | Weakness | Threat |
17
+ |-----------|-------|----------|----------|--------|
18
+ | [name] | [early/growth/mature] | [key strength] | [key weakness] | [H/M/L] |
19
+
20
+ ## Strategic Opportunity
21
+
22
+ [Single strongest opportunity with evidence]
23
+
24
+ ## Strategic Risk
25
+
26
+ [Single biggest risk with evidence]
27
+
28
+ ## Pricing Landscape Summary
29
+
30
+ - **Market price range:** $[low] -- $[high]
31
+ - **Dominant value metric:** [per seat / per usage / flat]
32
+ - **Pricing whitespace:** [where to position]
33
+
34
+ ## Full Deliverables
35
+
36
+ - `03-competitors/competitors-report.md` -- Full strategic report
37
+ - `03-competitors/competitive-matrix.md` -- Feature comparison
38
+ - `03-competitors/pricing-landscape.md` -- Pricing analysis
39
+ - `03-competitors/battle-cards/` -- Per-competitor battle cards
40
+
41
+ ---
42
+
43
+ *Generated with StartupKit Phase 3 (sk-competitors)*