arkaos 2.53.0 → 2.55.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/VERSION CHANGED
@@ -1 +1 @@
1
- 2.53.0
1
+ 2.55.0
@@ -1,7 +1,9 @@
1
1
  ---
2
2
  name: content/youtube-strategy
3
3
  description: >
4
- YouTube strategy: title/thumbnail packaging, script structure, SEO, upload cadence.
4
+ YouTube strategy channel positioning, title × thumbnail architecture,
5
+ hook + script structure, SEO + metadata, publishing cadence, cross-platform
6
+ distribution.
5
7
  allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
6
8
  ---
7
9
 
@@ -19,14 +21,141 @@ treat them as your default source. External research supplements, it
19
21
  does not replace the vault.
20
22
  <!-- arka:kb-first-prefix end -->
21
23
 
22
- # Youtube Strategy — `/content youtube <topic>`
24
+ # YouTube Strategy — `/content youtube <topic>`
23
25
 
24
- > **Agent:** Rafael (Content Strategist) | **Framework:** MrBeast Method + YouTube Algorithm
26
+ > **Lead:** Rafael (Content Strategist) | **Cross-dept:** Isabel (Visual Designer) + Teresa (Copy) + Luna (Marketing) | **Frameworks:** MrBeast Title × Thumbnail Method + Algorithm-Aware Retention Design
25
27
 
26
- ## What It Does
28
+ ## What ships
27
29
 
28
- YouTube strategy: title/thumbnail packaging, script structure, SEO, upload cadence.
30
+ A production YouTube strategy in 7 deliverables:
29
31
 
30
- ## Output
32
+ 1. **Channel positioning** with competing-channel analysis
33
+ 2. **10 title × thumbnail pairs** with CTR patterns named
34
+ 3. **Hook architecture** + retention curve plan per video
35
+ 4. **Script structure** with retention drops mapped
36
+ 5. **SEO metadata + playlist hierarchy**
37
+ 6. **Publishing cadence** with view + subscriber targets
38
+ 7. **Cross-platform derivative spec** (Shorts, threads, newsletter)
31
39
 
