setup

# Setup Design Doc Backlog System

This skill helps users set up the design doc driven task management system in their project.

## When to Use

Activate when the user says things like:
- "set up design docs"
- "initialize the backlog"
- "configure design doc workflow"
- "add task management with design docs"

## Setup Process

### 1. Gather Information

Ask the user for:
- **Project prefix**: A short uppercase identifier (e.g., `ACME`, `GF`, `DAB`) used in task IDs like `[ACME-001-01]`

Check if they already have:
- A `README.org` with `#+PROJECT_PREFIX:` set (use that)
- Existing `docs/design/` directory (don't overwrite)
- Existing `backlog.org` (don't overwrite)

### 2. Create Directory Structure

Create these directories if they don't exist:
```
docs/design/
```

### 3. Create Files from Templates

The templates are in the plugin's `templates/` directory. Copy them with PROJECT substitution:

| Template | Destination | Substitution |
|----------|-------------|--------------|
| `readme-project.org` | `README.org` | Replace `PROJECT` with prefix |
| `readme-design.org` | `docs/design/README.org` | None |
| `org-setup.org` | `org-setup.org` | Replace `PROJECT` with prefix |
| `backlog-template.org` | `backlog.org` | Replace `PROJECT` with prefix |
| `design-doc-template.org` | `docs/design/000-template.org` | Replace `PROJECT` with prefix |
| `changelog-template.md` | `CHANGELOG.md` | None |

**Important**: Check if files exist before writing. Ask the user before overwriting.

### 4. Update CLAUDE.md

Append or merge the following into the project's CLAUDE.md (create if needed):

```markdown
## Design Doc Workflow

This project uses design docs for task management. Design docs live in `docs/design/`.

### Key Files
- `backlog.org` - Working surface for active tasks
- `docs/design/*.org` - Design documents (source of truth)
- `README.org` - Project config (prefix, categories, statuses)

### Workflow
1. Create design docs with `/backlog:new-design-doc`
2. Queue task