trellis-start

Load Trellis workflow context and route coding sessions by task state.

92|8|Updated May 15, 2026
One-click install
npx skills add https://github.com/LonelyHerbivore/Trellis-Herbivore --skill trellis-start
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: trellis-start
Source: https://github.com/LonelyHerbivore/Trellis-Herbivore/tree/main/.agents/skills/trellis-start
Command: npx skills add https://github.com/LonelyHerbivore/Trellis-Herbivore --skill trellis-start

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

It solves the problem of starting (or resuming) a Claude Code coding session without manually reconstructing Trellis context, so the agent can immediately understand identity, repo state, active task status, and which workflow phase to follow.

Core Features & Use Cases

  • Session Context Initialization: Loads developer identity, git status, current task, active tasks, and the journal location so the session starts with the correct operational frame.
  • Workflow Phase & Step Routing: Classifies the next action based on active task status (e.g., planning vs in_progress) and whether required artifacts like prd.md exist, then routes to the appropriate skill or phase step detail.
  • Guideline Index Discovery: Discovers relevant packages and spec layers, then reads the specific index files that list which guideline documents to pull on demand for the current coding start.

Quick Start

Ask your AI to initialize a Trellis-managed coding session by reading the repository’s Trellis context and routing you to the correct next workflow step based on the current task state.

Frequently Asked Questions about trellis-start

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

FAQPage Schema
How do I initialize a Claude Code session with Trellis workflow context?

Trellis session initialization loads developer identity, git status, active tasks, and journal location by executing context discovery scripts, routing the agent to the correct workflow phase.

How does workflow routing and task triage work in Trellis-managed repos?

Workflow routing classifies the next action by checking active task status and required artifacts like prd.md, then routes to the appropriate skill or phase step detail for implementation.

Do I need a prd.md file to start a Trellis coding task?

A prd.md is a required planning artifact for Trellis workflow routing. The system checks for its existence to classify whether a task is in planning or in_progress state.

Can I resume a coding session without manually reconstructing Trellis context?

Yes, resuming is supported. The skill automatically reconstructs Trellis context by loading repo state, active task status, and journal location without manual setup.

What is the best way to discover guideline indexes for Trellis planning artifacts?

Use the built-in discovery scripts to locate relevant packages and spec layers, reading specific index files that list guideline documents for your current coding start.

Why does my Trellis workflow routing fail when git status is dirty?

Trellis workflow routing depends on git status to establish the operational frame. An uncommitted state may prevent accurate task triage and phase classification during session initialization.