trellis-start

Initializes Trellis development sessions by loading context, tasks, and workflow routing rules.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Starting or resuming work in a Trellis-managed project requires manually reconstructing context: who you are, what git state you're in, which task is active, and which workflow rules apply. This Skill automates that session bootstrap so an AI agent begins every coding session with the correct project context and routing decision. ## Core Features & Use Cases - Session Context Loading: Runs .trellis/scripts/get_context.py to retrieve developer identity, git status, current task, active tasks, and journal location. - Workflow & Guideline Discovery: Loads the compact Phase Index, request triage rules, and package/spec guideline indexes from .trellis/spec/ so coding standards are known before editing. - Task Routing: Classifies the incoming request and routes to the right follow-up skill, such as trellis-continue for active tasks, trellis-brainstorm for new features, or trellis-before-dev before writing code. - Use Case: You open a repository mid-sprint and ask the AI to continue work. The Skill detects the active task, resumes it via trellis-continue recovery rules, and surfaces any pending Trellis update notice. ## Quick Start Ask the AI to start a new Trellis session and load the current project context before beginning any coding task.

Frequently Asked Questions about trellis-start

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

FAQPage Schema
How do I start a Trellis development session with an AI agent?▼

Invoke the session-start workflow, which runs .trellis/scripts/get_context.py to load identity, git status, and active tasks, then reads workflow and guideline indexes. The agent then routes your request to the appropriate next skill automatically.

How does Trellis decide between brainstorm, direct edit, and task workflow?▼

The routing follows the Request Triage contract in .trellis/workflow.md. New or unclear features go to trellis-brainstorm, explicit task planning uses task.py create, and inferred complex planning uses task_intent.py create. Questions are asked only for material ambiguity.

What happens if an active task already exists when I start a session?▼

When an active task is detected, the session loads the trellis-continue skill and follows its recovery rules to decide the next step, rather than starting a new task or triage flow.

Does this session-start workflow require the Trellis CLI to be installed?▼

It requires a project initialized with Trellis, meaning a .trellis directory containing scripts like get_context.py and untracked_flow.py plus workflow and spec files. Without that structure the context-loading steps cannot run.

Why does session start report a Trellis update available message?▼

The get_context.py script checks for newer Trellis versions and emits a line beginning with 'Trellis update available:'. The instructions require copying that line verbatim into the session summary so upgrade hints are not lost.