# Farra Dev Agent Backlog Setup

> Setup Design Doc Backlog System

- Skill: `tomevault-io/farra-dev-agent-backlog-setup` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/farra-dev-agent-backlog-setup`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/farra-dev-agent-backlog-setup/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Product & Planning
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/farra-dev-agent-backlog-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 tasks with `/backlog:task-queue <id>`
3. Start work with `/backlog:task-start <id>`
4. Complete with `/backlog:task-complete <id>`

### Task ID Format
`[PREFIX-NNN-XX]` where:
- PREFIX = project prefix (e.g., ACME)
- NNN = design doc number
- XX = task sequence
```

### 5. Explain What Was Created

After setup, explain:
- What files were created and their purpose
- How to create a first design doc
- Available commands (`/backlog:new-design-doc`, etc.)

## Example Interaction

```
User: Set up design docs for this project

Claude: I'll help you set up the design doc backlog system.

What project prefix would you like to use? This is a short uppercase identifier
(like ACME, GF, or DAB) that will appear in task IDs like [ACME-001-01].

User: ACME

Claude: Great! Let me set up the backlog system with prefix ACME.

[Creates files...]

Done! I've created:
- README.org - Project config with categories and statuses
- org-setup.org - Shared org-mode configuration
- backlog.org - Your working surface for active tasks
- docs/design/README.org - Index of design documents
- docs/design/000-template.org - Template for new design docs
- CHANGELOG.md - For tracking releases

To create your first design doc, use:
  /backlog:new-design-doc "Your Feature Title"

This will create a numbered design doc with tasks you can then queue to your backlog.
```

## Template Content

When writing files, read the template content from the plugin's templates directory and perform the PROJECT → prefix substitution.

---
> Converted and distributed by [TomeVault](https://tomevault.io/claim/farra) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-11 -->