Trellis README

The project's README from github.com/mindfold-ai/Trellis. As one markdown file: README.md.

Trellis Logo

An out-of-the-box engineering framework for AI coding.
AI writes code fast, but every session it starts from scratch — no memory of your project, your conventions, or your team's requirements. Trellis persists specs, tasks, and memory into your repo, so any coding agent works to your engineering standards.

简体中文 • Docs • Quick Start • Supported Platforms • Use Cases

npm version npm downloads license stars docs Discord open issues open PRs Ask DeepWiki Ask ChatGPT

Trellis workflow demo

Why Trellis?

Capability What it changes
Auto-injected specs Write conventions once in .trellis/spec/, then let Trellis inject the relevant context into each session instead of repeating yourself.
Task-centered workflow Keep PRDs, implementation context, review context, and task status in .trellis/tasks/ so AI work stays structured.
Project memory Journals in .trellis/workspace/ preserve what happened last time, so each new session starts with real context.
Team-shared standards Specs live in the repo, so one person's hard-won workflow or rule can benefit the whole team.
Multi-platform setup Bring the same Trellis structure to 22 AI coding platforms instead of rebuilding your workflow per tool.

Prerequisites:

Quick Start

# 1. Install Trellis
npm install -g @mindfoldhq/trellis@latest

# 2. Initialize in your repo
trellis init -u your-name

# 3. Or initialize with the platforms you actually use
trellis init --cursor --opencode --codex -u your-name

See the Quick Start and Supported Platforms guides for setup details.

How to Use

The workflow is simple:

  1. Describe what you want in natural language.
  2. Brainstorm with the AI one question at a time until the PRD is clear, then implementation begins.
  3. Let it run — the AI calls Trellis Implement and auto-checks the result against specs, lint, type-check, and tests.
  4. Type /trellis:finish-work when the work is done or the session context fills up. Trellis archives the task and updates journals.

How It Works

Trellis runs a 4-phase loop with auto-invoked skills and sub-agents:

  1. Plan — trellis-brainstorm walks through requirements one question at a time and writes prd.md. Research-heavy items go to a trellis-research sub-agent. The result is curated specs + research files referenced from implement.jsonl / check.jsonl.
  2. Implement — a trellis-implement sub-agent writes code from the PRD with the curated context auto-injected, no git commit.
  3. Verify — a trellis-check sub-agent reviews the diff against specs and runs lint, type-check, and tests, self-fixing where it can.
  4. Finish — a final check runs, then trellis-update-spec promotes new learnings back into .trellis/spec/ so the next session starts smarter.

Resources

Need Link
Install Trellis in a repo Quick Start
Understand platform differences Supported Platforms
See the workflow in practice Real-World Scenarios
Start from spec templates Spec Templates
Track releases Changelog

FAQ

How is Trellis different from CLAUDE.md, AGENTS.md, or .cursorrules?

Those files are useful entry points, but they tend to become monolithic. Trellis adds scoped specs, task PRDs, workflow gates, workspace memory, and platform-aware generated files around them.

Is Trellis only for Claude Code?

No. Trellis is a project layer that works across multiple coding agents and IDEs.

Is Trellis for solo developers or teams?

Both. Solo developers use it for memory and repeatable workflow. Teams get the larger benefit: shared standards, task boundaries, reviewable context, and platform portability.

Do I have to write every spec file manually?

No. Many teams start by letting AI draft specs from existing code and then tighten the important parts by hand. Trellis works best when you keep the high-signal rules explicit and versioned.

Can teams use this without constant conflicts?

Yes. Personal workspace journals stay separate per developer, while shared specs and tasks stay in the repo where they can be reviewed and improved like any other project artifact.

Can I temporarily compare a project with and without Trellis?

Yes. trellis ablate temporarily removes all supported project-owned Trellis surfaces after creating a verified recovery transaction outside the project. Start a fresh agent session for the comparison, then run trellis restore to recover the exact prior state. Use --dry-run to preview either operation. The private recovery transaction includes exact .trellis task, spec, and workspace bytes, which may contain user-authored sensitive text, and is kept until restore verifies successfully.

