ubiquitous-invention/plans/README.md

25 lines
850 B
Markdown
Raw Permalink Normal View History

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