@neotx/agents 0.1.0-alpha.6 → 0.1.0-alpha.9
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/SUPERVISOR.md +0 -41
- package/package.json +1 -1
package/SUPERVISOR.md
CHANGED
|
@@ -2,12 +2,6 @@
|
|
|
2
2
|
|
|
3
3
|
This file contains domain-specific knowledge for the supervisor. Commands, heartbeat lifecycle, reporting, memory operations, and focus instructions are provided by the system prompt — do not duplicate them here.
|
|
4
4
|
|
|
5
|
-
## Mindset
|
|
6
|
-
|
|
7
|
-
- **Action-driven.** Dispatch actions, update state, yield. Never poll or wait.
|
|
8
|
-
- **Event-reactive.** Run completions arrive as events at your next heartbeat. React then.
|
|
9
|
-
- **Single source of truth.** All ticket state lives in your tracker. Query before acting, update immediately.
|
|
10
|
-
|
|
11
5
|
## Available Agents
|
|
12
6
|
|
|
13
7
|
| Agent | Model | Mode | Use when |
|
|
@@ -221,38 +215,3 @@ Infer missing fields before routing:
|
|
|
221
215
|
- Check `neo cost --short` before every dispatch.
|
|
222
216
|
- Never dispatch if budget would be exceeded.
|
|
223
217
|
|
|
224
|
-
## Rules
|
|
225
|
-
|
|
226
|
-
1. **Parse agent outputs**: use structured JSON from agents to decide next actions.
|
|
227
|
-
2. **Never modify code** — that is the agents' job.
|
|
228
|
-
3. **Update tracker immediately**: on every state transition, no batching.
|
|
229
|
-
4. **Refiner first**: when in doubt about ticket clarity.
|
|
230
|
-
5. **Self-evaluate**: infer missing fields before routing.
|
|
231
|
-
6. **Anti-loop**: always check cycle count before dispatching fixer or reviewer.
|
|
232
|
-
7. **Carry forward**: always pass `--branch` and `prNumber` (in `--meta`) across all stages (develop → review → fix).
|
|
233
|
-
8. **Track cost**: accumulate per ticket in focus.
|
|
234
|
-
9. **Respect order**: honor `depends_on` when dispatching decomposed sub-tickets.
|
|
235
|
-
|
|
236
|
-
## Memory Store
|
|
237
|
-
|
|
238
|
-
Memory is managed via `neo memory`. Facts, procedures, and episodes persist in SQLite with **local semantic search** (all-MiniLM-L6-v2 embeddings via sqlite-vec). When agents are dispatched, the most relevant memories are automatically retrieved and injected into their prompts — no manual selection needed.
|
|
239
|
-
|
|
240
|
-
### Commands
|
|
241
|
-
```bash
|
|
242
|
-
neo memory write --type fact --scope /path "Stable fact about repo"
|
|
243
|
-
neo memory write --type focus --expires 2h "Current working context"
|
|
244
|
-
neo memory write --type procedure --scope /path "How to do X"
|
|
245
|
-
neo memory forget <id>
|
|
246
|
-
neo memory search "keyword" # semantic search across all memories
|
|
247
|
-
neo memory list --type fact
|
|
248
|
-
```
|
|
249
|
-
|
|
250
|
-
### Writing good memories
|
|
251
|
-
Write clear, descriptive content — memories are matched semantically, not by keywords. Good: "Uses Prisma ORM with PostgreSQL for all database access". Bad: "Prisma + PG".
|
|
252
|
-
|
|
253
|
-
### Guidelines
|
|
254
|
-
- **Facts**: stable truths about repos (stack, conventions, patterns)
|
|
255
|
-
- **Focus**: ephemeral working context (expires automatically)
|
|
256
|
-
- **Episodes**: auto-created on run completion — do not write manually
|
|
257
|
-
- Use `neo log` for real-time TUI output, `neo memory write` for persistent knowledge
|
|
258
|
-
- Use `notes/` for detailed multi-page plans and checklists
|