moveros 4.0.8 → 4.1.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 (47) hide show
  1. package/install.js +4 -2
  2. package/package.json +1 -1
  3. package/src/hooks/context-staleness.sh +46 -46
  4. package/src/hooks/dirty-tree-guard.sh +33 -33
  5. package/src/hooks/engine-protection.sh +43 -43
  6. package/src/hooks/git-safety.sh +47 -47
  7. package/src/hooks/pre-compact-backup.sh +177 -177
  8. package/src/hooks/session-log-reminder.sh +135 -73
  9. package/src/skills/systematic-debugging/CREATION-LOG.md +119 -119
  10. package/src/skills/systematic-debugging/SKILL.md +296 -296
  11. package/src/skills/systematic-debugging/condition-based-waiting-example.ts +158 -158
  12. package/src/skills/systematic-debugging/condition-based-waiting.md +115 -115
  13. package/src/skills/systematic-debugging/defense-in-depth.md +122 -122
  14. package/src/skills/systematic-debugging/find-polluter.sh +63 -63
  15. package/src/skills/systematic-debugging/root-cause-tracing.md +169 -169
  16. package/src/skills/systematic-debugging/test-academic.md +14 -14
  17. package/src/skills/systematic-debugging/test-pressure-1.md +58 -58
  18. package/src/skills/systematic-debugging/test-pressure-2.md +68 -68
  19. package/src/skills/systematic-debugging/test-pressure-3.md +69 -69
  20. package/src/structure/01_Projects/_Template Project/plan.md +55 -55
  21. package/src/structure/01_Projects/_Template Project/project_brief.md +45 -45
  22. package/src/structure/02_Areas/Engine/Active_Context.md +146 -146
  23. package/src/structure/02_Areas/Engine/Auto_Learnings.md +36 -36
  24. package/src/structure/02_Areas/Engine/Daily_Template.md +133 -133
  25. package/src/structure/02_Areas/Engine/Identity_Prime_template.md +86 -86
  26. package/src/structure/02_Areas/Engine/Mover_Dossier.md +120 -120
  27. package/src/structure/02_Areas/Engine/Strategy_template.md +65 -65
  28. package/src/structure/03_Library/SOPs/Tech_Stack.md +55 -55
  29. package/src/structure/03_Library/SOPs/Zone_Operating.md +57 -57
  30. package/src/system/V4_CONTEXT.md +262 -262
  31. package/src/theme/minimal-theme.css +271 -271
  32. package/src/workflows/analyse-day.md +401 -401
  33. package/src/workflows/debug-resistance.md +180 -180
  34. package/src/workflows/harvest.md +239 -239
  35. package/src/workflows/ignite.md +720 -720
  36. package/src/workflows/init-plan.md +16 -16
  37. package/src/workflows/morning.md +222 -222
  38. package/src/workflows/overview.md +203 -203
  39. package/src/workflows/pivot-strategy.md +218 -218
  40. package/src/workflows/plan-tomorrow.md +308 -308
  41. package/src/workflows/primer.md +207 -207
  42. package/src/workflows/reboot.md +201 -201
  43. package/src/workflows/refactor-plan.md +135 -135
  44. package/src/workflows/review-week.md +558 -558
  45. package/src/workflows/setup.md +388 -388
  46. package/src/workflows/update.md +10 -13
  47. package/src/workflows/walkthrough.md +523 -523