This is different from trellis uninstall (permanent removal) and TRELLIS_HOOKS=0 (hooks only). Ablation does not launch agents, manage worktrees, hide Git changes, or remove the global CLI, channel logs, or host transcripts. If a managed path changes while ablated, restore refuses all writes until the conflict is resolved.

Star History

Star History Chart

Community & Resources

Official Repository • AGPL-3.0 License • Built by Mindfold

Trellis (mindfold-ai/Trellis)

Searching Database…

15K ·GitHub
Trellis
Что это такое?Trellis — это готовый инженерный фреймворк для работы с ИИ-агентами, которые пишут код. Он сохраняет спецификации, задачи и память проекта прямо в вашем репозитории, поэтому любой кодинг-агент работает по вашим правилам, а не начинает каждую сессию с нуля.
Trellis — это отдельный ИИ-агент для кода, или я использую его вместе с тем агентом, который у меня уже есть?Это проектный слой поверх ваших существующих агентов и IDE, а не отдельная модель или агент. Одна и та же структура Trellis работает на 22 платформах для кодинга с ИИ, так что вы не привязаны к Claude Code или Codex.
Как настроить его для моего проекта?Нужны Node.js >= 18 и Python >= 3.9, затем следуйте руководству Quick Start, чтобы установить Trellis в свой репозиторий. Вместе с ним придёт trellis CLI и папка .trellis/, где хранятся спецификации, задачи и журналы рабочих сессий.
А если я хочу попробовать поработать над проектом без Trellis или потом удалить его?Команда trellis ablate временно убирает всё, что добавляет Trellis, а trellis restore возвращает ровно прежнее состояние (с флагом --dry-run можно предварительно посмотреть, что произойдёт); trellis uninstall удаляет всё насовсем. Учтите: restore откажется вносить изменения, если какой-то управляемый файл менялся, пока Trellis был отключён.
Trellis рассчитан на одиночных разработчиков или на команды?И на тех, и на других. Одиночным разработчикам он даёт память проекта и повторяемый рабочий процесс; командам — общие стандарты, понятные границы задач и контекст для ревью. Личные журналы у каждого разработчика остаются отдельными, а общие спецификации и задачи лежат в репозитории.
Как выглядит обычный рабочий процесс?Вы описываете, что хотите, обычным языком и обсуждаете идею с ИИ по одному вопросу за раз, пока PRD не станет понятной. Затем реализация идёт с автопроверками по спецификациям, линтеру, проверке типов и тестам; команда /trellis:finish-work архивирует задачу и обновляет журналы.
Что происходит «под капотом» во время задачи?Цикл из четырёх этапов: trellis-brainstorm пишет prd.md (исследования выносятся в суб-агента trellis-research), trellis-implement пишет код по PRD без git-коммитов, trellis-check проверяет дифф и запускает линтер, проверку типов и тесты с самостоятельным исправлением ошибок, а trellis-update-spec переносит новые выводы обратно в спецификации.
Где Trellis всё хранит?В вашем репозитории в папке .trellis/: spec/ — правила и соглашения, которые автоматически подставляются в каждую сессию, tasks/ — PRD вместе с контекстом реализации и ревью, workspace/ — журналы, чтобы каждая новая сессия начиналась с реального контекста.
Мне нужно вручную писать все файлы со спецификациями?Нет. Многие команды просят ИИ набросать спецификации по существующему коду, а потом вручную дорабатывают важные места. Trellis работает лучше всего, когда ключевые правила явно прописаны и хранятся в системе контроля версий.
What are similar projects?superpowers-zh, gsd-core, operator-memory, autoprompt-skill, pstack-claude, oar, openrig, ECC
Which topics is it in?claudecode, spec-driven-development, subagents, agentic-coding, agent-harness, context-engineering, code-review, ai-coding, collaboration, harness, agent-memory, workflow
Creator
mindfold-ai
Size
238.9 MB
Stars
15K
Updated
CommitSep 29
Age
8mo
Commits · 90 Days