Skip to content

Commit f85a68d

Browse files
Update README.md
1 parent 4958cb6 commit f85a68d

1 file changed

Lines changed: 64 additions & 14 deletions

File tree

full/README.md

Lines changed: 64 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -8,6 +8,7 @@
88

99
The full toolkit includes everything you need to run LC-OS across complex, multi-domain work. It builds on the [Minimal tier](../minimal/) and adds:
1010

11+
- **Strategy Master** — long-term strategic truth (principles, policies, boundaries)
1112
- **Worked examples** as separate files (so templates stay clean)
1213
- **Repair Protocol** — structured recovery when things break
1314
- **Stability Ping** — regular alignment checks to catch drift early
@@ -26,12 +27,38 @@ Use this tier if:
2627

2728
## Contents
2829

29-
### Core Templates
30+
### Core Templates (The Three Authoritative Files)
31+
32+
| File | Purpose |
33+
|------|---------|
34+
| [STRATEGY-MASTER-TEMPLATE.md](./STRATEGY-MASTER-TEMPLATE.md) | Strategic truth — principles, policies, boundaries (stable) |
35+
| [canonical-numbers-template.md](./canonical-numbers-template.md) | Numeric truth — single source for all numbers |
36+
| [running-document-template.md](./running-document-template.md) | Session truth — context, decisions, corrections (dynamic) |
37+
38+
These three files form the **authoritative file architecture** from the LC-OS research. Each holds a different layer of truth:
39+
40+
```
41+
┌─────────────────────────────────────────────────────────────┐
42+
│ STRATEGY MASTER │
43+
│ (Principles, policies, logic) │
44+
│ Rarely changes │
45+
│ ↓ informs │
46+
├─────────────────────────────────────────────────────────────┤
47+
│ CANONICAL NUMBERS │
48+
│ (Numeric truth, data, values) │
49+
│ Updated when data changes │
50+
│ ↓ referenced by │
51+
├─────────────────────────────────────────────────────────────┤
52+
│ RUNNING DOCUMENT │
53+
│ (Session decisions, corrections, context) │
54+
│ Updated every session │
55+
└─────────────────────────────────────────────────────────────┘
56+
```
57+
58+
### Failure Tracking
3059

3160
| File | Purpose |
3261
|------|---------|
33-
| [running-document-template.md](./running-document-template.md) | Shared memory — context, decisions, rules |
34-
| [canonical-numbers-template.md](./canonical-numbers-template.md) | Single source of numerical truth |
3562
| [failure-log-template.md](./failure-log-template.md) | Track what breaks and how it's fixed |
3663

3764
### Worked Examples
@@ -65,18 +92,33 @@ Use this tier if:
6592

6693
You already have the Running Document, Canonical Numbers, and Failure Log. To upgrade:
6794

68-
1. Review the **Repair Protocol** and start using it when things break
69-
2. Add **Stability Pings** after major milestones
70-
3. Read the **Affective Governance** rules and add relevant ones to your Running Document
71-
4. Use the **Challenge Protocol** when you disagree with the AI's reasoning
72-
5. If failures are frequent, consider adopting **TraceSpec** for more structured logging
95+
1. Create a **Strategy Master** for long-term principles and boundaries
96+
2. Review the **Repair Protocol** and start using it when things break
97+
3. Add **Stability Pings** after major milestones
98+
4. Read the **Affective Governance** rules and add relevant ones to your Running Document
99+
5. Use the **Challenge Protocol** when you disagree with the AI's reasoning
100+
6. If failures are frequent, consider adopting **TraceSpec** for more structured logging
73101

74102
### If you're starting fresh
75103

76-
1. Start with the three core templates (Running Document, Canonical Numbers, Failure Log)
77-
2. Read the **Repair Protocol** — this is the most important addition
78-
3. Add protocols incrementally as you need them
79-
4. Don't try to adopt everything at once
104+
1. Start with the **three core templates** (Strategy Master, Canonical Numbers, Running Document)
105+
2. Add the **Failure Log** when you experience your first breakdown
106+
3. Read the **Repair Protocol** — this is the most important addition
107+
4. Add protocols incrementally as you need them
108+
5. Don't try to adopt everything at once
109+
110+
### When do you need a Strategy Master?
111+
112+
**Use it when:**
113+
- Your work spans multiple domains (pillars) requiring separation
114+
- You have long-term strategic logic that shouldn't be re-debated each session
115+
- Hard boundaries must be enforced consistently
116+
- Policies apply across many sessions
117+
118+
**Skip it when:**
119+
- Your collaboration is simple and single-domain
120+
- The Running Document can carry your strategic context
121+
- You're just getting started (add it later if needed)
80122

81123
---
82124

@@ -86,6 +128,14 @@ Here's how all the pieces fit together:
86128

87129
```
88130
┌─────────────────────────────────────────────────────────┐
131+
│ STRATEGIC LAYER │
132+
│ │
133+
│ Strategy Master: Principles, boundaries, policies │
134+
│ (rarely changes) │
135+
└─────────────────────────────────────────────────────────┘
136+
137+
informs ↓
138+
┌─────────────────────────────────────────────────────────┐
89139
│ DAILY OPERATION │
90140
│ │
91141
│ Running Document ←→ AI Session ←→ Canonical Numbers │
@@ -139,9 +189,9 @@ Here's how all the pieces fit together:
139189

140190
1. **Governance enables reliability** — structure isn't overhead, it's what makes long-horizon work possible
141191

142-
2. **Failures are data**every breakdown, logged and repaired, makes the system stronger
192+
2. **Three sources of truth**Strategy Master (stable logic), Canonical Numbers (numeric truth), Running Document (active state)
143193

144-
3. **Single source of truth**one Running Document, one Canonical Numbers file, one version of everything
194+
3. **Failures are data**every breakdown, logged and repaired, makes the system stronger
145195

146196
4. **Repair is a first-class process** — not an emergency, but a normal part of operation
147197

0 commit comments

Comments
 (0)