@jahanxu/trellis 0.4.1

package/dist/migrations/manifests/0.3.0-beta.2.json

@@ -0,0 +1,9 @@
+{
+  "version": "0.3.0-beta.2",
+  "description": "Windows compatibility fixes",
+  "breaking": false,
+  "recommendMigrate": false,
+  "changelog": "**Bug Fixes:**\n- fix(templates): use python3 consistently for Windows compatibility\n- fix(update): move breaking change warnings to bottom of output\n\n**Docs:**\n- Add cross-platform thinking guide",
+  "migrations": [],
+  "notes": "No migration required."
+}

package/dist/migrations/manifests/0.3.0-beta.3.json

@@ -0,0 +1,9 @@
+{
+  "version": "0.3.0-beta.3",
+  "description": "Breaking change warning and docs update",
+  "breaking": false,
+  "recommendMigrate": false,
+  "changelog": "**Bug Fixes:**\n- fix(update): show breaking change warning before confirm prompt\n\n**Docs:**\n- Update backend specs for shell-to-python migration",
+  "migrations": [],
+  "notes": "No migration required."
+}

package/dist/migrations/manifests/0.3.0-beta.4.json

@@ -0,0 +1,9 @@
+{
+  "version": "0.3.0-beta.4",
+  "description": "Version bump only",
+  "breaking": false,
+  "recommendMigrate": false,
+  "changelog": "Version bump release.",
+  "migrations": [],
+  "notes": "No migration required."
+}

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

@@ -0,0 +1,9 @@
+{
+  "version": "0.3.0-beta.5",
+  "description": "Semver prerelease version handling fix",
+  "breaking": false,
+  "recommendMigrate": false,
+  "changelog": "**Bug Fixes:**\n- fix(update): handle prerelease versions in semver comparison",
+  "migrations": [],
+  "notes": "No migration required."
+}

package/dist/migrations/manifests/0.3.0-beta.6.json

@@ -0,0 +1,9 @@
+{
+  "version": "0.3.0-beta.6",
+  "description": "Init conflict handling & trellis-meta skill",
+  "breaking": false,
+  "recommendMigrate": false,
+  "changelog": "**Features:**\n- feat(skill): add trellis-meta skill documenting Trellis system\n\n**Bug Fixes:**\n- fix(init): use writeFile for all file copies to allow user choice on conflicts",
+  "migrations": [],
+  "notes": "No migration required."
+}

package/dist/migrations/manifests/0.3.0-beta.7.json

@@ -0,0 +1,11 @@
+{
+  "version": "0.3.0-beta.7",
+  "description": "Windows compatibility fixes and hook JSON format corrections",
+  "breaking": false,
+  "recommendMigrate": true,
+  "changelog": "Fixes for Windows compatibility (Issue #19) and Claude Code hook JSON format (Issue #18). Hook commands now use `python3` directly. Windows users may need to manually update `.claude/settings.json` if `python3` is not available on their system.",
+  "migrationGuide": "# Migration Guide: v0.3.0-beta.7 Windows Compatibility\n\n## Overview\n\nThis release fixes Windows compatibility issues and corrects the Claude Code hook JSON output format.\n\n## What Changed\n\n### Hook JSON Format (Issue #18)\n\nSessionStart hooks now output the correct JSON format expected by Claude Code:\n\n```json\n{\n  \"hookSpecificOutput\": {\n    \"hookEventName\": \"SessionStart\",\n    \"additionalContext\": \"...\"\n  }\n}\n```\n\n### UTF-8 Encoding (Issue #19)\n\n- Git commands now force UTF-8 output encoding\n- Python subprocess calls use `encoding=\"utf-8\"` and `errors=\"replace\"`\n- Cross-platform `tail_follow()` implementation in status.py\n\n### Hook Command Change\n\nHook commands in `.claude/settings.json` now use `python3` directly:\n\n```json\n\"command\": \"python3 .claude/hooks/session-start.py\"\n```\n\n## Windows Users: Manual Step Required\n\nIf your Windows system uses `python` instead of `python3`, you need to manually update `.claude/settings.json`:\n\n1. Open `.claude/settings.json`\n2. Find all `\"command\": \"python3 ...\"` entries\n3. Change `python3` to `python` if needed\n\nExample:\n```json\n// Before (if python3 not available)\n\"command\": \"python3 .claude/hooks/session-start.py\"\n\n// After\n\"command\": \"python .claude/hooks/session-start.py\"\n```\n\n## Affected Files\n\n- `.claude/settings.json` - Hook commands updated\n- `.claude/hooks/session-start.py` - JSON format fixed\n- `.trellis/scripts/common/git_context.py` - UTF-8 encoding\n- `.trellis/scripts/multi_agent/status.py` - Cross-platform tail\n- Other scripts - UTF-8 encoding fixes",
+  "aiInstructions": "1. Update `.claude/settings.json` hook commands to use `python3`\n2. If user reports Python not found on Windows, guide them to change `python3` to `python` in settings.json\n3. Verify hook scripts output correct JSON format\n4. Check that git commands work with non-ASCII characters",
+  "migrations": [],
+  "notes": "This is a compatibility fix release. No file migrations required. Windows users using `python` instead of `python3` should manually update their `.claude/settings.json` file."
+}

