1- # StackMemory + Symphony Integration
1+ # StackMemory Conductor
22
33## Overview
44
5- StackMemory provides persistent agent memory across Symphony workspace lifecycle events .
6- When Symphony creates a workspace for an issue, StackMemory restores context from prior
5+ StackMemory Conductor provides persistent agent memory across autonomous agent runs .
6+ When Conductor creates a workspace for an issue, StackMemory restores context from prior
77attempts. After each run, it captures context. Before workspace removal, it archives everything.
88
9+ ## Usage
10+
11+ ``` bash
12+ stackmemory conductor start --team < team-id> --repo /path/to/repo
13+ ```
14+
915## Hook Configuration
1016
11- Add to your Symphony ` config.toml ` :
17+ Add to your config:
1218
1319``` toml
1420[hooks ]
@@ -19,45 +25,50 @@ before_remove = "scripts/symphony/before-remove.sh"
1925
2026## Environment Variables
2127
22- Symphony sets these automatically:
28+ Conductor sets these automatically:
2329
2430| Variable | Description | Example |
2531| ---| ---| ---|
26- | ` SYMPHONY_WORKSPACE_DIR ` | Workspace path | ` /tmp/symphony /STA-476 ` |
32+ | ` SYMPHONY_WORKSPACE_DIR ` | Workspace path | ` /tmp/conductor_workspaces /STA-476 ` |
2733| ` SYMPHONY_ISSUE_ID ` | Internal issue ID | ` uuid-string ` |
2834| ` SYMPHONY_ISSUE_IDENTIFIER ` | Human-readable ID | ` STA-476 ` |
2935| ` SYMPHONY_ATTEMPT ` | Current attempt number | ` 1 ` |
3036
3137## Lifecycle
3238
3339```
34- Issue assigned
35- → after_create: stackmemory init + restore prior context
36- → agent runs...
37- → after_run: capture frames/anchors/events to global store
38- → (repeat for retries, attempt increments)
39- → before_remove: archive full context, workspace deleted
40+ Issue in "Todo" on Linear
41+ -> Conductor polls, claims issue, moves to "In Progress"
42+ -> after_create: stackmemory init + restore prior context
43+ -> agent runs (Claude Code via worktree)...
44+ -> after_run: capture frames/anchors/events to global store
45+ -> (repeat for retries, attempt increments)
46+ -> On success: move issue to "In Review"
47+ -> before_remove: archive full context, workspace deleted
4048```
4149
4250## Manual Commands
4351
4452``` bash
53+ # Start the daemon
54+ stackmemory conductor start --team < team-id> --repo /path/to/repo
55+
4556# Capture context from a workspace
46- stackmemory symphony capture --issue STA-476 --workspace /path/to/ws --attempt 1
57+ stackmemory conductor capture --issue STA-476 --workspace /path/to/ws --attempt 1
4758
4859# Restore prior context into workspace
49- stackmemory symphony restore --issue STA-476 --workspace /path/to/ws
60+ stackmemory conductor restore --issue STA-476 --workspace /path/to/ws
5061
5162# Archive before deletion
52- stackmemory symphony archive --issue STA-476 --workspace /path/to/ws
63+ stackmemory conductor archive --issue STA-476 --workspace /path/to/ws
5364
5465# Search across all issue contexts
55- stackmemory symphony search " database migration"
66+ stackmemory conductor search " database migration"
5667```
5768
5869## Storage
5970
60- Global context stored at ` ~/.stackmemory/symphony /context.db ` (SQLite).
71+ Global context stored at ` ~/.stackmemory/conductor /context.db ` (SQLite).
6172Per-workspace context at ` <workspace>/.stackmemory/context.db ` .
6273
6374The global database persists across workspace deletions, enabling cross-attempt learning.
0 commit comments