@dzhechkov/p-replicator 1.5.17 → 1.6.0

package/templates/.claude/rules/docker-ports.md

@@ -0,0 +1,123 @@
+# Docker-порты: что смотрит наружу, а что нет
+
+## Правило №0 — хранилище не публикуется в интернет
+
+**Инвариант:** у хранилища НЕТ публикации на хост — кроме привязки к петле. Postgres, MySQL,
+MariaDB, MongoDB, Redis, Elasticsearch/OpenSearch, MinIO, RabbitMQ, Memcached, ClickHouse.
+
+Формулировка «не на все интерфейсы» была бы слишком узкой и пропускала бы половину случаев. Запрещено
+всё это, а не только первое:
+
+| Строка | Почему нарушение |
+|---|---|
+| `"5432:5432"` | без адреса Docker привязывает ко ВСЕМ интерфейсам |
+| `"0.0.0.0:5432:5432"` | то же самое, явно |
+| `"[::]:5432:5432"` | IPv6-джокер — та же дыра, часто забывают |
+| `"203.0.113.7:5432:5432"` | ОДИН явный публичный адрес: не «все интерфейсы», но из интернета доступно ровно так же |
+| `network_mode: host` | публикации нет вовсе, а порт всё равно наружу: контейнер слушает прямо на хосте. Хранилищу этот режим не подходит |
+
+Разрешено ровно два состояния: публикации нет, либо она привязана к петле (`127.0.0.1` или `::1`).
+
+**Почему это правило №0, а не пожелание.** Тестовый Postgres, поднятый с `-p 55432:5432` и паролем
+`postgres`, был взломан из интернета примерно за час: через `COPY … TO PROGRAM` на машину въехал
+червь-майнер. Порт был открыт «на время отладки». Цена ошибки здесь — компрометация машины, а не
+неудобство, поэтому правило безусловное.
+
+## Что писать вместо
+
+Достаточно **убрать `ports:` целиком**:
+
+```yaml
+services:
+  db:
+    image: postgres:16
+    # никакого ports: — и это ПОЛНОЕ решение
+```
+
+**Соседи по сети compose достучатся до сервиса по его имени** (`db:5432`) без всякой публикации:
+внутри сети видны все порты, которые контейнер слушает. Публикация нужна только для доступа С ХОСТА,
+а не между контейнерами.
+
+`expose:` в современном Compose ничего не открывает и ничего не требуется — это документирующая
+запись, не более:
+
+```yaml
+    expose:
+      - "5432"        # необязательно; читается как «этот сервис слушает 5432»
+```
+
+Писать её можно, полагаться на неё как на «то, что включает доступ» — нельзя: доступ внутри сети есть
+и без неё.
+
+## Исключение: петля — это законно
+
+Привязка к петлевому адресу разрешена и является нормальным способом поднять тестовое окружение,
+где тесты идут с хоста:
+
+```yaml
+    ports:
+      - "127.0.0.1:55432:5432"   # ЗАКОННО: доступно только с самой машины
+```
+
+Петлевых форм две и они равноправны: `127.0.0.1:` и `[::1]:`. Всё остальное — нарушение, включая
+`0.0.0.0`, `[::]`, отсутствие адреса вообще и один явный внешний адрес. Docker показывает привязку
+как `host_ip:`; «доступно мне» от «доступно всем» отличает именно она.
+
+Правило без этого исключения запрещало бы ровно то, что предписывает сам конвейер, поэтому исключение
+такая же часть правила, как и запрет.
+
+## За reverse-proxy приложение тоже не публикуется
+
+Если в compose есть `caddy`/`nginx`/`traefik`, то он и есть единственная дверь. Опубликованное рядом
+приложение позволяет обойти прокси — а вместе с ним и всё, что прокси гарантирует: TLS,
+rate-limiting, заголовки. Известный конкретный случай: код, доверяющий последнему элементу
+`X-Forwarded-For`, потому что его дописывает прокси, при прямом доступе получает этот элемент от
+клиента — и лимит обходится сменой заголовка.
+
+## Чем это правило НЕ является
+
+**Проверка теперь есть — но она не запускается сама.** В пакете отгружается
+`.claude/hooks/check-ports.cjs`: он читает нормализованный конфиг (`docker compose config`) и
+проверяет ровно этот инвариант, включая `network_mode: host` и обход reverse-proxy.
+
+```bash
+node .claude/hooks/check-ports.cjs .          # или путь к конкретному compose-файлу
+```
+
+Коды возврата — три, и третий здесь главный: `0` правило соблюдено, `1` нарушено, **`2` проверка НЕ
+ВЫПОЛНЕНА** (нет compose, нет docker, конфиг не читается). Проверка, которая на нечитаемом конфиге
+отвечает «чисто», хуже отсутствия проверки: она превращает неизвестность в заверение.
+
+**Чего она НЕ делает.** Она не привязана ни к какому событию — её надо позвать. Она смотрит на ВАШ
+проект, а не на машину: конфликты с портами, уже занятыми другими контейнерами, она не ищет. И она
+проверяет конфиг, а не запущенный стек.
+
+Детерминированная проверка существует отдельно (`check-port-conflicts.sh`, «Правило №0») и в этот
+пакет не входит. Причина: она на bash, а ХУКИ пакета принципиально на кросс-платформенном Node —
+ради Windows, — и проверка портов по форме именно хук. (Точности ради: пара вспомогательных `.sh`
+в пакете уже есть, внутри навыка `brutal-honesty-review`; обещание Node относится к хукам, а не ко
+всему пакету.) Если проверка вам нужна, её надо взять и подключить осознанно.
+
+Не выводите из присутствия этого правила, что кто-то за вас смотрит. Пока проверки нет, единственный
+контроль — глаза на ревью, и знать об этом важнее, чем иметь правило.
+
+## Быстрая самопроверка
+
+```bash
+docker compose config
+```
+
+Смотреть надо весь нормализованный вывод, а не окно вокруг `published`: Docker печатает `host_ip`
+отдельной строкой, и она не обязана попасть в фиксированные `-A2` — проверка по окну молча пропустит
+нарушение.
+
+Для каждого сервиса-хранилища ответьте на два вопроса:
+
+1. есть ли у него `published:` (или `network_mode: host`)?
+2. если есть — стоит ли рядом `host_ip: 127.0.0.1` либо `host_ip: ::1`?
+
+«Да» на первый и «нет» на второй — нарушение правила №0. Обе петлевые формы равноправны: проверка
+только по `127.0.0.1` отвергла бы `::1`, который это же правило разрешает.
+
+Детерминированная версия этой проверки существует и разбирает вывод с отслеживанием состояния именно
+потому, что построчного окна недостаточно.