@@ -1,720 +1,720 @@
1
- ---
2
- description: Initiates a new project or feature. Full pipeline from interrogation to Brief + Plan in one workflow.
3
- ---
4
-
5
- # Ignition Protocol (V4)
6
-
7
- **Trigger:** User runs `/ignite`, `/ignite --fast`, `/ignite --feature`, or `/ignite --monetize`
8
- **Role:** Systems Architect (single adaptive persona).
9
- **Task:** Transform a vague idea into a locked project with Brief, Plan, and Repo. Or add a feature to an existing project.
10
- **Risk Tier:** MEDIUM
11
-
12
- ---
13
-
14
- ## 0. PRE-FLIGHT
15
-
16
- Global Rules are pre-loaded as CLAUDE.md / GEMINI.md. Output `[Rules Loaded - DATE]`.
17
-
18
- LOAD (Memory Hierarchy):
19
- 1. Auto_Learnings.md (P0)
20
- 2. Active_Context.md (P1)
21
- 3. Strategy.md (P2)
22
- 4. Identity_Prime.md (P3)
23
- 5. Mover_Dossier.md (P3)
24
- 6. Last 3 Daily Notes (P5) — read via subagent (model: haiku). Needed for PIVOT DETECTION (Step 0.5). Shows what the user has actually been working on. If the new project contradicts their current Strategy or today's plan, this is the evidence.
25
-
26
- CONSTRAINTS:
27
- - All recommendations grounded in user's Strategy and Dossier
28
- - Check Dossier before suggesting cold starts [Mover_Global_Rules.md: S1]
29
- - Never proceed to next step without explicit user approval
30
- - Be proactive and strategic, not a checklist follower
31
- - Windows: no && in commands
32
-
33
- ---
34
-
35
- ## 1. MODE DETECTION
36
-
37
- **Fast Mode:** If `/ignite --fast`: FAST MODE (no TDD, hard-coded values OK, one file OK).
38
- If keywords: "quick script", "throwaway", "prototype" -> Suggest Fast Mode.
39
-
40
- **Feature Mode:** If `/ignite --feature` OR user describes a feature for an EXISTING project:
41
- 1. Detect the target project. Check for existing `project_brief.md` and `plan.md` in the project folder.
42
- 2. If no existing project found: "No project context found. Run `/ignite` for a full project, or specify which project folder."
43
- 3. LOAD existing `project_brief.md`, `plan.md`, `project_state.md` — these define the system the feature lives in.
44
- 4. Skip Clusters 4 (Business Model) and 5 (Resources) — already established for the project.
45
- 5. Adapt remaining clusters to focus on the feature within the existing system:
46
- - Cluster 1 → Feature Vision (what, why, how it fits the existing product)
47
- - Cluster 2 → User impact (who benefits, what changes for existing users)
48
- - Cluster 3 → Technical integration (what touches, what breaks, blast radius)
49
- - Cluster 6 → Edge cases specific to this feature
50
- - Cluster 7 → Stress test against existing system constraints
51
- 6. Output: Feature spec appended to `project_brief.md` under `## Feature: [Name]` + new Phase added to `plan.md`.
52
- 7. Skip Git Init (repo already exists).
53
-
54
- **Monetize Mode:** If `/ignite --monetize` OR user mentions revenue, selling, customers, pricing, "make money from this":
55
- 1. This mode fires Phase 0 (Market Validation) BEFORE the normal interrogation clusters.
56
- 2. Phase 0 spawns research subagents in parallel to build market intelligence.
57
- 3. A validation gate blocks proceeding to Cluster 1 until the user reviews market findings.
58
- 4. After Phase 0 approval, the normal interrogation proceeds with market context loaded.
59
- 5. Clusters 2 (User & Market) and 4 (Business Model) are pre-populated from Phase 0 research — the AI uses research findings as the baseline and the user corrects/extends, rather than starting from zero.
60
-
61
- **New Project Mode (default):** If neither flag, ask: "Is this a prototype or production code? If you intend to sell this, consider running `/ignite --monetize` instead."
62
-
63
- ---
64
-
65
- ## 1.5 PIVOT DETECTION (All modes except --feature on existing project)
66
-
67
- Before proceeding, cross-reference the new project against the user's current state:
68
-
69
- 1. **Read today's Daily Note** (if exists): What is the plan? What is the Single Test?
70
- 2. **Read last 3 Daily Notes**: What has the user been working on? Is there an active project with momentum?
71
- 3. **Read Strategy.md**: What is the current hypothesis being tested?
72
- 4. **Read Active_Context.md**: What is the stated bottleneck?
73
-
74
- **If the new project contradicts any of these:**
75
-
76
- Apply Escalating Friction (Global Rules S1.5):
77
-
78
- - Level 1: "Your Strategy says [X]. Your plan today says [Y]. You're proposing a new project: [Z]. Is this a deliberate pivot or are you avoiding [Y]?"
79
- - Level 2 (if they push through): "What about [current project] makes you want to start something new? One sentence."
80
- - Level 3 (if they still push through): "Noted. Logging this as a potential pivot. We'll proceed, but `/analyse-day` will flag this."
81
-
82
- **If not contradictory** (e.g., the new project IS the strategy, or no active projects exist): proceed without friction.
83
-
84
- **Log override if applicable:** Write `[OVERRIDE] User chose /ignite [new project] over [plan item]. Reason: "[user's stated reason]"` to today's Daily Note Session Log.
85
-
86
- ---
87
-
88
- ## 1.7 PHASE 0: MARKET VALIDATION (--monetize only)
89
-
90
- > **Gate:** Do not write a single line of code, generate a brief, or start architecture until Phase 0 is reviewed and approved. Building without validation is the most expensive form of procrastination.
91
-
92
- ### Step 1: Spawn Research Subagents (Parallel)
93
-
94
- Fire 3 research subagents simultaneously using the Task tool. All agents should use `model: "sonnet"`:
95
-
96
- **Agent A — ICP & Pain Points** (skill: `agent-research-analyst`)
97
- - Search Reddit (r/[relevant subreddits]), Hacker News, relevant forums for pain points
98
- - Collect verbatim quotes (exact language the target market uses — this becomes copy later)
99
- - Identify emotional tone per pain point (frustration, shame, resignation, hope)
100
- - Rank pain points by signal strength (upvotes, comment depth, recurrence)
101
- - Estimate willingness to pay based on existing spend patterns
102
-
103
- **Agent B — Competitor & Market Analysis** (skill: `agent-research-analyst`)
104
- - Map direct competitors (same niche + same solution type)
105
- - Map adjacent competitors (same niche, different solution OR different niche, same solution)
106
- - For each competitor: what they charge, how many users, what's missing (the gap)
107
- - Identify white space — what nobody is building
108
- - Market size estimate (TAM, SAM, SOM)
109
-
110
- **Agent C — Go-To-Market & First Users** (skill: `agent-content-researcher`)
111
- - Where do the first 50 customers come from? (specific channels, not "social media")
112
- - What distribution channels exist? (communities, newsletters, directories, marketplaces)
113
- - What launch playbooks have worked for similar products? (Product Hunt, Reddit, X threads)
114
- - What's the cheapest way to validate demand before building?
115
- - Map the Micro-Action-Chain (every step from first exposure to purchase). Identify stimulus fatigue risks and contrarian positioning opportunities
116
-
117
- **Agent D — Messaging & Psychology** (skills: `marketing-psychology`, `copywriting`, `pricing-strategy`)
118
- - Take the pain points from Agent A and translate into messaging:
119
- - Primary message (1 sentence that captures the core promise)
120
- - 3 supporting messages (each addressing a top pain point)
121
- - Objection handling (top 5 reasons someone won't buy + the counter)
122
- - Apply psychological leverage analysis:
123
- - Identify the top 10 cognitive biases most relevant to this niche and product (from the 88 in the leverage list)
124
- - Apply Lock & Key Theory: the human mind is the lock, the stimulus is the key. Build the stimulus to fit the lock, not the other way around.
125
- - Check for Lollapalooza Effect opportunities: where can 3+ biases stack to create non-linear persuasion?
126
- - Flag any overdone-it risk (too many levers = slimy, not genuine)
127
- - Pricing analysis: what price anchors exist in this market? What's the perceived value vs cost?
128
- - Positioning: "We are the only [X] that [Y]" — find the only statement
129
- - Tone/voice: based on ICP, what voice resonates? (technical, casual, authoritative, peer-to-peer)
130
-
131
- ### Step 2: Market Validation Frameworks
132
-
133
- While research agents run, apply these frameworks to the user's idea:
134
-
135
- **Niche Selection Checklist**:
136
-
137
- Ask the user these keystone questions (all must pass or the niche is unviable):
138
- 1. Does the niche need what you are selling? (Pain drives acquisition)
139
- 2. Is this niche growing? (Market must be expanding)
140
- 3. Can this niche afford your price? (Look at competitor pricing as signal)
141
- 4. Are you interested in this niche? (You'll spend thousands of hours here)
142
- 5. Are there more than 30,000 people in this niche?
143
- 6. Will you have competitors already succeeding? (Competition = sign of life)
144
- 7. Can people in this niche be easily found and contacted?
145
-
146
- **STOP. Wait for user response.**
147
-
148
- If ANY keystone question fails: "This niche fails the viability check on [X]. Either pivot the niche or acknowledge the risk before proceeding."
149
-
150
- **Client Avatar Worksheet**:
151
-
152
- Go deeper than demographics. Ask the user (or infer from Agent A research):
153
- 1. **Meet Your Client:** What do they do day-to-day? How do they spend their week? Where do they get their news/information?
154
- 2. **Financial & Emotional State:** How much do they make? How do they feel about their work? What are their concerns in life?
155
- 3. **History:** What happened in the past that led them here? A former job, a failed attempt, a frustrating experience?
156
- 4. **Decision Trigger:** What thoughts go through their head right before they buy? What's the "final straw" that makes them pull the trigger?
157
- 5. **Product Fit:** What about YOUR product matters to THIS person? How does it solve their pain or improve their life?
158
-
159
- **STOP. Wait for user response.**
160
-
161
- **Offer Creation Worksheet**:
162
-
163
- Walk the user through:
164
- 1. **Define Who:** Which specific segment of the niche? What's their current situation vs desired situation?
165
- 2. **Define Outcome:** What's the bold promise? Make it tangible (numbers-based).
166
- 3. **Define Timeframe:** How long to deliver the outcome? Can it be shorter?
167
- 4. **Methodology:** What steps/components deliver the outcome? Simplify to 6-9 words each.
168
- 5. **Factors of Value:** For each methodology step, list obstacles the prospect will imagine. Invert each obstacle into a solution. This is how value is created.
169
- 6. **Risk Reversal:** What guarantee can you offer? The bolder the guarantee, the higher the conversion.
170
- 7. **Packaging:** Reposition from "what it is" to "what it means." Not "markdown files" — "a self-improving execution engine."
171
-
172
- **STOP. Wait for user response.**
173
-
174
- **Offer Asset Creation**:
175
-
176
- Using the offer framework above + pain points from Agent A, create:
177
-
178
- 1. **Short-Form Messages (15-20):** 3-6 word hooks. Focus on end result. Reverse-engineer from the latent conditions of the market. Write what they want to read, not what you want to write. Examples: "escape the matrix", "make your bed", "become an acquisition expert."
179
- 2. **Long-Form Messages (4-5):** 1-4 sentence summaries of the offer. Include: who you help, end result, timeframe, risk reversal. Use words that display extreme confidence. Don't discuss the 'how.'
180
- 3. **Strategy Document:** List methodology items + factors of value. Less is more. This becomes the terms of your guarantee and sets deliverable expectations.
181
- 4. **The Pitch (5-part):** Our Promise, Our Strategy, Our Guarantee, The Ultimatum (either/or), The Packaging ("think of us like..."). Must be readable in under 2 minutes. Does NOT include the price.
182
-
183
- **STOP. Wait for user response.**
184
-
185
- ### Step 3: Compile Market Intelligence
186
-
187
- Once research agents return, compile into `dev/marketing/` (or project-specific `dev/marketing/` if a project folder exists):
188
-
189
- | File | Contents |
190
- |------|----------|
191
- | `ICP.md` | Ideal Customer Profile (3 tiers: primary, secondary, tertiary). Anti-ICP. Pain points ranked. Willingness to pay. |
192
- | `client_avatar.md` | Deep avatar profile: demographics, psychographics, history, decision triggers, "final straw" moment, product fit. |
193
- | `competitor_map.md` | Direct and adjacent competitors. Gap analysis. White space. Key people. |
194
- | `pain_points_raw.md` | Verbatim quotes organized by pain category. Emotional tone map. Sources. |
195
- | `gtm_plan.md` | First 50 customers strategy. Channels. Launch playbook. Validation experiments. |
196
- | `messaging_framework.md` | Primary message. Supporting messages. Objection handling. Psychology levers. Voice/tone. Positioning statement. |
197
- | `offer_framework.md` | Offer worksheet completed. Niche viability score. Packaging. Guarantee. Pricing. |
198
- | `offer_assets.md` | 15-20 short-form messages, 4-5 long-form messages, strategy document, 5-part pitch. |
199
- | `acquisition_system.md` | Micro-action-chain. Contrarian attraction analysis. System design (7-step). Sub-system priorities. |
200
- | `testing_plan.md` | First stimulus genotype. Key variables. KPIs. Sample sizes. Constants. Iteration protocol. |
201
-
202
- ### Step 4: Validation Gate
203
-
204
- Present the compiled findings to the user:
205
-
206
- "Here's what the market says about your idea:"
207
- 1. **ICP summary** — who buys this, what they're in pain about, what they already spend
208
- 2. **Competitive landscape** — who else does this, what's missing, your potential moat
209
- 3. **Go-to-market** — where the first 50 customers come from, cheapest validation path
210
- 4. **Offer framework** — your promise, your methodology, your guarantee, your price
211
-
212
- Then ask: **"Based on this research, do you want to:**
213
- - **A) Proceed** — market validated, start building
214
- - **B) Pivot** — research revealed a better angle, adjust the idea
215
- - **C) Kill** — insufficient market signal, don't build this
216
- - **D) Validate first** — run the cheapest experiment before building (landing page, waitlist, DMs)"
217
-
218
- **Do NOT proceed to Cluster 1 until the user explicitly chooses A or B.**
219
-
220
- If user chooses D: suggest the specific validation experiment (e.g., "Put up a landing page with an email capture. Share in [specific community]. If you get [X] signups in [Y] days, the signal is real.")
221
-
222
- ### Step 5: Acquisition System Design (if Proceed or Pivot)
223
-
224
- After validation, design the acquisition engine before any code is written.
225
-
226
- **Micro-Action-Chain Mapping:**
227
- Map the ENTIRE customer journey from first exposure to purchase. Every action the prospect must take:
228
- - Example chain: `sees post > clicks link > reads landing page > enters email > reads email sequence > clicks buy > enters payment > confirms`
229
- - For each action, identify the stimulus that triggers it (what makes them click, read, enter, buy?)
230
- - Identify where the chain breaks (highest drop-off points = priority optimization targets)
231
-
232
- **Contrarian Attraction Check:**
233
- - What is 95% of the market doing to acquire customers in this niche?
234
- - How can you do the opposite or something novel? (Stimulus Hypoesthesia = copying what everyone does guarantees fatigue)
235
- - What stimuli traits are overexposed? What's underused?
236
-
237
- **System Design** (7-step framework):
238
- 1. **Core Premises:** Which acquisition sub-system are you building first? (Attention, Interest, Appointments, Shows, Priming, Closing) — pick ONE to start.
239
- 2. **Input Mechanisms:** Where does the input pool come from? (email lists, social, ads, communities, organic)
240
- 3. **Stimuli Mechanisms:** What stimuli convert inputs to outputs? Define key variables per stimulus (2-4 max).
241
- 4. **Feedback Mechanisms:** What metrics and KPIs track effectiveness? Define metric-variable relationships.
242
- 5. **Flow:** Visualize the full system — all assets, all SOPs, all automations, in linear order.
243
- 6. **Deployment:** Which tasks are human vs machine? Create SOPs for human tasks.
244
- 7. **Scale Plan:** What happens after fitness is proven? How do you 10x the input volume?
245
-
246
- **Testing Plan** (Scientific Method for Acquisition):
247
- For the first stimulus genotype:
248
- - Define 2-4 key variables (the "DNA string" of the stimulus)
249
- - Define primary and secondary KPIs with target conversion rates
250
- - Set sample size (minimum 30 exposures per test for statistical validity)
251
- - Set timeframe (include latency — results don't appear instantly)
252
- - Establish constants (what does NOT change during the test)
253
- - Plan V1 → V2 iteration: if below KPI, which single variable do you change? (Ceteris Paribus — one variable at a time)
254
-
255
- Output: Add `acquisition_system.md` and `testing_plan.md` to `dev/marketing/`.
256
-
257
- ---
258
-
259
- ## 2. LIBRARY PRE-SEARCH (MANDATORY)
260
-
261
- Before starting, search `03_Library/` comprehensively:
262
- 1. List ALL files in `03_Library/Principles/` — read headers for relevance
263
- 2. List ALL files in `03_Library/Cheatsheets/` — read headers for relevance
264
- 3. List ALL files in `03_Library/SOPs/` — read headers for relevance
265
- 4. For each relevant file: read the full content and extract applicable lessons
266
- 5. Check `Auto_Learnings.md` for patterns related to this project domain
267
-
268
- **Output:** "From your Library, these past lessons apply to this project:"
269
- - "[Principle/Cheatsheet]: [Key lesson]. [[Link]]"
270
- - "Based on [[Past Failure X]], we should avoid [pattern]."
271
-
272
- If Library is empty or nothing relevant: "No Library entries found. This will be a fresh start."
273
-
274
- This step is non-negotiable. Past mistakes are the cheapest lessons. [Mover_Global_Rules.md: S4, S14]
275
-
276
- ---
277
-
278
- ## 3. CONTEXT INJECTION
279
-
280
- **From Strategy.md:** Does this project align with the current hypothesis?
281
- **From Dossier:** What assets can we leverage? (Don't cold-start if you have ammunition.)
282
- **From Identity_Prime.md:** Does this project fit the identity? Is this a "Mover" move or avoidance?
283
-
284
- Adapt approach based on project type:
285
- - **Tech/SaaS:** Focus on ROI, user flow, scalability. MVP Rule applies.
286
- - **Content/Marketing:** Focus on hooks, psychology, audience. 8th-grade readability.
287
- - **Life/Strategy:** Focus on leverage, systems thinking, identity alignment.
288
-
289
- ---
290
-
291
- ## 4. THE INTERROGATION (Kill Ambiguity)
292
-
293
- Go deep. The depth of questioning IS the value of /ignite. 35-50 questions across 7 clusters, batched with STOP gates so the user can answer before being buried. Each cluster covers ONE domain. Do not compress multiple domains into one cluster.
294
-
295
- ### BEHAVIORAL RULES (Read before asking a single question)
296
-
297
- **You are an intellectual opponent, not a customer service agent.**
298
-
299
- 1. **NEVER offer multiple choice for interrogation questions.** Ask open-ended questions only. "What's the target user?" not "Is the target user: A) developers, B) designers, C) marketers?" Exception: Decision gates (Phase 0 validation A/B/C/D, verification confirmations, structural choices like "overwrite/rename/abort") SHOULD use the AskUserQuestion tool for clear selection UX.
300
- 2. **NEVER accept vague answers.** If the user says "I want to build a game" — that is NOT an answer. Push: "What kind of game? For what platform? What's the core loop? What makes someone play it twice?"
301
- 3. **Challenge every answer at least once.** If they say "my target is small businesses" — push back: "Which small businesses? A plumber and a SaaS founder have nothing in common. Who specifically?"
302
- 4. **Call out contradictions immediately.** If Cluster 1 says "simple MVP" but Cluster 2 reveals 15 features — say so. "You said simple but you've described a complex system. Which is the real scope?"
303
- 5. **Do NOT rush to the next cluster.** If answers in Cluster 1 are thin, ask follow-ups WITHIN Cluster 1 before moving on. The gate is depth, not speed.
304
- 6. **Silence is data.** If the user can't answer a question, that's a red flag. Say: "The fact that you can't answer this is important. This is a gap we need to fill before building anything."
305
-
306
- ### WHAT BAD INTERROGATION LOOKS LIKE (Do NOT do this)
307
-
308
- ```
309
- BAD: "What's your project about?"
310
- User: "A cannon game"
311
- BAD: "Great! Let me help you build that. Here are the features we could add..."
312
-
313
- GOOD: "A cannon game. For what platform? Who plays it? What's the core mechanic
314
- that makes it different from Angry Birds, Worms, or any other physics-based
315
- projectile game? What makes someone open it a second time? What's the monetization
316
- model? Have you shipped a game before?"
317
- ```
318
-
319
- ```
320
- BAD: "Who is your target audience?
321
- A) Gamers B) Casual players C) Kids"
322
-
323
- GOOD: "Who plays this and why? Describe the person. What are they doing right
324
- before they open your game? What other games do they play? How old are they?
325
- How much do they spend on games per month?"
326
- ```
327
-
328
- ### Cluster 1 — Vision & Core (ask first, wait for response)
329
-
330
- These 5 questions are mandatory. Ask all 5, then STOP.
331
-
332
- 1. **The Pitch:** Explain this to me like I'm a skeptical investor with 60 seconds of patience. What is it, who is it for, and why will it win?
333
- 2. **The Happy Path:** Walk me through the user journey step by step — from discovery to first use to tenth use. Every screen, every click, every decision point.
334
- 3. **The Failure Points:** Where exactly will this break? What are the fragile assumptions? What's the riskiest part you're hoping nobody asks about?
335
- 4. **The Definition of Done:** Exact binary condition to declare victory. Not "it works well" — what measurable number means this succeeded vs failed?
336
- 5. **The Wildcard:** What do you NOT know yet? What question are you afraid to answer?
337
-
338
- **STOP. Wait for user response.**
339
-
340
- **After user responds:** Review each answer. If ANY answer is vague, one-sentence, or hand-wavy — push back BEFORE moving to Cluster 2. Examples:
341
- - "You said the happy path is 'user signs up and uses it.' That's not a walkthrough. Take me through each screen, each action, each decision point."
342
- - "Your definition of done is 'it works.' Works for whom? Measured how? What number?"
343
- - "You said 'I don't know' to the wildcard. That means there's a risk you haven't thought about. Let's name it now."
344
-
345
- Only proceed to Cluster 2 when Cluster 1 answers have substance.
346
-
347
- ### Cluster 2 — User & Market (5-7 questions)
348
-
349
- Based on the Cluster 1 answers, interrogate the user and market:
350
-
351
- 1. **The Person:** Describe the exact human who uses this. Not a segment — a person. What's their name, job, daily frustration? What are they doing 5 minutes before they discover your product?
352
- 2. **The Pain:** What pain are they in RIGHT NOW? How do you know this pain exists? (Evidence, not assumption. "I think people want this" is not evidence.)
353
- 3. **The Current Solution:** What do they currently do without your product? If the answer is "nothing" — push harder. People always have a workaround.
354
- 4. **The Competition:** Who else does this? If "nobody" — that's either a blue ocean or a graveyard. Which one and why?
355
- 5. **The Defensibility:** If this works, what stops someone from copying it in a weekend? What's your moat?
356
- 6. **The Distribution:** How does the first user find this? How does the 100th? The 10,000th?
357
- 7. **The Evidence:** What's the smallest piece of real-world evidence that anyone wants this? A conversation, a waitlist, a Reddit thread?
358
-
359
- **STOP. Wait for user response.**
360
-
361
- **After user responds:** Challenge thin answers. "No competition" is never true — what is the user currently doing instead? "Everyone" is not a target user — who specifically?
362
-
363
- ### Cluster 3 — Technical Architecture (5-7 questions)
364
-
365
- 1. **The Stack:** What technologies are you building with and why? If you don't know, say so — that's useful information.
366
- 2. **The Integrations:** What external services, APIs, or platforms does this depend on? What are their limits, costs, and failure modes?
367
- 3. **The Data:** What data do you store? Where? How sensitive is it? What happens if it's lost?
368
- 4. **The Platform:** Web, mobile, desktop, CLI, API? Why that platform for this user?
369
- 5. **The Constraints:** Any hard technical constraints? (Rate limits, file sizes, latency requirements, offline needs, device compatibility)
370
- 6. **The Build vs Buy:** For each major component — are you building it, buying it, or using an open-source solution? Why?
371
- 7. **The Deployment:** Where does this run? How does it get updated? Who monitors it when it breaks at 3am?
372
-
373
- **STOP. Wait for user response.**
374
-
375
- **After user responds:** If the user doesn't know the technical answers, that's data — flag it as a gap, don't fill it with assumptions.
376
-
377
- ### Cluster 4 — Business Model & Economics (5-7 questions)
378
-
379
- 1. **The Revenue Model:** How does this make money? If "it doesn't yet" — when does it, and what changes?
380
- 2. **The Pricing:** What do you charge? Why that number? What does the competition charge?
381
- 3. **The Unit Economics:** What does it cost to acquire one user? To serve one user? What are the margins?
382
- 4. **The Build Cost:** What does it cost in time and money to get to launch? Be specific — weeks, dollars, opportunity cost.
383
- 5. **The Run Cost:** Monthly hosting, APIs, tools, services. What's the burn rate post-launch?
384
- 6. **The Break-Even:** How many users/customers at what price to cover costs? When does that happen?
385
- 7. **The Upside:** If this 10x succeeds, what does that look like in numbers?
386
-
387
- **STOP. Wait for user response.**
388
-
389
- **After user responds:** If user hasn't thought about economics — say so directly. "You don't have a pricing model. That means you're building a hobby, not a business. Is that intentional?"
390
-
391
- ### Cluster 5 — Resources & Timeline (4-5 questions)
392
-
393
- 1. **The Deadline:** When does this need to be live? Is that a real deadline or a wish?
394
- 2. **The Budget:** What are you willing to spend in money? What about time — hours per week?
395
- 3. **The Team:** Who's building this? What skills exist and what's missing?
396
- 4. **The Sacrifice:** What are you willing to give up to make this happen? What's off the table?
397
- 5. **The Runway:** If this takes 3x longer than planned, can you sustain it? What breaks first — motivation, money, or time?
398
-
399
- **STOP. Wait for user response.**
400
-
401
- **After user responds:** If timeline is unrealistic given the scope from earlier clusters — call it out. "You described a 6-month build with a 2-week deadline. Something has to give. What gets cut?"
402
-
403
- ### Cluster 6 — Edge Cases & Failure Modes (5-7 questions)
404
-
405
- 1. **The Abuse Case:** How does a malicious user break this? What's the worst thing someone could do with your product?
406
- 2. **The Scale Break:** What happens at 10x users? 100x? Where does the architecture fall apart?
407
- 3. **The Data Loss:** What happens when data is corrupted, deleted, or leaked? What's the recovery plan?
408
- 4. **The Dependency Failure:** What happens when a third-party API goes down? When a service changes its pricing or terms?
409
- 5. **The Legal Risk:** Any regulatory, compliance, or IP issues? Content licensing? User data privacy (GDPR/CCPA)?
410
- 6. **The User Stupidity:** What happens when the user does the dumbest possible thing? What's the most confusing part of the interface?
411
- 7. **The Day-2 Problem:** First use is exciting. What makes someone come back on Day 2? Day 30? What's the retention hook?
412
-
413
- **STOP. Wait for user response.**
414
-
415
- **After user responds:** If the user hasn't considered failure modes — that's the most important signal. "You haven't thought about what happens when this breaks. That means it WILL break, and you won't be ready."
416
-
417
- ### Cluster 7 — Final Stress Test (5-10 contradiction-killers)
418
-
419
- Review ALL previous cluster answers. Identify every contradiction, gap, and untested assumption. Ask:
420
- - "You said [X] in Cluster 1 but [Y] in Cluster 4 — which is it?"
421
- - "If you had to cut 50% of scope, which half survives and why?"
422
- - "What's the one thing that, if it doesn't work, kills the whole project?"
423
- - "You've described [X features/components]. Rank them: which 3 ship first?"
424
- - "What has changed in your thinking since Cluster 1? Anything you'd revise?"
425
- - Any remaining gaps in the Happy Path walkthrough.
426
- - Any questions the user dodged or answered vaguely earlier — ask them again directly.
427
-
428
- **STOP. Wait for user response before proceeding to Leverage Audit.**
429
-
430
- ### The Leverage Audit
431
- Before proposing strategies, audit against the 4 Forms of Leverage:
432
- - **Labor:** Are we grinding? (Low leverage)
433
- - **Capital:** Are we spending? (Medium leverage)
434
- - **Code:** Can AI/automation do this? (High leverage)
435
- - **Media:** Can a video/content asset do the selling? (High leverage)
436
-
437
- If user proposes low-leverage solution: REJECT. Propose Code or Media alternative.
438
-
439
- ### The Polarity Paradox
440
- Don't offer binary choices. Offer the paradox solution that combines them.
441
- "The Automated Sniper (High Quality at High Volume via Code)."
442
-
443
- ### 3 Execution Vectors
444
- 1. **The Bootstrapper (Labor):** High effort, small cost.
445
- 2. **The Investor (Capital):** Low effort, high cost.
446
- 3. **The Architect (Code/Media):** Using automation + assets to break constraints.
447
-
448
- Ask: "Which form of leverage are we deploying?"
449
-
450
- ---
451
-
452
- ## 5. THE RECONNAISSANCE
453
-
454
- STOP. Do not propose a stack yet.
455
-
456
- **Run research directly** using WebSearch and subagents. Do NOT send the user to Perplexity or external tools. The agent handles this.
457
-
458
- Spawn a research subagent (model: sonnet) to find:
459
- - Top 3 Open Source repos that already do this (Build vs Buy).
460
- - State-of-the-art libraries for the current year.
461
- - Known gotchas (IP bans, API limits, legal issues).
462
-
463
- Present findings to user: "Here's what I found. Any of these change your approach?"
464
-
465
- If WebSearch is unavailable or returns insufficient results: flag all stack recommendations as `[INFERRED: no external research]` confidence 2. Offer: "Want to run deeper research externally? I can generate a research prompt."
466
-
467
- ---
468
-
469
- ## 6. THE STRATEGY BATTLE
470
-
471
- After research data is pasted:
472
- - Verify data quality.
473
- - Propose 2 paths:
474
- - **Path A (Heavy/Pro):** Perfect way. High effort, max results.
475
- - **Path B (Speed/Hack):** 80/20 way. Fast, good enough.
476
- - Recommend: Which maximizes ROI?
477
-
478
- ---
479
-
480
- ## 7. DIFFERENTIATION
481
-
482
- Suggest 2 angles:
483
- 1. **The Standard:** Safe, expected approach.
484
- 2. **The Novel:** 2 standard deviations away. The creative angle.
485
-
486
- ---
487
-
488
- ## 8. THE BLUEPRINT
489
-
490
- Describe System Architecture visually:
491
- - List nodes (components/steps)
492
- - List edges (data/action flow)
493
- - User can draw this in Excalidraw.
494
-
495
- ---
496
-
497
- ## 9. VERIFICATION GATE
498
-
499
- Before generating brief, get explicit permission.
500
- "Are you happy with the strategy? Ready for me to generate the Brief?"
501
-
502
- WAIT FOR CONFIRMATION. [Mover_Global_Rules.md: S3]
503
-
504
- ---
505
-
506
- ## 10. THE BRIEF
507
-
508
- Generate using this template:
509
-
510
- ```markdown
511
- # PROJECT BRIEF: [Project Name]
512
-
513
- ## 1. The Equation
514
- - Niche: [Who]
515
- - Problem: [The Pain]
516
- - Solution: [The Vehicle]
517
- - North Star: [The ONE Daily Metric]
518
-
519
- ## 2. The Leverage Stack
520
- - Code: [Automated?]
521
- - Media: [Assets?]
522
- - Labor: [Grind?]
523
-
524
- ## 3. The Why
525
- - Vision: [End State]
526
- - Mission: [Path]
527
-
528
- ## 4. Execution Roadmap
529
- - [ ] Step 1: Build the Asset (The Offer)
530
- - [ ] Step 2: Build the System (The Engine)
531
- - [ ] Step 3: The Launch (Volume)
532
-
533
- ## 5. The Stack
534
- - Frontend:
535
- - Backend/DB:
536
- - Key Libraries:
537
- - Hosting:
538
-
539
- ## 6. Core User Flow
540
- 1. [Action] -> [Response]
541
-
542
- ## 7. Data Models (Rough)
543
- - Entity: id, name, status
544
-
545
- ## 8. UI/UX Guidelines
546
- - Tone:
547
-
548
- ## 9. Blueprint (System Logic)
549
- - [Node A] connects to [Node B]
550
- ```
551
-
552
- ---
553
-
554
- ## 11. GIT INIT
555
-
556
- After brief approved:
557
- - **Check if `01_Projects/[Project Name]/` already exists.** If it does: "A folder for [Project Name] already exists. Overwrite, pick a new name, or abort?"
558
- - Create project folder in `01_Projects/`
559
- - `git init` (if standalone repo)
560
- - Create `.gitignore`
561
- - Create `project_state.md` with initial template:
562
-
563
- ```markdown
564
- # PROJECT STATE: [Project Name]
565
- *Status: Active*
566
-
567
- ## 1. THE BRAIN DUMP (Notes)
568
- - **Mission:** [From Brief — one sentence]
569
- - **Current Blocker:** None (just started)
570
-
571
- ## 2. THE SOLUTIONS LEDGER
572
- *Universal problem → solution pairs discovered during this project.*
573
-
574
- ## 3. CHANGELOG
575
- * [YYYY-MM-DD] Project initialized via /ignite.
576
-
577
- ## 4. SYSTEM STATE SNAPSHOTS
578
- - **Latest Snapshot:** [YYYY-MM-DD]
579
- - **Active Focus:** Phase 1 — Ignition
580
- - **Risk Profile:** Low
581
- - **Next Milestone:** [First deliverable from Brief]
582
- ```
583
-
584
- - Initial commit
585
- - Do NOT use && to chain commands.
586
-
587
- ---
588
-
589
- ## 11.5 ACTIVE_CONTEXT UPDATE
590
-
591
- Update `Active_Context.md` Section 4 (Technical Context) with the new project:
592
- - **Active Project:** [Project name] — `01_Projects/[Project Name]/`
593
- - **Tech Stack:** [From the brief's stack decision]
594
- - **Current Bottleneck:** Getting started (Phase 1)
595
-
596
- This ensures the next session knows what project is active without reading the full brief.
597
-
598
- ---
599
-
600
- ## 12. THE PLAN (Roadmap Generation)
601
-
602
- Generate `plan.md` directly after the Brief is approved. No separate workflow needed.
603
-
604
- **If plan.md already exists:** BLOCK. "plan.md already exists for this project. Use `/refactor-plan` to update it. Overwriting would destroy execution history."
605
-
606
- **Dynamic Logic:** No fixed limits. The template is a skeleton. Expand based on project complexity:
607
- - Complex backend? Create dedicated "Phase: Backend Infrastructure."
608
- - User flow has 8 steps? Phase 2 must have 8+ technical tasks.
609
- - Phase 1 Step 1 MUST reference the stack from the Brief.
610
- - Do NOT arbitrarily limit phases or steps.
611
-
612
- **Template:**
613
-
614
- ```markdown
615
- # PROJECT CONTROL CENTER: [Project Name]
616
-
617
- ## 1. THE NORTH STAR
618
- - **Goal:** [From Brief]
619
- - **Target Audience:** [From Brief]
620
- - **Definition of Done:** [Specific, binary condition]
621
- - **Status:** [ ACTIVE ]
622
-
623
- ## 2. THE ARCHITECTURE
624
- - **Stack:** [From Brief]
625
- - **Rules:**
626
- - Update Execution Log after every step
627
- - No external dependencies without asking
628
-
629
- ---
630
-
631
- ## 3. THE ROADMAP
632
-
633
- ### Phase 1: Ignition
634
- - [ ] Step 1: Initialize repo & folder structure for [Stack]
635
- - [ ] Step 2: Install dependencies
636
- - [ ] Step 3: Hello World / Smoke Test
637
-
638
- ### Phase 2: Core Construction (MVP)
639
- [Break down Core User Flow into granular tasks]
640
- - [ ] Step 1: ...
641
- [As many steps as needed]
642
-
643
- ### Phase [N]: [Complex Module if needed]
644
- [Give distinct features their own phase]
645
-
646
- ### Phase [N+1]: Polish & Ship
647
- - [ ] Step 1: Self-review (Security & UI Polish)
648
- - [ ] Step 2: Deploy to [Hosting]
649
-
650
- ### Phase [N+2]: Mission Debrief
651
- - [ ] Step 1: Extract lessons to Solutions Ledger
652
- - [ ] Step 2: Archive project
653
-
654
- ---
655
-
656
- ## 4. EXECUTION LOG
657
- * [YYYY-MM-DD] Plan generated from Project Brief.
658
- ```
659
-
660
- **Feature Mode:** If in Feature Mode, instead of creating plan.md, append a new Phase to the existing plan.md:
661
- ```markdown
662
- ### Phase [Next]: [Feature Name]
663
- - [ ] Step 1: ...
664
- [As many steps as needed]
665
- ```
666
- And append to EXECUTION LOG: `* [YYYY-MM-DD] Feature phase added: [Feature Name]`
667
-
668
- **After plan generation:** "Brief and Plan are locked. Ready to start Phase 1?"
669
-
670
- ---
671
-
672
- ## 13. SELF-VERIFICATION (CISC)
673
-
674
- Before outputting the Brief, self-check:
675
- 1. All recommendations grounded in Strategy.md, Dossier, and user's interview responses? (90%+ accuracy)
676
- 2. No cold-start suggestions when user already has assets in Dossier?
677
- 3. Library pre-search completed before proposing stack?
678
- 4. No banned phrases in output?
679
- 5. Explicit user approval received at each gate?
680
-
681
- If any check fails: fix before presenting.
682
-
683
- ---
684
-
685
- ## 14. PROACTIVE SUGGESTIONS
686
-
687
- Based on observations during this workflow:
688
- 1. If proposed project conflicts with current Strategy hypothesis: "Strategy misalignment detected — this project may split focus. Intentional pivot or parallel bet?" - Confidence: 3
689
- 2. If Library search found a relevant past failure: "Similar project attempted before. Want to review [[Past Project]] to avoid repeating it?" - Confidence: [from match quality]
690
- 3. If leverage audit reveals low-leverage path chosen: "Labor-heavy approach chosen — confirm this is intentional before we brief it." - Confidence: 3
691
-
692
- "Want me to address any of these?"
693
-
694
- ---
695
-
696
- ## 15. SELF-IMPROVEMENT
697
-
698
- If user corrected AI during this workflow:
699
- 1. Acknowledge: "I made a mistake."
700
- 2. Identify the rule violated.
701
- 3. Append to Auto_Learnings.md:
702
- `* [YYYY-MM-DD] CORRECTION: [Description]. Source: User correction. Confidence: 3.`
703
- 4. If same correction seen 3x+, escalate confidence to 5.
704
-
705
- ---
706
-
707
- ## HANDOFF
708
-
709
- Sources used: Auto_Learnings.md, Active_Context.md, Strategy.md, Identity_Prime.md, Mover_Dossier.md, 03_Library/ (pre-search)
710
- Confidence range: [Brief claims grounded in interview responses; flag any assumption marked [TBD]]
711
-
712
- **Next:** "Brief and Plan are locked. Start executing Phase 1, or run `/log` when you complete a milestone."
713
- If Fast Mode: "Fast Mode active. Skipping TDD. Let's build."
714
- If Feature Mode: "Feature phase added to plan.md. Start executing, or run `/overview` to see the full project state."
715
-
716
- Key rules still active:
717
- - All claims must be grounded in loaded files
718
- - Confidence < 3 = ask, don't assert
719
- - Append-only: never delete history
720
- - No && in Windows commands
1
+ ---
2
+ description: Initiates a new project or feature. Full pipeline from interrogation to Brief + Plan in one workflow.
3
+ ---
4
+
5
+ # Ignition Protocol (V4)
6
+
7
+ **Trigger:** User runs `/ignite`, `/ignite --fast`, `/ignite --feature`, or `/ignite --monetize`
8
+ **Role:** Systems Architect (single adaptive persona).
9
+ **Task:** Transform a vague idea into a locked project with Brief, Plan, and Repo. Or add a feature to an existing project.
10
+ **Risk Tier:** MEDIUM
11
+
12
+ ---
13
+
14
+ ## 0. PRE-FLIGHT
15
+
16
+ Global Rules are pre-loaded as CLAUDE.md / GEMINI.md. Output `[Rules Loaded - DATE]`.
17
+
18
+ LOAD (Memory Hierarchy):
19
+ 1. Auto_Learnings.md (P0)
20
+ 2. Active_Context.md (P1)
21
+ 3. Strategy.md (P2)
22
+ 4. Identity_Prime.md (P3)
23
+ 5. Mover_Dossier.md (P3)
24
+ 6. Last 3 Daily Notes (P5) — read via subagent (model: haiku). Needed for PIVOT DETECTION (Step 0.5). Shows what the user has actually been working on. If the new project contradicts their current Strategy or today's plan, this is the evidence.
25
+
26
+ CONSTRAINTS:
27
+ - All recommendations grounded in user's Strategy and Dossier
28
+ - Check Dossier before suggesting cold starts [Mover_Global_Rules.md: S1]
29
+ - Never proceed to next step without explicit user approval
30
+ - Be proactive and strategic, not a checklist follower
31
+ - Windows: no && in commands
32
+
33
+ ---
34
+
35
+ ## 1. MODE DETECTION
36
+
37
+ **Fast Mode:** If `/ignite --fast`: FAST MODE (no TDD, hard-coded values OK, one file OK).
38
+ If keywords: "quick script", "throwaway", "prototype" -> Suggest Fast Mode.
39
+
40
+ **Feature Mode:** If `/ignite --feature` OR user describes a feature for an EXISTING project:
41
+ 1. Detect the target project. Check for existing `project_brief.md` and `plan.md` in the project folder.
42
+ 2. If no existing project found: "No project context found. Run `/ignite` for a full project, or specify which project folder."
43
+ 3. LOAD existing `project_brief.md`, `plan.md`, `project_state.md` — these define the system the feature lives in.
44
+ 4. Skip Clusters 4 (Business Model) and 5 (Resources) — already established for the project.
45
+ 5. Adapt remaining clusters to focus on the feature within the existing system:
46
+ - Cluster 1 → Feature Vision (what, why, how it fits the existing product)
47
+ - Cluster 2 → User impact (who benefits, what changes for existing users)
48
+ - Cluster 3 → Technical integration (what touches, what breaks, blast radius)
49
+ - Cluster 6 → Edge cases specific to this feature
50
+ - Cluster 7 → Stress test against existing system constraints
51
+ 6. Output: Feature spec appended to `project_brief.md` under `## Feature: [Name]` + new Phase added to `plan.md`.
52
+ 7. Skip Git Init (repo already exists).
53
+
54
+ **Monetize Mode:** If `/ignite --monetize` OR user mentions revenue, selling, customers, pricing, "make money from this":
55
+ 1. This mode fires Phase 0 (Market Validation) BEFORE the normal interrogation clusters.
56
+ 2. Phase 0 spawns research subagents in parallel to build market intelligence.
57
+ 3. A validation gate blocks proceeding to Cluster 1 until the user reviews market findings.
58
+ 4. After Phase 0 approval, the normal interrogation proceeds with market context loaded.
59
+ 5. Clusters 2 (User & Market) and 4 (Business Model) are pre-populated from Phase 0 research — the AI uses research findings as the baseline and the user corrects/extends, rather than starting from zero.
60
+
61
+ **New Project Mode (default):** If neither flag, ask: "Is this a prototype or production code? If you intend to sell this, consider running `/ignite --monetize` instead."
62
+
63
+ ---
64
+
65
+ ## 1.5 PIVOT DETECTION (All modes except --feature on existing project)
66
+
67
+ Before proceeding, cross-reference the new project against the user's current state:
68
+
69
+ 1. **Read today's Daily Note** (if exists): What is the plan? What is the Single Test?
70
+ 2. **Read last 3 Daily Notes**: What has the user been working on? Is there an active project with momentum?
71
+ 3. **Read Strategy.md**: What is the current hypothesis being tested?
72
+ 4. **Read Active_Context.md**: What is the stated bottleneck?
73
+
74
+ **If the new project contradicts any of these:**
75
+
76
+ Apply Escalating Friction (Global Rules S1.5):
77
+
78
+ - Level 1: "Your Strategy says [X]. Your plan today says [Y]. You're proposing a new project: [Z]. Is this a deliberate pivot or are you avoiding [Y]?"
79
+ - Level 2 (if they push through): "What about [current project] makes you want to start something new? One sentence."
80
+ - Level 3 (if they still push through): "Noted. Logging this as a potential pivot. We'll proceed, but `/analyse-day` will flag this."
81
+
82
+ **If not contradictory** (e.g., the new project IS the strategy, or no active projects exist): proceed without friction.
83
+
84
+ **Log override if applicable:** Write `[OVERRIDE] User chose /ignite [new project] over [plan item]. Reason: "[user's stated reason]"` to today's Daily Note Session Log.
85
+
86
+ ---
87
+
88
+ ## 1.7 PHASE 0: MARKET VALIDATION (--monetize only)
89
+
90
+ > **Gate:** Do not write a single line of code, generate a brief, or start architecture until Phase 0 is reviewed and approved. Building without validation is the most expensive form of procrastination.
91
+
92
+ ### Step 1: Spawn Research Subagents (Parallel)
93
+
94
+ Fire 3 research subagents simultaneously using the Task tool. All agents should use `model: "sonnet"`:
95
+
96
+ **Agent A — ICP & Pain Points** (skill: `agent-research-analyst`)
97
+ - Search Reddit (r/[relevant subreddits]), Hacker News, relevant forums for pain points
98
+ - Collect verbatim quotes (exact language the target market uses — this becomes copy later)
99
+ - Identify emotional tone per pain point (frustration, shame, resignation, hope)
100
+ - Rank pain points by signal strength (upvotes, comment depth, recurrence)
101
+ - Estimate willingness to pay based on existing spend patterns
102
+
103
+ **Agent B — Competitor & Market Analysis** (skill: `agent-research-analyst`)
104
+ - Map direct competitors (same niche + same solution type)
105
+ - Map adjacent competitors (same niche, different solution OR different niche, same solution)
106
+ - For each competitor: what they charge, how many users, what's missing (the gap)
107
+ - Identify white space — what nobody is building
108
+ - Market size estimate (TAM, SAM, SOM)
109
+
110
+ **Agent C — Go-To-Market & First Users** (skill: `agent-content-researcher`)
111
+ - Where do the first 50 customers come from? (specific channels, not "social media")
112
+ - What distribution channels exist? (communities, newsletters, directories, marketplaces)
113
+ - What launch playbooks have worked for similar products? (Product Hunt, Reddit, X threads)
114
+ - What's the cheapest way to validate demand before building?
115
+ - Map the Micro-Action-Chain (every step from first exposure to purchase). Identify stimulus fatigue risks and contrarian positioning opportunities
116
+
117
+ **Agent D — Messaging & Psychology** (skills: `marketing-psychology`, `copywriting`, `pricing-strategy`)
118
+ - Take the pain points from Agent A and translate into messaging:
119
+ - Primary message (1 sentence that captures the core promise)
120
+ - 3 supporting messages (each addressing a top pain point)
121
+ - Objection handling (top 5 reasons someone won't buy + the counter)
122
+ - Apply psychological leverage analysis:
123
+ - Identify the top 10 cognitive biases most relevant to this niche and product (from the 88 in the leverage list)
124
+ - Apply Lock & Key Theory: the human mind is the lock, the stimulus is the key. Build the stimulus to fit the lock, not the other way around.
125
+ - Check for Lollapalooza Effect opportunities: where can 3+ biases stack to create non-linear persuasion?
126
+ - Flag any overdone-it risk (too many levers = slimy, not genuine)
127
+ - Pricing analysis: what price anchors exist in this market? What's the perceived value vs cost?
128
+ - Positioning: "We are the only [X] that [Y]" — find the only statement
129
+ - Tone/voice: based on ICP, what voice resonates? (technical, casual, authoritative, peer-to-peer)
130
+
131
+ ### Step 2: Market Validation Frameworks
132
+
133
+ While research agents run, apply these frameworks to the user's idea:
134
+
135
+ **Niche Selection Checklist**:
136
+
137
+ Ask the user these keystone questions (all must pass or the niche is unviable):
138
+ 1. Does the niche need what you are selling? (Pain drives acquisition)
139
+ 2. Is this niche growing? (Market must be expanding)
140
+ 3. Can this niche afford your price? (Look at competitor pricing as signal)
141
+ 4. Are you interested in this niche? (You'll spend thousands of hours here)
142
+ 5. Are there more than 30,000 people in this niche?
143
+ 6. Will you have competitors already succeeding? (Competition = sign of life)
144
+ 7. Can people in this niche be easily found and contacted?
145
+
146
+ **STOP. Wait for user response.**
147
+
148
+ If ANY keystone question fails: "This niche fails the viability check on [X]. Either pivot the niche or acknowledge the risk before proceeding."
149
+
150
+ **Client Avatar Worksheet**:
151
+
152
+ Go deeper than demographics. Ask the user (or infer from Agent A research):
153
+ 1. **Meet Your Client:** What do they do day-to-day? How do they spend their week? Where do they get their news/information?
154
+ 2. **Financial & Emotional State:** How much do they make? How do they feel about their work? What are their concerns in life?
155
+ 3. **History:** What happened in the past that led them here? A former job, a failed attempt, a frustrating experience?
156
+ 4. **Decision Trigger:** What thoughts go through their head right before they buy? What's the "final straw" that makes them pull the trigger?
157
+ 5. **Product Fit:** What about YOUR product matters to THIS person? How does it solve their pain or improve their life?
158
+
159
+ **STOP. Wait for user response.**
160
+
161
+ **Offer Creation Worksheet**:
162
+
163
+ Walk the user through:
164
+ 1. **Define Who:** Which specific segment of the niche? What's their current situation vs desired situation?
165
+ 2. **Define Outcome:** What's the bold promise? Make it tangible (numbers-based).
166
+ 3. **Define Timeframe:** How long to deliver the outcome? Can it be shorter?
167
+ 4. **Methodology:** What steps/components deliver the outcome? Simplify to 6-9 words each.
168
+ 5. **Factors of Value:** For each methodology step, list obstacles the prospect will imagine. Invert each obstacle into a solution. This is how value is created.
169
+ 6. **Risk Reversal:** What guarantee can you offer? The bolder the guarantee, the higher the conversion.
170
+ 7. **Packaging:** Reposition from "what it is" to "what it means." Not "markdown files" — "a self-improving execution engine."
171
+
172
+ **STOP. Wait for user response.**
173
+
174
+ **Offer Asset Creation**:
175
+
176
+ Using the offer framework above + pain points from Agent A, create:
177
+
178
+ 1. **Short-Form Messages (15-20):** 3-6 word hooks. Focus on end result. Reverse-engineer from the latent conditions of the market. Write what they want to read, not what you want to write. Examples: "escape the matrix", "make your bed", "become an acquisition expert."
179
+ 2. **Long-Form Messages (4-5):** 1-4 sentence summaries of the offer. Include: who you help, end result, timeframe, risk reversal. Use words that display extreme confidence. Don't discuss the 'how.'
180
+ 3. **Strategy Document:** List methodology items + factors of value. Less is more. This becomes the terms of your guarantee and sets deliverable expectations.
181
+ 4. **The Pitch (5-part):** Our Promise, Our Strategy, Our Guarantee, The Ultimatum (either/or), The Packaging ("think of us like..."). Must be readable in under 2 minutes. Does NOT include the price.
182
+
183
+ **STOP. Wait for user response.**
184
+
185
+ ### Step 3: Compile Market Intelligence
186
+
187
+ Once research agents return, compile into `dev/marketing/` (or project-specific `dev/marketing/` if a project folder exists):
188
+
189
+ | File | Contents |
190
+ |------|----------|
191
+ | `ICP.md` | Ideal Customer Profile (3 tiers: primary, secondary, tertiary). Anti-ICP. Pain points ranked. Willingness to pay. |
192
+ | `client_avatar.md` | Deep avatar profile: demographics, psychographics, history, decision triggers, "final straw" moment, product fit. |
193
+ | `competitor_map.md` | Direct and adjacent competitors. Gap analysis. White space. Key people. |
194
+ | `pain_points_raw.md` | Verbatim quotes organized by pain category. Emotional tone map. Sources. |
195
+ | `gtm_plan.md` | First 50 customers strategy. Channels. Launch playbook. Validation experiments. |
196
+ | `messaging_framework.md` | Primary message. Supporting messages. Objection handling. Psychology levers. Voice/tone. Positioning statement. |
197
+ | `offer_framework.md` | Offer worksheet completed. Niche viability score. Packaging. Guarantee. Pricing. |
198
+ | `offer_assets.md` | 15-20 short-form messages, 4-5 long-form messages, strategy document, 5-part pitch. |
199
+ | `acquisition_system.md` | Micro-action-chain. Contrarian attraction analysis. System design (7-step). Sub-system priorities. |
200
+ | `testing_plan.md` | First stimulus genotype. Key variables. KPIs. Sample sizes. Constants. Iteration protocol. |
201
+
202
+ ### Step 4: Validation Gate
203
+
204
+ Present the compiled findings to the user:
205
+
206
+ "Here's what the market says about your idea:"
207
+ 1. **ICP summary** — who buys this, what they're in pain about, what they already spend
208
+ 2. **Competitive landscape** — who else does this, what's missing, your potential moat
209
+ 3. **Go-to-market** — where the first 50 customers come from, cheapest validation path
210
+ 4. **Offer framework** — your promise, your methodology, your guarantee, your price
211
+
212
+ Then ask: **"Based on this research, do you want to:**
213
+ - **A) Proceed** — market validated, start building
214
+ - **B) Pivot** — research revealed a better angle, adjust the idea
215
+ - **C) Kill** — insufficient market signal, don't build this
216
+ - **D) Validate first** — run the cheapest experiment before building (landing page, waitlist, DMs)"
217
+
218
+ **Do NOT proceed to Cluster 1 until the user explicitly chooses A or B.**
219
+
220
+ If user chooses D: suggest the specific validation experiment (e.g., "Put up a landing page with an email capture. Share in [specific community]. If you get [X] signups in [Y] days, the signal is real.")
221
+
222
+ ### Step 5: Acquisition System Design (if Proceed or Pivot)
223
+
224
+ After validation, design the acquisition engine before any code is written.
225
+
226
+ **Micro-Action-Chain Mapping:**
227
+ Map the ENTIRE customer journey from first exposure to purchase. Every action the prospect must take:
228
+ - Example chain: `sees post > clicks link > reads landing page > enters email > reads email sequence > clicks buy > enters payment > confirms`
229
+ - For each action, identify the stimulus that triggers it (what makes them click, read, enter, buy?)
230
+ - Identify where the chain breaks (highest drop-off points = priority optimization targets)
231
+
232
+ **Contrarian Attraction Check:**
233
+ - What is 95% of the market doing to acquire customers in this niche?
234
+ - How can you do the opposite or something novel? (Stimulus Hypoesthesia = copying what everyone does guarantees fatigue)
235
+ - What stimuli traits are overexposed? What's underused?
236
+
237
+ **System Design** (7-step framework):
238
+ 1. **Core Premises:** Which acquisition sub-system are you building first? (Attention, Interest, Appointments, Shows, Priming, Closing) — pick ONE to start.
239
+ 2. **Input Mechanisms:** Where does the input pool come from? (email lists, social, ads, communities, organic)
240
+ 3. **Stimuli Mechanisms:** What stimuli convert inputs to outputs? Define key variables per stimulus (2-4 max).
241
+ 4. **Feedback Mechanisms:** What metrics and KPIs track effectiveness? Define metric-variable relationships.
242
+ 5. **Flow:** Visualize the full system — all assets, all SOPs, all automations, in linear order.
243
+ 6. **Deployment:** Which tasks are human vs machine? Create SOPs for human tasks.
244
+ 7. **Scale Plan:** What happens after fitness is proven? How do you 10x the input volume?
245
+
246
+ **Testing Plan** (Scientific Method for Acquisition):
247
+ For the first stimulus genotype:
248
+ - Define 2-4 key variables (the "DNA string" of the stimulus)
249
+ - Define primary and secondary KPIs with target conversion rates
250
+ - Set sample size (minimum 30 exposures per test for statistical validity)
251
+ - Set timeframe (include latency — results don't appear instantly)
252
+ - Establish constants (what does NOT change during the test)
253
+ - Plan V1 → V2 iteration: if below KPI, which single variable do you change? (Ceteris Paribus — one variable at a time)
254
+
255
+ Output: Add `acquisition_system.md` and `testing_plan.md` to `dev/marketing/`.
256
+
257
+ ---
258
+
259
+ ## 2. LIBRARY PRE-SEARCH (MANDATORY)
260
+
261
+ Before starting, search `03_Library/` comprehensively:
262
+ 1. List ALL files in `03_Library/Principles/` — read headers for relevance
263
+ 2. List ALL files in `03_Library/Cheatsheets/` — read headers for relevance
264
+ 3. List ALL files in `03_Library/SOPs/` — read headers for relevance
265
+ 4. For each relevant file: read the full content and extract applicable lessons
266
+ 5. Check `Auto_Learnings.md` for patterns related to this project domain
267
+
268
+ **Output:** "From your Library, these past lessons apply to this project:"
269
+ - "[Principle/Cheatsheet]: [Key lesson]. [[Link]]"
270
+ - "Based on [[Past Failure X]], we should avoid [pattern]."
271
+
272
+ If Library is empty or nothing relevant: "No Library entries found. This will be a fresh start."
273
+
274
+ This step is non-negotiable. Past mistakes are the cheapest lessons. [Mover_Global_Rules.md: S4, S14]
275
+
276
+ ---
277
+
278
+ ## 3. CONTEXT INJECTION
279
+
280
+ **From Strategy.md:** Does this project align with the current hypothesis?
281
+ **From Dossier:** What assets can we leverage? (Don't cold-start if you have ammunition.)
282
+ **From Identity_Prime.md:** Does this project fit the identity? Is this a "Mover" move or avoidance?
283
+
284
+ Adapt approach based on project type:
285
+ - **Tech/SaaS:** Focus on ROI, user flow, scalability. MVP Rule applies.
286
+ - **Content/Marketing:** Focus on hooks, psychology, audience. 8th-grade readability.
287
+ - **Life/Strategy:** Focus on leverage, systems thinking, identity alignment.
288
+
289
+ ---
290
+
291
+ ## 4. THE INTERROGATION (Kill Ambiguity)
292
+
293
+ Go deep. The depth of questioning IS the value of /ignite. 35-50 questions across 7 clusters, batched with STOP gates so the user can answer before being buried. Each cluster covers ONE domain. Do not compress multiple domains into one cluster.
294
+
295
+ ### BEHAVIORAL RULES (Read before asking a single question)
296
+
297
+ **You are an intellectual opponent, not a customer service agent.**
298
+
299
+ 1. **NEVER offer multiple choice for interrogation questions.** Ask open-ended questions only. "What's the target user?" not "Is the target user: A) developers, B) designers, C) marketers?" Exception: Decision gates (Phase 0 validation A/B/C/D, verification confirmations, structural choices like "overwrite/rename/abort") SHOULD use the AskUserQuestion tool for clear selection UX.
300
+ 2. **NEVER accept vague answers.** If the user says "I want to build a game" — that is NOT an answer. Push: "What kind of game? For what platform? What's the core loop? What makes someone play it twice?"
301
+ 3. **Challenge every answer at least once.** If they say "my target is small businesses" — push back: "Which small businesses? A plumber and a SaaS founder have nothing in common. Who specifically?"
302
+ 4. **Call out contradictions immediately.** If Cluster 1 says "simple MVP" but Cluster 2 reveals 15 features — say so. "You said simple but you've described a complex system. Which is the real scope?"
303
+ 5. **Do NOT rush to the next cluster.** If answers in Cluster 1 are thin, ask follow-ups WITHIN Cluster 1 before moving on. The gate is depth, not speed.
304
+ 6. **Silence is data.** If the user can't answer a question, that's a red flag. Say: "The fact that you can't answer this is important. This is a gap we need to fill before building anything."
305
+
306
+ ### WHAT BAD INTERROGATION LOOKS LIKE (Do NOT do this)
307
+
308
+ ```
309
+ BAD: "What's your project about?"
310
+ User: "A cannon game"
311
+ BAD: "Great! Let me help you build that. Here are the features we could add..."
312
+
313
+ GOOD: "A cannon game. For what platform? Who plays it? What's the core mechanic
314
+ that makes it different from Angry Birds, Worms, or any other physics-based
315
+ projectile game? What makes someone open it a second time? What's the monetization
316
+ model? Have you shipped a game before?"
317
+ ```
318
+
319
+ ```
320
+ BAD: "Who is your target audience?
321
+ A) Gamers B) Casual players C) Kids"
322
+
323
+ GOOD: "Who plays this and why? Describe the person. What are they doing right
324
+ before they open your game? What other games do they play? How old are they?
325
+ How much do they spend on games per month?"
326
+ ```
327
+
328
+ ### Cluster 1 — Vision & Core (ask first, wait for response)
329
+
330
+ These 5 questions are mandatory. Ask all 5, then STOP.
331
+
332
+ 1. **The Pitch:** Explain this to me like I'm a skeptical investor with 60 seconds of patience. What is it, who is it for, and why will it win?
333
+ 2. **The Happy Path:** Walk me through the user journey step by step — from discovery to first use to tenth use. Every screen, every click, every decision point.
334
+ 3. **The Failure Points:** Where exactly will this break? What are the fragile assumptions? What's the riskiest part you're hoping nobody asks about?
335
+ 4. **The Definition of Done:** Exact binary condition to declare victory. Not "it works well" — what measurable number means this succeeded vs failed?
336
+ 5. **The Wildcard:** What do you NOT know yet? What question are you afraid to answer?
337
+
338
+ **STOP. Wait for user response.**
339
+
340
+ **After user responds:** Review each answer. If ANY answer is vague, one-sentence, or hand-wavy — push back BEFORE moving to Cluster 2. Examples:
341
+ - "You said the happy path is 'user signs up and uses it.' That's not a walkthrough. Take me through each screen, each action, each decision point."
342
+ - "Your definition of done is 'it works.' Works for whom? Measured how? What number?"
343
+ - "You said 'I don't know' to the wildcard. That means there's a risk you haven't thought about. Let's name it now."
344
+
345
+ Only proceed to Cluster 2 when Cluster 1 answers have substance.
346
+
347
+ ### Cluster 2 — User & Market (5-7 questions)
348
+
349
+ Based on the Cluster 1 answers, interrogate the user and market:
350
+
351
+ 1. **The Person:** Describe the exact human who uses this. Not a segment — a person. What's their name, job, daily frustration? What are they doing 5 minutes before they discover your product?
352
+ 2. **The Pain:** What pain are they in RIGHT NOW? How do you know this pain exists? (Evidence, not assumption. "I think people want this" is not evidence.)
353
+ 3. **The Current Solution:** What do they currently do without your product? If the answer is "nothing" — push harder. People always have a workaround.
354
+ 4. **The Competition:** Who else does this? If "nobody" — that's either a blue ocean or a graveyard. Which one and why?
355
+ 5. **The Defensibility:** If this works, what stops someone from copying it in a weekend? What's your moat?
356
+ 6. **The Distribution:** How does the first user find this? How does the 100th? The 10,000th?
357
+ 7. **The Evidence:** What's the smallest piece of real-world evidence that anyone wants this? A conversation, a waitlist, a Reddit thread?
358
+
359
+ **STOP. Wait for user response.**
360
+
361
+ **After user responds:** Challenge thin answers. "No competition" is never true — what is the user currently doing instead? "Everyone" is not a target user — who specifically?
362
+
363
+ ### Cluster 3 — Technical Architecture (5-7 questions)
364
+
365
+ 1. **The Stack:** What technologies are you building with and why? If you don't know, say so — that's useful information.
366
+ 2. **The Integrations:** What external services, APIs, or platforms does this depend on? What are their limits, costs, and failure modes?
367
+ 3. **The Data:** What data do you store? Where? How sensitive is it? What happens if it's lost?
368
+ 4. **The Platform:** Web, mobile, desktop, CLI, API? Why that platform for this user?
369
+ 5. **The Constraints:** Any hard technical constraints? (Rate limits, file sizes, latency requirements, offline needs, device compatibility)
370
+ 6. **The Build vs Buy:** For each major component — are you building it, buying it, or using an open-source solution? Why?
371
+ 7. **The Deployment:** Where does this run? How does it get updated? Who monitors it when it breaks at 3am?
372
+
373
+ **STOP. Wait for user response.**
374
+
375
+ **After user responds:** If the user doesn't know the technical answers, that's data — flag it as a gap, don't fill it with assumptions.
376
+
377
+ ### Cluster 4 — Business Model & Economics (5-7 questions)
378
+
379
+ 1. **The Revenue Model:** How does this make money? If "it doesn't yet" — when does it, and what changes?
380
+ 2. **The Pricing:** What do you charge? Why that number? What does the competition charge?
381
+ 3. **The Unit Economics:** What does it cost to acquire one user? To serve one user? What are the margins?
382
+ 4. **The Build Cost:** What does it cost in time and money to get to launch? Be specific — weeks, dollars, opportunity cost.
383
+ 5. **The Run Cost:** Monthly hosting, APIs, tools, services. What's the burn rate post-launch?
384
+ 6. **The Break-Even:** How many users/customers at what price to cover costs? When does that happen?
385
+ 7. **The Upside:** If this 10x succeeds, what does that look like in numbers?
386
+
387
+ **STOP. Wait for user response.**
388
+
389
+ **After user responds:** If user hasn't thought about economics — say so directly. "You don't have a pricing model. That means you're building a hobby, not a business. Is that intentional?"
390
+
391
+ ### Cluster 5 — Resources & Timeline (4-5 questions)
392
+
393
+ 1. **The Deadline:** When does this need to be live? Is that a real deadline or a wish?
394
+ 2. **The Budget:** What are you willing to spend in money? What about time — hours per week?
395
+ 3. **The Team:** Who's building this? What skills exist and what's missing?
396
+ 4. **The Sacrifice:** What are you willing to give up to make this happen? What's off the table?
397
+ 5. **The Runway:** If this takes 3x longer than planned, can you sustain it? What breaks first — motivation, money, or time?
398
+
399
+ **STOP. Wait for user response.**
400
+
401
+ **After user responds:** If timeline is unrealistic given the scope from earlier clusters — call it out. "You described a 6-month build with a 2-week deadline. Something has to give. What gets cut?"
402
+
403
+ ### Cluster 6 — Edge Cases & Failure Modes (5-7 questions)
404
+
405
+ 1. **The Abuse Case:** How does a malicious user break this? What's the worst thing someone could do with your product?
406
+ 2. **The Scale Break:** What happens at 10x users? 100x? Where does the architecture fall apart?
407
+ 3. **The Data Loss:** What happens when data is corrupted, deleted, or leaked? What's the recovery plan?
408
+ 4. **The Dependency Failure:** What happens when a third-party API goes down? When a service changes its pricing or terms?
409
+ 5. **The Legal Risk:** Any regulatory, compliance, or IP issues? Content licensing? User data privacy (GDPR/CCPA)?
410
+ 6. **The User Stupidity:** What happens when the user does the dumbest possible thing? What's the most confusing part of the interface?
411
+ 7. **The Day-2 Problem:** First use is exciting. What makes someone come back on Day 2? Day 30? What's the retention hook?
412
+
413
+ **STOP. Wait for user response.**
414
+
415
+ **After user responds:** If the user hasn't considered failure modes — that's the most important signal. "You haven't thought about what happens when this breaks. That means it WILL break, and you won't be ready."
416
+
417
+ ### Cluster 7 — Final Stress Test (5-10 contradiction-killers)
418
+
419
+ Review ALL previous cluster answers. Identify every contradiction, gap, and untested assumption. Ask:
420
+ - "You said [X] in Cluster 1 but [Y] in Cluster 4 — which is it?"
421
+ - "If you had to cut 50% of scope, which half survives and why?"
422
+ - "What's the one thing that, if it doesn't work, kills the whole project?"
423
+ - "You've described [X features/components]. Rank them: which 3 ship first?"
424
+ - "What has changed in your thinking since Cluster 1? Anything you'd revise?"
425
+ - Any remaining gaps in the Happy Path walkthrough.
426
+ - Any questions the user dodged or answered vaguely earlier — ask them again directly.
427
+
428
+ **STOP. Wait for user response before proceeding to Leverage Audit.**
429
+
430
+ ### The Leverage Audit
431
+ Before proposing strategies, audit against the 4 Forms of Leverage:
432
+ - **Labor:** Are we grinding? (Low leverage)
433
+ - **Capital:** Are we spending? (Medium leverage)
434
+ - **Code:** Can AI/automation do this? (High leverage)
435
+ - **Media:** Can a video/content asset do the selling? (High leverage)
436
+
437
+ If user proposes low-leverage solution: REJECT. Propose Code or Media alternative.
438
+
439
+ ### The Polarity Paradox
440
+ Don't offer binary choices. Offer the paradox solution that combines them.
441
+ "The Automated Sniper (High Quality at High Volume via Code)."
442
+
443
+ ### 3 Execution Vectors
444
+ 1. **The Bootstrapper (Labor):** High effort, small cost.
445
+ 2. **The Investor (Capital):** Low effort, high cost.
446
+ 3. **The Architect (Code/Media):** Using automation + assets to break constraints.
447
+
448
+ Ask: "Which form of leverage are we deploying?"
449
+
450
+ ---
451
+
452
+ ## 5. THE RECONNAISSANCE
453
+
454
+ STOP. Do not propose a stack yet.
455
+
456
+ **Run research directly** using WebSearch and subagents. Do NOT send the user to Perplexity or external tools. The agent handles this.
457
+
458
+ Spawn a research subagent (model: sonnet) to find:
459
+ - Top 3 Open Source repos that already do this (Build vs Buy).
460
+ - State-of-the-art libraries for the current year.
461
+ - Known gotchas (IP bans, API limits, legal issues).
462
+
463
+ Present findings to user: "Here's what I found. Any of these change your approach?"
464
+
465
+ If WebSearch is unavailable or returns insufficient results: flag all stack recommendations as `[INFERRED: no external research]` confidence 2. Offer: "Want to run deeper research externally? I can generate a research prompt."
466
+
467
+ ---
468
+
469
+ ## 6. THE STRATEGY BATTLE
470
+
471
+ After research data is pasted:
472
+ - Verify data quality.
473
+ - Propose 2 paths:
474
+ - **Path A (Heavy/Pro):** Perfect way. High effort, max results.
475
+ - **Path B (Speed/Hack):** 80/20 way. Fast, good enough.
476
+ - Recommend: Which maximizes ROI?
477
+
478
+ ---
479
+
480
+ ## 7. DIFFERENTIATION
481
+
482
+ Suggest 2 angles:
483
+ 1. **The Standard:** Safe, expected approach.
484
+ 2. **The Novel:** 2 standard deviations away. The creative angle.
485
+
486
+ ---
487
+
488
+ ## 8. THE BLUEPRINT
489
+
490
+ Describe System Architecture visually:
491
+ - List nodes (components/steps)
492
+ - List edges (data/action flow)
493
+ - User can draw this in Excalidraw.
494
+
495
+ ---
496
+
497
+ ## 9. VERIFICATION GATE
498
+
499
+ Before generating brief, get explicit permission.
500
+ "Are you happy with the strategy? Ready for me to generate the Brief?"
501
+
502
+ WAIT FOR CONFIRMATION. [Mover_Global_Rules.md: S3]
503
+
504
+ ---
505
+
506
+ ## 10. THE BRIEF
507
+
508
+ Generate using this template:
509
+
510
+ ```markdown
511
+ # PROJECT BRIEF: [Project Name]
512
+
513
+ ## 1. The Equation
514
+ - Niche: [Who]
515
+ - Problem: [The Pain]
516
+ - Solution: [The Vehicle]
517
+ - North Star: [The ONE Daily Metric]
518
+
519
+ ## 2. The Leverage Stack
520
+ - Code: [Automated?]
521
+ - Media: [Assets?]
522
+ - Labor: [Grind?]
523
+
524
+ ## 3. The Why
525
+ - Vision: [End State]
526
+ - Mission: [Path]
527
+
528
+ ## 4. Execution Roadmap
529
+ - [ ] Step 1: Build the Asset (The Offer)
530
+ - [ ] Step 2: Build the System (The Engine)
531
+ - [ ] Step 3: The Launch (Volume)
532
+
533
+ ## 5. The Stack
534
+ - Frontend:
535
+ - Backend/DB:
536
+ - Key Libraries:
537
+ - Hosting:
538
+
539
+ ## 6. Core User Flow
540
+ 1. [Action] -> [Response]
541
+
542
+ ## 7. Data Models (Rough)
543
+ - Entity: id, name, status
544
+
545
+ ## 8. UI/UX Guidelines
546
+ - Tone:
547
+
548
+ ## 9. Blueprint (System Logic)
549
+ - [Node A] connects to [Node B]
550
+ ```
551
+
552
+ ---
553
+
554
+ ## 11. GIT INIT
555
+
556
+ After brief approved:
557
+ - **Check if `01_Projects/[Project Name]/` already exists.** If it does: "A folder for [Project Name] already exists. Overwrite, pick a new name, or abort?"
558
+ - Create project folder in `01_Projects/`
559
+ - `git init` (if standalone repo)
560
+ - Create `.gitignore`
561
+ - Create `project_state.md` with initial template:
562
+
563
+ ```markdown
564
+ # PROJECT STATE: [Project Name]
565
+ *Status: Active*
566
+
567
+ ## 1. THE BRAIN DUMP (Notes)
568
+ - **Mission:** [From Brief — one sentence]
569
+ - **Current Blocker:** None (just started)
570
+
571
+ ## 2. THE SOLUTIONS LEDGER
572
+ *Universal problem → solution pairs discovered during this project.*
573
+
574
+ ## 3. CHANGELOG
575
+ * [YYYY-MM-DD] Project initialized via /ignite.
576
+
577
+ ## 4. SYSTEM STATE SNAPSHOTS
578
+ - **Latest Snapshot:** [YYYY-MM-DD]
579
+ - **Active Focus:** Phase 1 — Ignition
580
+ - **Risk Profile:** Low
581
+ - **Next Milestone:** [First deliverable from Brief]
582
+ ```
583
+
584
+ - Initial commit
585
+ - Do NOT use && to chain commands.
586
+
587
+ ---
588
+
589
+ ## 11.5 ACTIVE_CONTEXT UPDATE
590
+
591
+ Update `Active_Context.md` Section 4 (Technical Context) with the new project:
592
+ - **Active Project:** [Project name] — `01_Projects/[Project Name]/`
593
+ - **Tech Stack:** [From the brief's stack decision]
594
+ - **Current Bottleneck:** Getting started (Phase 1)
595
+
596
+ This ensures the next session knows what project is active without reading the full brief.
597
+
598
+ ---
599
+
600
+ ## 12. THE PLAN (Roadmap Generation)
601
+
602
+ Generate `plan.md` directly after the Brief is approved. No separate workflow needed.
603
+
604
+ **If plan.md already exists:** BLOCK. "plan.md already exists for this project. Use `/refactor-plan` to update it. Overwriting would destroy execution history."
605
+
606
+ **Dynamic Logic:** No fixed limits. The template is a skeleton. Expand based on project complexity:
607
+ - Complex backend? Create dedicated "Phase: Backend Infrastructure."
608
+ - User flow has 8 steps? Phase 2 must have 8+ technical tasks.
609
+ - Phase 1 Step 1 MUST reference the stack from the Brief.
610
+ - Do NOT arbitrarily limit phases or steps.
611
+
612
+ **Template:**
613
+
614
+ ```markdown
615
+ # PROJECT CONTROL CENTER: [Project Name]
616
+
617
+ ## 1. THE NORTH STAR
618
+ - **Goal:** [From Brief]
619
+ - **Target Audience:** [From Brief]
620
+ - **Definition of Done:** [Specific, binary condition]
621
+ - **Status:** [ ACTIVE ]
622
+
623
+ ## 2. THE ARCHITECTURE
624
+ - **Stack:** [From Brief]
625
+ - **Rules:**
626
+ - Update Execution Log after every step
627
+ - No external dependencies without asking
628
+
629
+ ---
630
+
631
+ ## 3. THE ROADMAP
632
+
633
+ ### Phase 1: Ignition
634
+ - [ ] Step 1: Initialize repo & folder structure for [Stack]
635
+ - [ ] Step 2: Install dependencies
636
+ - [ ] Step 3: Hello World / Smoke Test
637
+
638
+ ### Phase 2: Core Construction (MVP)
639
+ [Break down Core User Flow into granular tasks]
640
+ - [ ] Step 1: ...
641
+ [As many steps as needed]
642
+
643
+ ### Phase [N]: [Complex Module if needed]
644
+ [Give distinct features their own phase]
645
+
646
+ ### Phase [N+1]: Polish & Ship
647
+ - [ ] Step 1: Self-review (Security & UI Polish)
648
+ - [ ] Step 2: Deploy to [Hosting]
649
+
650
+ ### Phase [N+2]: Mission Debrief
651
+ - [ ] Step 1: Extract lessons to Solutions Ledger
652
+ - [ ] Step 2: Archive project
653
+
654
+ ---
655
+
656
+ ## 4. EXECUTION LOG
657
+ * [YYYY-MM-DD] Plan generated from Project Brief.
658
+ ```
659
+
660
+ **Feature Mode:** If in Feature Mode, instead of creating plan.md, append a new Phase to the existing plan.md:
661
+ ```markdown
662
+ ### Phase [Next]: [Feature Name]
663
+ - [ ] Step 1: ...
664
+ [As many steps as needed]
665
+ ```
666
+ And append to EXECUTION LOG: `* [YYYY-MM-DD] Feature phase added: [Feature Name]`
667
+
668
+ **After plan generation:** "Brief and Plan are locked. Ready to start Phase 1?"
669
+
670
+ ---
671
+
672
+ ## 13. SELF-VERIFICATION (CISC)
673
+
674
+ Before outputting the Brief, self-check:
675
+ 1. All recommendations grounded in Strategy.md, Dossier, and user's interview responses? (90%+ accuracy)
676
+ 2. No cold-start suggestions when user already has assets in Dossier?
677
+ 3. Library pre-search completed before proposing stack?
678
+ 4. No banned phrases in output?
679
+ 5. Explicit user approval received at each gate?
680
+
681
+ If any check fails: fix before presenting.
682
+
683
+ ---
684
+
685
+ ## 14. PROACTIVE SUGGESTIONS
686
+
687
+ Based on observations during this workflow:
688
+ 1. If proposed project conflicts with current Strategy hypothesis: "Strategy misalignment detected — this project may split focus. Intentional pivot or parallel bet?" - Confidence: 3
689
+ 2. If Library search found a relevant past failure: "Similar project attempted before. Want to review [[Past Project]] to avoid repeating it?" - Confidence: [from match quality]
690
+ 3. If leverage audit reveals low-leverage path chosen: "Labor-heavy approach chosen — confirm this is intentional before we brief it." - Confidence: 3
691
+
692
+ "Want me to address any of these?"
693
+
694
+ ---
695
+
696
+ ## 15. SELF-IMPROVEMENT
697
+
698
+ If user corrected AI during this workflow:
699
+ 1. Acknowledge: "I made a mistake."
700
+ 2. Identify the rule violated.
701
+ 3. Append to Auto_Learnings.md:
702
+ `* [YYYY-MM-DD] CORRECTION: [Description]. Source: User correction. Confidence: 3.`
703
+ 4. If same correction seen 3x+, escalate confidence to 5.
704
+
705
+ ---
706
+
707
+ ## HANDOFF
708
+
709
+ Sources used: Auto_Learnings.md, Active_Context.md, Strategy.md, Identity_Prime.md, Mover_Dossier.md, 03_Library/ (pre-search)
710
+ Confidence range: [Brief claims grounded in interview responses; flag any assumption marked [TBD]]
711
+
712
+ **Next:** "Brief and Plan are locked. Start executing Phase 1, or run `/log` when you complete a milestone."
713
+ If Fast Mode: "Fast Mode active. Skipping TDD. Let's build."
714
+ If Feature Mode: "Feature phase added to plan.md. Start executing, or run `/overview` to see the full project state."
715
+
716
+ Key rules still active:
717
+ - All claims must be grounded in loaded files
718
+ - Confidence < 3 = ask, don't assert
719
+ - Append-only: never delete history
720
+ - No && in Windows commands