# Plans directory

Human- and agent-oriented backlog. Structure:

```text
plans/
  Plan-<plan-slug>/
    Plan-<plan-slug>.md
    Epic-<epic-slug>/
      Epic-<epic-slug>.md
      Task-<task-slug>.md
      Task-<other-task>.md
```

- **Slug**: lowercase, hyphenated, stable across renames of display title when possible.
- **Templates**: copy from `docs/templates/`.
- **Chunking**: keep each **Task** small enough for one Cursor agent or subagent to own; use **Epics** for milestones that need several tasks.

See `docs/Glossary.md` and `config/CursorSync.md`.

**Import to database:** from the repo root, with `DATABASE_URL` and your workspace UUID:

`pnpm --filter @tasks/database watch:markdown-backlog`

Set `MARKDOWN_BACKLOG_WORKSPACE_ID` (and optionally `MARKDOWN_BACKLOG_REPO_ROOT`). This runs an initial sync and watches `plans/` for changes.