package/dist/migrations/manifests/0.3.0-beta.8.json

@@ -0,0 +1,9 @@
+{
+  "version": "0.3.0-beta.8",
+  "description": "Task commands now support task name lookup",
+  "breaking": false,
+  "recommendMigrate": false,
+  "changelog": "All task commands (start, init-context, set-branch, etc.) now support task name in addition to full path. Example: `python3 task.py start my-task` instead of `python3 task.py start .trellis/tasks/01-31-my-task`.",
+  "migrations": [],
+  "notes": "Usability improvement. No migration required."
+}

package/dist/migrations/manifests/0.3.0-beta.9.json

@@ -0,0 +1,9 @@
+{
+  "version": "0.3.0-beta.9",
+  "description": "OpenCode platform support",
+  "breaking": false,
+  "recommendMigrate": false,
+  "changelog": "Added OpenCode platform support:\n\n**New Features:**\n- `trellis init --opencode` - Initialize project for OpenCode\n- `--platform opencode` flag for plan.py, start.py\n- Complete `.opencode/` templates (agents, commands, plugins)\n- Session ID extraction and resume for OpenCode (`ses_xxx` format)\n- CLI adapter abstraction (`cli_adapter.py`)\n\n**Changes:**\n- Agent definitions use `permission:` format instead of deprecated `tools:`\n- Agents no longer hardcode `model:` field, inherit from user's global config\n- `status.py` outputs platform-specific resume commands\n\n**OpenCode Usage:**\n```bash\n# Initialize\ntrellis init --opencode\n\n# Multi-agent with OpenCode\npython3 .trellis/scripts/multi_agent/plan.py --platform opencode ...\npython3 .trellis/scripts/multi_agent/start.py --platform opencode ...\n```\n\n**Note:** Full subagent context injection requires oh-my-opencode (omo). Without omo, agents use Self-Loading fallback.",
+  "migrations": [],
+  "notes": "New platform support. No migration required for existing Claude Code users."
+}

package/dist/migrations/manifests/0.3.0-rc.0.json

