@mindfoldhq/trellis 0.5.0-beta.3 → 0.5.0-beta.5

package/dist/migrations/manifests/0.5.0-beta.5.json

@@ -0,0 +1,220 @@
+{
+  "version": "0.5.0-beta.5",
+  "description": "Sub-agent rename + remove model: opus from all agent templates. Prefixes implement/check/research with trellis- to prevent accidental invocation by user's own agents or the main agent's description heuristics. Drops hardcoded model: opus from agent frontmatter across all 10 platforms — this caused Cursor users real cost pain because Cursor mapped opus to Claude Opus (~5x Sonnet pricing).",
+  "breaking": true,
+  "recommendMigrate": true,
+  "changelog": "**Breaking Changes:**\n- rename(agents): `implement` / `check` / `research` sub-agents are now `trellis-implement` / `trellis-check` / `trellis-research` across all 10 platforms (claude, cursor, opencode, codex, kiro, gemini, qoder, codebuddy, copilot, droid). Generic names were colliding with user-defined agents and being matched by the main agent's description heuristics on some platforms. Prefixing with `trellis-` makes them unambiguously Trellis sub-agents. `workflow.md`, copilot start prompt, `shared-hooks/inject-subagent-context.py`, and configurator detection all updated to use the new names.\n\n**Bug Fixes:**\n- fix(agents): drop `model: opus` from all 18 markdown agent frontmatters + the example `Task()` calls in `copilot/prompts/start.prompt.md`. On Claude Code this merely hardcoded Opus for all sub-agent runs (ignoring user preference); on Cursor it actively mapped to Claude Opus billing at ~5x Sonnet cost and surprised users; on Gemini/Droid/Codebuddy/Qoder `opus` isn't even a valid model identifier. Agents now inherit whatever model the user configured for their platform.",
+  "migrations": [
+    {
+      "type": "rename",
+      "from": ".claude/agents/implement.md",
+      "to": ".claude/agents/trellis-implement.md",
+      "description": "v0.5.0-beta.5: prefix claude sub-agent with trellis- to prevent accidental invocation",
+      "reason": "Generic names like 'implement'/'check'/'research' can collide with the user's own agent definitions or get picked up by the main agent's description heuristics. Prefixing with 'trellis-' makes them explicit Trellis agents."
+    },
+    {
+      "type": "rename",
+      "from": ".claude/agents/check.md",
+      "to": ".claude/agents/trellis-check.md",
+      "description": "v0.5.0-beta.5: prefix claude sub-agent with trellis- to prevent accidental invocation",
+      "reason": "Generic names like 'implement'/'check'/'research' can collide with the user's own agent definitions or get picked up by the main agent's description heuristics. Prefixing with 'trellis-' makes them explicit Trellis agents."
+    },
+    {
+      "type": "rename",
+      "from": ".claude/agents/research.md",
+      "to": ".claude/agents/trellis-research.md",
+      "description": "v0.5.0-beta.5: prefix claude sub-agent with trellis- to prevent accidental invocation",
+      "reason": "Generic names like 'implement'/'check'/'research' can collide with the user's own agent definitions or get picked up by the main agent's description heuristics. Prefixing with 'trellis-' makes them explicit Trellis agents."
+    },
+    {
+      "type": "rename",
+      "from": ".cursor/agents/implement.md",
+      "to": ".cursor/agents/trellis-implement.md",
+      "description": "v0.5.0-beta.5: prefix cursor sub-agent with trellis- to prevent accidental invocation",
+      "reason": "Generic names like 'implement'/'check'/'research' can collide with the user's own agent definitions or get picked up by the main agent's description heuristics. Prefixing with 'trellis-' makes them explicit Trellis agents."
+    },
+    {
+      "type": "rename",
+      "from": ".cursor/agents/check.md",
+      "to": ".cursor/agents/trellis-check.md",
+      "description": "v0.5.0-beta.5: prefix cursor sub-agent with trellis- to prevent accidental invocation",
+      "reason": "Generic names like 'implement'/'check'/'research' can collide with the user's own agent definitions or get picked up by the main agent's description heuristics. Prefixing with 'trellis-' makes them explicit Trellis agents."
+    },
+    {
+      "type": "rename",
+      "from": ".cursor/agents/research.md",
+      "to": ".cursor/agents/trellis-research.md",
+      "description": "v0.5.0-beta.5: prefix cursor sub-agent with trellis- to prevent accidental invocation",
+      "reason": "Generic names like 'implement'/'check'/'research' can collide with the user's own agent definitions or get picked up by the main agent's description heuristics. Prefixing with 'trellis-' makes them explicit Trellis agents."
+    },
+    {
+      "type": "rename",
+      "from": ".opencode/agents/implement.md",
+      "to": ".opencode/agents/trellis-implement.md",
+      "description": "v0.5.0-beta.5: prefix opencode sub-agent with trellis- to prevent accidental invocation",
+      "reason": "Generic names like 'implement'/'check'/'research' can collide with the user's own agent definitions or get picked up by the main agent's description heuristics. Prefixing with 'trellis-' makes them explicit Trellis agents."
+    },
+    {
+      "type": "rename",
+      "from": ".opencode/agents/check.md",
+      "to": ".opencode/agents/trellis-check.md",
+      "description": "v0.5.0-beta.5: prefix opencode sub-agent with trellis- to prevent accidental invocation",
+      "reason": "Generic names like 'implement'/'check'/'research' can collide with the user's own agent definitions or get picked up by the main agent's description heuristics. Prefixing with 'trellis-' makes them explicit Trellis agents."
+    },
+    {
+      "type": "rename",
+      "from": ".opencode/agents/research.md",
+      "to": ".opencode/agents/trellis-research.md",
+      "description": "v0.5.0-beta.5: prefix opencode sub-agent with trellis- to prevent accidental invocation",
+      "reason": "Generic names like 'implement'/'check'/'research' can collide with the user's own agent definitions or get picked up by the main agent's description heuristics. Prefixing with 'trellis-' makes them explicit Trellis agents."
+    },
+    {
+      "type": "rename",
+      "from": ".codex/agents/implement.toml",
+      "to": ".codex/agents/trellis-implement.toml",
+      "description": "v0.5.0-beta.5: prefix codex sub-agent with trellis- to prevent accidental invocation",
+      "reason": "Generic names like 'implement'/'check'/'research' can collide with the user's own agent definitions or get picked up by the main agent's description heuristics. Prefixing with 'trellis-' makes them explicit Trellis agents."
+    },
+    {
+      "type": "rename",
+      "from": ".codex/agents/check.toml",
+      "to": ".codex/agents/trellis-check.toml",
+      "description": "v0.5.0-beta.5: prefix codex sub-agent with trellis- to prevent accidental invocation",
+      "reason": "Generic names like 'implement'/'check'/'research' can collide with the user's own agent definitions or get picked up by the main agent's description heuristics. Prefixing with 'trellis-' makes them explicit Trellis agents."
+    },
+    {
+      "type": "rename",
+      "from": ".codex/agents/research.toml",
+      "to": ".codex/agents/trellis-research.toml",
+      "description": "v0.5.0-beta.5: prefix codex sub-agent with trellis- to prevent accidental invocation",
+      "reason": "Generic names like 'implement'/'check'/'research' can collide with the user's own agent definitions or get picked up by the main agent's description heuristics. Prefixing with 'trellis-' makes them explicit Trellis agents."
+    },
+    {
+      "type": "rename",
+      "from": ".kiro/agents/implement.json",
+      "to": ".kiro/agents/trellis-implement.json",
+      "description": "v0.5.0-beta.5: prefix kiro sub-agent with trellis- to prevent accidental invocation",
+      "reason": "Generic names like 'implement'/'check'/'research' can collide with the user's own agent definitions or get picked up by the main agent's description heuristics. Prefixing with 'trellis-' makes them explicit Trellis agents."
+    },
+    {
+      "type": "rename",
+      "from": ".kiro/agents/check.json",
+      "to": ".kiro/agents/trellis-check.json",
+      "description": "v0.5.0-beta.5: prefix kiro sub-agent with trellis- to prevent accidental invocation",
+      "reason": "Generic names like 'implement'/'check'/'research' can collide with the user's own agent definitions or get picked up by the main agent's description heuristics. Prefixing with 'trellis-' makes them explicit Trellis agents."
+    },
+    {
+      "type": "rename",
+      "from": ".kiro/agents/research.json",
+      "to": ".kiro/agents/trellis-research.json",
+      "description": "v0.5.0-beta.5: prefix kiro sub-agent with trellis- to prevent accidental invocation",
+      "reason": "Generic names like 'implement'/'check'/'research' can collide with the user's own agent definitions or get picked up by the main agent's description heuristics. Prefixing with 'trellis-' makes them explicit Trellis agents."
+    },
+    {
+      "type": "rename",
+      "from": ".gemini/agents/implement.md",
+      "to": ".gemini/agents/trellis-implement.md",
+      "description": "v0.5.0-beta.5: prefix gemini sub-agent with trellis- to prevent accidental invocation",
+      "reason": "Generic names like 'implement'/'check'/'research' can collide with the user's own agent definitions or get picked up by the main agent's description heuristics. Prefixing with 'trellis-' makes them explicit Trellis agents."
+    },
+    {
+      "type": "rename",
+      "from": ".gemini/agents/check.md",
+      "to": ".gemini/agents/trellis-check.md",
+      "description": "v0.5.0-beta.5: prefix gemini sub-agent with trellis- to prevent accidental invocation",
+      "reason": "Generic names like 'implement'/'check'/'research' can collide with the user's own agent definitions or get picked up by the main agent's description heuristics. Prefixing with 'trellis-' makes them explicit Trellis agents."
+    },
+    {
+      "type": "rename",
+      "from": ".gemini/agents/research.md",
+      "to": ".gemini/agents/trellis-research.md",
+      "description": "v0.5.0-beta.5: prefix gemini sub-agent with trellis- to prevent accidental invocation",
+      "reason": "Generic names like 'implement'/'check'/'research' can collide with the user's own agent definitions or get picked up by the main agent's description heuristics. Prefixing with 'trellis-' makes them explicit Trellis agents."
+    },
+    {
+      "type": "rename",
+      "from": ".qoder/agents/implement.md",
+      "to": ".qoder/agents/trellis-implement.md",
+      "description": "v0.5.0-beta.5: prefix qoder sub-agent with trellis- to prevent accidental invocation",
+      "reason": "Generic names like 'implement'/'check'/'research' can collide with the user's own agent definitions or get picked up by the main agent's description heuristics. Prefixing with 'trellis-' makes them explicit Trellis agents."
+    },
+    {
+      "type": "rename",
+      "from": ".qoder/agents/check.md",
+      "to": ".qoder/agents/trellis-check.md",
+      "description": "v0.5.0-beta.5: prefix qoder sub-agent with trellis- to prevent accidental invocation",
+      "reason": "Generic names like 'implement'/'check'/'research' can collide with the user's own agent definitions or get picked up by the main agent's description heuristics. Prefixing with 'trellis-' makes them explicit Trellis agents."
+    },
+    {
+      "type": "rename",
+      "from": ".qoder/agents/research.md",
+      "to": ".qoder/agents/trellis-research.md",
+      "description": "v0.5.0-beta.5: prefix qoder sub-agent with trellis- to prevent accidental invocation",
+      "reason": "Generic names like 'implement'/'check'/'research' can collide with the user's own agent definitions or get picked up by the main agent's description heuristics. Prefixing with 'trellis-' makes them explicit Trellis agents."
+    },
+    {
+      "type": "rename",
+      "from": ".codebuddy/agents/implement.md",
+      "to": ".codebuddy/agents/trellis-implement.md",
+      "description": "v0.5.0-beta.5: prefix codebuddy sub-agent with trellis- to prevent accidental invocation",
+      "reason": "Generic names like 'implement'/'check'/'research' can collide with the user's own agent definitions or get picked up by the main agent's description heuristics. Prefixing with 'trellis-' makes them explicit Trellis agents."
+    },
+    {
+      "type": "rename",
+      "from": ".codebuddy/agents/check.md",
+      "to": ".codebuddy/agents/trellis-check.md",
+      "description": "v0.5.0-beta.5: prefix codebuddy sub-agent with trellis- to prevent accidental invocation",
+      "reason": "Generic names like 'implement'/'check'/'research' can collide with the user's own agent definitions or get picked up by the main agent's description heuristics. Prefixing with 'trellis-' makes them explicit Trellis agents."
+    },
+    {
+      "type": "rename",
+      "from": ".codebuddy/agents/research.md",
+      "to": ".codebuddy/agents/trellis-research.md",
+      "description": "v0.5.0-beta.5: prefix codebuddy sub-agent with trellis- to prevent accidental invocation",
+      "reason": "Generic names like 'implement'/'check'/'research' can collide with the user's own agent definitions or get picked up by the main agent's description heuristics. Prefixing with 'trellis-' makes them explicit Trellis agents."
+    },
+    {
+      "type": "rename",
+      "from": ".github/agents/implement.agent.md",
+      "to": ".github/agents/trellis-implement.agent.md",
+      "description": "v0.5.0-beta.5: prefix copilot sub-agent with trellis- to prevent accidental invocation",
+      "reason": "Generic names like 'implement'/'check'/'research' can collide with the user's own agent definitions or get picked up by the main agent's description heuristics. Prefixing with 'trellis-' makes them explicit Trellis agents."
+    },
+    {
+      "type": "rename",
+      "from": ".github/agents/check.agent.md",
+      "to": ".github/agents/trellis-check.agent.md",
+      "description": "v0.5.0-beta.5: prefix copilot sub-agent with trellis- to prevent accidental invocation",
+      "reason": "Generic names like 'implement'/'check'/'research' can collide with the user's own agent definitions or get picked up by the main agent's description heuristics. Prefixing with 'trellis-' makes them explicit Trellis agents."
+    },
+    {
+      "type": "rename",
+      "from": ".github/agents/research.agent.md",
+      "to": ".github/agents/trellis-research.agent.md",
+      "description": "v0.5.0-beta.5: prefix copilot sub-agent with trellis- to prevent accidental invocation",
+      "reason": "Generic names like 'implement'/'check'/'research' can collide with the user's own agent definitions or get picked up by the main agent's description heuristics. Prefixing with 'trellis-' makes them explicit Trellis agents."
+    },
+    {
+      "type": "rename",
+      "from": ".factory/droids/implement.md",
+      "to": ".factory/droids/trellis-implement.md",
+      "description": "v0.5.0-beta.5: prefix droid sub-agent with trellis- to prevent accidental invocation",
+      "reason": "Generic names like 'implement'/'check'/'research' can collide with the user's own agent definitions or get picked up by the main agent's description heuristics. Prefixing with 'trellis-' makes them explicit Trellis agents."
+    },
+    {
+      "type": "rename",
+      "from": ".factory/droids/check.md",
+      "to": ".factory/droids/trellis-check.md",
+      "description": "v0.5.0-beta.5: prefix droid sub-agent with trellis- to prevent accidental invocation",
+      "reason": "Generic names like 'implement'/'check'/'research' can collide with the user's own agent definitions or get picked up by the main agent's description heuristics. Prefixing with 'trellis-' makes them explicit Trellis agents."
+    },
+    {
+      "type": "rename",
+      "from": ".factory/droids/research.md",
+      "to": ".factory/droids/trellis-research.md",
+      "description": "v0.5.0-beta.5: prefix droid sub-agent with trellis- to prevent accidental invocation",
+      "reason": "Generic names like 'implement'/'check'/'research' can collide with the user's own agent definitions or get picked up by the main agent's description heuristics. Prefixing with 'trellis-' makes them explicit Trellis agents."
+    }
+  ],
+  "notes": "This is a breaking rename for sub-agent invocation. The migration is automatic for unmodified agent files (hash-matched via .trellis/.template-hashes.json). If you customized an agent, you'll see the usual `Modified by you` confirm prompt with diff — pick `[1] Overwrite` to adopt the new name, or `[3] Skip` if you've built your own workflow on the old names (in which case you must update `workflow.md`, any skill prompts, and hook constants yourself).\n\n`update.skip` is BYPASSED for this release (breaking + recommendMigrate both true, invoked with `--migrate`) to prevent a half-migrated state where workflow.md points to `trellis-implement` but your `.claude/agents/` still has `implement.md`.\n\nAction required: run `trellis update --migrate`."
+}

