> ## 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.

# v0.4.0-rc.1

> 2026-04-14

**Late-RC additive feature.** Two pure-additive changes — no migrations, no behavior changes for existing platforms. Safe to update mid-RC.

## Factory Droid platform support

[Factory Droid](https://factory.ai) is now a first-class Trellis platform. Cursor-level scope: commands-only, no hooks/agents.

* `trellis init --droid` writes 12 Trellis commands to `.factory/commands/trellis/<name>.md`
* Each file ships with optional YAML frontmatter (`description: ...`) so Droid's `/commands` autocomplete shows a one-line summary
* Layout uses nested `trellis/` subdirectory like Claude Code (Droid's docs claim nesting is unsupported but the actual binary picks them up — verified before release)
* `cli_adapter.py` fully integrates Droid so Trellis Python scripts (status, archive, journals) detect `.factory/` projects correctly
* Multi-agent CLI `run`/`resume` currently raises `ValueError` ("not yet integrated with Trellis multi-agent") — same pattern as Copilot/Windsurf. Can be extended in a future release if there's demand.

## Codex option hints at `.agents/skills/` shared layer

The interactive `trellis init` checkbox for Codex now reads:

```
Codex (also writes .agents/skills/ — read by Cursor, Gemini CLI, GitHub Copilot, Amp, Kimi Code)
```

Trellis only writes `.agents/skills/` when Codex is enabled, but that directory is read by many other clients via the [agentskills.io](https://agentskills.io) open standard. Surfacing this in the prompt makes the spillover benefit visible — users picking Codex understand it isn't Codex-specific.

Verified against each client's official docs:

* [Cursor Skills](https://cursor.com/docs/skills) — explicit `.agents/skills/` entry
* [Gemini CLI Skills](https://geminicli.com/docs/cli/skills) — `.agents/skills/` is the cross-client "alias", takes precedence over `.gemini/skills/`
* [VS Code Copilot Agent Skills](https://code.visualstudio.com/docs/copilot/customization/agent-skills) — `.agents/skills/` listed alongside `.github/skills/` and `.claude/skills/`
* [Amp Owner's Manual](https://ampcode.com/manual) — `.agents/skills/` is the only project-level skill location
* [Kimi Code CLI Skills](https://moonshotai.github.io/kimi-cli/en/customization/skills.html) — discovered from `.agents/skills/` (or `.kimi/skills/`, `.claude/skills/`)

Note: Claude Code is intentionally omitted. Its [official skills docs](https://code.claude.com/docs/en/skills) only list `.claude/skills/` and `~/.claude/skills/` — Claude Code does NOT read `.agents/skills/`, contrary to several third-party blog claims.

## Notes

* Pure-additive update. RC users can `trellis update` safely — no file renames, no behavior changes, no migrations.
* Run `trellis init --droid` to try Factory Droid support.
* RC install: `npm install -g @mindfoldhq/trellis@rc`