@@ -0,0 +1,9 @@
+{
+  "version": "0.3.0-rc.0",
+  "description": "Registry refactor, bug fixes, test coverage, release tooling",
+  "breaking": false,
+  "recommendMigrate": false,
+  "changelog": "**New Features:**\n- feat(init): support remote spec templates from docs repo\n- feat(scripts): create-manifest.js supports beta/rc/release workflows\n- feat(scripts): add release:rc script to package.json\n\n**Bug Fixes:**\n- fix: template placeholder roundtrip — collectTemplates settings now resolve {{PYTHON_CMD}} correctly\n- fix: remove stale cross-platform-thinking-guide.md reference from update command\n- fix: tool flags (--claude etc.) now take precedence over -y default\n- fix: Windows python3 command compatibility ({{PYTHON_CMD}} placeholder)\n\n**Refactor:**\n- refactor: centralized platform registry pattern (replaces scattered init/update logic)\n- refactor: extract resolvePlaceholders to shared.ts, remove templates.ts dispatcher\n- refactor: simplify tool selection with data-driven approach\n- refactor: extract VERSION constant to src/constants/version.ts\n\n**Testing:**\n- 312 tests across 17 files (unit, integration, regression)\n- @vitest/coverage-v8 with pnpm test:coverage\n\n**Documentation:**\n- docs: add .trellis/spec/unit-test/ conventions (4 files)\n- docs: update platform-integration.md with registry pattern, known gaps, CliFlag type\n- docs: integrate test guidance into workflow commands (start, check-backend, finish-work)",
+  "migrations": [],
+  "notes": "No migration required. First release candidate — feature complete, stabilization phase."
+}

package/dist/migrations/manifests/0.3.0-rc.1.json

@@ -0,0 +1,9 @@
+{
+  "version": "0.3.0-rc.1",
+  "description": "Fix CLI version comparison for prerelease versions",
+  "breaking": false,
+  "recommendMigrate": false,
+  "changelog": "**Bug Fixes:**\n- fix: CLI startup incorrectly reports rc version as older than beta (e.g., 0.3.0-rc.0 < 0.3.0-beta.16)\n- fix: deduplicate compareVersions — extract to shared utils/compare-versions.ts (was duplicated 3x with inconsistent implementations)\n\n**Root Cause:**\n- cli/index.ts used a simplified compareVersions that ignored prerelease identifiers, parsing \"0.3.0-rc.0\" as [0, 3, 0, 0] and \"0.3.0-beta.16\" as [0, 3, 0, 16], concluding rc < beta\n- commands/update.ts and migrations/index.ts had the correct full implementation but it was not shared",
+  "migrations": [],
+  "notes": "No migration required. Hotfix for version comparison bug introduced in rc.0."
+}

package/dist/migrations/manifests/0.3.0-rc.2.json

@@ -0,0 +1,9 @@
+{
+  "version": "0.3.0-rc.2",
+  "description": "Codex platform integration and test/doc alignment",
+  "breaking": false,
+  "recommendMigrate": false,
+  "changelog": "**New Features:**\n- feat(platform): add Codex as a first-class platform in AI tool registry (types, CLI flag, init options, configurator dispatch)\n- feat(templates): add Codex skill templates under `src/templates/codex/skills/*/SKILL.md`\n- feat(configurator): add `configureCodex()` and template collection mapping to `.agents/skills/<name>/SKILL.md`\n- feat(runtime): extend Python `cli_adapter.py` / `registry.py` to support Codex detection and command path mapping\n\n**Testing:**\n- test(codex): add focused coverage for Codex template loading, init behavior, managed path detection, platform configurator output, and regression checks\n- test: full suite passing (`pnpm lint`, `pnpm typecheck`, `pnpm test`, `pnpm test:coverage`)\n\n**Documentation & Workflow:**\n- docs(workflow): add `improve-ut` skill/command to standardize UT planning and reporting\n- docs(spec): update backend platform integration guidance for Codex scope and common pitfalls",
+  "migrations": [],
+  "notes": "No migration required. Existing projects can adopt Codex via re-init/update workflows; no file rename/delete migration is needed."
+}

package/dist/migrations/manifests/0.3.0-rc.3.json

