Trellis Autonomous Workflow

Install the CLI globally:

npm install -g trellis-autonomous-workflow
trellis-workflow /path/to/project

Or run it without a global install:

npx trellis-autonomous-workflow /path/to/project

The package distributes the existing installer and templates. It does not change a project during npm install; run trellis-workflow explicitly.

The target machine must already have python3, trellis, and codegraph on PATH. Use the installer's existing flags for scoped or previewed setup:

trellis-workflow --project-only /path/to/project
trellis-workflow --global-only --dry-run

The package name is the npm publication name. Change name in package.json before publishing if a different namespace is required.

Bundled coding rulesets

Two third-party rulesets install with the workflow, vendored as MIT text — no plugin marketplace, no network at install time, and they survive trellis update:

| | Governs | Default | Source | |---|---|---|---| | ponytail 4.9.0 | what code gets written (the laziness ladder) | full | MIT | | caveman 2.3.1 | how terse the prose is | lite | MIT (skills/ only) |

They land in three places, because each reaches a different agent:

• .trellis/spec/guides/{ponytail,caveman}.md — binding contracts. The only path that reaches a channel worker, which sees no hooks and no skills; list them in the task's implement.jsonl / check.jsonl.
• .claude/skills/ — Claude Code's /ponytail and /caveman switches.
• .agents/skills/ — the shared layer Codex and Pi both read.

Where a vendored SKILL.md and a contract disagree, the contract wins; the SKILL.md files are kept byte-identical to upstream so they stay diffable.

Caveman's compression proxy (BSL-1.1: engine/, proxy/, mcp/, shrink/) is deliberately not installed — it needs a machine-level global npm install that rewires each agent's API base URL, has no Pi adapter, and ponytail's own agentic benchmark measured that arm at +7% tokens / +3% cost versus baseline. Install it yourself from upstream if you want it; nothing here depends on it.