trellis-spec-bootstrap

To bootstrap Trellis specs, the skill analyzes your repository architecture and inspects the current .trellis/spec tree to identify gaps, then writes concrete, testable guidelines aligned with real files.

Generating code-aligned architecture documentation requires analyzing your live codebase by package and layer, embedding actual file paths and patterns, and verifying final specs to remove generic template remnants.

You need to refresh .trellis/specs when starting a new Trellis project or after significant code changes to ensure your specification guidelines accurately reflect the real-world code structure and architecture.

To ensure testable guidelines, the skill decomposes spec work by package and layer based on actual code, embeds real file paths and anti-patterns in the docs, and provides verification steps for consistency.

Yes, you can use it to start a new Trellis project. The skill inspects the existing .trellis/spec tree to identify the current state and gaps, allowing it to bootstrap initial guidelines directly from your codebase.

A limitation is that the produced docs depend entirely on the current codebase state; if the code contains anti-patterns, they may be documented unless verification steps are followed to ensure alignment with intended architecture.