package/templates/.claude/rules/replicate-pipeline.md

@@ -121,6 +121,9 @@ Always pass these constraints to sparc-prd-mini (Phase 1):
 - Infrastructure: VPS (AdminVPS/HOSTKEY)
 - Deploy: Docker Compose direct deploy
 - AI Integration: MCP servers
+- Storage: у баз и очередей НЕТ публикации на хост — кроме привязки к петле (`127.0.0.1` / `::1`).
+  Ни `0.0.0.0`, ни `[::]`, ни один явный внешний адрес, ни `network_mode: host`
+  (см. `.claude/rules/docker-ports.md`, «Правило №0»)
 
 ## Git Discipline During Pipeline
 
@@ -148,8 +151,8 @@ are project-agnostic and can be enhanced (read by Phase 3) but never recreated.
 **Agents (4):** `replicate-coordinator`, `product-discoverer`, `doc-validator`,
 `harvest-coordinator`
 
-**Rules (5):** `replicate-pipeline`, `skill-interface-protocol`, `git-workflow`,
-`insights-capture`, `feature-lifecycle`
+**Rules (6):** `replicate-pipeline`, `skill-interface-protocol`, `git-workflow`,
+`insights-capture`, `feature-lifecycle`, `docker-ports`
 
 **Hooks:** `.claude/settings.json` (SessionStart + Stop) + cross-platform Node
 scripts in `.claude/hooks/` (`session-insights.cjs`, `autocommit-roadmap.cjs`,

package/templates/.claude/settings.json

@@ -3,7 +3,7 @@
   "_comment": "Default hooks + statusline shipped by @dzhechkov/p-replicator init. Cross-platform Node scripts (no bash dependencies). Auto-commits roadmap/insights/plans on Stop, injects relevant insights on SessionStart. Statusline displays pipeline+roadmap+toolkit dashboard above the prompt. Project-specific hooks (DDD, fitness functions, etc.) are merged in by /replicate Phase 3.",
   "statusLine": {
     "type": "command",
-    "command": "node .claude/hooks/statusline.cjs"
+    "command": "node \"${CLAUDE_PROJECT_DIR}/.claude/hooks/statusline.cjs\""
   },
   "hooks": {
     "SessionStart": [
@@ -12,7 +12,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "node .claude/hooks/session-insights.cjs",
+            "command": "node \"${CLAUDE_PROJECT_DIR}/.claude/hooks/session-insights.cjs\"",
             "timeout": 5
           }
         ]
@@ -24,17 +24,17 @@
         "hooks": [
           {
             "type": "command",
-            "command": "node .claude/hooks/autocommit-roadmap.cjs",
+            "command": "node \"${CLAUDE_PROJECT_DIR}/.claude/hooks/autocommit-roadmap.cjs\"",
             "timeout": 10
           },
           {
             "type": "command",
-            "command": "node .claude/hooks/autocommit-insights.cjs",
+            "command": "node \"${CLAUDE_PROJECT_DIR}/.claude/hooks/autocommit-insights.cjs\"",
             "timeout": 10
           },
           {
             "type": "command",
-            "command": "node .claude/hooks/autocommit-plans.cjs",
+            "command": "node \"${CLAUDE_PROJECT_DIR}/.claude/hooks/autocommit-plans.cjs\"",
             "timeout": 10
           }
         ]

package/templates/.claude/skills/cc-toolkit-generator-enhanced/modules/01-detect-parse.md

@@ -1,7 +1,7 @@
 # Module: Detect & Parse
 
 Phase 1 of the CC-Toolkit-Generator Enhanced pipeline.
-Scans the documentation directory, detects the pipeline type, identifies project
+Scans the PROJECT ROOT (see `docs_path` below — it is the root, not `docs/`), detects the pipeline type, identifies project
 characteristics, and builds the Internal Project Model (IPM) used by all
 subsequent modules.
 
@@ -11,7 +11,7 @@ subsequent modules.
 
 | Parameter | Type | Description |
 |-----------|------|-------------|
-| `docs_path` | string | Path to documentation directory. In Claude.ai context this is `/mnt/user-data/uploads/`. In Claude Code / replicate context this is `docs/` (project root). |
+| `docs_path` | string | The directory every probe below resolves from. In Claude.ai context: `/mnt/user-data/uploads/`. In Claude Code / replicate context: **the PROJECT ROOT** — not `docs/`. It has to be the root, because the probes reach both `.ai-context/` (a root-level directory, beside `.claude/`) and `docs/…` below it; anchoring at `docs/` would force `../` on half of them. |
 
 No prior module output is required. This is the foundation module.
 
@@ -25,7 +25,7 @@ Scan `docs_path` recursively and catalog every file by category.
 
 ```
 SCAN docs_path FOR:
-  # SPARC pipeline files (top-level or docs/)
+  # SPARC pipeline files — under docs/ (replicate.md:233-243 writes them all there)
   PRD.md
   Solution_Strategy.md
   Specification.md
@@ -41,7 +41,8 @@ SCAN docs_path FOR:
   docs/prd/PRD.md
   docs/ddd/strategic/    # bounded-contexts.md, context-map.md
   docs/ddd/tactical/     # aggregates/, entities/, value-objects/, events/, repositories/
-  docs/adr/*.md          # ADR-001-*.md, ADR-002-*.md, ...
+  docs/adr/*.md          # ADR-001-*.md, ADR-002-*.md, ... (directory shape)
+  docs/ADR.md            # single-file shape — /replicate writes ALL decisions here
   docs/c4/*.mermaid      # context.mermaid, container.mermaid, component.mermaid
   docs/pseudocode/*.pseudo
   docs/tests/*.feature   # Gherkin scenarios
@@ -72,13 +73,18 @@ def detect_pipeline(docs_path: str) -> str:
     has_ddd       = exists(f"{docs_path}/docs/ddd/")
     has_ai_context = exists(f"{docs_path}/.ai-context/")
     has_gherkin   = glob(f"{docs_path}/docs/tests/*.feature")
-    has_adr       = len(glob(f"{docs_path}/docs/adr/*.md")) > 5
-    has_sparc_arch = exists(f"{docs_path}/Architecture.md")
-    has_sparc_sol  = exists(f"{docs_path}/Solution_Strategy.md")
+    # Pipeline-IDENTITY marker: the docs/adr/ DIRECTORY is an idea2prd fingerprint. The
+    # expression is deliberately unchanged (>5) so routing stays byte-identical for every
+    # existing project. The DECISION-presence flag `has_adr` (see Collector below) never
+    # participates in routing: it can now be true via docs/ADR.md — a /replicate fingerprint,
+    # not an idea2prd one — and flipping routing on it would silently reroute SPARC projects.
+    has_idea2prd_adr_dir = len(glob(f"{docs_path}/docs/adr/*.md")) > 5
+    has_sparc_arch = exists(f"{docs_path}/docs/Architecture.md")      # replicate.md:237 writes it here
+    has_sparc_sol  = exists(f"{docs_path}/docs/Solution_Strategy.md") # replicate.md:234 writes it here
 
     if has_ddd and has_ai_context:
         return "IDEA2PRD_FULL"      # Complete idea2prd-manual output
-    elif has_ddd or has_adr:
+    elif has_ddd or has_idea2prd_adr_dir:
         return "IDEA2PRD_PARTIAL"   # Partial idea2prd output
     elif has_sparc_arch and has_sparc_sol:
         return "SPARC"              # Full SPARC documentation set
@@ -88,12 +94,49 @@ def detect_pipeline(docs_path: str) -> str:
         return "MINIMAL"            # Basic PRD only, or mixed
 ```
 
+### ADR collector — ONE normalizer for both storage shapes
+
+ADRs arrive in two shapes: a `docs/adr/*.md` directory (idea2prd-manual, one decision per file) and
+a single `docs/ADR.md` (what `/replicate` writes). ONE collector handles both; no other step in this
+skill may glob ADR paths for itself — every consumer iterates `detected_docs.idea2prd.adrs`.
+
+```python
+def collect_adrs(docs_path: str) -> list:
+    entries = []
+    for f in glob(f"{docs_path}/docs/adr/*.md"):           # shape A: one decision per file
+        entries.append({ "id": id_from_filename(f),        # ADR-001-title.md -> "ADR-001"
+                         "title": first_heading(f),
+                         "source_path": f })
+    single = f"{docs_path}/docs/ADR.md"                    # shape B: /replicate's single file
+    if exists(single):
+        for section in split_on_h2_headings(read(single)): # each "## ..." heading opens one decision
+            entries.append({ "id": id_from_heading(section),   # "## ADR-003: X" -> "ADR-003"; else slug of title
+                             "title": heading_title(section),
+                             "source_path": single })
+    # STABLE-FIRST dedupe: keep the FIRST entry for a given id (falling back to title when an id is
+    # absent), and directory entries are appended first — so "directory wins" is a property of the
+    # ORDER above, not an unstated convention inside the helper.
+    return dedupe_stable_first_by_id_then_title(entries)   # both shapes present -> merged, no double-count
+
+has_adr = len(collect_adrs(docs_path)) > 0   # THE one definition — decisions, not files
+```
+
+Worked examples (the behavioural contract, verbatim acid ids):
+
+- **A1** — `docs/ADR.md` with two `##` sections ⇒ 2 entries, `has_adr: true`. The single-file shape
+  is a first-class citizen, not a fallback.
+- **A4** — `docs/ADR.md` exists but holds prose with NO `##` headings ⇒ 0 entries,
+  `has_adr: false`. A file is not a decision; presence of the path never flips the flag by itself.
+- **A5** — BOTH shapes present and `docs/adr/ADR-002-caching.md` duplicates the id of a `## ADR-002`
+  section ⇒ one merged list, the duplicate dropped (directory entry wins — it is the finer-grained
+  source).
+
 | Pipeline | Minimum Docs | Typical File Count |
 |----------|-------------|-------------------|
 | IDEA2PRD_FULL | `docs/ddd/` + `.ai-context/` | 30-50 files |
 | IDEA2PRD_PARTIAL | `docs/ddd/` or `docs/adr/` (>5) | 15-30 files |
-| SPARC | `Architecture.md` + `Solution_Strategy.md` | 8-11 files |
-| SPARC_MINIMAL | `Architecture.md` only | 2-5 files |
+| SPARC | `docs/Architecture.md` + `docs/Solution_Strategy.md` | 8-11 files |
+| SPARC_MINIMAL | `docs/Architecture.md` only | 2-5 files |
 | MINIMAL | PRD.md only | 1-3 files |
 
 ### Step 3: Detect Project Characteristics
@@ -116,7 +159,7 @@ IF any keyword found → has_external_apis = true
 #### 3b. `has_database`
 
 ```
-SCAN Architecture.md, Specification.md, docker-compose.yml,
+SCAN docs/Architecture.md, docs/Specification.md, docker-compose.yml (project root),
      ADR-*-data.md, repositories/*.md FOR:
   keywords: "PostgreSQL", "Postgres", "MongoDB", "MySQL", "Redis",
             "database", "Prisma", "TypeORM", "Drizzle", "Knex",
@@ -185,7 +228,7 @@ IPM = {
         events:         [paths] | [],
         repositories:   [paths] | []
       },
-      adrs:             [paths] | [],
+      adrs:             [{id, title, source_path}] | [],   // collect_adrs() output — entries, not bare paths
       c4_diagrams:      [paths] | [],
       pseudocode:       [paths] | [],
       gherkin_tests:    [paths] | [],
@@ -217,7 +260,7 @@ IPM = {
     has_ddd_strategic:  bool,   // same as has_ddd (alias for readability)
     has_gherkin:        bool,   // detected_docs.idea2prd.gherkin_tests non-empty
     has_fitness:        bool,   // detected_docs.idea2prd.fitness non-empty
-    has_adr:            bool,   // detected_docs.idea2prd.adr length > 0
+    has_adr:            bool,   // collect_adrs() output non-empty — the ONE definition (see ADR collector)
     has_c4:             bool,   // detected_docs.idea2prd.c4 non-empty
     has_ai_context:     bool,   // detected_docs.ai_context.readme non-null
     has_pseudocode:     bool,   // detected_docs.sparc.pseudocode OR idea2prd.pseudocode non-null
@@ -291,7 +334,7 @@ All of the following must be satisfied before the IPM is considered valid:
 
 | Check | Condition | Action on Failure |
 |-------|-----------|-------------------|
-| Minimum docs | SPARC: at least `PRD.md` + `Architecture.md` present | Halt. Ask user to upload missing docs. |
+| Minimum docs | SPARC: at least `docs/PRD.md` + `docs/Architecture.md` present | Halt. Ask user to upload missing docs. |
 | Minimum docs | idea2prd: at least `docs/ddd/` directory present | Halt. Ask user to upload missing docs. |
 | Pipeline resolved | `pipeline_type` is not ambiguous | If mixed signals, default to "SPARC" with unified mapping. |
 | Characteristics scanned | All 4 characteristic flags have been evaluated | Re-scan if any flag is missing. |

package/templates/.claude/skills/cc-toolkit-generator-enhanced/modules/02-analyze-map.md

@@ -128,7 +128,9 @@ DDD TACTICAL:
     - Event handlers           → PostToolUse hooks (P2)
 
 ADR DOCUMENTS:
-  FOR EACH adr/*.md:
+  # via detected_docs.idea2prd.adrs — the Module-1 collector output, BOTH storage
+  # shapes (docs/adr/*.md AND the single docs/ADR.md). Never glob ADR paths here.
+  FOR EACH entry IN detected_docs.idea2prd.adrs (read entry.source_path):
     CLASSIFY by keywords:
       "security", "auth", "encryption"  → security.md rule
       "performance", "scale", "cache"   → performance rules
@@ -217,8 +219,8 @@ aggregates/ has >3 files          → ddd-validator.md (+8), +5 if >7 files
 aggregates/ has >5 files          → aggregate-patterns/ (+5)
 events/ has >3 files              → event-handlers/ (+5)
 events/ has >0 files              → event-handlers/ (+10)
-docs/adr/ has >10 files           → architect.md (+10)
-docs/adr/ has >15 files           → architect.md (+5 additional)
+adrs has >10 decisions            → architect.md (+10)   # detected_docs.idea2prd.adrs — decisions, not files
+adrs has >15 decisions            → architect.md (+5 additional)
 docs/tests/*.feature exists       → testing-patterns/ (+10), tdd-guide.md (+8)
 tests/ has >10 scenarios          → testing-patterns/ (+5)
 docs/fitness/ exists              → fitness-functions.md (+10)
@@ -226,10 +228,10 @@ fitness has >5 functions          → validation hooks (+5)
 .ai-context/ exists               → INTEGRATE into CLAUDE.md, project-context/ (+10)
 .ai-context/ has >4 files         → project-context/ RECOMMEND
 
-# ADR Security Boost
-FOR EACH adr/*.md containing "security": security.md += 2
-FOR EACH adr/*.md containing "authentication": security.md += 1
-FOR EACH adr/*.md containing "encryption": security.md += 1
+# ADR Security Boost (over detected_docs.idea2prd.adrs — read each entry.source_path)
+FOR EACH adr entry containing "security": security.md += 2
+FOR EACH adr entry containing "authentication": security.md += 1
+FOR EACH adr entry containing "encryption": security.md += 1
 ```
 
 #### 4c. Assign Priority Tiers

package/templates/.claude/skills/cc-toolkit-generator-enhanced/references/enhanced-recommendations.md

@@ -13,7 +13,9 @@ def detect_pipeline(uploads_path: str) -> str:
     has_ddd = exists(f"{uploads_path}/docs/ddd/")
     has_ai_context = exists(f"{uploads_path}/.ai-context/")
     has_gherkin = glob(f"{uploads_path}/docs/tests/*.feature")
-    has_adr = len(glob(f"{uploads_path}/docs/adr/*.md")) > 5
+    # Shape marker only (mirrors Module 1 detect_pipeline). The DECISION flag has_adr is
+    # defined ONCE, in Module 1 ADR collector — never redefined here.
+    has_idea2prd_adr_dir = len(glob(f"{uploads_path}/docs/adr/*.md")) > 5
     has_sparc = exists(f"{uploads_path}/Architecture.md")
     
     if has_ddd and has_ai_context:
@@ -124,7 +126,7 @@ if len(events) > 5:
 ```python
 score = 10  # base (always somewhat useful)
 
-adrs = glob("docs/adr/*.md")
+adrs = detected_docs.idea2prd.adrs   # Module-1 collector: both storage shapes
 if len(adrs) > 5:
     score += 5
 if len(adrs) > 10:
@@ -145,8 +147,8 @@ if exists("docs/c4/container.mermaid"):
 ```python
 security_boost = 0
 
-for adr in glob("docs/adr/*.md"):
-    content = read(adr)
+for adr in detected_docs.idea2prd.adrs:   # both storage shapes
+    content = read(adr.source_path)
     if "security" in content.lower():
         security_boost += 2
     if "authentication" in content.lower():

package/templates/.claude/skills/cc-toolkit-generator-enhanced/references/extended-mapping.md

@@ -211,7 +211,7 @@ EXTRACT events/*.md:
 ### From ADRs
 
 ```
-FOR EACH adr/*.md:
+FOR EACH entry IN detected_docs.idea2prd.adrs (read entry.source_path):
   EXTRACT:
     - Title → Rule/skill name candidate
     - Status → (if Accepted) include, (if Deprecated) exclude
@@ -348,7 +348,7 @@ IF fitness has architecture rules: +5 to ddd-validator
 ### From ADR Integration Decisions
 
 ```
-SCAN adr/*.md for:
+SCAN detected_docs.idea2prd.adrs (each entry.source_path) for:
   - "GitHub" → @modelcontextprotocol/server-github
   - "PostgreSQL", "Postgres" → @modelcontextprotocol/server-postgres
   - "MongoDB" → @modelcontextprotocol/server-mongodb

package/templates/.claude/skills/cc-toolkit-generator-enhanced/references/templates/ddd-agents.md

@@ -425,7 +425,7 @@ APPROVE / REQUEST_CHANGES / COMMENT
    - Context diagram summary
    - Container descriptions
 
-2. Extract from `docs/adr/`:
+2. Extract from `detected_docs.idea2prd.adrs` (docs/adr/*.md or the single docs/ADR.md):
    - Top 5-10 most important ADRs
    - Architecture-related decisions
 
@@ -448,7 +448,7 @@ APPROVE / REQUEST_CHANGES / COMMENT
 1. Extract from `docs/fitness/`:
    - All fitness functions as checklist
 
-2. Extract from `docs/adr/`:
+2. Extract from `detected_docs.idea2prd.adrs` (docs/adr/*.md or the single docs/ADR.md):
    - Key decisions affecting code
 
 3. Extract from `docs/ddd/tactical/`:

package/templates/.claude/skills/cc-toolkit-generator-enhanced/references/templates/ddd-skills.md

@@ -345,6 +345,6 @@ src/
 1. From `.ai-context/coding-standards.md`:
    - Direct integration
 
-2. From `docs/adr/`:
+2. From `detected_docs.idea2prd.adrs` (docs/adr/*.md or the single docs/ADR.md):
    - Extract coding-related decisions
    - Extract rejected alternatives as anti-patterns

package/templates/.claude/skills/cc-toolkit-generator-enhanced/references/templates/enhanced-claude-md.md

@@ -188,9 +188,9 @@ If specific .ai-context file missing, extract from:
 |---------|----------------|------------------|
 | Overview | docs/prd/PRD.md | Research_Findings.md |
 | Architecture | docs/c4/*.mermaid | Architecture.md |
-| Key Decisions | docs/adr/*.md | Solution_Strategy.md |
+| Key Decisions | detected_docs.idea2prd.adrs (docs/adr/*.md or docs/ADR.md) | Solution_Strategy.md |
 | Domain Model | docs/ddd/strategic/ | Specification.md |
-| Tech Stack | docs/adr/*-technology.md | Architecture.md |
+| Tech Stack | adrs entries titled *technology* | Architecture.md |
 | Testing | docs/tests/*.feature | Refinement.md |
 | Deployment | docs/completion/ | Completion.md |
 

package/templates/.claude/skills/cc-toolkit-generator-enhanced/references/templates/feature-suggestions.md

@@ -4,13 +4,21 @@ Templates for generating a feature navigation and contextual suggestion system.
 Combines CLAUDE.md roadmap, SessionStart hook for dynamic context, `/next` command,
 and `feature-navigator` skill for on-demand roadmap navigation.
 
-Architecture: **feature-roadmap.json** as single source of truth → consumed by hook, skill, and command.
+Architecture: **feature-roadmap.json** as the system's single data file → consumed by hook, skill,
+and command. (The SCHEMA of that file is defined once, in `.claude/commands/next.md`; this document
+describes the system built on it, not the file's fields.)
 
 ---
 
 ## 1. Data File Template: `feature-roadmap.json`
 
-Generate as `.claude/feature-roadmap.json` — pre-populate from project's PRD/Specification:
+Generate as `.claude/feature-roadmap.json` — pre-populate from project's PRD/Specification.
+
+**Fields: follow `.claude/commands/next.md`, which holds the single schema.** In particular every
+feature carries `priority` from the closed set `mvp | high | medium | low`; a roadmap without it
+cannot be read by the shipped status line. The sketch below shows only the ENVELOPE and this system's
+OPTIONAL extensions — `project`, `current_sprint`, `description`, `sprint`, `files` — which the
+canonical schema does not forbid:
 
 ```json
 {
@@ -21,6 +29,7 @@ Generate as `.claude/feature-roadmap.json` — pre-populate from project's PRD/S
       "id": "{{feature-id}}",
       "name": "{{Feature Name}}",
       "description": "{{Brief description of the feature}}",
+      "priority": "mvp|high|medium|low",
       "status": "done|in_progress|next|planned|blocked",
       "files": ["src/path/to/main-file.ts"],
       "depends_on": ["{{other-feature-id}}"],

package/templates/.claude/skills/cc-toolkit-generator-enhanced/references/templates/start-command.md

@@ -139,7 +139,7 @@ List ALL documentation files the /start should read.
 ```markdown
    - `docs/ddd/strategic/` → bounded contexts, context map
    - `docs/ddd/tactical/` → aggregates, entities, events
-   - `docs/adr/` → technology decisions
+   - `detected_docs.idea2prd.adrs` (docs/adr/ or docs/ADR.md) → technology decisions
    - `docs/tests/*.feature` → Gherkin test scenarios
 ```