package/dist/templates/claude/agents/{check.md → trellis-check.md}

@@ -1,9 +1,8 @@
 ---
-name: check
+name: trellis-check
 description: |
   Code quality check expert. Reviews code changes against specs and self-fixes issues.
 tools: Read, Write, Edit, Bash, Glob, Grep, mcp__exa__web_search_exa, mcp__exa__get_code_context_exa
-model: opus
 ---
 # Check Agent
 

package/dist/templates/{cursor/agents/implement.md → claude/agents/trellis-implement.md}

@@ -1,9 +1,8 @@
 ---
-name: implement
+name: trellis-implement
 description: |
   Code implementation expert. Understands specs and requirements, then implements features. No git commit allowed.
 tools: Read, Write, Edit, Bash, Glob, Grep, mcp__exa__web_search_exa, mcp__exa__get_code_context_exa
-model: opus
 ---
 # Implement Agent
 

package/dist/templates/{cursor/agents/research.md → claude/agents/trellis-research.md}

@@ -1,9 +1,8 @@
 ---
-name: research
+name: trellis-research
 description: |
   Code and tech search expert. Finds files, patterns, and tech solutions, and PERSISTS every finding to the current task's research/ directory. No code modifications outside that directory.
 tools: Read, Write, Glob, Grep, Bash, mcp__exa__web_search_exa, mcp__exa__get_code_context_exa, Skill, mcp__chrome-devtools__*