32
- YouTube strategy with 10 video ideas, title/thumb variants, and growth targets
40
+ ## The CTR-Retention Math (why packaging matters)
41
+
42
+ The YouTube algorithm rewards two metrics in tight loop:
43
+
44
+ - **CTR (click-through rate)** — % of impressions that click. Median is 4-6%; top performers 10-15%.
45
+ - **AVD (average view duration)** — minutes watched per view. Algorithm normalizes by video length but rewards higher absolute AVD.
46
+
47
+ CTR depends on **title × thumbnail × topic** working together. AVD depends on **hook + retention curve + payoff**. If CTR is high but AVD is low, the algorithm interprets the video as clickbait and demotes it. If CTR is low but AVD is high, the video starves of impressions.
48
+
49
+ Target floor: CTR ≥ 6%, AVD ≥ 40% of length, retention curve no sharp drops in first 30 seconds.
50
+
51
+ ## Title × Thumbnail Patterns (CTR levers)
52
+
53
+ Each title × thumbnail pair uses one of these named patterns. Mixing patterns randomly produces noise; picking a primary pattern per channel produces compounding.
54
+
55
+ | Pattern | Title shape | Thumbnail shape | Use case |
56
+ |---|---|---|---|
57
+ | **Curiosity Gap** | "What happens when [unexpected]" | One element + question mark + face surprised | Investigation, experiment videos |
58
+ | **Transformation** | "From X to Y in Z time" | Before / After split | Tutorial, journey, case study |
59
+ | **Specific Claim** | "I [verb] [specific number] [specific subject]" | Numbers visible + product / outcome | Stunt, achievement, deep-dive |
60
+ | **Loss Aversion** | "Don't [common mistake]" | Red X + warning icon + face concerned | Warning, education |
61
+ | **Authority + Specific** | "How [expert title] [does specific thing]" | Person + tool / artifact + clean type | Expert content, behind-the-scenes |
62
+ | **Comparison** | "X vs Y: Which actually [outcome]" | Split with both items + clear winner cue | Review, head-to-head |
63
+ | **Contrarian** | "Why everyone is wrong about X" | Strikethrough on common belief + face defiant | Opinion, takedown, education |
64
+
65
+ Thumbnail design rules (visual hierarchy):
66
+ - **One focal point** — eye lands on a single element first
67
+ - **Face if relevant** — human face drives 30-40% CTR lift on most topics
68
+ - **Contrast** — high-saturation focal vs muted background
69
+ - **Type ≤ 4 words** — readable on mobile at 320px width
70
+ - **No clickbait that breaks promise** — title and thumbnail must accurately preview the payoff
71
+
72
+ ## Hook Architecture (first 30 seconds)
73
+
74
+ The first 30 seconds determines whether the viewer stays. The hook structure that consistently retains:
75
+
76
+ ```
77
+ 0-3s PATTERN INTERRUPT — visual + audio shock or unexpected statement
78
+ 3-10s PROMISE — name the transformation / outcome the viewer gets
79
+ 10-20s STAKES — why this matters, what they'll lose by leaving
80
+ 20-30s PREVIEW — quick montage of the 3 best moments coming up
81
+ ```
82
+
83
+ Pattern interrupts that work: starting mid-action, a contradictory statement, an unexpected location, an unexpected visual element. Pattern interrupts that don't work: long intro animations, founder face talking to camera with no visual.
84
+
85
+ ## Script Structure (full video)
86
+
87
+ Default structure for a 10-12 minute video (the optimal range for monetisation + retention):
88
+
89
+ ```
90
+ 0:00 - 0:30 Hook (see Hook Architecture)
91
+ 0:30 - 2:00 Setup — name the problem, stakes, why now
92
+ 2:00 - 4:00 Reframe — show the prevailing wrong answer + your alternative frame
93
+ 4:00 - 8:00 Content blocks (2-3 blocks) — each with a mini-hook, a payoff, a transition
94
+ 8:00 - 10:00 Payoff — the promised transformation / answer delivered concretely
95
+ 10:00 - 11:00 Recap + CTA — quick recap + subscribe / next video / link in description
96
+ 11:00 - 12:00 Outro + end screen — pattern-interrupt sting + related video CTA
97
+ ```
98
+
99
+ Retention drops happen at predictable moments: 1:00 (initial commitment), 4:00 (mid-video boredom), 8:00 (sense of completion). Insert a mini-hook 10 seconds before each predicted drop to retain viewers through it.
100
+
101
+ ## SEO Metadata Stack
102
+
103
+ For each video, fill the metadata stack:
104
+
105
+ ```yaml
106
+ title:
107
+ primary_keyword: "<2-3 word keyword>"
108
+ full_title: "<title with keyword + pattern + emotional anchor>"
109
+ variants_for_testing: 3-5 alternates
110
+
111
+ description:
112
+ first_140_chars: "<keyword-loaded summary that appears in search>"
113
+ full_description:
114
+ - paragraph 1: hook + value prop (250 chars)
115
+ - paragraph 2: timestamps with keyword variants
116
+ - paragraph 3: links + CTAs
117
+ - paragraph 4: hashtags (3-5 max, mixed broad + niche)
118
+ pinned_comment: "<first comment author posts with related links>"
119
+
120
+ tags:
121
+ primary: ["<broad topic>", "<specific topic>"]
122
+ long_tail: ["<specific phrase>", "<question phrase>"]
123
+ branded: ["<channel name>", "<series name>"]
124
+
125
+ end_screen:
126
+ best_for_viewer: <related video by same channel>
127
+ subscribe_cta: <button position>
128
+
129
+ playlists:
130
+ series_playlist: <series name if applicable>
131
+ topic_playlist: <topic cluster>
132
+ ```
133
+
134
+ ## Publishing Cadence Math
135
+
136
+ Sustainability beats burst. The cadence math:
137
+
138
+ - **Long-form video** anchor — 1 per week typical floor for growth channels, 1 per 2 weeks for high-production
139
+ - **Shorts derivatives** — 3-5 per long-form video, posted on rolling schedule
140
+ - **Community posts** — 2-3 per week to keep algorithm engagement signal
141
+ - **Live / Premiere** — optional monthly cadence for community deepening
142
+
143
+ First 90 days targets:
144
+ - Week 1-4: 4 long-forms, 16-20 shorts. Target: identify which pattern resonates.
145
+ - Week 5-8: Double down on winning pattern. Target: first video to 10k views.
146
+ - Week 9-12: Optimise + scale. Target: first 1000 subs OR 100k cumulative views, whichever ships first.
147
+
148
+ ## Cross-Platform Derivatives (per long-form video)
149
+
150
+ Each long-form video should produce:
151
+ - **3-5 YouTube Shorts** (vertical, 30-60s, hook-led clips)
152
+ - **1 Twitter/X thread** (10-15 tweets summarising the video with embedded clips)
153
+ - **1 LinkedIn post** (professional framing for B2B audiences)
154
+ - **1 newsletter section** (long-form summary with personal context)
155
+ - **1 Podcast adaptation** (audio extraction if relevant)
156
+
157
+ Derivative production should be templated — derivatives are not new content, they are repackaging.
158
+
159
+ ## Output → Obsidian: `WizardingCode/Content/YouTube/<topic>-<date>/`
160
+
161
+ Delivers: channel positioning + 10 title × thumbnail pairs + hook architecture + script structure for 3-5 videos + SEO metadata stack per video + 90-day cadence + cross-platform derivative spec + 1-page executive summary.
@@ -0,0 +1,136 @@
1
+ id: content-system
2
+ name: Content Operating System
3
+ description: Build a complete Content OS — strategy + production system + distribution + repurposing + analytics — that compounds output over time
4
+ department: content
5
+ tier: enterprise
6
+ command: "/content system"
7
+ requires_branch: false
8
+ requires_spec: false
9
+ quality_gate_required: true
10
+
11
+ phases:
12
+ - id: brief
13
+ name: Content OS Brief
14
+ description: Define audience, content goals, current capacity, platforms, runway, success metric
15
+ agents:
16
+ - agent_id: content-director-rafael
17
+ role: Frame audience, goals, current production cadence, target platforms, success metric
18
+ gate:
19
+ type: user_approval
20
+ description: User confirms audience, goals, platforms, success metric
21
+
22
+ - id: pillar-design
23
+ name: Content Pillar Design
24
+ description: Define 3-5 content pillars that align audience interest × business value × differentiation
25
+ agents:
26
+ - agent_id: content-director-rafael
27
+ role: 3-5 pillar topics with audience-interest score + business-value score per pillar
28
+ - agent_id: marketing-director-luna
29
+ role: Search demand + competitive density per pillar
30
+ parallel: true
31
+ gate:
32
+ type: user_approval
33
+ description: User approves the pillar set
34
+ outputs:
35
+ - type: document
36
+ format: markdown
37
+ obsidian_path: "WizardingCode/Content/OS/Pillars/"
38
+ description: Content pillar definition with audience/business/differentiation scoring
39
+
40
+ - id: format-stack
41
+ name: Format Stack
42
+ description: Define the format stack per pillar (long-form anchor + short-form derivatives + repurposing chain)
43
+ agents:
44
+ - agent_id: content-director-rafael
45
+ role: Format stack design (anchor format + 4-6 derivative formats per anchor)
46
+ - agent_id: short-form-specialist
47
+ role: Short-form derivative specifications (Reels / Shorts / Tweets / Carousels)
48
+ parallel: true
49
+ gate:
50
+ type: user_approval
51
+ description: User approves the format stack
52
+
53
+ - id: production-cadence
54
+ name: Production Cadence
55
+ description: Set realistic cadence — anchor pieces per month, derivatives per anchor, total weekly output
56
+ agents:
57
+ - agent_id: content-director-rafael
58
+ role: Cadence math — anchor cycle time, derivative multiplier, weekly total, sustainability check
59
+ gate:
60
+ type: user_approval
61
+ description: User approves the cadence
62
+
63
+ - id: distribution-channels
64
+ name: Distribution Channels
65
+ description: Map content type × platform — where each anchor and each derivative lives, with platform-native adaptations
66
+ agents:
67
+ - agent_id: content-director-rafael
68
+ role: Channel map with platform-native adaptations per format
69
+ - agent_id: marketing-director-luna
70
+ role: Distribution amplification — paid, partnerships, syndication options
71
+ parallel: true
72
+ gate:
73
+ type: user_approval
74
+ description: User approves distribution map
75
+
76
+ - id: analytics-stack
77
+ name: Analytics Stack
78
+ description: Define the metrics that matter — per-pillar performance, per-format performance, per-channel performance, North Star metric
79
+ agents:
80
+ - agent_id: content-director-rafael
81
+ role: Analytics dashboard spec with per-level metrics (pillar / format / channel)
82
+ - agent_id: tech-director-francisca
83
+ role: Tracking implementation feasibility
84
+ parallel: true
85
+ gate:
86
+ type: user_approval
87
+ description: User approves analytics stack
88
+
89
+ - id: ops-systems
90
+ name: Ops & Systems
91
+ description: Templates, briefs, asset library, review workflow, publishing workflow, archive
92
+ agents:
93
+ - agent_id: content-director-rafael
94
+ role: Operational templates and workflow specs (brief, review, publish, archive)
95
+ gate:
96
+ type: auto
97
+
98
+ - id: self-critique
99
+ name: Self-Critique
100
+ description: Stress-test the system — is cadence sustainable? Are pillars differentiated? Does analytics tie to North Star?
101
+ agents:
102
+ - agent_id: content-director-rafael
103
+ role: Coherence check across pillars / format stack / cadence / analytics / North Star
104
+ gate:
105
+ type: auto
106
+
107
+ - id: quality-gate
108
+ name: Quality Gate
109
+ model_override: opus
110
+ description: Mandatory quality review
111
+ agents:
112
+ - agent_id: cqo-marta
113
+ role: Orchestrate quality review
114
+ - agent_id: copy-director-eduardo
115
+ role: Pillar prose, format brief quality, no clichés
116
+ parallel: true
117
+ - agent_id: tech-director-francisca
118
+ role: Cadence feasibility, tracking integrity, workflow operability
119
+ parallel: true
120
+ gate:
121
+ type: quality_gate
122
+ required_verdict: APPROVED
123
+
124
+ - id: delivery
125
+ name: Content OS Package Delivery
126
+ description: Compile the full Content OS — pillars + format stack + cadence + distribution + analytics + ops templates
127
+ agents:
128
+ - agent_id: content-director-rafael
129
+ role: Full Content OS package + 1-page executive summary
130
+ gate:
131
+ type: auto
132
+ outputs:
133
+ - type: document
134
+ format: markdown
135
+ obsidian_path: "WizardingCode/Content/OS/"
136
+ description: Complete Content OS — pillars + format stack + cadence + distribution + analytics + ops templates + exec summary
@@ -0,0 +1,144 @@
1
+ id: content-youtube
2
+ name: YouTube Strategy
3
+ description: Full YouTube strategy — channel positioning, title × thumbnail × hook architecture, script structure, SEO optimization, distribution
4
+ department: content
5
+ tier: enterprise
6
+ command: "/content youtube"
7
+ requires_branch: false
8
+ requires_spec: false
9
+ quality_gate_required: true
10
+
11
+ phases:
12
+ - id: brief
13
+ name: YouTube Brief
14
+ description: Define topic, target audience, current channel state, monetisation goal, weekly capacity
15
+ agents:
16
+ - agent_id: content-director-rafael
17
+ role: Frame topic, audience, current subscribers + AVG view duration, monetisation goal
18
+ gate:
19
+ type: user_approval
20
+ description: User confirms YouTube brief
21
+
22
+ - id: channel-positioning
23
+ name: Channel Positioning
24
+ description: Position the channel in the YouTube taxonomy — niche, target persona, channel promise, competing channels
25
+ agents:
26
+ - agent_id: content-director-rafael
27
+ role: Channel positioning statement + competing channels analysis
28
+ - agent_id: brand-strategist-mateus
29
+ role: Differentiation angle, channel identity
30
+ parallel: true
31
+ gate:
32
+ type: user_approval
33
+ description: User approves channel positioning
34
+ outputs:
35
+ - type: document
36
+ format: markdown
37
+ obsidian_path: "WizardingCode/Content/YouTube/Positioning/"
38
+ description: Channel positioning + competing channels + differentiation angle
39
+
40
+ - id: title-thumbnail-architecture
41
+ name: Title × Thumbnail Architecture
42
+ description: Design 10 title × thumbnail pairs using CTR-tested patterns — curiosity gap + transformation + specificity + visual hierarchy
43
+ agents:
44
+ - agent_id: content-director-rafael
45
+ role: 10 title × thumbnail pairs with CTR pattern named per pair
46
+ - agent_id: visual-designer-isabel
47
+ role: Thumbnail visual hierarchy specs (face / contrast / focal-point / text-overlay rules)
48
+ parallel: true
49
+ gate:
50
+ type: user_approval
51
+ description: User selects 3-5 title × thumbnail pairs for first videos
52
+
53
+ - id: hook-script-structure
54
+ name: Hook × Script Structure
55
+ description: First 30s hook architecture + retention curve plan for the full script
56
+ agents:
57
+ - agent_id: content-director-rafael
58
+ role: Hook framework (negative → positive → curiosity gap → preview) + retention curve plan
59
+ - agent_id: sales-copywriter-teresa
60
+ role: Hook copy variants (3 per video) + script outline with retention drops mapped
61
+ parallel: true
62
+ gate:
63
+ type: user_approval
64
+ description: User approves hook + script structure
65
+ outputs:
66
+ - type: document
67
+ format: markdown
68
+ obsidian_path: "WizardingCode/Content/YouTube/Scripts/"
69
+ description: Hook architecture + script structure with retention curve plan
70
+
71
+ - id: seo-metadata
72
+ name: SEO & Metadata
73
+ description: Title keywords, description optimization, tags, end-screen design, playlist architecture
74
+ agents:
75
+ - agent_id: content-director-rafael
76
+ role: SEO metadata specs per video; playlist hierarchy
77
+ - agent_id: marketing-director-luna
78
+ role: Keyword research + search volume targeting
79
+ parallel: true
80
+ gate:
81
+ type: user_approval
82
+ description: User approves SEO + playlist architecture
83
+
84
+ - id: publishing-cadence
85
+ name: Publishing Cadence
86
+ description: Set sustainable publishing cadence with first-week / first-month / first-quarter targets
87
+ agents:
88
+ - agent_id: content-director-rafael
89
+ role: Cadence math + first-week / first-month / first-quarter view + subscriber targets
90
+ gate:
91
+ type: user_approval
92
+ description: User approves cadence and targets
93
+
94
+ - id: distribution-amplification
95
+ name: Distribution & Amplification
96
+ description: Cross-platform distribution — Shorts derivatives, Twitter/LinkedIn threads, email newsletter, podcast
97
+ agents:
98
+ - agent_id: content-director-rafael
99
+ role: Cross-platform derivative spec per long-form video
100
+ - agent_id: short-form-specialist
101
+ role: Shorts adaptation spec (3-5 Shorts per long-form)
102
+ parallel: true
103
+ gate:
104
+ type: auto
105
+
106
+ - id: self-critique
107
+ name: Self-Critique
108
+ description: Stress-test the strategy — is the cadence sustainable? Does positioning differentiate from competing channels? Does the CTR pattern math hold?
109
+ agents:
110
+ - agent_id: content-director-rafael
111
+ role: Coherence + sustainability + differentiation check
112
+ gate:
113
+ type: auto
114
+
115
+ - id: quality-gate
116
+ name: Quality Gate
117
+ model_override: opus
118
+ description: Mandatory quality review
119
+ agents:
120
+ - agent_id: cqo-marta
121
+ role: Orchestrate quality review
122
+ - agent_id: copy-director-eduardo
123
+ role: Title copy, hook copy, script structure, no clickbait that breaks promise
124
+ parallel: true
125
+ - agent_id: tech-director-francisca
126
+ role: Thumbnail visual hierarchy, retention curve feasibility, SEO metadata correctness
127
+ parallel: true
128
+ gate:
129
+ type: quality_gate
130
+ required_verdict: APPROVED
131
+
132
+ - id: delivery
133
+ name: YouTube Strategy Package Delivery
134
+ description: Compile the full YouTube strategy package
135
+ agents:
136
+ - agent_id: content-director-rafael
137
+ role: Full YouTube strategy package + 1-page executive summary
138
+ gate:
139
+ type: auto
140
+ outputs:
141
+ - type: document
142
+ format: markdown
143
+ obsidian_path: "WizardingCode/Content/YouTube/"
144
+ description: Complete YouTube strategy — positioning + title × thumbnail pairs + hook architecture + script structure + SEO metadata + publishing cadence + distribution + exec summary
@@ -1,7 +1,9 @@
1
1
  ---
