From 9c4e6d42d45fdc604a4cc923e9c5569f0f2cb53e Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=D0=94=D0=BC=D0=B8=D1=82=D1=80=D0=B8=D0=B9?=
 <donnalee11681676@gmail.com>
Date: Sun, 17 May 2026 08:05:20 +0300
Subject: [PATCH] feat(c9): bootstrap docs/projects + CCPM store + ADR-004

---
 .claude/epics/.gitkeep                        |  1 +
 .claude/prds/.gitkeep                         |  1 +
 .../adr/ADR-004-project-management-tooling.md | 33 +++++++++++++++
 docs/projects/README.md                       | 40 +++++++++++++++++++
 4 files changed, 75 insertions(+)
 create mode 100644 .claude/epics/.gitkeep
 create mode 100644 .claude/prds/.gitkeep
 create mode 100644 docs/adr/ADR-004-project-management-tooling.md
 create mode 100644 docs/projects/README.md

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/<feature>/`.
+  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.