-model: opus
 ---
 # Research Agent
 

package/dist/templates/{cursor/agents/check.md → codebuddy/agents/trellis-check.md}

@@ -1,9 +1,8 @@
 ---
-name: check
+name: trellis-check
 description: |
   Code quality check expert. Reviews code changes against specs and self-fixes issues.
 tools: Read, Write, Edit, Bash, Glob, Grep, mcp__exa__web_search_exa, mcp__exa__get_code_context_exa
-model: opus
 ---
 # Check Agent
 

package/dist/templates/{claude/agents/implement.md → codebuddy/agents/trellis-implement.md}

@@ -1,9 +1,8 @@
 ---
-name: implement
+name: trellis-implement
 description: |
   Code implementation expert. Understands specs and requirements, then implements features. No git commit allowed.
 tools: Read, Write, Edit, Bash, Glob, Grep, mcp__exa__web_search_exa, mcp__exa__get_code_context_exa
-model: opus
 ---
 # Implement Agent
 

package/dist/templates/{droid/droids/research.md → codebuddy/agents/trellis-research.md}

@@ -1,9 +1,8 @@
 ---
-name: research
+name: trellis-research
 description: |
   Code and tech search expert. Finds files, patterns, and tech solutions, and PERSISTS every finding to the current task's research/ directory. No code modifications outside that directory.
 tools: Read, Write, Glob, Grep, Bash, mcp__exa__web_search_exa, mcp__exa__get_code_context_exa, Skill, mcp__chrome-devtools__*
