trellis-start

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

Updated Sep 5, 2026
One-click install
npx skills add https://github.com/jiozhaoyue/ST-BgLoader --skill trellis-start-jiozhaoyue
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: trellis-start
Source: https://github.com/jiozhaoyue/ST-BgLoader/tree/main/.reasonix/skills/trellis-start
Command: npx skills add https://github.com/jiozhaoyue/ST-BgLoader --skill trellis-start-jiozhaoyue

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Starting a new AI coding session without project context leads to lost continuity, forgotten tasks, and inconsistent workflows. This Skill restores full session context by reading developer identity, git status, active tasks, and project guidelines from the .trellis/ directory, then routes the work to the correct workflow phase. ## Core Features & Use Cases - Session Context Loading: Runs get_context.py to retrieve developer identity, git status, current task, and journal location in one step. - Task Classification & Routing: Inspects the active task status (planning vs in_progress) and routes to brainstorm, direct edit, or task workflow phases. - Skill Routing Table: Maps user intent to related Trellis skills such as trellis-brainstorm, trellis-before-dev, trellis-check, and trellis-break-loop. - Use Case: A developer returns to a project after a week away. Activating this Skill reloads the active task, its planning artifacts (prd.md, design.md), and the correct next workflow step without manual digging. ## Quick Start Start my Trellis development session and tell me what task I should work on next.

Frequently Asked Questions about trellis-start

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

FAQPage Schema
How do I restore project context when starting a new AI coding session?▼

Run the get_context.py script in the .trellis/scripts directory to load developer identity, git status, current task, and active tasks. Then read the workflow phase index and relevant guideline index files to re-establish full context.

What is the Trellis workflow for managing AI development tasks?▼

Trellis organizes work into phases: Phase 1 covers planning with prd.md, design.md, and implement.md artifacts, while Phase 2 covers execution. Tasks are classified as brainstorm, direct edit, or full task workflow based on complexity.

How does Trellis decide between brainstorm and direct edit workflows?▼

The decision depends on task state: an active task in planning status without prd.md routes to the brainstorm skill, while planning with prd.md continues Phase 1. Simple conversation or small tasks may skip Trellis entirely with user approval.

Does trellis-start require any external Python packages?▼

No external packages are required. The Skill only invokes the get_context.py script bundled in the .trellis/scripts directory and reads Markdown index files from .trellis/spec, using standard Python and shell commands.

What happens if there is no active task when a session starts?▼

The Skill classifies the incoming request first. For simple conversation or small tasks, it asks whether to create a Trellis task; for complex work, it asks permission to enter planning. If the user declines, Trellis is skipped for that session.