trellis-meta

Guides customization of local Trellis workflow, hooks, agents, and platform files.

1|Updated Mar 19, 2026
One-click install
npx skills add https://github.com/hejiajiudeeyu/delegated-execution-workspace --skill trellis-meta-hejiajiudeeyu
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: trellis-meta
Source: https://github.com/hejiajiudeeyu/delegated-execution-workspace/tree/main/.agents/skills/trellis-meta
Command: npx skills add https://github.com/hejiajiudeeyu/delegated-execution-workspace --skill trellis-meta-hejiajiudeeyu

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? After running trellis init, teams often need to adapt the generated Trellis setup to their own workflow, but it is unclear which local files control phases, hooks, agents, skills, or specs. This Skill teaches an AI assistant the local Trellis architecture so it can safely modify the right files inside the user project instead of guessing or editing upstream source. ## Core Features & Use Cases - Architecture Orientation: Explains the three-layer local Trellis model (workflow, persistence, platform integration) and which files are editable versus managed runtime state. - Platform File Mapping: Maps directories like .claude/, .codex/, .cursor/, and .agents/skills/ to their hooks, agents, skills, and commands across many AI tools. - Customization Playbooks: Provides step-by-step references for changing workflow phases, task lifecycle hooks, context injection, agent behavior, spec structure, and project-local conventions. - Use Case: A user says "the implement agent never reads our backend spec." The Skill directs the AI to inspect the task's implement.jsonl, the platform agent file, and the inject-subagent-context hook, then fix the correct layer. ## Quick Start Ask the AI to use the trellis-meta skill to change how the check agent runs project-specific commands in this project.

Frequently Asked Questions about trellis-meta

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

FAQPage Schema
How do I customize the Trellis workflow in my project?▼

Edit .trellis/workflow.md, which is the local workflow source of truth defining phases, skill routing, and workflow-state prompt blocks. After editing, check that platform entry files like skills and commands still describe the same flow.

How do I change what the trellis-implement or trellis-check agent reads?▼

Edit the platform agent file (for example .claude/agents/trellis-implement.md) and the task's implement.jsonl or check.jsonl manifests. Depending on the platform, context is either pushed by a hook or pulled by the agent reading files after startup.

Which AI coding platforms does Trellis support?▼

Trellis generates files for Claude Code, Cursor, OpenCode, Codex, Kiro, Gemini CLI, Qoder, CodeBuddy, GitHub Copilot, Factory Droid, Pi Agent, Kilo, Antigravity, and Windsurf. Which directories exist depends on the trellis init flags the user ran.

Why does my AI agent not see the current Trellis task?▼

Active task state is stored per session in .trellis/.runtime/sessions/. Run task.py current --source to verify, then check whether the platform hook passes session identity into the shell rather than creating a global pointer file.

Should I edit node_modules or the Trellis npm package to customize behavior?▼

No. Customization targets are the generated local files: .trellis/, platform directories, and .agents/skills/. Only modify upstream Trellis source when explicitly contributing a PR or changing the CLI itself.

Where should team coding conventions live in a Trellis project?▼

Put long-term engineering conventions in .trellis/spec/ under the appropriate layer with an index.md entry point. Reference them from task JSONL manifests so agents read them during implementation and checking.