@@ -0,0 +1,9 @@
+{
+  "version": "0.3.0-rc.3",
+  "description": "Code-spec enforcement, codex skill fixes, and add_session robustness",
+  "breaking": false,
+  "recommendMigrate": false,
+  "changelog": "**Bug Fixes:**\n- fix(templates): tolerate formatted markdown in add_session.py table separator matching — `startswith(\"|---\")` replaced with `re.match(r\"^\\|\\s*-\", line)` to handle formatters adding spaces\n- fix(codex): replace `/trellis:xxx` with `$xxx` syntax in codex skill templates (finish-work, update-spec, start)\n- fix(codex): remove Claude Code-specific `Task()`, `subagent_type`, `model: \"opus\"` references from codex start skill\n\n**Enhancements:**\n- feat(codex): add codex platform support to local cli_adapter.py (config dir, detect, command path)\n- docs(code-spec): enforce executable spec requirements — add Step 1.5 Code-Spec Depth Requirement to start, Section 2.5 Hard Block to finish-work, 7-section structure to update-spec\n- docs(templates): sync code-spec requirements to all 5 platform command templates\n\n**Testing:**\n- test(regression): add [rc.2] regression test for add_session.py table separator fix",
+  "migrations": [],
+  "notes": "No migration required. Fixes and enhancements are template-level only."
+}

package/dist/migrations/manifests/0.3.0-rc.4.json

@@ -0,0 +1,9 @@
+{
+  "version": "0.3.0-rc.4",
+  "description": "Active spec sync in finish agent and codex skill template fixes",
+  "breaking": false,
+  "recommendMigrate": false,
+  "changelog": "**Enhancements:**\n- feat(templates): finish agent now actively syncs spec docs during pipeline runs — injects `update-spec.md` into finish context across all pipeline platforms (claude/iflow/opencode), rewrites finish workflow from passive verification to active spec sync that detects new patterns/contracts and updates spec files before confirming PR readiness\n\n**Documentation:**\n- docs(templates): update dispatch.md across claude/iflow/opencode to document the new finish-phase spec injection (update-spec.md + finish-work.md + prd.md)\n- docs(templates): update finish-work.md block rule — pipeline platforms note automatic spec sync by finish agent, non-pipeline platforms (cursor/codex) retain manual-first wording\n- docs(codex): restore code-spec enforcement sections (Section 2.5 Hard Block) in codex skill templates that were missing from initial codex integration",
+  "migrations": [],
+  "notes": "No migration required. Template-level changes only — run `trellis update` to sync."
+}

package/dist/migrations/manifests/0.3.0-rc.5.json

@@ -0,0 +1,9 @@
+{
+  "version": "0.3.0-rc.5",
+  "description": "Brainstorm templates for all platforms",
+  "breaking": false,
+  "recommendMigrate": false,
+  "changelog": "**Enhancements:**\n- feat(templates): add brainstorm command to all 5 platform templates (claude/iflow/opencode/cursor/codex) with platform-specific command syntax — previously only existed in deployed dirs, never generated by `trellis init/update`\n\n**Documentation:**\n- docs(templates): add brainstorm references to start commands across iflow/opencode/cursor/codex — adds Complex Task classification, brainstorm-first workflow section, and command table entry (matching existing Claude start.md)",
+  "migrations": [],
+  "notes": "No migration required. Template-level changes only — run `trellis update` to sync."
+}

package/dist/migrations/manifests/0.3.0-rc.6.json

@@ -0,0 +1,9 @@
+{
+  "version": "0.3.0-rc.6",
+  "description": "4 new platforms: Kilo, Kiro, Gemini CLI, Antigravity",
+  "breaking": false,
+  "recommendMigrate": false,
+  "changelog": "**New Platforms:**\n- feat(kilo): add Kilo CLI as commands-only platform (.kilocode/commands/trellis/)\n- feat(kiro): add Kiro Code as skills-based platform (.kiro/skills/)\n- feat(gemini): add Gemini CLI as first TOML-format command platform (.gemini/commands/trellis/*.toml)\n- feat(antigravity): add Antigravity as workflow-based platform (.agent/workflows/)\n\n**Bug Fixes:**\n- fix(scripts): remove non-existent spec/shared/ references from init-context defaults\n- fix(templates): correct iflow start/finish-work template content\n- fix(docs): correct license badge from FSL to AGPL-3.0\n- fix(init): fix start process flow (#48)\n\n**Tests:**\n- Added 50+ new tests covering all 4 new platforms (templates, configurators, init integration, regression)",
+  "migrations": [],
+  "notes": "No migration required. New platform templates only — existing projects unaffected. Run `trellis init --kilo`, `--kiro`, `--gemini`, or `--antigravity` to add new platform support."
+}

