docs(c10): plan correction — operations is 9 skills, not /ops:* commands

Task 2 install revealed operations@knowledge-work-plugins v1.2.0 ships
9 skills (process-doc, process-optimization, change-request, …) and 0
lifecycle hooks — not /ops:* slash-commands. OPS4 resolved on install;
+OPS5 (boundary vs the 2 self-authored skills); skill "Границы" sharpened.
cspell-words += RACI/DMN/czlonkowski.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This commit is contained in:
Дмитрий
2026-05-17 18:21:49 +03:00
parent e84172ed14
commit 5d054227cd
2 changed files with 41 additions and 23 deletions
+5
View File
@@ -1391,3 +1391,8 @@ ivotoby
дровер
канбаном
коммитить
# C10 business-process tooling integration — spec + plan (2026-05-17)
RACI
DMN
czlonkowski
@@ -16,13 +16,13 @@
| # | Tool | Install mode | Source / License | Hooks? |
|---|---|---|---|---|
| 1 | **operations plugin** — business-process documentation (`/ops:process-doc`), change management (`/ops:change-request`), capacity planning (`/ops:capacity-plan`), vendor review (`/ops:vendor-review`). | Claude Code **marketplace plugin**`operations@knowledge-work-plugins`; marketplace `anthropics/knowledge-work-plugins` (already added — #42/#46 installed from it) | GitHub `anthropics/knowledge-work-plugins`, Anthropic Verified | Verify on install (Task 2 Step 4) — knowledge-work plugins are skills + slash-commands; #42/#46 added no lifecycle hooks |
| 1 | **operations plugin** 9 business-process skills: `process-doc`, `process-optimization`, `change-request`, `capacity-plan`, `compliance-tracking`, `risk-assessment`, `runbook`, `status-report`, `vendor-review`. | Claude Code **marketplace plugin**`operations@knowledge-work-plugins` v1.2.0; marketplace `anthropics/knowledge-work-plugins` (already added — #42/#46 installed from it) | GitHub `anthropics/knowledge-work-plugins`, Anthropic Verified | **None** — skills-only plugin, no `hooks/` dir, no `commands/` dir (verified on install 2026-05-17, Task 2) |
| 2 | **process-modeling skill** — BPMN 2.0 notation, process maps, customer-journey / value-stream maps, RACI matrices, state-machine modeling. Renders via the `mermaid` skill. | **Self-authored** standalone skill — created in `.claude/skills/process-modeling/` (no plugin, no marketplace) | Project-authored — content in this plan (Task 3) | None — self-authored, no `hooks` block |
| 3 | **process-analysis skill** — process discovery (reverse-engineer the as-is process from Laravel code + audit-log tables), bottleneck analysis, requirement→process traceability, business-process KPI/metrics. | **Self-authored** standalone skill — created in `.claude/skills/process-analysis/` | Project-authored — content in this plan (Task 4) | None — self-authored, no `hooks` block |
| — | **n8n-mcp** (`czlonkowski/n8n-mcp`) — workflow-automation MCP server for the n8n platform. | **NOT installed** — deferred reserved slot (see "Deferred Task"). | GitHub `czlonkowski/n8n-mcp`, **MIT** | n/a — not installed |
| — | **mermaid** / **architecture-patterns** / **CCPM** / **product-management** / **superpowers writing-plans** | **Reuse** — already installed; surfaced in C10 via `NODE_SECTION_SECONDARY` | A6 #37/#38, C9 #41/#42, superpowers | n/a |
**Verification status:** operations — plugin **name `operations`** confirmed via the live `anthropics/knowledge-work-plugins` `.claude-plugin/marketplace.json` (WebFetch 2026-05-17); description "Optimize business operations — vendor management, process documentation, change management, capacity planning, and compliance tracking"; plugin-id form `operations@knowledge-work-plugins` (matches `product-management@knowledge-work-plugins` / `design@knowledge-work-plugins`). The exact `/ops:*` command list is confirmed on install (Task 2 Step 3). n8n-mcp — repo `czlonkowski/n8n-mcp`, MIT, Claude Code compatible, confirmed via WebSearch; **not installed by this plan**.
**Verification status:** operations — plugin **name `operations`** confirmed via the live `anthropics/knowledge-work-plugins` `.claude-plugin/marketplace.json` (WebFetch 2026-05-17); plugin-id `operations@knowledge-work-plugins`. **Installed 2026-05-17 (Task 2): v1.2.0, scope user.** It ships **9 skills** (`process-doc`, `process-optimization`, `change-request`, `capacity-plan`, `compliance-tracking`, `risk-assessment`, `runbook`, `status-report`, `vendor-review`) — **not** `/ops:*` slash-commands — and **no lifecycle hooks** (no `hooks/` / `commands/` dir). n8n-mcp — repo `czlonkowski/n8n-mcp`, MIT, Claude Code compatible, confirmed via WebSearch; **not installed by this plan**.
**Deferred (with reason — no task in this plan):**
@@ -42,10 +42,11 @@ Pattern follows the AK1CC1 / ML1NUM1 audits used for the A6 / C9 / D3 / A1
| # | Tool | Sev | Conflict | Resolution (locked) |
|---|---|---|---|---|
| OPS1 | operations | 🟢 | `/ops:process-doc` produces a flowchart; the `mermaid` skill (A6) renders diagrams — overlapping render. | operations emits **Mermaid source**; the `mermaid` skill stays the render-SoT. operations owns the *document* + methodology, mermaid owns *rendering*. Stated in `docs/process/README.md` (Task 5) + the Tooling entry (Task 7). |
| OPS2 | operations | 🟢 | `/ops:capacity-plan` overlaps product-management `/sprint-planning` (C9) and the C8 HR domain. | Boundary by scope: operations capacity-plan = cross-functional business-process capacity; `/sprint-planning` = dev-team sprints; C8 = HR. Boundary documented in `docs/process/README.md` (Task 5). |
| OPS3 | operations | 🟢 | `/ops:change-request` overlaps adr-kit (A6) and claude-md-management. | Distinct objects: change-request = business-process change; ADR = architecture decision; claude-md-management = normative-doc edit. Documented in `docs/process/README.md` (Task 5). |
| OPS4 | operations | 🟡 | knowledge-work-plugins are built primarily for "Claude Cowork" — the plugin must verifiably activate in **Claude Code**. | Task 2 installs + Step 3 verifies the `/ops:*` slash-commands appear in-session. Strong precedent: #42 product-management and #46 design from the **same marketplace** are already integrated and work in Claude Code. If `/ops:*` do not surface → stop, report. |
| OPS1 | operations | 🟢 | The operations `process-doc` skill produces a flowchart; the `mermaid` skill (A6) renders diagrams — overlapping render. | operations emits **Mermaid source**; the `mermaid` skill stays the render-SoT. operations owns the *document* + methodology, mermaid owns *rendering*. Stated in `docs/process/README.md` (Task 5) + the Tooling entry (Task 7). |
| OPS2 | operations | 🟢 | The operations `capacity-plan` skill overlaps product-management `/sprint-planning` (C9) and the C8 HR domain. | Boundary by scope: operations `capacity-plan` = cross-functional business-process capacity; `/sprint-planning` = dev-team sprints; C8 = HR. Boundary documented in `docs/process/README.md` (Task 5). |
| OPS3 | operations | 🟢 | The operations `change-request` skill overlaps adr-kit (A6) and claude-md-management. | Distinct objects: `change-request` = business-process change; ADR = architecture decision; claude-md-management = normative-doc edit. Documented in `docs/process/README.md` (Task 5). |
| OPS4 | operations | 🟢 | knowledge-work-plugins are built primarily for "Claude Cowork" — the plugin must verifiably activate in **Claude Code**. | **Resolved on install (Task 2):** operations v1.2.0 installed (scope user), present in `~/.claude/settings.json` `enabledPlugins`, ships 9 skills auto-discovered by Claude Code, **0 lifecycle hooks**. Same marketplace as the working #42/#46. |
| OPS5 | operations vs the 2 self-authored skills | 🟢 | operations ships `process-doc` (overlaps `process-modeling`) and `process-optimization` (overlaps `process-analysis`). | Boundary: operations skills are **generic, stack-agnostic** business-process methodology. The self-authored skills cover what operations structurally cannot: **`process-modeling`** = formal BPMN 2.0 / state-machine notation rendered via `mermaid`, grounded in `db/schema.sql` (the 14-status funnel); **`process-analysis`** = as-is discovery grounded in the Лидерра codebase (`routes/`, `app/Jobs`, `audit_*` tables) — operations cannot read the repo. Each self-authored `SKILL.md` "Границы" names the operations skills explicitly; generic optimization methodology is delegated to operations `process-optimization`. |
| BPMN1 | process-modeling | 🟢 | Overlap with the `mermaid` skill. | `mermaid` renders flowchart/state; it does **not** carry BPMN 2.0 semantics (pools/lanes/gateways/events methodology). `process-modeling` owns BPMN methodology and **delegates rendering** to `mermaid`. Stated in the skill's `SKILL.md` "Границы" section (Task 3). |
| LINT1 | process-modeling, process-analysis | 🟡 | Self-authored skills `.claude/skills/process-{modeling,analysis}/**/*.md` are caught by the cspell + markdownlint pre-commit jobs. | **Decision:** these are **self-authored project skills** — they are **linted** like `audit-portal` / `regression` (NOT lint-ignored like the vendored `mermaid`/`ccpm`/`data-scientist`). Skill content is written lint-clean; new technical vocabulary (`BPMN`, `swimlane`, `gateway`, `RACI`, `throughput`, …) goes to `cspell-words.txt`. Task 1 Step 5 confirms project skills are not in `cspell.json` `ignorePaths` / `.markdownlintignore`; if they unexpectedly are → follow suit and record. |
| PA1 | process-analysis | 🟢 | Overlap with `perf-analyzer` / `analysis:bottleneck-detect` and product-management `/metrics-review`. | Different objects: `process-analysis` = *business-process* discovery/optimization; `perf-analyzer` / `bottleneck-detect` = *code/runtime* performance; `/metrics-review` = *product* metrics. Boundary in the skill's "Границы" section (Task 4) + `docs/process/README.md` (Task 5). |
@@ -64,7 +65,7 @@ Pattern follows the AK1CC1 / ML1NUM1 audits used for the A6 / C9 / D3 / A1
| File | Created / Modified | Responsibility |
|---|---|---|
| `docs/process/` | Create dir | C10 home — the business-process playbook |
| `docs/process/README.md` | Create | The BP convention: tool boundaries (operations = *document/change/capacity* · process-modeling = *model* · process-analysis = *discover & optimise* · n8n-mcp = *deferred engine*); the reuse-layer cross-ref map; the OPS1/OPS2/OPS3/PA1 boundaries |
| `docs/process/README.md` | Create | The BP convention: tool boundaries (operations = *document/change/capacity* · process-modeling = *model* · process-analysis = *discover & optimize* · n8n-mcp = *deferred engine*); the reuse-layer cross-ref map; the OPS1/OPS2/OPS3/PA1 boundaries |
| `docs/process/examples/deal-lifecycle-process.md` | Create | One worked example — the deal-lifecycle process modeled as a BPMN-style swimlane (the seed artifact, the A11 `promptfoo-example` pattern) |
| `.claude/skills/process-modeling/SKILL.md` | Create (self-authored) | The process-modeling skill — frontmatter + methodology |
| `.claude/skills/process-modeling/references/bpmn.md` | Create (self-authored) | BPMN 2.0 element reference + the BPMN→mermaid rendering map |
@@ -140,6 +141,7 @@ ls docs/adr/
```
Read `docs/Tooling_v8_3.md` Прил. Н §0 — record the **live** tool counter and the last `§4.x` subsection number. Expected (post-A11): counter `50`, last subsection `§4.25`. Record:
- C10 numbers = `counter+1 .. counter+4`: operations, process-modeling, process-analysis, n8n-mcp (pending).
- C10 subsections = next four after the last `§4.x`.
- ADR number = next free after the highest existing `ADR-NNN` (expected `ADR-008``ADR-007-ml-ai-tooling.md` exists).
@@ -188,6 +190,7 @@ Confirm `operations@knowledge-work-plugins` is listed in `~/.claude/settings.jso
## Task 3: Author the process-modeling skill (BPMN1 / LINT1)
**Files:**
- Create: `.claude/skills/process-modeling/SKILL.md`
- Create: `.claude/skills/process-modeling/references/bpmn.md`
@@ -252,8 +255,8 @@ description: Моделирование бизнес-процесса — BPMN 2
рисует — отдаёт его mermaid.
- **DDD-границы доменных процессов** — скил `architecture-patterns` (bounded
context = граница бизнес-процесса).
- **Документ процесса, change-request** — плагин `operations`
(`/ops:process-doc`, `/ops:change-request`).
- **Документ процесса, change-request, оптимизация** — плагин `operations`
(скилы `process-doc`, `change-request`, `process-optimization`).
- **Анализ as-is процесса** (discovery, узкие места) — скил `process-analysis`.
- Этот скил — про проектирование **to-be модели**, не про вскрытие as-is.
```
@@ -348,6 +351,7 @@ git commit -m "feat(c10): add self-authored process-modeling skill (BPMN/process
## Task 4: Author the process-analysis skill (PA1 / LINT1)
**Files:**
- Create: `.claude/skills/process-analysis/SKILL.md`
- Create: `.claude/skills/process-analysis/references/discovery.md`
@@ -414,7 +418,10 @@ description: Анализ и оптимизация существующего
`analysis:bottleneck-detect` (PA1).
- **Продуктовые метрики** — плагин `product-management`.
- **Документ / change-request процесса** — плагин `operations`.
- Этот скил — про вскрытие **as-is**, не про проектирование.
- **Генерик-методология оптимизации процесса** — скил `process-optimization`
плагина `operations`. Этот скил — про code-grounded discovery конкретного
процесса Лидерры (вскрытие as-is), не про общую методологию и не про
проектирование to-be.
```
- [ ] **Step 2: Create the discovery reference**
@@ -483,6 +490,7 @@ git commit -m "feat(c10): add self-authored process-analysis skill (discovery/bo
## Task 5: Bootstrap the C10 home — `docs/process/` + worked example + ADR-008
**Files:**
- Create: `docs/process/README.md`, `docs/process/examples/deal-lifecycle-process.md`
- Create: `docs/adr/ADR-008-business-process-tooling.md`
- Modify (conditional): `cspell-words.txt`
@@ -505,7 +513,7 @@ uses to model, automate and analyse business processes.
| Tool | Role | Status |
|---|---|---|
| **operations plugin** | Document a process (`/ops:process-doc`), change management (`/ops:change-request`), capacity planning (`/ops:capacity-plan`), vendor review (`/ops:vendor-review`). | installed — `operations@knowledge-work-plugins` |
| **operations plugin** | 9 skills — `process-doc`, `process-optimization`, `change-request`, `capacity-plan`, `compliance-tracking`, `risk-assessment`, `runbook`, `status-report`, `vendor-review`. | installed — `operations@knowledge-work-plugins` v1.2.0 |
| **process-modeling skill** | Model a to-be process — BPMN 2.0, process maps, customer-journey / value-stream, RACI, state-machines. | installed — self-authored skill |
| **process-analysis skill** | Analyse an as-is process — discovery from code/audit-logs, bottlenecks, traceability, BP metrics. | installed — self-authored skill |
| **n8n-mcp** | Workflow-automation engine. | **deferred** — see below |
@@ -513,16 +521,21 @@ uses to model, automate and analyse business processes.
## Boundaries (which tool for which job)
- **Documenting a process / a change to it / capacity** → the **operations** plugin.
- **Designing a to-be process model** (BPMN, swimlane, state-machine) → the
**process-modeling** skill — which delegates *rendering* to the **mermaid** skill
(operations and process-modeling emit Mermaid source; mermaid renders — OPS1/BPMN1).
- **Reverse-engineering / optimising an as-is process** → the **process-analysis**
skill.
- `/ops:capacity-plan` plans **cross-functional business-process** capacity;
dev-team sprint capacity is product-management `/sprint-planning` (OPS2).
- `/ops:change-request` = a **business-process** change; an architecture decision
is an ADR (adr-kit); a normative-doc edit is claude-md-management (OPS3).
- **Documenting a process / a change to it / capacity / generic optimization** →
the **operations** plugin skills (`process-doc`, `change-request`,
`capacity-plan`, `process-optimization`, …).
- **Designing a to-be process model** (formal BPMN 2.0, swimlane, state-machine) →
the **process-modeling** skill — which delegates *rendering* to the **mermaid**
skill (operations and process-modeling emit Mermaid source; mermaid renders —
OPS1/BPMN1).
- **Reverse-engineering an as-is process from the Лидерра codebase** → the
**process-analysis** skill (discovery from `routes/`, `app/Jobs`, `audit_*`
tables — what the generic `process-optimization` skill cannot do; OPS5).
- The operations `capacity-plan` skill plans **cross-functional business-process**
capacity; dev-team sprint capacity is product-management `/sprint-planning` (OPS2).
- The operations `change-request` skill = a **business-process** change; an
architecture decision is an ADR (adr-kit); a normative-doc edit is
claude-md-management (OPS3).
- process-analysis finds **business-process** bottlenecks; **code/runtime**
performance is `perf-analyzer` / `analysis:bottleneck-detect` (PA1).
@@ -649,7 +662,7 @@ git commit -m "feat(c10): bootstrap docs/process — README + worked example + A
- [ ] **Step 1: Smoke-test the operations plugin**
Run `/ops:process-doc` (or the closest available `/ops:*` command from Task 2 Step 3) on a trivial process (e.g. "лид поступил → менеджер принял → создана сделка"). Expected: the command runs and produces a process document / flowchart. Functional smoke — no file output required. Record which `/ops:*` commands exist.
Invoke the operations `process-doc` skill on a trivial process (e.g. "лид поступил → менеджер принял → создана сделка"). Expected: the skill loads and produces a process document / flowchart. Functional smoke — no file output required. The 9 operations skills were already enumerated on install (Task 2): `process-doc`, `process-optimization`, `change-request`, `capacity-plan`, `compliance-tracking`, `risk-assessment`, `runbook`, `status-report`, `vendor-review`.
- [ ] **Step 2: Smoke-test the process-modeling skill**
@@ -679,7 +692,7 @@ Read for exact insertion points and the **current** counter: `docs/Tooling_v8_3.
Edit `docs/Tooling_v8_3.md`: add `§4.26``§4.29` (next four after the last subsection), category **business-process** (off-phase). Per tool:
- **operations** (`#51`) — marketplace plugin `operations@knowledge-work-plugins` (`anthropics/knowledge-work-plugins`), Anthropic Verified; commands `/ops:process-doc` / `/ops:change-request` / `/ops:capacity-plan` / `/ops:vendor-review` (the list confirmed in Task 2 Step 3); boundaries OPS1/OPS2/OPS3; no CC hooks.
- **operations** (`#51`) — marketplace plugin `operations@knowledge-work-plugins` v1.2.0 (`anthropics/knowledge-work-plugins`), Anthropic Verified; ships **9 skills** (`process-doc`, `process-optimization`, `change-request`, `capacity-plan`, `compliance-tracking`, `risk-assessment`, `runbook`, `status-report`, `vendor-review`); **0 lifecycle hooks**; boundaries OPS1/OPS2/OPS3/OPS5.
- **process-modeling** (`#52`) — self-authored standalone skill in `.claude/skills/process-modeling/`; BPMN 2.0 + process maps; renders via mermaid (BPMN1); linted, not lint-ignored (LINT1).
- **process-analysis** (`#53`) — self-authored standalone skill in `.claude/skills/process-analysis/`; as-is discovery / bottleneck / traceability / metrics; boundary vs perf-analyzer (PA1).
- **n8n-mcp** (`#54`) — `czlonkowski/n8n-mcp`, MIT, **pending — NOT installed**; deferred severable task gated on an ADR adopting n8n (N8N1); the Sentry #34 / Jupyter #50 "pending" precedent.