diff --git a/.claude/epics/.gitkeep b/.claude/epics/.gitkeep new file mode 100644 index 00000000..58c6bf31 --- /dev/null +++ b/.claude/epics/.gitkeep @@ -0,0 +1 @@ +# CCPM epic/task store — see docs/projects/README.md diff --git a/.claude/prds/.gitkeep b/.claude/prds/.gitkeep new file mode 100644 index 00000000..9cb7224c --- /dev/null +++ b/.claude/prds/.gitkeep @@ -0,0 +1 @@ +# CCPM PRD store — see docs/projects/README.md diff --git a/docs/adr/ADR-004-project-management-tooling.md b/docs/adr/ADR-004-project-management-tooling.md new file mode 100644 index 00000000..681622fb --- /dev/null +++ b/docs/adr/ADR-004-project-management-tooling.md @@ -0,0 +1,33 @@ +# ADR-004: Project-management tooling (C9) + +- **Status:** Accepted +- **Date:** 2026-05-17 +- **Deciders:** Дмитрий + +## Context + +The `C9 «Управление проектами»` map section had zero tooling. Planning was done +ad-hoc via `docs/superpowers/plans/` files, the `Открытые_вопросы` registry, and +sprint notes in memory. GitHub Issues were barely used (FF-push workflow). + +## Decision + +- Project management adopts a **GitHub-issue-backed** model: CCPM + (vendored skill) drives PRD→epic→issue→code with traceability; epics are + parent issues, tasks are sub-issues. +- The **GitHub Projects v2** board (official GitHub MCP `projects` toolset) is + the sprint/iteration board. +- Execution plans stay as `docs/superpowers/plans/` files (Superpowers). +- The `Открытые_вопросы` registry remains the home of *open* questions; an ADR + records *closed* decisions; CCPM tracks *features in flight*. +- product-management (Anthropic) is added only if Claude-Code-installable. + +## Consequences + +- Positive: C9 populated; planning traceable; sprints visible on a board. +- Risk: CCPM is third-party (bus-factor) — mitigated by vendoring. +- Risk: a workflow shift toward GitHub Issues — accepted, this is the decision. + +## Enforcement + +None — C9 tools are advisory; verified by use and code review. diff --git a/docs/projects/README.md b/docs/projects/README.md new file mode 100644 index 00000000..72ac7bab --- /dev/null +++ b/docs/projects/README.md @@ -0,0 +1,40 @@ +# docs/projects — project-management playbook (map section C9) + +Home of the `C9 «Управление проектами»` section. Defines how the Лидерра +development project is planned, tracked, and reported. + +## Toolset + +- **CCPM** (`.claude/skills/ccpm/`) — the PRD→epic→GitHub-issue→code traceability + layer. PRDs live in `.claude/prds/`, epics/tasks in `.claude/epics//`. + Invoked via the `/pm` flow / the `ccpm` skill. +- **GitHub MCP** — issues, sub-issues (epic = parent issue, task = sub-issue), + and **Projects v2** boards used as the sprint/iteration board. +- **Superpowers `writing-plans` / `executing-plans` / `subagent-driven-development`** + — authoring and running execution plan-files in `docs/superpowers/plans/`. +- **`q-item-add` skill + `docs/Открытые_вопросы_v8_3.md`** — the open-question + registry (Б-/CTO-/Ю-/Диз-/DO-/OPEN- codes). +- **product-management plugin** (if installed — see Task 5) — PRD/roadmap/metrics + product-strategy ceremonies. + +## Boundaries (which tool for which artifact) + +- **Open product/business/legal question** → `Открытые_вопросы` registry. Not an + epic, not an ADR — it has no resolution yet. +- **A closed technical/architecture decision** → `docs/adr/` (adr-kit, A6). +- **A feature to build, with engineering traceability** → a CCPM PRD → epic → + GitHub issues. +- **The step-by-step execution plan for that epic** → a `docs/superpowers/plans/` + file (Superpowers `writing-plans`). CCPM tracks *what & status*; the plan + file tracks *how, task-by-task*. +- **Product-strategy spec / roadmap** → product-management `/write-spec` / + `/roadmap-update` (if installed); else a registry/WISHLIST entry. + +## Workflow + +1. Idea → CCPM PRD (`.claude/prds/`). +2. PRD → epic + GitHub issues (CCPM `sync`, via GitHub MCP `issue_write` / + `sub_issue_write`). +3. Epic → a `docs/superpowers/plans/` plan-file → execution. +4. Status → CCPM `status.sh` / `standup.sh`; the GitHub Projects v2 board is the + sprint view.