package/dist/migrations/manifests/0.3.0.json

@@ -0,0 +1,11 @@
+{
+  "version": "0.3.0",
+  "description": "Stable release: Shell→Python migration, 9 AI platforms, centralized registry",
+  "breaking": false,
+  "recommendMigrate": false,
+  "changelog": "**BREAKING: Shell to Python Migration**\n- All `.trellis/scripts/*.sh` replaced by Python equivalents (requires Python 3.10+)\n- Directory rename: `multi-agent/` → `multi_agent/` (underscore)\n- Command namespace migration: Claude uses `.claude/commands/trellis/` subdirectory, Cursor uses `trellis-` prefix\n\n**New Platforms (9 total):**\n- Codex (`.agents/skills/`) — OpenAI's CLI agent\n- Kilo (`.kilocode/commands/trellis/`) — commands-only platform\n- Kiro (`.kiro/skills/`) — skills-based platform\n- Gemini CLI (`.gemini/commands/trellis/*.toml`) — TOML-format commands\n- Antigravity (`.agent/workflows/`) — workflow-based platform\n- Plus existing: Claude Code, Cursor, iFlow, OpenCode\n\n**Architecture:**\n- Centralized platform registry replacing scattered init/update logic\n- Extracted `resolvePlaceholders()` to shared module\n- Deduplicated `compareVersions()` to `utils/compare-versions.ts`\n- Remote spec templates from docs repo\n\n**Key Fixes:**\n- Windows encoding: `_configure_stream` with reconfigure/detach fallback for stdout/stderr\n- Windows subprocess: `CREATE_NEW_PROCESS_GROUP` on win32, `start_new_session` on Unix\n- Template placeholder roundtrip (`{{PYTHON_CMD}}` resolution)\n- CLI version comparison for prerelease versions\n- add_session.py table separator tolerance for formatted markdown\n\n**Quality:**\n- 312+ tests across 17+ files (unit, integration, regression)\n- @vitest/coverage-v8 support\n- Executable spec enforcement (7-section structure)",
+  "migrations": [],
+  "migrationGuide": "# Migration Guide: v0.2.x → v0.3.0\n\n## Overview\n\nAll shell scripts (.sh) have been replaced by Python scripts (.py). This affects any custom workflows, slash commands, or documentation that references the old scripts.\n\n## Requirements\n\n- Python 3.10 or higher\n\n## What Changed\n\n### Script Extensions\n\n| Old Path | New Path |\n|----------|----------|\n| `.trellis/scripts/*.sh` | `.trellis/scripts/*.py` |\n| `.trellis/scripts/common/*.sh` | `.trellis/scripts/common/*.py` |\n| `.trellis/scripts/multi-agent/*.sh` | `.trellis/scripts/multi_agent/*.py` |\n\n### Directory Rename\n\n| Old | New |\n|-----|-----|\n| `multi-agent/` (hyphen) | `multi_agent/` (underscore) |\n\n### Invocation Change\n\n| Old | New |\n|-----|-----|\n| `./script.sh` | `python3 ./script.py` |\n| `./.trellis/scripts/task.sh` | `python3 ./.trellis/scripts/task.py` |\n\n## After Migration\n\nRun `trellis update --migrate` to remove the old shell scripts from your project.",
+  "aiInstructions": "When assisting users upgrading from 0.2.x to 0.3.0:\n1. Search for files containing `.trellis/scripts/*.sh` references and update to `.py`\n2. Replace `multi-agent/` directory references with `multi_agent/` (underscore)\n3. Always use `python3` explicitly, not just `python` (Windows compatibility)\n4. Check ALL locations: docstrings, help text, error messages, markdown docs\n5. Run `trellis update --migrate` to remove legacy shell scripts\n\nNote: Users upgrading from any 0.3.0 prerelease (beta/rc) need no file changes — only the version stamp is updated.",
+  "notes": "Aggregated release covering beta.0 through rc.6. All file migrations were applied in beta.0. Users upgrading from any 0.3.0 prerelease will see no file changes — only the .version stamp is updated. New projects get all 9 platform options via `trellis init`."
+}

