thePR0M3TH3ANandClaude Opus 4.6
ca31abf33e
- Update agent models from gpt-5.3-codex to claude-compatible names (opus for coordinator/lead, sonnet for builder/scout/reviewer/merger, haiku for monitor) - Switch runtime from codex to claude (codex requires interactive TTY, incompatible with tmux-based agent spawning) - Add Overstory ecosystem links to AGENTS.md and CLAUDE.md - Add docs/overstory_quick_reference.md with startup, monitoring, and CLI commands - Sync seeds issue state Co-Authored-By: Claude Opus 4.6 <[email protected]>
4.2 KiB
SeedPass Agent Guide
Overstory Ecosystem
This project is part of the Overstory multi-agent development ecosystem. When asked to "update Overstory" or work on the ecosystem, these are the relevant repositories:
- Overstory — The coordinator. Orchestrates multi-agent workflows across worktrees.
- Mulch — Structured expertise/memory system for agents.
- Canopy — Prompt management system for agents.
- Seeds — Git-native issue tracker for agents.
- os-eco — The entire Overstory ecosystem (meta-repo/docs).
Planning & Strategy
Consult these first to align with current objectives:
- Dev Control Center: Current priorities.
- TUI v2 Execution Plan: Roadmap for TUI v2.
Testing
Always run the full suite before proposing changes:
bash scripts/run_ci_tests.sh- Central Index: Test Infrastructure Inventory
TORCH Memory Integration
You have access to the TORCH memory system.
- READ: Check
.scheduler-memory/latest/${cadence}/memories.mdfor past learnings. - WRITE: Before exiting, save new insights to
memory-update.mdso future runs can learn from this session.
Project Expertise (Mulch)
This project uses Mulch for structured expertise management.
At the start of every session, run:
mulch prime
This injects project-specific conventions, patterns, decisions, and other learnings into your context.
Use mulch prime --files src/foo.ts to load only records relevant to specific files.
Before completing your task, review your work for insights worth preserving — conventions discovered, patterns applied, failures encountered, or decisions made — and record them:
mulch record <domain> --type <convention|pattern|failure|decision|reference|guide> --description "..."
Link evidence when available: --evidence-commit <sha>, --evidence-bead <id>
Run mulch status to check domain health and entry counts.
Run mulch --help for full usage.
Mulch write commands use file locking and atomic writes — multiple agents can safely record to the same domain concurrently.
Before You Finish
- Discover what to record:
mulch learn - Store insights from this work session:
mulch record <domain> --type <convention|pattern|failure|decision|reference|guide> --description "..." - Validate and commit:
mulch sync
Issue Tracking (Seeds)
This project uses Seeds for git-native issue tracking.
At the start of every session, run:
sd prime
This injects session context: rules, command reference, and workflows.
Quick reference:
sd ready— Find unblocked worksd create --title "..." --type task --priority 2— Create issuesd update <id> --status in_progress— Claim worksd close <id>— Complete worksd sync— Sync with git (run before pushing)
Before You Finish
- Close completed issues:
sd close <id> - File issues for remaining work:
sd create --title "..." - Sync and push:
sd sync && git push
Prompt Management (Canopy)
This project uses Canopy for git-native prompt management.
At the start of every session, run:
cn prime
This injects prompt workflow context: commands, conventions, and common workflows.
Quick reference:
cn list— List all promptscn render <name>— View rendered prompt (resolves inheritance)cn emit --all— Render prompts to filescn update <name>— Update a prompt (creates new version)cn sync— Stage and commit .canopy/ changes
Do not manually edit emitted files. Use cn update to modify prompts, then cn emit to regenerate.