> ## Documentation Index
> Fetch the complete documentation index at: https://docs.trytrellis.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Trellis

> All-in-one AI framework & toolkit for 10+ AI coding platforms

## What is Trellis?

AI's capabilities grow like vines: full of vitality but spreading everywhere. Trellis is scaffolding for AI, guiding it along the path of your conventions.

Supported platforms: Claude Code, Cursor, OpenCode, Codex, Kiro, Kilo, Gemini CLI, Antigravity, Devin, Qoder, CodeBuddy, GitHub Copilot, Droid, Pi Agent, Oh My Pi, Reasonix, ZCode, Trae, Grok Build, Kimi Code, Snow CLI, plus any agent that reads the `.agents/skills/` standard (Amp, Cline, Deep Agents, Firebender, Warp, and more).

### One-Line Summary

**Trellis is training wheels for AI coding assistants.** It automatically injects your project specs into every AI session, so the AI writes code following your standards instead of improvising.

> AI's capabilities grow like vines, full of vitality but spreading everywhere.
> Trellis is scaffolding for AI, guiding it along the path of your conventions.

### Comparison with Traditional Approaches

| Dimension             | `.cursorrules`                    | `CLAUDE.md`                      | Skills                    | **Trellis**                                                                                   |
| --------------------- | --------------------------------- | -------------------------------- | ------------------------- | --------------------------------------------------------------------------------------------- |
| Spec injection method | Manually loaded each conversation | Auto-loaded but easily truncated | User-initiated            | **Auto-injection (hooks on capable platforms, prelude on others), precisely loaded per task** |
| Spec granularity      | One large file                    | One large file                   | One per Skill             | **Modular files, composed per task**                                                          |
| Cross-session memory  | None                              | None                             | None                      | **Workspace journal persistence**                                                             |
| Workflow enforcement  | None                              | None                             | None                      | **Auto-trigger skills + check sub-agent verify loop**                                         |
| Team sharing          | Single user                       | Single user                      | Shareable but no standard | **Git-versioned Spec library**                                                                |
| Platform support      | Cursor only                       | Claude Code only                 | Per platform              | **21 configured platforms + shared skill ecosystem**                                          |

### Core Concepts at a Glance

| Concept       | Description                                                                                                       | Location                                 |
| ------------- | ----------------------------------------------------------------------------------------------------------------- | ---------------------------------------- |
| **Spec**      | Your coding standards, written in Markdown. AI reads specs before writing code                                    | `.trellis/spec/`                         |
| **Workspace** | Each developer's session logs, letting AI remember what was done last time                                        | `.trellis/workspace/`                    |
| **Task**      | A work unit containing requirements docs and context configuration                                                | `.trellis/tasks/`                        |
| **Skill**     | Auto-triggered workflow modules: brainstorm, before-dev, check, update-spec, break-loop                           | platform-specific skills dir             |
| **Sub-agent** | Specialized AI sub-process: `trellis-research`, `trellis-implement`, `trellis-check`                              | platform-specific agents dir             |
| **Command**   | Explicit session entries: `finish-work`, `continue`, and manual `start` where needed                              | platform-specific commands dir           |
| **Hook**      | Auto-triggered scripts that inject context at session start, sub-agent launch, etc. (platforms with hook support) | `.claude/hooks/`, etc.                   |
| **Journal**   | Session log files recording what was done in each development session                                             | `.trellis/workspace/{name}/journal-N.md` |

***

## Why Trellis?

| Feature                       | Problem Solved                                                                              |
| ----------------------------- | ------------------------------------------------------------------------------------------- |
| **Auto-Injection**            | Required specs and workflows auto-inject into every conversation. Write once, apply forever |
| **Auto-updated Spec Library** | Best practices live in auto-updated spec files. The more you use it, the better it gets     |
| **Skill-first Workflow**      | Most operations are auto-trigger skills. AI picks the right one without manual commands     |
| **Team Sync**                 | Share specs across your team. One person's best practice benefits everyone                  |
| **Session Persistence**       | Work traces persist in your repo. AI remembers project context across sessions              |

<CardGroup cols={2}>
  <Card title="Quick Start" icon="rocket" href="/start/install-and-first-task">
    Install Trellis and set up your first project in 5 minutes.
  </Card>

  <Card title="Architecture" icon="book" href="/advanced/architecture">
    Understand specs, tasks, hooks, and workspaces.
  </Card>

  <Card title="Commands & Skills" icon="terminal" href="/start/everyday-use">
    Reference for slash commands (`/start`, `/finish-work`) and auto-trigger skills.
  </Card>

  <Card title="Writing Specs" icon="file-lines" href="/start/everyday-use">
    Turn blank templates into executable contracts with `trellis-update-spec`.
  </Card>
</CardGroup>
