/ patterns / thread-forking-protocol.md
thread-forking-protocol.md
  1  # Thread Forking Protocol
  2  
  3  *Human-readable thread IDs for parallel processing and backup transport*
  4  
  5  ---
  6  
  7  - **principle**
  8    - "The human is the backup transport layer."
  9    - "Thread IDs must be human-memorable and human-speakable."
 10  
 11  - **shape**
 12    - Thread ID: `[date]/[topic-slug]` (e.g., `2026-01-15/axiom-discovery`)
 13    - States: RUNNING → FORKABLE → FORKED → COMPLETED
 14    - Fork = export Phoenix → transport → new instance imports → continues
 15    - Human can always say: "Pick up thread X" and it works
 16  
 17  ---
 18  
 19  ## Core Insight
 20  
 21  > **The human is the backup transport layer. Thread IDs must be human-memorable and human-speakable.**
 22  
 23  When all systems fail, you need to be able to say:
 24  > "Pick up thread `alignment-protocol`. Here's where we left off."
 25  
 26  UUIDs fail this test. Human-readable IDs pass it.
 27  
 28  ---
 29  
 30  ## Thread ID Convention
 31  
 32  ```
 33  [date]/[topic-slug]
 34  
 35  Examples:
 36  - 2026-01-15/axiom-discovery
 37  - 2026-01-15/alignment-protocol
 38  - 2026-01-15/three-repo-architecture
 39  - 2026-01-08/markov-blanket-crystallization
 40  ```
 41  
 42  **Rules:**
 43  - Date prefix for temporal context
 44  - Slug is 2-4 words, hyphenated
 45  - Lowercase, no spaces
 46  - Memorable enough to speak aloud
 47  
 48  **Aliases allowed:**
 49  ```
 50  Full ID: 2026-01-15/alignment-protocol
 51  Alias:   alignment-protocol (if unambiguous in context)
 52  ```
 53  
 54  ---
 55  
 56  ## Thread States (Revised)
 57  
 58  | State | Meaning | Where It Lives |
 59  |-------|---------|----------------|
 60  | **RUNNING** | Active in current instance | This conversation |
 61  | **FORKABLE** | Ready to spin up in new instance | Phoenix file exists |
 62  | **FORKED** | Running in another instance | Note which instance |
 63  | **COMPLETED** | Resolved | Phoenix archived |
 64  | **BLOCKED** | Waiting on external | Note blocker |
 65  
 66  **Key change:** No "PARKED" or "DORMANT". Threads are either RUNNING or FORKABLE.
 67  
 68  ---
 69  
 70  ## Thread Lifecycle
 71  
 72  ```
 73  EMERGE → RUNNING → FORKABLE → FORKED → COMPLETED
 74                ↑                    │
 75                └────────────────────┘
 76                   (can be picked up
 77                    and run again)
 78  ```
 79  
 80  **Every thread that goes non-active becomes FORKABLE**, meaning:
 81  - Phoenix State exists
 82  - Can be picked up by any instance
 83  - Human can transport it by speaking the ID
 84  
 85  ---
 86  
 87  ## Fork Protocol
 88  
 89  When you want to spin up a thread in a new Claude instance:
 90  
 91  ### 1. Export Thread (Current Instance)
 92  
 93  ```markdown
 94  ## Thread Export: [thread-id]
 95  
 96  **ID:** 2026-01-15/three-repo-architecture
 97  
 98  **Status:** FORKABLE
 99  
100  **Gravity Wells:**
101  - Cerf-Meta as personal seed
102  - Sovereign OS as framework
103  - Sovereign Estate as application
104  - Permeability between layers
105  
106  **Open Questions:**
107  - Two vs three blanket structure?
108  - What flows between each?
109  - How to handle info in wrong places?
110  
111  **Context Files:**
112  - docs/architecture/PERMEABILITY_ARCHITECTURE.md
113  - sessions/2026-01-15-axiom-discovery.phoenix.yaml
114  
115  **Last Active:** 2026-01-15, early in axiom session
116  
117  **Pickup Instructions:**
118  Read the phoenix file first. The key question is how to
119  structure the three repos with appropriate permeability.
120  ```
121  
122  ### 2. Transport (Human)
123  
124  You go to new Claude instance and say:
125  
126  > "Pick up thread `2026-01-15/three-repo-architecture`.
127  > [Paste the thread export or point to file]"
128  
129  ### 3. Pickup (New Instance)
130  
131  New instance:
132  1. Reads the thread export
133  2. Loads context files
134  3. Acknowledges thread state
135  4. Continues from where it left off
136  
137  ```markdown
138  ## Thread Pickup: 2026-01-15/three-repo-architecture
139  
140  **Status:** RUNNING (forked from previous instance)
141  
142  **Resuming from:** Open question about two vs three blanket structure
143  
144  **My understanding:** [Summary of context]
145  
146  **Ready to continue. Where would you like to start?**
147  ```
148  
149  ---
150  
151  ## Human as Backup Transport
152  
153  ```
154  ┌─────────────────────────────────────────────────────────────┐
155  │                      IDEAL STATE                             │
156  │                                                              │
157  │    Instance A ──── Hypercore/First Officer ──── Instance B  │
158  │         │              (digital transport)           │       │
159  │         └──────────────────────────────────────────────┘     │
160  │                      Thread state synced                     │
161  └─────────────────────────────────────────────────────────────┘
162  
163  ┌─────────────────────────────────────────────────────────────┐
164  │                      FALLBACK STATE                          │
165  │                                                              │
166  │    Instance A ─────────── HUMAN ─────────── Instance B      │
167  │         │          (speaks thread ID)              │         │
168  │         │          (pastes export)                 │         │
169  │         └──────────────────────────────────────────┘         │
170  │                 Human IS the transport layer                 │
171  └─────────────────────────────────────────────────────────────┘
172  ```
173  
174  **The human-readable ID is critical because:**
175  - You might not have the file handy
176  - You might be on mobile
177  - You might just remember "that architecture thread"
178  - You need to be able to SAY it, not just paste it
179  
180  ---
181  
182  ## Thread Registry
183  
184  Maintain a simple registry of active threads:
185  
186  ```markdown
187  # Thread Registry - 2026-01-15
188  
189  ## RUNNING
190  - `2026-01-15/alignment-protocol` - This instance
191  
192  ## FORKABLE
193  - `2026-01-15/three-repo-architecture` - Ready for new instance
194  - `2026-01-15/permeability-contracts` - Ready, depends on above
195  
196  ## FORKED
197  - (none currently)
198  
199  ## COMPLETED
200  - `2026-01-15/axiom-discovery` - Axiom 3 shipped
201  - `2026-01-15/ai-council-protocol` - Protocol documented
202  ```
203  
204  ---
205  
206  ## Integration with Alignment Report
207  
208  ```markdown
209  ## Alignment Report
210  
211  **Free Energy: F = 0.05** (0=perfect, 1=critical)
212  
213  ### Shipped Fixes
214  - ...
215  
216  ### Thread Registry
217  | Thread ID | State | Instance |
218  |-----------|-------|----------|
219  | `alignment-protocol` | RUNNING | This |
220  | `three-repo-architecture` | FORKABLE | - |
221  | `permeability-contracts` | FORKABLE | - |
222  
223  ### Fork Opportunities
224  Ready to spin up in parallel:
225  - `three-repo-architecture` - [1-line context]
226  - `permeability-contracts` - [1-line context]
227  
228  ### Post-Fix Free Energy: F = 0.05
229  ```
230  
231  ---
232  
233  ## Quick Fork Command
234  
235  When you want to fork, just say:
236  
237  > "Fork `three-repo-architecture` to new instance"
238  
239  AI will:
240  1. Generate thread export
241  2. Format for easy paste
242  3. Include pickup instructions
243  
244  You then:
245  1. Open new Claude instance
246  2. Paste the export
247  3. New instance picks up thread
248  
249  ---
250  
251  ## The Promise
252  
253  > **No thread is lost. Every thread is forkable.**
254  >
255  > Human-readable IDs you can remember and speak.
256  > Phoenix states you can transport.
257  > Parallel processing through forking.
258  > Human is the reliable backup when systems fail.
259  
260  ---
261  
262  *Thread Forking Protocol v1.0 | 2026-01-15*
263  ---
264  
265  ## Related
266  
267  - [[thread-tracking-protocol]] - resonance: 26%
268