Skip to content

Commit 90f5b0f

Browse files
committed
docs: Update AGENTS-consumer.md with storyteller and .opencode/strray
- Add @storyteller agent to agents table - Add Storyteller story types section (reflection, saga, journey, narrative) - Add .opencode/strray directory documentation - Update both root and .opencode/ versions
1 parent 2ac5a29 commit 90f5b0f

2 files changed

Lines changed: 60 additions & 0 deletions

File tree

.opencode/AGENTS-consumer.md

Lines changed: 30 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -104,6 +104,22 @@ StringRay uses **two reflection folders** for different purposes:
104104
| Quick learning/insight | `docs/reflections/` |
105105
| Deep investigation with many discoveries | `docs/deep-reflections/` |
106106

107+
### Storyteller Story Types
108+
109+
The `@storyteller` agent supports multiple story types:
110+
111+
| Type | Description | Invoke |
112+
|------|-------------|--------|
113+
| `reflection` | Technical deep reflections on development process | `@storyteller write a reflection about X` |
114+
| `saga` | Long-form technical saga spanning multiple sessions | `@storyteller write a saga about X` |
115+
| `journey` | Investigation/learning journey | `@storyteller write a journey about X` |
116+
| `narrative` | Technical narrative - telling the story of code | `@storyteller write a narrative about X` |
117+
118+
**Example:**
119+
```
120+
@storyteller write a reflection about fixing the memory leak
121+
```
122+
107123
## Available Agents
108124

109125
| Agent | Purpose | Invoke |
@@ -116,6 +132,7 @@ StringRay uses **two reflection folders** for different purposes:
116132
| `@refactorer` | Technical debt elimination | `@refactorer optimize code` |
117133
| `@testing-lead` | Testing strategy | `@testing-lead plan tests` |
118134
| `@bug-triage-specialist` | Error investigation | `@bug-triage-specialist debug error` |
135+
| `@storyteller` | Narrative deep reflections | `@storyteller write a journey` |
119136
| `@researcher` | Codebase exploration | `@researcher find implementation` |
120137

121138
## Complexity Routing
@@ -168,6 +185,19 @@ cat .opencode/strray/features.json
168185
npx strray-ai config set --feature token_optimization.enabled --value false
169186
```
170187

188+
### .opencode/strray Directory
189+
190+
The `.opencode/strray/` directory contains core framework configuration:
191+
192+
| File | Purpose |
193+
|------|---------|
194+
| `codex.json` | Universal Development Codex (60 error prevention terms) |
195+
| `features.json` | Feature flags and settings |
196+
| `config.json` | Framework configuration |
197+
| `agents_template.md` | Agent architecture templates |
198+
| `routing-mappings.json` | Agent routing configurations |
199+
| `workflow_state.json` | Runtime workflow state |
200+
171201
## Agent Discovery & Capabilities
172202

173203
### First-Time Agent Context

AGENTS-consumer.md

Lines changed: 30 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -66,6 +66,22 @@ StringRay uses **two reflection folders** for different purposes:
6666
| Quick learning/insight | `docs/reflections/` |
6767
| Deep investigation with many discoveries | `docs/deep-reflections/` |
6868

69+
### Storyteller Story Types
70+
71+
The `@storyteller` agent supports multiple story types:
72+
73+
| Type | Description | Invoke |
74+
|------|-------------|--------|
75+
| `reflection` | Technical deep reflections on development process | `@storyteller write a reflection about X` |
76+
| `saga` | Long-form technical saga spanning multiple sessions | `@storyteller write a saga about X` |
77+
| `journey` | Investigation/learning journey | `@storyteller write a journey about X` |
78+
| `narrative` | Technical narrative - telling the story of code | `@storyteller write a narrative about X` |
79+
80+
**Example:**
81+
```
82+
@storyteller write a reflection about fixing the memory leak
83+
```
84+
6985
## Available Agents
7086

7187
| Agent | Purpose | Invoke |
@@ -78,6 +94,7 @@ StringRay uses **two reflection folders** for different purposes:
7894
| `@refactorer` | Technical debt elimination | `@refactorer optimize code` |
7995
| `@testing-lead` | Testing strategy | `@testing-lead plan tests` |
8096
| `@bug-triage-specialist` | Error investigation | `@bug-triage-specialist debug error` |
97+
| `@storyteller` | Narrative deep reflections | `@storyteller write a journey` |
8198
| `@researcher` | Codebase exploration | `@researcher find implementation` |
8299

83100
## Complexity Routing
@@ -130,6 +147,19 @@ cat .opencode/strray/features.json
130147
npx strray-ai config set --feature token_optimization.enabled --value false
131148
```
132149

150+
### .opencode/strray Directory
151+
152+
The `.opencode/strray/` directory contains core framework configuration:
153+
154+
| File | Purpose |
155+
|------|---------|
156+
| `codex.json` | Universal Development Codex (60 error prevention terms) |
157+
| `features.json` | Feature flags and settings |
158+
| `config.json` | Framework configuration |
159+
| `agents_template.md` | Agent architecture templates |
160+
| `routing-mappings.json` | Agent routing configurations |
161+
| `workflow_state.json` | Runtime workflow state |
162+
133163
## Agent Discovery & Capabilities
134164

135165
### First-Time Agent Context

0 commit comments

Comments
 (0)