Skip to main content

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.

Adds task-creation consent gates and planning artifacts to the 0.6 beta workflow.

Enhancements

No-task turns now classify the request before creating any Trellis task.
Request typeBehavior
Simple conversation / small taskAsk only whether this turn should create a Trellis task; if not, skip Trellis for the turn.
Complex taskAsk whether Trellis may create a task and enter planning. If declined, clarify scope or suggest a smaller split.

Planning Artifacts

task.py create now creates a default prd.md; complex planning uses prd.md, design.md, and implement.md before task.py start.
ArtifactPurpose
prd.mdRequirements, constraints, acceptance criteria, out-of-scope.
design.mdComplex task technical design: boundaries, data flow, contracts, tradeoffs.
implement.mdComplex task execution plan: checklist, validation commands, review gates.

Context Loading

Implement/check context order is now consistent across hook-push, pull-prelude, Pi extension, OpenCode plugin, and inline modes.
jsonl entries -> prd.md -> design.md if present -> implement.md if present
implement.jsonl and check.jsonl remain spec/research manifests; they do not replace implement.md.

Codex Inline Mode

Codex no-task breadcrumbs include <trellis-bootstrap> and <codex-mode> context. Inline mode means the main Codex session implements and checks directly; it does not dispatch implement/check sub-agents.

Upgrade

npm install -g @mindfoldhq/trellis@beta
trellis update