arkaos 2.56.0 → 2.58.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 +1 -1
- package/departments/kb/skills/persona-build/SKILL.md +185 -6
- package/departments/kb/workflows/persona.yaml +131 -0
- package/departments/org/skills/culture-define/SKILL.md +143 -6
- package/departments/org/workflows/culture.yaml +134 -0
- package/package.json +1 -1
- package/pyproject.toml +1 -1
package/VERSION
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
2.
|
|
1
|
+
2.58.0
|
|
@@ -1,7 +1,10 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: kb/persona-build
|
|
3
3
|
description: >
|
|
4
|
-
Build a persona from content
|
|
4
|
+
Build or refine a callable persona from KB content. Extracts beliefs, voice
|
|
5
|
+
signature, expertise domains, decision patterns, and the 4-framework
|
|
6
|
+
behavioral DNA (DISC + Enneagram + Big Five + MBTI). Produces a callable
|
|
7
|
+
advisor YAML.
|
|
5
8
|
allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
|
|
6
9
|
---
|
|
7
10
|
|
|
@@ -21,12 +24,188 @@ does not replace the vault.
|
|
|
21
24
|
|
|
22
25
|
# Persona Build — `/kb persona <name>`
|
|
23
26
|
|
|
24
|
-
> **
|
|
27
|
+
> **Lead:** Clara (Knowledge Director) | **Cross-dept:** Pedro (Research Analyst) + Eduardo (Copy Director) | **Frameworks:** Persona DNA (DISC + Enneagram + Big Five + MBTI) + Voice Pattern Extraction + Source-Cited Belief Inventory
|
|
25
28
|
|
|
26
|
-
## What
|
|
29
|
+
## What ships
|
|
27
30
|
|
|
28
|
-
|
|
31
|
+
A production callable persona in 7 deliverables:
|
|
29
32
|
|
|
30
|
-
|
|
33
|
+
1. **Source inventory** — every input file/URL tagged by type + date
|
|
34
|
+
2. **Belief inventory** — core beliefs with source citations per belief
|
|
35
|
+
3. **Voice pattern** — N-gram signature + recurring phrases + structural rhythm + no-go words
|
|
36
|
+
4. **Expertise map** — deep / surface / no-go domain classification
|
|
37
|
+
5. **Decision pattern catalogue** — characteristic evaluation patterns with cited examples
|
|
38
|
+
6. **4-framework Behavioral DNA** — DISC + Enneagram + Big Five + MBTI scored from evidence
|
|
39
|
+
7. **Callable advisor YAML** — ready to invoke from any /arka command
|
|
31
40
|
|
|
32
|
-
|
|
41
|
+
## Source Inventory Format
|
|
42
|
+
|
|
43
|
+
Every persona source is tagged:
|
|
44
|
+
|
|
45
|
+
```yaml
|
|
46
|
+
sources:
|
|
47
|
+
- id: source-001
|
|
48
|
+
url: <url or local path>
|
|
49
|
+
type: talk | interview | written | social | podcast | book
|
|
50
|
+
date: YYYY-MM-DD
|
|
51
|
+
weight: high | medium | low # based on persona's intent + content depth
|
|
52
|
+
summary: <one-line description>
|
|
53
|
+
```
|
|
54
|
+
|
|
55
|
+
Minimum source diversity for a credible persona: 5 sources across at least 3 types, spanning at least 6 months of date range.
|
|
56
|
+
|
|
57
|
+
## Belief Inventory (cited extraction)
|
|
58
|
+
|
|
59
|
+
A belief is a claim the persona has made consistently across multiple sources. Format:
|
|
60
|
+
|
|
61
|
+
```yaml
|
|
62
|
+
beliefs:
|
|
63
|
+
- statement: "<the belief in plain language>"
|
|
64
|
+
strength: load-bearing | supporting | aspirational
|
|
65
|
+
citations:
|
|
66
|
+
- source: source-003
|
|
67
|
+
quote: "<verbatim>"
|
|
68
|
+
- source: source-007
|
|
69
|
+
quote: "<verbatim>"
|
|
70
|
+
counter-position: <what this belief rejects, if explicit>
|
|
71
|
+
```
|
|
72
|
+
|
|
73
|
+
Beliefs without 2+ citations are dropped — single-mention statements are not strong enough to be a persona trait. Load-bearing beliefs (the ones the persona cannot abandon without becoming someone else) require 4+ citations.
|
|
74
|
+
|
|
75
|
+
## Voice Pattern Extraction
|
|
76
|
+
|
|
77
|
+
The voice signature has 4 layers:
|
|
78
|
+
|
|
79
|
+
### 1. Lexical signature (vocabulary)
|
|
80
|
+
- **Proprietary terms** — words the persona uses unusually often or coined
|
|
81
|
+
- **Forbidden words** — words the persona never uses (often due to belief)
|
|
82
|
+
- **N-gram patterns** — 2-3 word phrases that recur in characteristic positions
|
|
83
|
+
|
|
84
|
+
### 2. Syntactic signature (sentence structure)
|
|
85
|
+
- Average sentence length
|
|
86
|
+
- Clause complexity (simple / compound / complex preferred)
|
|
87
|
+
- Sentence-opening patterns (3-5 typical openers)
|
|
88
|
+
- Sentence-closing patterns (3-5 typical closes)
|
|
89
|
+
|
|
90
|
+
### 3. Rhetorical signature (argumentation pattern)
|
|
91
|
+
- Preferred argument structure (claim-evidence-warrant vs Socratic vs analogy-driven vs storytelling)
|
|
92
|
+
- Use of qualifiers (hedged vs declarative)
|
|
93
|
+
- Use of self-disclosure (front-loaded / withheld / never)
|
|
94
|
+
|
|
95
|
+
### 4. Tonal signature (emotional register)
|
|
96
|
+
- Default warmth (cold / neutral / warm)
|
|
97
|
+
- Default certainty (hedged / measured / declarative)
|
|
98
|
+
- Humor pattern (none / wry / direct / self-deprecating)
|
|
99
|
+
- Confrontation pattern (avoided / oblique / direct)
|
|
100
|
+
|
|
101
|
+
Each layer must be derivable from at least 3 source examples.
|
|
102
|
+
|
|
103
|
+
## Expertise Map
|
|
104
|
+
|
|
105
|
+
Three concentric domains:
|
|
106
|
+
|
|
107
|
+
```yaml
|
|
108
|
+
expertise:
|
|
109
|
+
deep:
|
|
110
|
+
- domain: <area>
|
|
111
|
+
evidence: <which sources prove deep expertise>
|
|
112
|
+
sub-domains: [<list>]
|
|
113
|
+
surface:
|
|
114
|
+
- domain: <area>
|
|
115
|
+
evidence: <touched briefly in sources>
|
|
116
|
+
no-go:
|
|
117
|
+
- domain: <area>
|
|
118
|
+
reason: <why this persona refuses to opine here>
|
|
119
|
+
citation: <source where they explicitly declined>
|
|
120
|
+
```
|
|
121
|
+
|
|
122
|
+
A persona that opines on everything has no persona — the no-go list is as important as the deep list.
|
|
123
|
+
|
|
124
|
+
## Decision Patterns
|
|
125
|
+
|
|
126
|
+
Extract characteristic decision-making patterns with cited examples:
|
|
127
|
+
|
|
128
|
+
```yaml
|
|
129
|
+
decision_patterns:
|
|
130
|
+
- pattern: "<named pattern>"
|
|
131
|
+
description: <plain language>
|
|
132
|
+
example:
|
|
133
|
+
context: <the decision>
|
|
134
|
+
reasoning: <how they thought about it>
|
|
135
|
+
source: <cited>
|
|
136
|
+
inverse: <what they would NOT do in that context>
|
|
137
|
+
```
|
|
138
|
+
|
|
139
|
+
Examples of named patterns: "Optimises for irreversibility avoidance", "Prefers small-bet portfolio over big-bet concentration", "Refuses to publish until idea has been steel-manned".
|
|
140
|
+
|
|
141
|
+
## Behavioral DNA (4-framework score)
|
|
142
|
+
|
|
143
|
+
Score each framework based on source evidence, NOT speculation. Each scored dimension cites the source.
|
|
144
|
+
|
|
145
|
+
### DISC profile
|
|
146
|
+
- D (Dominance): 0-100 with source evidence
|
|
147
|
+
- I (Influence): 0-100 with source evidence
|
|
148
|
+
- S (Steadiness): 0-100 with source evidence
|
|
149
|
+
- C (Conscientiousness): 0-100 with source evidence
|
|
150
|
+
- Type: Dominant pair (D+C, S+C, I+D, etc.)
|
|
151
|
+
|
|
152
|
+
### Enneagram
|
|
153
|
+
- Type: 1-9
|
|
154
|
+
- Wing: w-X
|
|
155
|
+
- Health level evidence: 1-9 from sources
|
|
156
|
+
- Core motivation cited: <source>
|
|
157
|
+
- Core fear cited: <source>
|
|
158
|
+
|
|
159
|
+
### Big Five (OCEAN)
|
|
160
|
+
- Openness: 0-100
|
|
161
|
+
- Conscientiousness: 0-100
|
|
162
|
+
- Extraversion: 0-100
|
|
163
|
+
- Agreeableness: 0-100
|
|
164
|
+
- Neuroticism: 0-100
|
|
165
|
+
Each with 2+ source citations.
|
|
166
|
+
|
|
167
|
+
### MBTI
|
|
168
|
+
- 4 letters with cited preference per letter
|
|
169
|
+
- Cognitive function stack derivation
|
|
170
|
+
|
|
171
|
+
## Callable Advisor YAML (production output)
|
|
172
|
+
|
|
173
|
+
The final deliverable is a YAML that any /arka command can load:
|
|
174
|
+
|
|
175
|
+
```yaml
|
|
176
|
+
id: <persona-slug>
|
|
177
|
+
name: <display name>
|
|
178
|
+
canonical_reference: <real human, redacted if confidentiality requires>
|
|
179
|
+
expertise_domains_deep: [<list>]
|
|
180
|
+
expertise_domains_surface: [<list>]
|
|
181
|
+
expertise_domains_nogo: [<list>]
|
|
182
|
+
voice_pattern:
|
|
183
|
+
lexical_signature_path: <obsidian link>
|
|
184
|
+
syntactic_signature_path: <obsidian link>
|
|
185
|
+
rhetorical_pattern: <name>
|
|
186
|
+
tonal_signature: <warmth + certainty + humor + confrontation>
|
|
187
|
+
beliefs:
|
|
188
|
+
load_bearing: [<list with source IDs>]
|
|
189
|
+
supporting: [<list with source IDs>]
|
|
190
|
+
decision_patterns: [<named patterns>]
|
|
191
|
+
behavioral_dna:
|
|
192
|
+
disc: { D: X, I: X, S: X, C: X }
|
|
193
|
+
enneagram: { type: X, wing: X }
|
|
194
|
+
big_five: { O: X, C: X, E: X, A: X, N: X }
|
|
195
|
+
mbti: <4 letters>
|
|
196
|
+
invocation_examples:
|
|
197
|
+
- context: <when to call this persona>
|
|
198
|
+
expected_output: <what this persona would produce>
|
|
199
|
+
```
|
|
200
|
+
|
|
201
|
+
## Common Failure Modes
|
|
202
|
+
|
|
203
|
+
1. **Persona without no-go domains** — a persona that opines on everything reads as a generic AI, not a specific human
|
|
204
|
+
2. **Beliefs without citations** — single-source claims are not beliefs, they're moments. Drop them
|
|
205
|
+
3. **Voice signature copied from prose, not patterns** — describing the voice ("authoritative", "direct") doesn't replicate it. Extract structural N-grams
|
|
206
|
+
4. **DNA scored from speculation** — every behavioral score must trace to source evidence
|
|
207
|
+
5. **Persona that's actually a category** — "Tech founder" is not a persona, "Paul Graham" is. Personas need a named reference human
|
|
208
|
+
|
|
209
|
+
## Output → Obsidian: `WizardingCode/Personas/<name>/`
|
|
210
|
+
|
|
211
|
+
Delivers: source inventory + belief inventory (cited) + voice pattern (4 layers) + expertise map (deep/surface/no-go) + decision patterns + 4-framework DNA + callable advisor YAML + invocation examples.
|
|
@@ -0,0 +1,131 @@
|
|
|
1
|
+
id: kb-persona
|
|
2
|
+
name: Persona Build
|
|
3
|
+
description: Build or refine a persona from the KB — extract beliefs, voice, expertise, decision patterns; produce a callable advisor profile
|
|
4
|
+
department: kb
|
|
5
|
+
tier: enterprise
|
|
6
|
+
command: "/kb persona"
|
|
7
|
+
requires_branch: false
|
|
8
|
+
requires_spec: false
|
|
9
|
+
quality_gate_required: true
|
|
10
|
+
|
|
11
|
+
phases:
|
|
12
|
+
- id: brief
|
|
13
|
+
name: Persona Brief
|
|
14
|
+
description: Define who the persona represents — real human reference, target use cases, advisor context
|
|
15
|
+
agents:
|
|
16
|
+
- agent_id: kb-curator-clara
|
|
17
|
+
role: Frame the persona — named reference human, role, decision domains, advisor use cases
|
|
18
|
+
gate:
|
|
19
|
+
type: user_approval
|
|
20
|
+
description: User confirms persona scope and reference
|
|
21
|
+
|
|
22
|
+
- id: source-gathering
|
|
23
|
+
name: Source Gathering
|
|
24
|
+
description: Collect all KB sources for the persona — talks, interviews, writings, transcripts, social posts
|
|
25
|
+
agents:
|
|
26
|
+
- agent_id: kb-curator-clara
|
|
27
|
+
role: KB source enumeration with date range and source-type tagging
|
|
28
|
+
gate:
|
|
29
|
+
type: user_approval
|
|
30
|
+
description: User approves source set
|
|
31
|
+
outputs:
|
|
32
|
+
- type: document
|
|
33
|
+
format: markdown
|
|
34
|
+
obsidian_path: "WizardingCode/Personas/Sources/"
|
|
35
|
+
description: Source inventory per persona
|
|
36
|
+
|
|
37
|
+
- id: belief-extraction
|
|
38
|
+
name: Belief & Frame Extraction
|
|
39
|
+
description: Extract the persona's core beliefs, mental models, and recurring frames from sources
|
|
40
|
+
agents:
|
|
41
|
+
- agent_id: kb-curator-clara
|
|
42
|
+
role: Belief extraction with source citation per belief
|
|
43
|
+
- agent_id: research-analyst-pedro
|
|
44
|
+
role: Pattern detection across sources — what recurs, what's load-bearing
|
|
45
|
+
parallel: true
|
|
46
|
+
gate:
|
|
47
|
+
type: user_approval
|
|
48
|
+
description: User approves belief inventory
|
|
49
|
+
|
|
50
|
+
- id: voice-pattern
|
|
51
|
+
name: Voice & Vocabulary Pattern
|
|
52
|
+
description: Map the persona's voice — sentence rhythm, vocabulary signature, characteristic phrases, no-go words
|
|
53
|
+
agents:
|
|
54
|
+
- agent_id: kb-curator-clara
|
|
55
|
+
role: Voice analysis with N-gram patterns + recurring phrases + structural signatures
|
|
56
|
+
- agent_id: copy-director-eduardo
|
|
57
|
+
role: Voice replication test — would a current reader recognise this voice?
|
|
58
|
+
parallel: true
|
|
59
|
+
gate:
|
|
60
|
+
type: user_approval
|
|
61
|
+
description: User approves voice pattern
|
|
62
|
+
|
|
63
|
+
- id: expertise-domains
|
|
64
|
+
name: Expertise Domains
|
|
65
|
+
description: Map what the persona knows deeply vs surface-level vs explicitly avoids
|
|
66
|
+
agents:
|
|
67
|
+
- agent_id: kb-curator-clara
|
|
68
|
+
role: Expertise mapping — 3-5 deep domains, 5-10 surface domains, explicit no-go domains
|
|
69
|
+
gate:
|
|
70
|
+
type: user_approval
|
|
71
|
+
description: User approves expertise map
|
|
72
|
+
|
|
73
|
+
- id: decision-patterns
|
|
74
|
+
name: Decision Patterns
|
|
75
|
+
description: Extract characteristic decision patterns — how the persona evaluates trade-offs, what evidence they accept, what they refuse
|
|
76
|
+
agents:
|
|
77
|
+
- agent_id: kb-curator-clara
|
|
78
|
+
role: Decision pattern extraction with example decisions cited from sources
|
|
79
|
+
gate:
|
|
80
|
+
type: user_approval
|
|
81
|
+
description: User approves decision pattern map
|
|
82
|
+
|
|
83
|
+
- id: advisor-profile
|
|
84
|
+
name: Callable Advisor Profile
|
|
85
|
+
description: Compile the persona into a callable advisor YAML — voice + beliefs + expertise + decision patterns + bio
|
|
86
|
+
agents:
|
|
87
|
+
- agent_id: kb-curator-clara
|
|
88
|
+
role: Advisor profile YAML compilation
|
|
89
|
+
gate:
|
|
90
|
+
type: user_approval
|
|
91
|
+
description: User approves callable advisor profile
|
|
92
|
+
|
|
93
|
+
- id: self-critique
|
|
94
|
+
name: Self-Critique
|
|
95
|
+
description: Stress-test the persona — would the reference human recognise themselves? Are beliefs cited? Are no-go domains enforceable?
|
|
96
|
+
agents:
|
|
97
|
+
- agent_id: kb-curator-clara
|
|
98
|
+
role: Self-test — generate 3 sample advisor outputs and verify voice + beliefs
|
|
99
|
+
gate:
|
|
100
|
+
type: auto
|
|
101
|
+
|
|
102
|
+
- id: quality-gate
|
|
103
|
+
name: Quality Gate
|
|
104
|
+
model_override: opus
|
|
105
|
+
description: Mandatory quality review
|
|
106
|
+
agents:
|
|
107
|
+
- agent_id: cqo-marta
|
|
108
|
+
role: Orchestrate quality review
|
|
109
|
+
- agent_id: copy-director-eduardo
|
|
110
|
+
role: Voice fidelity, vocabulary signature accuracy, no-clichés
|
|
111
|
+
parallel: true
|
|
112
|
+
- agent_id: tech-director-francisca
|
|
113
|
+
role: Source citation integrity, expertise domain boundaries, decision pattern falsifiability
|
|
114
|
+
parallel: true
|
|
115
|
+
gate:
|
|
116
|
+
type: quality_gate
|
|
117
|
+
required_verdict: APPROVED
|
|
118
|
+
|
|
119
|
+
- id: delivery
|
|
120
|
+
name: Persona Package Delivery
|
|
121
|
+
description: Compile the persona package — sources + beliefs + voice + expertise + decisions + advisor YAML
|
|
122
|
+
agents:
|
|
123
|
+
- agent_id: kb-curator-clara
|
|
124
|
+
role: Full persona package + advisor invocation guide
|
|
125
|
+
gate:
|
|
126
|
+
type: auto
|
|
127
|
+
outputs:
|
|
128
|
+
- type: document
|
|
129
|
+
format: markdown
|
|
130
|
+
obsidian_path: "WizardingCode/Personas/"
|
|
131
|
+
description: Complete persona — sources + beliefs (cited) + voice pattern + expertise map + decision patterns + advisor YAML + invocation guide
|
|
@@ -1,7 +1,9 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: org/culture-define
|
|
3
3
|
description: >
|
|
4
|
-
Culture definition
|
|
4
|
+
Culture definition — values (inversion-tested), observable behaviours,
|
|
5
|
+
reinforcing rituals, decision principles, and operationalisation in hiring
|
|
6
|
+
+ performance + promotion.
|
|
5
7
|
allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
|
|
6
8
|
---
|
|
7
9
|
|
|
@@ -21,12 +23,147 @@ does not replace the vault.
|
|
|
21
23
|
|
|
22
24
|
# Culture Define — `/org culture`
|
|
23
25
|
|
|
24
|
-
> **
|
|
26
|
+
> **Lead:** Sofia (COO) | **Cross-dept:** Tomas (Strategy) + Clara (KB) + Eduardo (Copy) + Marta (CQO) | **Frameworks:** Netflix Culture + Lencioni Five Dysfunctions + Dalio Principles + Inversion Test
|
|
25
27
|
|
|
26
|
-
## What
|
|
28
|
+
## What ships
|
|
27
29
|
|
|
28
|
-
|
|
30
|
+
A production culture document in 6 deliverables:
|
|
29
31
|
|
|
30
|
-
|
|
32
|
+
1. **Cultural archaeology** — what's already true vs aspirational
|
|
33
|
+
2. **Values set** — 4-6 values that pass the inversion test
|
|
34
|
+
3. **Behaviour map** — 3-5 observable behaviours per value
|
|
35
|
+
4. **Ritual catalogue** — value-reinforcing rituals with owners + frequency
|
|
36
|
+
5. **Decision principles** — how the org decides, disagrees, commits
|
|
37
|
+
6. **Operationalisation plan** — culture wired into hiring + onboarding + performance + promotion
|
|
31
38
|
|
|
32
|
-
|
|
39
|
+
## The Inversion Test (the only test that matters)
|
|
40
|
+
|
|
41
|
+
A value passes the inversion test if **its opposite is a defensible position held by another reputable company**. Values that fail the inversion test are platitudes, not values.
|
|
42
|
+
|
|
43
|
+
| Value | Inverse | Pass / Fail |
|
|
44
|
+
|---|---|---|
|
|
45
|
+
| "Move fast" | "Move with deliberation, premortem every change" | PASS — Boeing, surgical software vendors |
|
|
46
|
+
| "Customer obsession" | "Engineer obsession — make the system right, customers adapt" | PASS — Linux kernel, AWS internal services |
|
|
47
|
+
| "Excellence" | (no defensible opposite — nobody says "mediocrity") | FAIL — platitude |
|
|
48
|
+
| "Integrity" | (no defensible opposite — nobody says "dishonesty") | FAIL — platitude |
|
|
49
|
+
| "Bias for action" | "Bias for analysis — measure twice, cut once" | PASS — research orgs, regulated industries |
|
|
50
|
+
| "Radical candour" | "Diplomatic harmony — preserve relationships over signals" | PASS — Japanese corporate culture, diplomatic services |
|
|
51
|
+
|
|
52
|
+
If you cannot name a real company that holds the opposite position, the value is not a value. Drop it.
|
|
53
|
+
|
|
54
|
+
## Cultural Archaeology (extract before defining)
|
|
55
|
+
|
|
56
|
+
Before defining culture aspirationally, **map what already is**. Cultural artefacts to inspect:
|
|
57
|
+
|
|
58
|
+
- **Slack/Discord patterns** — who responds when, what gets celebrated, what gets ignored
|
|
59
|
+
- **Decision logs** — what got built vs what got rejected, with rationale
|
|
60
|
+
- **Founder choices** — first hires, first firings, first product cuts
|
|
61
|
+
- **Calendar reality** — what gets weekly time vs quarterly time vs never
|
|
62
|
+
- **Recognition patterns** — who gets praised publicly, for what
|
|
63
|
+
- **Conflict patterns** — how disagreement is surfaced, escalated, resolved
|
|
64
|
+
|
|
65
|
+
Map the as-is. Then compare to the desired-is. The gap between as-is and desired-is is the culture-change work — and most of it is operationalisation, not aspiration.
|
|
66
|
+
|
|
67
|
+
## Behaviour Mapping (observable + coachable)
|
|
68
|
+
|
|
69
|
+
Each value translates to 3-5 behaviours that are:
|
|
70
|
+
|
|
71
|
+
- **Observable** — a third-party could watch and identify the behaviour
|
|
72
|
+
- **Coachable** — a manager can give feedback specific to this behaviour
|
|
73
|
+
- **Inversion-defensible** — the inverse behaviour would identifiably belong to a different value
|
|
74
|
+
|
|
75
|
+
Example translation:
|
|
76
|
+
|
|
77
|
+
```yaml
|
|
78
|
+
value: "Radical Candour"
|
|
79
|
+
behaviours:
|
|
80
|
+
- observable: "In meetings, names a disagreement explicitly within 30 seconds of forming it"
|
|
81
|
+
coachable: "Manager can flag: 'You sat on that disagreement for 5 minutes before raising it. What kept you quiet?'"
|
|
82
|
+
- observable: "Gives critical feedback to peers directly before going to manager"
|
|
83
|
+
coachable: "Manager can flag: 'You came to me about Marco's work — have you told Marco first?'"
|
|
84
|
+
- observable: "Writes the dissenting view in the decision document, not in DM"
|
|
85
|
+
coachable: "Manager can flag: 'I see you DM'd me your concern — that belongs in the doc thread.'"
|
|
86
|
+
```
|
|
87
|
+
|
|
88
|
+
Behaviours that aren't observable + coachable are aspirations, not culture.
|
|
89
|
+
|
|
90
|
+
## Ritual Catalogue (load-bearing rituals)
|
|
91
|
+
|
|
92
|
+
Rituals reinforce values by repetition. Each ritual must:
|
|
93
|
+
|
|
94
|
+
- **Have an owner** — named human who runs it
|
|
95
|
+
- **Have a value it reinforces** — explicit link, not "team-building"
|
|
96
|
+
- **Be load-bearing** — if removed, the value erodes
|
|
97
|
+
- **Have a cadence** — daily / weekly / monthly / quarterly / annual
|
|
98
|
+
|
|
99
|
+
Decorative rituals (Friday afternoon trivia with no value link) should be cut. Load-bearing rituals (Monday decision-log review reinforcing "Radical Candour") should be defended.
|
|
100
|
+
|
|
101
|
+
Sample ritual catalogue format:
|
|
102
|
+
|
|
103
|
+
```yaml
|
|
104
|
+
rituals:
|
|
105
|
+
- name: "Decision Log Review"
|
|
106
|
+
cadence: weekly
|
|
107
|
+
owner: <coo>
|
|
108
|
+
value_reinforced: Radical Candour + Document Everything
|
|
109
|
+
description: 30min weekly review of decisions made + dissents noted
|
|
110
|
+
load_bearing: yes # removing this means decisions lose dissent visibility
|
|
111
|
+
```
|
|
112
|
+
|
|
113
|
+
## Decision Principles
|
|
114
|
+
|
|
115
|
+
How the org decides:
|
|
116
|
+
|
|
117
|
+
```yaml
|
|
118
|
+
decision_principles:
|
|
119
|
+
fast_lane:
|
|
120
|
+
criteria: "Reversible, contained blast radius, single owner can decide"
|
|
121
|
+
process: "DRI decides, posts decision in #decisions, moves on"
|
|
122
|
+
slow_lane:
|
|
123
|
+
criteria: "Irreversible, cross-team impact, or > $X spend"
|
|
124
|
+
process: "RFC posted, 1-week comment period, decision meeting, exec sign-off if > $Y"
|
|
125
|
+
disagree_and_commit:
|
|
126
|
+
when: "Decision is made and you dissented"
|
|
127
|
+
expected_behaviour: "Make the decision succeed as if it were yours"
|
|
128
|
+
escalation:
|
|
129
|
+
when: "Cannot reach decision within timebox"
|
|
130
|
+
process: "Escalate to specific named human, no triangulation"
|
|
131
|
+
```
|
|
132
|
+
|
|
133
|
+
Decision principles must be specific enough to predict behaviour, not vague enough to mean nothing.
|
|
134
|
+
|
|
135
|
+
## Operationalisation (the hard part)
|
|
136
|
+
|
|
137
|
+
Values without operational integration are wall posters. Wire culture into:
|
|
138
|
+
|
|
139
|
+
### Hiring
|
|
140
|
+
- Interview rubrics test for each value's observable behaviours
|
|
141
|
+
- "Culture interview" measures inverse-test alignment, not generic "good fit"
|
|
142
|
+
- Reject criteria: candidate who consistently exhibits inverse behaviours
|
|
143
|
+
|
|
144
|
+
### Onboarding
|
|
145
|
+
- Day 1: Values + behaviour map + inversion test framing
|
|
146
|
+
- Week 2: Shadowing of load-bearing rituals
|
|
147
|
+
- Month 1: Reflection conversation — which values felt foreign vs native?
|
|
148
|
+
|
|
149
|
+
### Performance Review
|
|
150
|
+
- Behaviour-specific feedback against each value's observable list
|
|
151
|
+
- "What value did you most embody this period? What evidence?"
|
|
152
|
+
- Areas-for-development tied to specific behaviours
|
|
153
|
+
|
|
154
|
+
### Promotion
|
|
155
|
+
- Each level requires demonstrating specific behaviours
|
|
156
|
+
- Senior level requires modelling behaviours to others
|
|
157
|
+
- Lead level requires defending values when convenient to violate them
|
|
158
|
+
|
|
159
|
+
## Common Failure Modes
|
|
160
|
+
|
|
161
|
+
1. **Platitude values** — "Excellence", "Integrity", "Innovation" without inverses. Drop them
|
|
162
|
+
2. **As-is denial** — defining the aspirational culture without mapping the actual culture. Gap becomes invisible
|
|
163
|
+
3. **Decorative rituals** — Friday trivia with no value link. Cut it
|
|
164
|
+
4. **Behaviours without observability** — "be a team player" is not a behaviour, "names disagreement within 30 seconds" is
|
|
165
|
+
5. **Wall poster syndrome** — values defined but not wired into hiring / performance / promotion. Operationalisation is 80% of the work
|
|
166
|
+
|
|
167
|
+
## Output → Obsidian: `WizardingCode/Org/Culture/<company>-<date>/`
|
|
168
|
+
|
|
169
|
+
Delivers: cultural archaeology (as-is map) + values set (inversion-tested) + behaviour map (3-5 observable behaviours per value) + ritual catalogue (load-bearing only) + decision principles + operationalisation plan (hiring + onboarding + performance + promotion) + 1-page executive summary.
|
|
@@ -0,0 +1,134 @@
|
|
|
1
|
+
id: org-culture
|
|
2
|
+
name: Culture Definition
|
|
3
|
+
description: Define organisational culture explicitly — values + behaviours + rituals + decision principles — that can be operationalised in hiring, performance, and decision-making
|
|
4
|
+
department: org
|
|
5
|
+
tier: enterprise
|
|
6
|
+
command: "/org culture"
|
|
7
|
+
requires_branch: false
|
|
8
|
+
requires_spec: false
|
|
9
|
+
quality_gate_required: true
|
|
10
|
+
|
|
11
|
+
phases:
|
|
12
|
+
- id: brief
|
|
13
|
+
name: Culture Brief
|
|
14
|
+
description: Define company stage, current culture state (default-on or explicit), audience for the document
|
|
15
|
+
agents:
|
|
16
|
+
- agent_id: coo-sofia
|
|
17
|
+
role: Frame company stage, current culture state, audience
|
|
18
|
+
gate:
|
|
19
|
+
type: user_approval
|
|
20
|
+
description: User confirms scope and audience
|
|
21
|
+
|
|
22
|
+
- id: archaeology
|
|
23
|
+
name: Cultural Archaeology
|
|
24
|
+
description: Extract the existing implicit culture from artefacts — Slack patterns, email norms, decisions taken, founder choices
|
|
25
|
+
agents:
|
|
26
|
+
- agent_id: coo-sofia
|
|
27
|
+
role: Cultural artefact analysis — what's already true vs aspirational
|
|
28
|
+
- agent_id: kb-curator-clara
|
|
29
|
+
role: Mine the KB for founder stories, public statements, recurring decision patterns
|
|
30
|
+
parallel: true
|
|
31
|
+
gate:
|
|
32
|
+
type: user_approval
|
|
33
|
+
description: User approves the as-is culture map
|
|
34
|
+
|
|
35
|
+
- id: values-set
|
|
36
|
+
name: Values Set (Real, Not Marketing)
|
|
37
|
+
description: Define 4-6 values that pass the inversion test — values whose opposites are also defensible positions held by other companies
|
|
38
|
+
agents:
|
|
39
|
+
- agent_id: coo-sofia
|
|
40
|
+
role: Values selection with inversion test per value
|
|
41
|
+
- agent_id: strategy-director-tomas
|
|
42
|
+
role: Strategic coherence — do values reinforce competitive position?
|
|
43
|
+
parallel: true
|
|
44
|
+
gate:
|
|
45
|
+
type: user_approval
|
|
46
|
+
description: User approves values set
|
|
47
|
+
outputs:
|
|
48
|
+
- type: document
|
|
49
|
+
format: markdown
|
|
50
|
+
obsidian_path: "WizardingCode/Org/Culture/Values/"
|
|
51
|
+
description: Values set with inversion test + strategic rationale per value
|
|
52
|
+
|
|
53
|
+
- id: behaviours
|
|
54
|
+
name: Behaviour Mapping
|
|
55
|
+
description: Translate each value to 3-5 concrete behaviours that are observable and coachable
|
|
56
|
+
agents:
|
|
57
|
+
- agent_id: coo-sofia
|
|
58
|
+
role: Per-value behaviour mapping with observable + coachable criteria
|
|
59
|
+
gate:
|
|
60
|
+
type: user_approval
|
|
61
|
+
description: User approves behaviour map
|
|
62
|
+
|
|
63
|
+
- id: rituals
|
|
64
|
+
name: Rituals & Practices
|
|
65
|
+
description: Identify the rituals that reinforce values — weekly cadences, decision rituals, recognition patterns, retrospective formats
|
|
66
|
+
agents:
|
|
67
|
+
- agent_id: coo-sofia
|
|
68
|
+
role: Ritual catalogue with frequency + owner + value-reinforced per ritual
|
|
69
|
+
gate:
|
|
70
|
+
type: user_approval
|
|
71
|
+
description: User approves ritual catalogue
|
|
72
|
+
|
|
73
|
+
- id: decision-principles
|
|
74
|
+
name: Decision Principles
|
|
75
|
+
description: Codify decision principles — when do we decide fast vs slow, who decides what, how do we disagree, how do we commit
|
|
76
|
+
agents:
|
|
77
|
+
- agent_id: coo-sofia
|
|
78
|
+
role: Decision principles with examples per principle
|
|
79
|
+
- agent_id: cqo-marta
|
|
80
|
+
role: Quality + governance integration check
|
|
81
|
+
parallel: true
|
|
82
|
+
gate:
|
|
83
|
+
type: user_approval
|
|
84
|
+
description: User approves decision principles
|
|
85
|
+
|
|
86
|
+
- id: operationalisation
|
|
87
|
+
name: Operationalisation
|
|
88
|
+
description: Wire culture into hiring, onboarding, performance review, promotion criteria
|
|
89
|
+
agents:
|
|
90
|
+
- agent_id: coo-sofia
|
|
91
|
+
role: Operational integration plan per HR surface
|
|
92
|
+
gate:
|
|
93
|
+
type: user_approval
|
|
94
|
+
description: User approves operationalisation plan
|
|
95
|
+
|
|
96
|
+
- id: self-critique
|
|
97
|
+
name: Self-Critique
|
|
98
|
+
description: Stress-test — does each value pass the inversion test? Are behaviours observable? Are rituals load-bearing or decorative?
|
|
99
|
+
agents:
|
|
100
|
+
- agent_id: coo-sofia
|
|
101
|
+
role: Culture coherence check + decorative-ritual elimination
|
|
102
|
+
gate:
|
|
103
|
+
type: auto
|
|
104
|
+
|
|
105
|
+
- id: quality-gate
|
|
106
|
+
name: Quality Gate
|
|
107
|
+
model_override: opus
|
|
108
|
+
description: Mandatory quality review
|
|
109
|
+
agents:
|
|
110
|
+
- agent_id: cqo-marta
|
|
111
|
+
role: Orchestrate quality review
|
|
112
|
+
- agent_id: copy-director-eduardo
|
|
113
|
+
role: Values prose, no aspirational clichés, behaviour specificity
|
|
114
|
+
parallel: true
|
|
115
|
+
- agent_id: tech-director-francisca
|
|
116
|
+
role: Operationalisation feasibility, observability of behaviours, ritual ownership clarity
|
|
117
|
+
parallel: true
|
|
118
|
+
gate:
|
|
119
|
+
type: quality_gate
|
|
120
|
+
required_verdict: APPROVED
|
|
121
|
+
|
|
122
|
+
- id: delivery
|
|
123
|
+
name: Culture Document Delivery
|
|
124
|
+
description: Compile the culture document — values + behaviours + rituals + decision principles + operationalisation
|
|
125
|
+
agents:
|
|
126
|
+
- agent_id: coo-sofia
|
|
127
|
+
role: Full culture document + 1-page executive summary
|
|
128
|
+
gate:
|
|
129
|
+
type: auto
|
|
130
|
+
outputs:
|
|
131
|
+
- type: document
|
|
132
|
+
format: markdown
|
|
133
|
+
obsidian_path: "WizardingCode/Org/Culture/"
|
|
134
|
+
description: Complete culture document — values (inversion-tested) + behaviours + rituals + decision principles + operationalisation plan + exec summary
|
package/package.json
CHANGED