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

# trellis-spec-bootstarp

> Bootstrap project-specific Trellis coding specs from the real codebase

`trellis-spec-bootstarp` helps an AI create or refresh `.trellis/spec/` guidelines from the actual repository. It is platform-neutral: one capable agent can analyze the codebase, choose the spec boundaries, write the docs, and verify that no placeholder text remains.

## When to Use It

Use this skill after `trellis init` when the default spec templates exist but still need project-specific content.

Good fits:

* New projects that need first-pass Trellis coding specs
* Existing projects where `.trellis/spec/` is still generic
* Repositories where the spec boundaries should follow real package or layer boundaries
* Teams that want source-backed rules instead of boilerplate advice

## Availability

`trellis-spec-bootstarp` is bundled with Trellis. After installing or updating Trellis, use the skill directly; there is no extra marketplace download step.

The beta bundle includes this skill now. The docs also mention it on the release track so the same workflow is visible there once the release bundle includes the matching skill.

## Usage

After installation, ask the AI to bootstrap or refresh specs:

```text theme={null}
Use trellis-spec-bootstarp to fill the Trellis specs for this project from the real codebase.
```

```text theme={null}
Refresh .trellis/spec so it reflects the current repository structure and coding patterns.
```

## How It Works

1. Inspect the existing `.trellis/spec/` tree.
2. Analyze repository architecture with GitNexus, ABCoder, language tooling, or direct source reads.
3. Choose spec boundaries that match the actual codebase.
4. Fill or reshape spec files with concrete file paths, examples, and anti-patterns.
5. Verify that index files match the final spec set and no template placeholders remain.

## Included References

| File                                | Contents                               |
| ----------------------------------- | -------------------------------------- |
| `SKILL.md`                          | Main workflow and operating rules      |
| `references/repository-analysis.md` | How to inspect repository architecture |
| `references/spec-task-planning.md`  | How to decompose spec work             |
| `references/spec-writing.md`        | How to write high-signal Trellis specs |
| `references/mcp-setup.md`           | GitNexus and ABCoder setup notes       |