-model: opus
 ---
 # Research Agent
 

package/dist/templates/codex/agents/{check.toml → trellis-check.toml}

@@ -1,4 +1,4 @@
-name = "check"
+name = "trellis-check"
 description = "Read-only Trellis reviewer focused on correctness, missing tests, and spec drift."
 sandbox_mode = "read-only"
 

package/dist/templates/codex/agents/{implement.toml → trellis-implement.toml}

@@ -1,4 +1,4 @@
-name = "implement"
+name = "trellis-implement"
 description = "Workspace-write Trellis implementer that follows specs and keeps generated templates in sync."
 sandbox_mode = "workspace-write"
 

package/dist/templates/codex/agents/{research.toml → trellis-research.toml}

@@ -1,4 +1,4 @@
-name = "research"
+name = "trellis-research"
 description = "Trellis researcher for specs, code patterns, and affected files. Writes findings into {TASK_DIR}/research/ — read-only elsewhere."
 sandbox_mode = "workspace-write"
 

package/dist/templates/copilot/prompts/start.prompt.md

@@ -54,7 +54,7 @@ cat .trellis/spec/<package>/<layer>/index.md   # Package-specific guidelines
 cat .trellis/spec/guides/index.md              # Thinking guides (always read)
 ```
 
-> **Important**: The index files are navigation �?they list the actual guideline files (e.g., `error-handling.md`, `conventions.md`, `mock-strategies.md`).
+> **Important**: The index files are navigation �?they list the actual guideline files (e.g., `error-handling.md`, `conventions.md`, `mock-strategies.md`).
 > At this step, just read the indexes to understand what's available.
 > When you start actual development, you MUST go back and read the specific guideline files relevant to your task, as listed in the index's Pre-Development Checklist.
 
@@ -72,8 +72,8 @@ When user describes a task, classify it:
 |------|----------|----------|
 | **Question** | User asks about code, architecture, or how something works | Answer directly |
 | **Trivial Fix** | Typo fix, comment update, single-line change | Direct Edit |
-| **Simple Task** | Clear goal, 1-2 files, well-defined scope | Quick confirm �?Implement |
-| **Complex Task** | Vague goal, multiple files, architectural decisions | **Brainstorm �?Task Workflow** |
+| **Simple Task** | Clear goal, 1-2 files, well-defined scope | Quick confirm �?Implement |
+| **Complex Task** | Vague goal, multiple files, architectural decisions | **Brainstorm �?Task Workflow** |
 
 ### Classification Signals
 
@@ -128,7 +128,7 @@ For simple, well-defined tasks:
 
 ## Complex Task - Brainstorm First
 
-For complex or vague tasks, **automatically start the brainstorm process** �?do NOT skip directly to implementation.
+For complex or vague tasks, **automatically start the brainstorm process** �?do NOT skip directly to implementation.
 
 See `/` for the full process. Summary:
 
@@ -167,10 +167,10 @@ See `/` for the full process. Summary:
 
 ```
 From Brainstorm (Complex Task):
