lonelyherbivore/trellis-herbivore

Trellis-Herbivore is a customised fork of an existing AI coding tool called Trellis, tuned specifically for use with Claude Code, the command-line coding assistant. The original Trellis is described as a team AI coding harness with its own ideas about specs, tasks, and workflow. This branch keeps all of that intact and adds extra structure on top, with documentation written in Chinese so a team can read and review the artefacts directly. The core idea is that important context should live in repository files, not in a chat window that grows longer and longer. Project rules go into a spec folder, and each task gets its own folder with a product requirements document, a design file, an implementation plan, and small JSON files that load context for the implementation and check steps. When a user asks for something in plain language, the workflow first turns the request into a task, then runs a brainstorm step and a so-called grill step to challenge the requirements, then forces explicit decisions before any code is written. Before implementation starts, the developer has to pick three things: whether the current chat session writes the code or a subagent does, whether changes happen on the current branch or in a separate worktree, and whether the work follows the default Trellis flow or test-driven development. The aim is to make these choices visible in the task documents instead of being implicit. Quality control is split into layers. After implementation there is a general check, then separate spec, code, and architecture reviews, an optional deeper architectural review for sensitive tasks, a post-merge review, and a final build and test. Installation is one npm command for Node 18 or newer with Python 3.9 or newer. The project is released under the AGPL-3.0 license.