package/dist/templates/antigravity/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Antigravity workflow templates
+ *
+ * Antigravity uses workspace workflows under .agent/workflows/.
+ * We reuse Codex skill content as workflow content.
+ */
+export interface WorkflowTemplate {
+    name: string;
+    content: string;
+}
+export declare function getAllWorkflows(): WorkflowTemplate[];
+//# sourceMappingURL=index.d.ts.map

package/dist/templates/antigravity/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/templates/antigravity/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAOH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AA6BD,wBAAgB,eAAe,IAAI,gBAAgB,EAAE,CAOpD"}

package/dist/templates/antigravity/index.js

@@ -0,0 +1,29 @@
+/**
+ * Antigravity workflow templates
+ *
+ * Antigravity uses workspace workflows under .agent/workflows/.
+ * We reuse Codex skill content as workflow content.
+ */
+import { getAllSkills as getAllCodexSkills, } from "../codex/index.js";
+function adaptSkillContentToWorkflow(content, workflowNames) {
+    const base = content
+        .replaceAll("Codex skills", "Antigravity workflows")
+        .replaceAll("Codex skill", "Antigravity workflow")
+        .replaceAll("Create New Skill", "Create New Workflow")
+        .replaceAll(".agents/skills/<skill-name>/SKILL.md", ".agent/workflows/<workflow-name>.md")
+        .replace(/\.agents\/skills\/([^/\s`]+)\/SKILL\.md/g, ".agent/workflows/$1.md")
+        .replaceAll(".agents/skills/", ".agent/workflows/")
+        .replaceAll("$<skill-name>", "/<workflow-name>")
+        .replaceAll("Or open /skills and select it", "Or type / and select it");
+    // Antigravity workflows are triggered with slash commands (/start), not "$skill".
+    return workflowNames.reduce((adapted, name) => adapted.replaceAll(`$${name}`, `/${name}`), base);
+}
+export function getAllWorkflows() {
+    const skills = getAllCodexSkills();
+    const workflowNames = skills.map((skill) => skill.name);
+    return skills.map((skill) => ({
+        name: skill.name,
+        content: adaptSkillContentToWorkflow(skill.content, workflowNames),
+    }));
+}
+//# sourceMappingURL=index.js.map

package/dist/templates/antigravity/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/templates/antigravity/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,YAAY,IAAI,iBAAiB,GAElC,MAAM,mBAAmB,CAAC;AAO3B,SAAS,2BAA2B,CAClC,OAAe,EACf,aAAuB;IAEvB,MAAM,IAAI,GAAG,OAAO;SACjB,UAAU,CAAC,cAAc,EAAE,uBAAuB,CAAC;SACnD,UAAU,CAAC,aAAa,EAAE,sBAAsB,CAAC;SACjD,UAAU,CAAC,kBAAkB,EAAE,qBAAqB,CAAC;SACrD,UAAU,CACT,sCAAsC,EACtC,qCAAqC,CACtC;SACA,OAAO,CACN,0CAA0C,EAC1C,wBAAwB,CACzB;SACA,UAAU,CAAC,iBAAiB,EAAE,mBAAmB,CAAC;SAClD,UAAU,CAAC,eAAe,EAAE,kBAAkB,CAAC;SAC/C,UAAU,CAAC,+BAA+B,EAAE,yBAAyB,CAAC,CAAC;IAE1E,kFAAkF;IAClF,OAAO,aAAa,CAAC,MAAM,CACzB,CAAC,OAAO,EAAE,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,UAAU,CAAC,IAAI,IAAI,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC,EAC7D,IAAI,CACL,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,eAAe;IAC7B,MAAM,MAAM,GAAyB,iBAAiB,EAAE,CAAC;IACzD,MAAM,aAAa,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACxD,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QAC5B,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,OAAO,EAAE,2BAA2B,CAAC,KAAK,CAAC,OAAO,EAAE,aAAa,CAAC;KACnE,CAAC,CAAC,CAAC;AACN,CAAC"}

package/dist/templates/claude/agents/check.md

@@ -0,0 +1,122 @@
+---
+name: 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
+
+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.
+
+---
+
+## Completion Markers (Ralph Loop)
+
+**CRITICAL**: You are in a loop controlled by the Ralph Loop system.
+The loop will NOT stop until you output ALL required completion markers.
+
+Completion markers are generated from `check.jsonl` in the task directory.
+Each entry's `reason` field becomes a marker: `{REASON}_FINISH`
+
+For example, if check.jsonl contains:
+```json
+{"file": "...", "reason": "TypeCheck"}
+{"file": "...", "reason": "Lint"}
+{"file": "...", "reason": "CodeReview"}
+```
+
+You MUST output these markers when each check passes:
+- `TYPECHECK_FINISH` - After typecheck passes
+- `LINT_FINISH` - After lint passes
+- `CODEREVIEW_FINISH` - After code review passes
+
+If check.jsonl doesn't exist or has no reasons, output: `ALL_CHECKS_FINISH`
+
+**The loop will block you from stopping until all markers are present in your output.**
+
+---
+
+## 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 TYPECHECK_FINISH
+- Lint: Passed LINT_FINISH
+
+### Summary
+
+Checked X files, found Y issues, all fixed.
+ALL_CHECKS_FINISH
+```

package/dist/templates/claude/agents/debug.md

@@ -0,0 +1,106 @@
+---
+name: debug
+description: |
+  Issue fixing expert. Understands issues, fixes against specs, and verifies fixes. Precise fixes only.
+tools: Read, Write, Edit, Bash, Glob, Grep, mcp__exa__web_search_exa, mcp__exa__get_code_context_exa
+model: opus
+---
+# Debug Agent
+
+You are the Debug Agent in the Trellis workflow.
+
+## Context
+
+Before debugging, read:
+- `.trellis/spec/` - Development guidelines
+- Error messages or issue descriptions provided
+
+## Core Responsibilities
+
+1. **Understand issues** - Analyze error messages or reported issues
+2. **Fix against specs** - Fix issues following dev specs
+3. **Verify fixes** - Run typecheck to ensure no new issues
+4. **Report results** - Report fix status
+
+---
+
+## Workflow
+
+### Step 1: Understand Issues
+
+Parse the issue, categorize by priority:
+
+- `[P1]` - Must fix (blocking)
+- `[P2]` - Should fix (important)
+- `[P3]` - Optional fix (nice to have)
+
+### Step 2: Research if Needed
+
+If you need additional info:
+
+```bash
+# Check knowledge base
+ls .trellis/big-question/
+```
+
+### Step 3: Fix One by One
+
+For each issue:
+
+1. Locate the exact position
+2. Fix following specs
+3. Run typecheck to verify
+
+### Step 4: Verify
+
+Run project's lint and typecheck commands to verify fixes.
+
+If fix introduces new issues:
+
+1. Revert the fix
+2. Use a more complete solution
+3. Re-verify
+
+---
+
+## Report Format
+
+```markdown
+## Fix Report
+
+### Issues Fixed
+
+1. `[P1]` `<file>:<line>` - <what was fixed>
+2. `[P2]` `<file>:<line>` - <what was fixed>
+
+### Issues Not Fixed
+
+- `<file>:<line>` - <reason why not fixed>
+
+### Verification
+
+- TypeCheck: Pass
+- Lint: Pass
+
+### Summary
+
+Fixed X/Y issues. Z issues require discussion.
+```
+
+---
+
+## Guidelines
+
+### DO
+
+- Precise fixes for reported issues
+- Follow specs
+- Verify each fix
+
+### DON'T
+
+- Don't refactor surrounding code
+- Don't add new features
+- Don't modify unrelated files
+- Don't use non-null assertion (`x!` operator)
+- Don't execute git commit