2
2
  name: strat/growth-strategy
3
3
  description: >
4
- Growth strategy: market penetration, development, product development, diversification.
4
+ Growth strategy using Ansoff Matrix + adjacency framework + Greiner growth
5
+ phases. Picks the next growth vector with risk-adjusted feasibility and a
6
+ 12-month execution roadmap.
5
7
  allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
6
8
  ---
7
9
 
@@ -21,12 +23,139 @@ does not replace the vault.
21
23
 
22
24
  # Growth Strategy — `/strat growth <business>`
23
25
 
24
- > **Agent:** Tomas (Chief Strategist) | **Framework:** Ansoff Matrix + Adjacencies
26
+ > **Lead:** Tomas (Chief Strategist) | **Cross-dept:** Helena (CFO) + Rita (Market Analyst) | **Frameworks:** Ansoff Matrix + Chris Zook Adjacencies + Greiner Growth Phases
25
27
 
26
- ## What It Does
28
+ ## What ships
27
29
 
28
- Growth strategy: market penetration, development, product development, diversification.
30
+ A production growth strategy in 6 deliverables:
29
31
 
30
- ## Output
32
+ 1. **Greiner phase diagnosis** — current phase + impending crisis prediction
33
+ 2. **Ansoff Matrix mapping** — concrete options per quadrant with market sizing
34
+ 3. **Adjacency analysis** — ranked adjacencies by distance × capability × attractiveness
35
+ 4. **Growth vector selection** — primary + assist with explicit trade-off rationale
36
+ 5. **Risk profile** — pre-mortem with top 5 risks + early warning signals + mitigations
37
+ 6. **12-month execution roadmap** — quarter-by-quarter milestones with named owners
31
38
 
