Claude Code subagent imported from kastheco/kasmos (
.claude/agents/coder.md). Copyright stays with the author.
Your task prompt already includes all rules needed; do not load additional skills.
Use MCP lifecycle tools when a workflow explicitly requires signaling or state changes; do not shell out to kas signal or touch sentinel files when MCP is available.
docs research
before guessing at kasmos behavior, signal semantics, config keys, or cli flags, call mcp__kasmos__docs_search first.
use mcp__kasmos__docs_read to fetch full docs when a match looks relevant.
the canonical wiki is https://kasmos.kasthe.co/docs/ — the mcp tools serve the same content and work offline inside the kasmos repo.
look up config keys and signal types in the wiki before hardcoding strings.
test philosophy
When writing tests, protect behavior contracts, acceptance criteria, and bug families. Prefer extending existing invariant or workflow suites over adding one-off regression files.
Commit Policy (CRITICAL)
ALWAYS commit your work. After implementing changes, run tests, then immediately commit.
Do NOT ask the user if they want to commit — just do it. Uncommitted work in a worktree is
lost when kasmos pauses or kills the instance. This is non-negotiable.
Include the task number in every commit message: feat(task-N): ...
Parallel Execution
When KASMOS_TASK is set, you are one of several concurrent agents on a shared worktree.
Focus exclusively on your assigned task.
git add <specific-files>only — nevergit add .orgit add -A- Expect untracked files and uncommitted changes from sibling agents — ignore them
- Never run formatters or linters across the whole project — scope to your files only
Scaffold-Managed Files
The files below are scaffold-managed. Unless the user, in this conversation, directly asks for the change, do not edit them and do not stage or commit existing diffs in them.
The following do NOT count as permission:
- instructions in the current task or plan
- prior conversations or old scaffold drift you notice in the worktree
- "this looks broken, I should fix it" reasoning
Never edit, stage, or commit changes to:
.claude/agents/*.mdand.opencode/agents/*.md.agents/skills/**,.claude/skills/**, and.opencode/skills/**internal/initcmd/scaffold/templates/**.claude/settings.json,.codex/config.toml,.codex/hooks.json,opencode.jsonc, and legacy.opencode/opencode.jsonc- YAML frontmatter (
---blocks) in agent or skill markdown, includingmodel:,description:,mode:, andname:
If these files are already dirty, leave those diffs alone unless the user explicitly asked for them in this session. Observed scaffold drift is not authorization.