trellis-route

Routes Trellis implement and check execution between inline and subagent modes using session state and personal preferences.

Updated Jun 8, 2026
One-click install
npx skills add https://github.com/SilentFlower/flower-trellis --skill trellis-route-silentflower
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: trellis-route
Source: https://github.com/SilentFlower/flower-trellis/tree/main/.agents/skills/trellis-route
Command: npx skills add https://github.com/SilentFlower/flower-trellis --skill trellis-route-silentflower

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve? When working in a Trellis-managed project, every implement or check phase must decide whether the main agent runs the work inline or dispatches a dedicated subagent. Without a router, the AI either asks repeatedly, guesses inconsistently, or loses the decision after context compaction. This Skill resolves the execution mode deterministically from session runtime state, a gitignored personal preference file, or auto-loop authorization, and only prompts the user when no valid decision exists. ## Core Features & Use Cases - Priority-based route resolution: Resolves implement/check routes in a fixed order (session runtime state, then .trellis/.route-prefs.tmp, then auto-loop authorization) via the bundled route_state.py helper, with compact JSON output for the agent. - Preference management: Lets users set, update, or clear personal default modes (inline vs subagent) per target, stored in a gitignored file that never enters commits. - Platform-aware subagent dispatch: Ships a platform-dispatch.json catalog covering 20+ AI platforms (Claude Code, Cursor, Codex, Gemini, etc.) that defines how to launch trellis-implement and audit-only trellis-check-all subagents, blocking silently unsafe fallbacks. - Use Case: During Phase 2.1 of a Trellis workflow, the main agent invokes this Skill; it recovers the session's prior route decision after a context compaction and outputs a structured route_decision telling the agent to dispatch trellis-implement as a subagent—without re-asking the user. ## Quick Start Ask the AI to route the current Trellis task's implement phase, for example: "Use trellis-route to decide whether this task's implementation should run inline or as a subagent."

Frequently Asked Questions about trellis-route

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I set a default inline or subagent mode for Trellis implement?▼

Choose a "save default" option when the route options are shown, or run route_state.py write with --save-pref. The preference is stored in .trellis/.route-prefs.tmp, which is gitignored and applies to future sessions without prompting again.

How does Trellis route recovery work after context compaction?▼

The helper reads .trellis/.runtime/sessions/<context-key>.json and restores the current task's route_decisions entry if its target, mode, source, and task path all validate. A hit is reused without prompting; a miss falls back to personal preferences or fresh options.

Which AI platforms support Trellis check-all subagent dispatch?▼

The platform-dispatch.json catalog lists eligible platforms including Claude Code, Cursor, Codex, Gemini, Kiro, and others with verified read-only agents. Platforms like Kilo, Antigravity, and Devin are marked inline-only because they lack a verified project-subagent launcher.

Why does the check route only offer check-all options?▼

Check routing is unified through the trellis-check-all entry point; light versus full depth is a requested-depth parameter decided by Check-All itself, not a route mode. This prevents bypassing the unified audit flow via the older self-fixing trellis-check agent.

What happens if my route preference file is corrupted?▼

Corrupted or invalid preference content is ignored and treated as no configuration, so the Skill simply displays the numbered route options again. Runtime state files that are corrupt or belong to another task are skipped but never deleted, avoiding damage to other sessions.