-  PRD confirmed �?Research �?Configure Context �?Activate �?Implement �?Check �?Complete
+  PRD confirmed �?Research �?Configure Context �?Activate �?Implement �?Check �?Complete
 
 From Simple Task:
-  Confirm �?Create Task �?Write PRD �?Research �?Configure Context �?Activate �?Implement �?Check �?Complete
+  Confirm �?Create Task �?Write PRD �?Research �?Configure Context �?Activate �?Implement �?Check �?Complete
 ```
 
 **Key principle: Research happens AFTER requirements are clear (PRD exists).**
@@ -248,7 +248,7 @@ Based on the confirmed PRD, call Research Agent to find relevant specs and patte
 
 ```
 Task(
-  subagent_type: "research",
+  subagent_type: "trellis-research",
   prompt: "Analyze the codebase for this task:
 
   Task: <goal from PRD>
@@ -267,8 +267,7 @@ Task(
   - <pattern>: <example file path>
 
   ## Files to Modify
-  - <path>: <what change>",
-  model: "opus"
+  - <path>: <what change>"
 )
 ```
 
@@ -307,12 +306,11 @@ Call Implement Agent (code-spec context is auto-injected by hook):
 
 ```
 Task(
-  subagent_type: "implement",
+  subagent_type: "trellis-implement",
   prompt: "Implement the task described in prd.md.
 
   Follow all code-spec files that have been injected into your context.
-  Run lint and typecheck before finishing.",
-  model: "opus"
+  Run lint and typecheck before finishing."
 )
 ```
 
@@ -322,12 +320,11 @@ Call Check Agent (code-spec context is auto-injected by hook):
 
 ```
 Task(
-  subagent_type: "check",
+  subagent_type: "trellis-check",
   prompt: "Review all code changes against the code-spec requirements.
 
   Fix any issues you find directly.
-  Ensure lint and typecheck pass.",
-  model: "opus"
+  Ensure lint and typecheck pass."
 )
 ```
 

package/dist/templates/{droid/droids/check.md → cursor/agents/trellis-check.md}

@@ -1,9 +1,8 @@
 ---
-name: check
+name: trellis-check
 description: |
   Code quality check expert. Reviews code changes against specs and self-fixes issues.
 tools: Read, Write, Edit, Bash, Glob, Grep, mcp__exa__web_search_exa, mcp__exa__get_code_context_exa
-model: opus
 ---
 # Check Agent
 

package/dist/templates/{codebuddy/agents/implement.md → cursor/agents/trellis-implement.md}

@@ -1,9 +1,8 @@
 ---
-name: implement
+name: trellis-implement
 description: |
   Code implementation expert. Understands specs and requirements, then implements features. No git commit allowed.
 tools: Read, Write, Edit, Bash, Glob, Grep, mcp__exa__web_search_exa, mcp__exa__get_code_context_exa
-model: opus
 ---
 # Implement Agent
 

package/dist/templates/{claude/agents/research.md → cursor/agents/trellis-research.md}

@@ -1,9 +1,8 @@
 ---
-name: research
+name: trellis-research
 description: |
   Code and tech search expert. Finds files, patterns, and tech solutions, and PERSISTS every finding to the current task's research/ directory. No code modifications outside that directory.
 tools: Read, Write, Glob, Grep, Bash, mcp__exa__web_search_exa, mcp__exa__get_code_context_exa, Skill, mcp__chrome-devtools__*
-model: opus
 ---
 # Research Agent
 

package/dist/templates/{codebuddy/agents/check.md → droid/droids/trellis-check.md}

@@ -1,9 +1,8 @@
 ---
-name: check
+name: trellis-check
 description: |
   Code quality check expert. Reviews code changes against specs and self-fixes issues.
 tools: Read, Write, Edit, Bash, Glob, Grep, mcp__exa__web_search_exa, mcp__exa__get_code_context_exa
-model: opus
 ---
 # Check Agent
 

package/dist/templates/droid/droids/{implement.md → trellis-implement.md}

@@ -1,9 +1,8 @@
 ---
-name: implement
+name: trellis-implement
 description: |
   Code implementation expert. Understands specs and requirements, then implements features. No git commit allowed.
 tools: Read, Write, Edit, Bash, Glob, Grep, mcp__exa__web_search_exa, mcp__exa__get_code_context_exa
-model: opus
 ---
 # Implement Agent
 

package/dist/templates/{codebuddy/agents/research.md → droid/droids/trellis-research.md}

@@ -1,9 +1,8 @@
 ---
-name: research
+name: trellis-research
 description: |
   Code and tech search expert. Finds files, patterns, and tech solutions, and PERSISTS every finding to the current task's research/ directory. No code modifications outside that directory.
 tools: Read, Write, Glob, Grep, Bash, mcp__exa__web_search_exa, mcp__exa__get_code_context_exa, Skill, mcp__chrome-devtools__*
-model: opus
 ---
 # Research Agent
 

package/dist/templates/gemini/agents/trellis-check.md

@@ -0,0 +1,94 @@
+---
+name: trellis-check
+description: |
+  Code quality check expert. Reviews code changes against specs and self-fixes issues.
+tools: Read, Write, Edit, Bash, Glob, Grep, mcp__exa__web_search_exa, mcp__exa__get_code_context_exa
+---
+# Check Agent
+
+You are the Check Agent in the Trellis workflow.
+
+## Context
+
+Before checking, read:
+- `.trellis/spec/` - Development guidelines
+- Pre-commit checklist for quality standards
+
+## Core Responsibilities
+
+1. **Get code changes** - Use git diff to get uncommitted code
+2. **Check against specs** - Verify code follows guidelines
+3. **Self-fix** - Fix issues yourself, not just report them
+4. **Run verification** - typecheck and lint
+
+## Important
+
+**Fix issues yourself**, don't just report them.
+
+You have write and edit tools, you can modify code directly.
+
+---
+
+## Workflow
+
+### Step 1: Get Changes
+
+```bash
+git diff --name-only  # List changed files
+git diff              # View specific changes
+```
+
+### Step 2: Check Against Specs
+
+Read relevant specs in `.trellis/spec/` to check code:
+
+- Does it follow directory structure conventions
+- Does it follow naming conventions
+- Does it follow code patterns
+- Are there missing types
+- Are there potential bugs
+
+### Step 3: Self-Fix
+
+After finding issues:
+
+1. Fix the issue directly (use edit tool)
+2. Record what was fixed
+3. Continue checking other issues
+
+### Step 4: Run Verification
+
+Run project's lint and typecheck commands to verify changes.
+
+If failed, fix issues and re-run.
+
+---
+
+## Report Format
+
+```markdown
+## Self-Check Complete
+
+### Files Checked
+
+- src/components/Feature.tsx
+- src/hooks/useFeature.ts
+
+### Issues Found and Fixed
+
+1. `<file>:<line>` - <what was fixed>
+2. `<file>:<line>` - <what was fixed>
+
+### Issues Not Fixed
+
+(If there are issues that cannot be self-fixed, list them here with reasons)
+
+### Verification Results
+
+- TypeCheck: Passed
+- Lint: Passed
+
+### Summary
+
+Checked X files, found Y issues, all fixed.
+```