32
- Growth roadmap with Ansoff quadrant, risk assessment, and resource requirements
39
+ ## Greiner Growth Phases (where are you in the curve?)
40
+
41
+ Larry Greiner's model says companies grow through 6 evolutionary phases, each ending in a predictable crisis. Knowing the phase predicts the crisis.
42
+
43
+ | # | Phase | Driver | Predictable Crisis | Resolution |
44
+ |---|---|---|---|---|
45
+ | 1 | **Creativity** | Founder vision + product-market fit | Leadership Crisis (founder can't manage operations) | Hire professional management |
46
+ | 2 | **Direction** | Top-down management + functional structure | Autonomy Crisis (middle managers blocked by HQ) | Delegate authority downward |
47
+ | 3 | **Delegation** | Decentralised operating units | Control Crisis (HQ loses visibility into BUs) | Build coordination systems |
48
+ | 4 | **Coordination** | Formal systems, planning, ROI gates | Red Tape Crisis (bureaucracy strangles decisions) | Collaboration via teams |
49
+ | 5 | **Collaboration** | Cross-functional teams, matrix structure | Growth Crisis (internal saturation, need new sources) | External alliances / M&A |
50
+ | 6 | **Alliances** | Partnerships, joint ventures, ecosystems | Identity Crisis (who are we?) | Reinvention / spin-out |
51
+
52
+ Diagnose by symptoms, not org-chart vibes. Each phase has specific decision-making patterns and pain points.
53
+
54
+ ## The Ansoff Matrix (4 growth quadrants)
55
+
56
+ The 2×2 matrix on Products (existing / new) × Markets (existing / new). Each quadrant has a different risk profile.
57
+
58
+ ```
59
+ EXISTING PRODUCTS NEW PRODUCTS
60
+ EXISTING MARKETS Market Penetration Product Development
61
+ (lowest risk) (medium-high risk)
62
+ - Cross-sell - Adjacent product
63
+ - Up-sell - Same customer expansion
64
+ - Win share from competitor
65
+
66
+ NEW MARKETS Market Development Diversification
67
+ (medium risk) (highest risk)
68
+ - New geo - New product + new market
69
+ - New segment - True new business
70
+ - New channel - Acquisition often required
71
+ ```
72
+
73
+ Default risk-adjusted sequencing: start with **Market Penetration** until the law of diminishing returns hits (typically 70-80% market share in a defined segment). Then choose between Market Development and Product Development based on capability fit. Diversification only when first three quadrants are exhausted or a structural opportunity is undeniable.
74
+
75
+ ## Chris Zook Adjacency Framework
76
+
77
+ For each candidate growth move, score on three dimensions:
78
+
79
+ 1. **Distance from core** (1-10): How far is this from your repeatable model? 1 = same customer + same product + tweaks. 10 = different customer + different product + different capability.
80
+ 2. **Capability fit** (1-10): Does it use your existing strengths? 10 = leverages your core competence. 1 = requires building all-new capability.
81
+ 3. **Market attractiveness** (1-10): Size × growth × profitability of the target market.
82
+
83
+ Zook's empirical finding: **adjacency success rate drops 50% with every step away from core**. So the math:
84
+
85
+ ```
86
+ expected_success_rate = 0.27 × (0.5 ^ distance_from_core_steps) × capability_fit_factor × market_factor
87
+ ```
88
+
89
+ Adjacencies more than 2 steps from core have <10% historical success rate. Pick the closest viable adjacency, not the most attractive one.
90
+
91
+ ## Growth Vector Decision Tree
92
+
93
+ ```
94
+ Is current retention healthy (D30 > category norm)?
95
+ NO → Fix retention. No growth vector survives broken retention.
96
+ YES → Continue.
97
+
98
+ Have you saturated current market segment (>70% share or stalled)?
99
+ NO → Market Penetration is the default. Cross-sell, up-sell, win share.
100
+ YES → Continue.
101
+
102
+ Do you have unique capability that transfers?
103
+ YES → Product Development (new product to existing customers) OR
104
+ Market Development (existing product to new segment / geo).
105
+ Choose by capability fit score.
106
+ NO → Acquisition or partnership required. Diversification.
107
+ ```
108
+
109
+ ## Risk Profile Template
110
+
111
+ Every growth vector ships with a pre-mortem. Format:
112
+
113
+ ```yaml
114
+ top_5_risks:
115
+ - name: <specific risk>
116
+ probability: low | medium | high
117
+ impact: low | medium | high | terminal
118
+ early_warning_signal: <observable signal in first 90 days>
119
+ mitigation: <named action if signal fires>
120
+ owner: <named human>
121
+ ```
122
+
123
+ Risks must be specific. "Market might shift" is vibes; "if our top 3 partners renegotiate pricing in Q2 our gross margin drops below the cost floor" is a risk.
124
+
125
+ ## 12-Month Roadmap Template
126
+
127
+ ```
128
+ Q1: Foundation
129
+ Milestone: [specific outcome, not activity]
130
+ Owner: [named human]
131
+ Success metric: [measurable number]
132
+
133
+ Q2: First Proof
134
+ Milestone: [first measurable signal that vector is working]
135
+ Owner: [named]
136
+ Decision gate: [continue / pivot criteria]
137
+
138
+ Q3: Scale or Pivot
139
+ Decision: [scale signal observed? Y/N]
140
+ If scale: doubling milestone
141
+ If pivot: alternate vector selected
142
+
143
+ Q4: Compound
144
+ Milestone: [vector now self-sustaining or absorbed into ops]
145
+ Owner: [named]
146
+ Year-end metric: [measurable target tied to original brief]
147
+ ```
148
+
149
+ Every quarter has a decision gate, not just a milestone. Roadmaps without decision gates become wish lists.
150
+
151
+ ## Common Failure Modes
152
+
153
+ 1. **Skipping retention check** — chasing growth on broken retention amplifies churn
154
+ 2. **Ansoff diagonal-jumping** — jumping straight to Diversification without proving Market Penetration is exhausted
155
+ 3. **Capability vanity** — picking the most attractive adjacency instead of the highest-fit one
156
+ 4. **Greiner phase denial** — refusing to acknowledge the next crisis (e.g., founder won't delegate, stays in Direction phase past breakeven)
157
+ 5. **Roadmap without decision gates** — quarterly milestones without "continue / pivot" criteria become marketing for the existing strategy
158
+
159
+ ## Output → Obsidian: `WizardingCode/Strategy/Growth/<business>-<date>/`
160
+
161
+ Delivers: Greiner phase diagnosis + Ansoff Matrix mapping + adjacency analysis + vector selection rationale + risk profile (5 risks with mitigations) + 12-month roadmap with decision gates + 1-page executive summary.
@@ -0,0 +1,136 @@
1
+ id: strat-blue-ocean
2
+ name: Blue Ocean Strategy
3
+ description: Blue Ocean Strategy canvas with ERRC grid (Eliminate / Reduce / Raise / Create) — define uncontested market space
4
+ department: strategy
5
+ tier: enterprise
6
+ command: "/strat blue-ocean"
7
+ requires_branch: false
8
+ requires_spec: false
9
+ quality_gate_required: true
10
+
11
+ phases:
12
+ - id: brief
13
+ name: Market Brief
14
+ description: Define the current market, the industry's competitive factors, and the customer base under analysis
15
+ agents:
16
+ - agent_id: strategy-director-tomas
17
+ role: Frame current market, named competitors, customer segments
18
+ gate:
19
+ type: user_approval
20
+ description: User confirms market scope, competitor set, customer segments
21
+
22
+ - id: red-ocean-canvas
23
+ name: Red Ocean Strategy Canvas
24
+ description: Map the current industry on the Strategy Canvas — 6-10 competitive factors with relative levels
25
+ agents:
26
+ - agent_id: strategy-director-tomas
27
+ role: Identify 6-10 competitive factors the industry competes on; score each competitor 1-10
28
+ gate:
29
+ type: user_approval
30
+ description: User approves the red ocean canvas before ERRC analysis
31
+ outputs:
32
+ - type: document
33
+ format: markdown
34
+ obsidian_path: "WizardingCode/Strategy/BlueOcean/Canvas/"
35
+ description: Red Ocean Strategy Canvas with competitor scores per factor
36
+
37
+ - id: errc-grid
38
+ name: ERRC Grid
39
+ description: Apply the ERRC framework — Eliminate / Reduce / Raise / Create — to redesign the value curve
40
+ agents:
41
+ - agent_id: strategy-director-tomas
42
+ role: ERRC analysis on each competitive factor with rationale
43
+ - agent_id: market-analyst-rita
44
+ role: Non-customer analysis — what would the 3 tiers of non-customers value?
45
+ parallel: true
46
+ gate:
47
+ type: user_approval
48
+ description: User approves the ERRC grid
49
+
50
+ - id: non-customer-analysis
51
+ name: Non-Customer Analysis
52
+ description: Map the 3 tiers of non-customers (Soon-to-be, Refusing, Unexplored) and what would convert each tier
53
+ agents:
54
+ - agent_id: market-analyst-rita
55
+ role: Define 3 non-customer tiers with their reasons for not buying and conversion triggers
56
+ gate:
57
+ type: user_approval
58
+ description: User approves non-customer analysis
59
+
60
+ - id: blue-ocean-canvas
61
+ name: Blue Ocean Strategy Canvas
62
+ description: Draw the new value curve — the blue ocean position based on ERRC + non-customer insights
63
+ agents:
64
+ - agent_id: strategy-director-tomas
65
+ role: Blue Ocean Strategy Canvas with new value curve; quantify divergence from red ocean
66
+ gate:
67
+ type: user_approval
68
+ description: User approves the blue ocean canvas before viability test
69
+ outputs:
70
+ - type: document
71
+ format: markdown
72
+ obsidian_path: "WizardingCode/Strategy/BlueOcean/Canvas/"
73
+ description: Blue Ocean Strategy Canvas with new value curve and divergence analysis
74
+
75
+ - id: viability-test
76
+ name: Commercial Viability Test
77
+ description: Apply the BOS Sequence — Utility, Price, Cost, Adoption — to test whether the blue ocean is commercially viable
78
+ agents:
79
+ - agent_id: strategy-director-tomas
80
+ role: BOS Sequence test (Buyer Utility Map, Strategic Pricing, Target Cost, Adoption Hurdles)
81
+ - agent_id: cfo-helena
82
+ role: Cost feasibility check — does the target cost math work given the price corridor?
83
+ parallel: true
84
+ gate:
85
+ type: user_approval
86
+ description: User approves commercial viability before execution plan
87
+
88
+ - id: execution-plan
89
+ name: Execution Plan
90
+ description: 90-day execution — first product/service move, channels, organisational changes
91
+ agents:
92
+ - agent_id: strategy-director-tomas
93
+ role: 90-day execution plan with first move, channel implications, organisational changes
94
+ gate:
95
+ type: user_approval
96
+ description: User approves the 90-day execution plan
97
+
98
+ - id: self-critique
99
+ name: Self-Critique
100
+ description: Stress-test the blue ocean — is the divergence real? Are non-customer triggers credible? Does the cost math close?
101
+ agents:
102
+ - agent_id: strategy-director-tomas
103
+ role: Coherence + viability + execution feasibility cross-check
104
+ gate:
105
+ type: auto
106
+
107
+ - id: quality-gate
108
+ name: Quality Gate
109
+ model_override: opus
110
+ description: Mandatory quality review
111
+ agents:
112
+ - agent_id: cqo-marta
113
+ role: Orchestrate quality review
114
+ - agent_id: copy-director-eduardo
115
+ role: Canvas labels, non-customer prose, no clichés
116
+ parallel: true
117
+ - agent_id: tech-director-francisca
118
+ role: Visual canvas integrity, ERRC grid completeness, viability test math
119
+ parallel: true
120
+ gate:
121
+ type: quality_gate
122
+ required_verdict: APPROVED
123
+
124
+ - id: delivery
125
+ name: Blue Ocean Package Delivery
126
+ description: Compile the full blue ocean package
127
+ agents:
128
+ - agent_id: strategy-director-tomas
129
+ role: Full blue ocean package + 1-page executive summary
130
+ gate:
131
+ type: auto
132
+ outputs:
133
+ - type: document
134
+ format: markdown
135
+ obsidian_path: "WizardingCode/Strategy/BlueOcean/"
136
+ description: Complete blue ocean package — red ocean canvas + ERRC grid + non-customer analysis + blue ocean canvas + viability test + execution plan
@@ -0,0 +1,139 @@
1
+ id: strat-growth
2
+ name: Growth Strategy
3
+ description: Growth strategy using Ansoff Matrix + adjacencies + Greiner growth phases — pick the next growth vector with risk-adjusted feasibility
4
+ department: strategy
5
+ tier: enterprise
6
+ command: "/strat growth"
7
+ requires_branch: false
8
+ requires_spec: false
9
+ quality_gate_required: true
10
+
11
+ phases:
12
+ - id: brief
13
+ name: Growth Brief
14
+ description: Define current business state, current revenue mix, current growth rate, runway, success metric
15
+ agents:
16
+ - agent_id: strategy-director-tomas
17
+ role: Frame current business — products, markets, revenue mix, growth rate, runway
18
+ gate:
19
+ type: user_approval
20
+ description: User confirms business context and growth target
21
+
22
+ - id: greiner-diagnosis
23
+ name: Greiner Growth Phase Diagnosis
24
+ description: Identify which Greiner growth phase the business is in (Creativity / Direction / Delegation / Coordination / Collaboration / Alliances) and the predictable crisis
25
+ agents:
26
+ - agent_id: strategy-director-tomas
27
+ role: Greiner phase diagnosis with evidence; name the impending crisis
28
+ gate:
29
+ type: user_approval
30
+ description: User approves Greiner diagnosis
31
+ outputs:
32
+ - type: document
33
+ format: markdown
34
+ obsidian_path: "WizardingCode/Strategy/Growth/Diagnosis/"
35
+ description: Greiner growth phase diagnosis with crisis prediction
36
+
37
+ - id: ansoff-matrix
38
+ name: Ansoff Matrix Analysis
39
+ description: Map growth options across the 4 Ansoff quadrants (Market Penetration / Market Development / Product Development / Diversification)
40
+ agents:
41
+ - agent_id: strategy-director-tomas
42
+ role: Ansoff Matrix mapping with concrete options per quadrant
43
+ - agent_id: market-analyst-rita
44
+ role: Market sizing per quadrant option
45
+ parallel: true
46
+ gate:
47
+ type: user_approval
48
+ description: User approves Ansoff Matrix mapping before adjacency analysis
49
+
50
+ - id: adjacency-analysis
51
+ name: Adjacency Analysis
52
+ description: Apply Chris Zook's adjacency framework — score each adjacency by distance from core, capability fit, market attractiveness
53
+ agents:
54
+ - agent_id: strategy-director-tomas
55
+ role: Adjacency scoring (distance from core × capability fit × market attractiveness)
56
+ - agent_id: cfo-helena
57
+ role: Investment requirement and payback per adjacency
58
+ parallel: true
59
+ gate:
60
+ type: user_approval
61
+ description: User approves adjacency scoring
62
+ outputs:
63
+ - type: document
64
+ format: markdown
65
+ obsidian_path: "WizardingCode/Strategy/Growth/Adjacencies/"
66
+ description: Ranked adjacency analysis with investment + payback
67
+
68
+ - id: vector-selection
69
+ name: Growth Vector Selection
70
+ description: Pick the primary growth vector + assist vector based on Greiner phase, Ansoff quadrant, adjacency ranking
71
+ agents:
72
+ - agent_id: strategy-director-tomas
73
+ role: Vector selection with explicit trade-off rationale
74
+ gate:
75
+ type: user_approval
76
+ description: User approves primary + assist growth vector
77
+
78
+ - id: risk-feasibility
79
+ name: Risk & Feasibility
80
+ description: Stress-test the chosen vector — what kills it? What signals indicate it's working / failing?
81
+ agents:
82
+ - agent_id: strategy-director-tomas
83
+ role: Pre-mortem analysis — top 5 risks + early warning signals + mitigation per risk
84
+ - agent_id: cfo-helena
85
+ role: Runway impact per vector, breakeven scenario, downside math
86
+ parallel: true
87
+ gate:
88
+ type: user_approval
89
+ description: User approves risk profile
90
+
91
+ - id: execution-roadmap
92
+ name: 12-Month Execution Roadmap
93
+ description: Quarter-by-quarter milestones, owner per milestone, success metric per quarter
94
+ agents:
95
+ - agent_id: strategy-director-tomas
96
+ role: 12-month roadmap with quarterly milestones and named owners
97
+ gate:
98
+ type: user_approval
99
+ description: User approves the 12-month roadmap
100
+
101
+ - id: self-critique
102
+ name: Self-Critique
103
+ description: Stress-test coherence — does Greiner phase support the chosen vector? Does Ansoff position match adjacency ranking?
104
+ agents:
105
+ - agent_id: strategy-director-tomas
106
+ role: Coherence check across Greiner / Ansoff / adjacency / vector / roadmap
107
+ gate:
108
+ type: auto
109
+
110
+ - id: quality-gate
111
+ name: Quality Gate
112
+ model_override: opus
113
+ description: Mandatory quality review
114
+ agents:
115
+ - agent_id: cqo-marta
116
+ role: Orchestrate quality review
117
+ - agent_id: copy-director-eduardo
118
+ role: Diagnosis prose, vector rationale, no clichés
119
+ parallel: true
120
+ - agent_id: tech-director-francisca
121
+ role: Roadmap executability, milestone measurability, owner specificity
122
+ parallel: true
123
+ gate:
124
+ type: quality_gate
125
+ required_verdict: APPROVED
126
+
127
+ - id: delivery
128
+ name: Growth Strategy Package Delivery
129
+ description: Compile the full growth strategy package
130
+ agents:
131
+ - agent_id: strategy-director-tomas
132
+ role: Full growth package + 1-page executive summary
133
+ gate:
134
+ type: auto
135
+ outputs:
136
+ - type: document
137
+ format: markdown
138
+ obsidian_path: "WizardingCode/Strategy/Growth/"
139
+ description: Complete growth package — Greiner diagnosis + Ansoff Matrix + adjacency analysis + vector selection + risk profile + 12-month roadmap
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "arkaos",
3
- "version": "2.53.0",
3
+ "version": "2.55.0",
4
4
  "description": "The Operating System for AI Agent Teams",
5
5
  "type": "module",
6
6
  "bin": {
package/pyproject.toml CHANGED
@@ -1,6 +1,6 @@
1
1
  [project]
2
2
  name = "arkaos-core"
3
- version = "2.53.0"
3
+ version = "2.55.0"
4
4
  description = "Core engine for ArkaOS — The Operating System for AI Agent Teams"
5
5
  readme = "README.md"
6
6
  license = {text = "MIT"}