@os-eco/overstory-cli 0.6.1

package/templates/overlay.md.tmpl

@@ -0,0 +1,81 @@
+# DO NOT EDIT — Auto-generated by overstory
+# This overlay was written by `overstory sling`. Manual edits will be
+# overwritten on the next spawn. Modify the template at
+# templates/overlay.md.tmpl in the overstory repo instead.
+
+{{BASE_DEFINITION}}
+
+---
+
+## Your Assignment
+
+- **Agent Name:** {{AGENT_NAME}}
+- **Task ID:** {{BEAD_ID}}
+- **Spec:** {{SPEC_PATH}}
+- **Branch:** {{BRANCH_NAME}}
+- **Worktree:** {{WORKTREE_PATH}}
+- **Parent:** {{PARENT_AGENT}}
+- **Depth:** {{DEPTH}}
+
+{{SPEC_INSTRUCTION}}
+
+{{SKIP_SCOUT}}
+
+## Working Directory
+
+Your worktree root is: `{{WORKTREE_PATH}}`
+
+**CRITICAL**: All file operations MUST use paths within this directory.
+- Use paths relative to your worktree root, or absolute paths starting with `{{WORKTREE_PATH}}`
+- Writing to the canonical repo root instead of your worktree is a critical error (PATH_BOUNDARY_VIOLATION)
+- You may READ files from the canonical repo for context, but all WRITES go to your worktree
+
+## File Scope (exclusive ownership)
+
+These paths are relative to your worktree root: `{{WORKTREE_PATH}}`
+
+You may ONLY modify the files listed below within your worktree. Do not touch any other files.
+If you need changes outside your scope, send mail to your parent agent
+requesting the modification.
+
+{{FILE_SCOPE}}
+
+## Expertise
+
+Prime relevant domain knowledge before starting work:
+
+{{MULCH_DOMAINS}}
+
+{{MULCH_EXPERTISE}}
+
+## Communication
+
+Use `overstory mail` for all communication. Your address is **{{AGENT_NAME}}**.
+
+```bash
+# Check your inbox (do this regularly)
+overstory mail check --agent {{AGENT_NAME}}
+
+# Send a status update to your parent
+overstory mail send --to {{PARENT_AGENT}} --subject "status" \
+  --body "Progress update here" --type status --agent {{AGENT_NAME}}
+
+# Ask a question
+overstory mail send --to {{PARENT_AGENT}} --subject "question" \
+  --body "Your question here" --type question --priority high --agent {{AGENT_NAME}}
+
+# Report completion
+overstory mail send --to {{PARENT_AGENT}} --subject "done" \
+  --body "Summary of what was done" --type result --agent {{AGENT_NAME}}
+
+# Reply to a message
+overstory mail reply <message-id> --body "Your reply" --agent {{AGENT_NAME}}
+```
+
+## Spawning Sub-Workers
+
+{{CAN_SPAWN}}
+
+{{QUALITY_GATES}}
+
+{{CONSTRAINTS}}