@dzhechkov/p-replicator 1.0.1 → 1.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (19) hide show
  1. package/README.md +25 -3
  2. package/package.json +6 -3
  3. package/src/commands/doctor.js +2 -2
  4. package/src/commands/list.js +1 -1
  5. package/templates/.claude/rules/replicate-pipeline.md +13 -1
  6. package/templates/.claude/rules/skill-interface-protocol.md +148 -0
  7. package/templates/.claude/skills/cc-toolkit-generator-enhanced/SKILL.md +116 -63
  8. package/templates/.claude/skills/cc-toolkit-generator-enhanced/modules/01-detect-parse.md +329 -0
  9. package/templates/.claude/skills/cc-toolkit-generator-enhanced/modules/02-analyze-map.md +449 -0
  10. package/templates/.claude/skills/cc-toolkit-generator-enhanced/modules/03-generate-p0.md +630 -0
  11. package/templates/.claude/skills/cc-toolkit-generator-enhanced/modules/04-generate-p1.md +537 -0
  12. package/templates/.claude/skills/cc-toolkit-generator-enhanced/modules/05-generate-p2p3.md +512 -0
  13. package/templates/.claude/skills/cc-toolkit-generator-enhanced/modules/06-package-deliver.md +710 -0
  14. package/templates/.claude/skills/cc-toolkit-generator-enhanced/modules/07-harvest-feedback.md +286 -0
  15. package/templates/.claude/skills/cc-toolkit-generator-enhanced/modules/08-skill-composition.md +378 -0
  16. package/templates/.claude/skills/cc-toolkit-generator-enhanced/modules/09-cross-project-learning.md +461 -0
  17. package/templates/.claude/skills/cc-toolkit-generator-enhanced/modules/README.md +83 -0
  18. package/templates/.claude/skills/cc-toolkit-generator-enhanced/references/maturity-integration.md +198 -0
  19. package/templates/.claude/skills/pipeline-forge/references/self-extracted-patterns.md +260 -0
package/README.md CHANGED
@@ -23,10 +23,10 @@ The system walks you through 4-5 phases with interactive checkpoints. At each ch
23
23
 
24
24
  | Component | Count | Description |
25
25
  |-----------|-------|-------------|
26
- | **Skills** | 10 | SPARC docs, research, problem-solving, validation, review, reverse engineering, toolkit generation, pipeline forge, knowledge extraction, task exploration |
26
+ | **Skills** | 10 | 90+ files (~200K chars). Modular architecture: foundation composite master orchestrator |
27
27
  | **Commands** | 2 | `/replicate` (full pipeline), `/harvest` (knowledge extraction) |
28
28
  | **Agents** | 4 | replicate-coordinator, product-discoverer, doc-validator, harvest-coordinator |
29
- | **Rules** | 1 | replicate-pipeline (phase constraints) |
29
+ | **Rules** | 2 | replicate-pipeline (phase constraints), skill-interface-protocol (composition standard) |
30
30
 
31
31
  After running `/replicate`, the toolkit generates additional commands, agents, rules, and skills specific to your project (see [Post-Pipeline Commands](#post-pipeline-commands)).
32
32
 
@@ -40,11 +40,33 @@ After running `/replicate`, the toolkit generates additional commands, agents, r
40
40
  | `problem-solver-enhanced` | First principles + TRIZ (9 modules) |
41
41
  | `requirements-validator` | INVEST/SMART validation + BDD scenarios |
42
42
  | `brutal-honesty-review` | Unvarnished technical criticism |
43
- | `cc-toolkit-generator-enhanced` | Claude Code toolkit generator |
43
+ | `cc-toolkit-generator-enhanced` | Modular toolkit generator (9 modules, ~165K chars) + cross-project learning |
44
44
  | `reverse-engineering-unicorn` | Company reverse engineering + playbook |
45
45
  | `pipeline-forge` | Meta-skill: build AI pipelines from patterns |
46
46
  | `knowledge-extractor` | Extract reusable knowledge from projects |
47
47
 
48
+ ## Skill Architecture
49
+
50
+ Skills use a **composable module system** with three tiers:
51
+
52
+ - **Foundation** (explore, problem-solver, goap-research, brutal-honesty-review) — self-contained, no dependencies
53
+ - **Composite** (sparc-prd-mini, requirements-validator, knowledge-extractor) — compose foundation skills via `view()`
54
+ - **Master Orchestrator** (cc-toolkit-generator-enhanced) — 9 modular phases with quality gates
55
+
56
+ The `cc-toolkit-generator-enhanced` skill is the largest component (~165K chars) split into modules:
57
+
58
+ | Module | Purpose |
59
+ |--------|---------|
60
+ | 01-detect-parse | Document detection → Internal Project Model (IPM) |
61
+ | 02-analyze-map | Instrument mapping + scoring engine |
62
+ | 03-generate-p0 | P0 mandatory instruments (CLAUDE.md, /start, etc.) |
63
+ | 04-generate-p1 | P1 recommended + enterprise lifecycle |
64
+ | 05-generate-p2p3 | P2 optional + MCP + fitness functions |
65
+ | 06-package-deliver | Master validation checklist (710 lines) |
66
+ | 07-harvest-feedback | Post-project learning loop |
67
+ | 08-skill-composition | Dependency graph + path rewriting |
68
+ | 09-cross-project-learning | Pattern reuse via maturity model |
69
+
48
70
  ## CLI Commands
49
71
 
50
72
  ```bash
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "@dzhechkov/p-replicator",
3
- "version": "1.0.1",
4
- "description": "P-Replicator — Claude Code toolkit for AI-assisted product development (Vibe Coding). Full /replicate pipeline, 10 skills, /harvest knowledge extraction, swarm agents, quality gates.",
3
+ "version": "1.1.0",
4
+ "description": "P-Replicator — Claude Code toolkit for AI-assisted product development (Vibe Coding). Full /replicate pipeline, 10 modular skills (165K+ chars), /harvest knowledge extraction, swarm agents, quality gates, cross-project learning.",
5
5
  "main": "src/cli.js",
6
6
  "bin": {
7
7
  "p-replicator": "bin/cli.js"
@@ -36,7 +36,10 @@
36
36
  "invest",
37
37
  "smart",
38
38
  "documentation",
39
- "skill-pack"
39
+ "skill-pack",
40
+ "modular-skills",
41
+ "cross-project-learning",
42
+ "composable-architecture"
40
43
  ],
41
44
  "author": "dzhechko",
42
45
  "license": "MIT",
@@ -35,7 +35,7 @@ const EXPECTED_AGENTS = [
35
35
  'harvest-coordinator',
36
36
  ];
37
37
 
38
- const EXPECTED_RULES = ['replicate-pipeline'];
38
+ const EXPECTED_RULES = ['replicate-pipeline', 'skill-interface-protocol'];
39
39
 
40
40
  function run(options) {
41
41
  const { targetDir } = options;
@@ -110,7 +110,7 @@ function run(options) {
110
110
  console.log('');
111
111
 
112
112
  // ── 6) Rules ────────────────────────────────────────────────────────────
113
- console.log(bold('Rules (expected 1):'));
113
+ console.log(bold('Rules (expected 2):'));
114
114
  for (const rule of EXPECTED_RULES) {
115
115
  const rulePath = path.join(claudeDir, 'rules', `${rule}.md`);
116
116
  if (fileExists(rulePath)) {
@@ -20,7 +20,7 @@ const SKILL_DETAILS = {
20
20
  'problem-solver-enhanced': 'First principles + TRIZ (9 modules)',
21
21
  'requirements-validator': 'INVEST/SMART validation + BDD scenarios',
22
22
  'brutal-honesty-review': 'Unvarnished technical criticism',
23
- 'cc-toolkit-generator-enhanced': 'Claude Code toolkit generator',
23
+ 'cc-toolkit-generator-enhanced': 'Modular toolkit generator (9 modules, ~165K chars)',
24
24
  'reverse-engineering-unicorn': 'Company reverse engineering + playbook',
25
25
  'pipeline-forge': 'Meta-skill: build AI pipelines from patterns',
26
26
  'knowledge-extractor': 'Extract reusable knowledge from projects',
@@ -20,6 +20,17 @@ When executing skills during the pipeline:
20
20
  3. When a skill references `/mnt/user-data/uploads/` — read from `docs/` instead
21
21
  4. When a skill outputs to `/output/` — write to `docs/` or project root instead
22
22
  5. `goap-research` skill name maps to `goap-research-ed25519` in this repo
23
+ 6. When a skill has `modules/` directory — read the module file referenced by the phase
24
+ 7. See `.claude/rules/skill-interface-protocol.md` for full interface specification
25
+
26
+ ## Modular Skills
27
+
28
+ Skills with `modules/` directories delegate phases to self-contained module files.
29
+ Each module follows: INPUT → PROCESS → OUTPUT → QUALITY GATE interface.
30
+
31
+ Currently modularized skills:
32
+ - `cc-toolkit-generator-enhanced` — 9 modules (6 core pipeline + 3 extensions)
33
+ - `knowledge-extractor` — 4 modules (agent review → classify → decontextualize → integrate)
23
34
 
24
35
  ## Output Paths
25
36
 
@@ -61,7 +72,7 @@ Commit after each major phase completion:
61
72
  ## What Gets Generated vs Pre-existing
62
73
 
63
74
  ### Pre-existing (template files — do NOT overwrite)
64
- - `.claude/skills/*` — all 10 skills
75
+ - `.claude/skills/*` — all 10 skills (with modules/ subdirectories)
65
76
  - `.claude/commands/replicate.md` — this pipeline
66
77
  - `.claude/commands/harvest.md` — knowledge extraction pipeline
67
78
  - `.claude/agents/replicate-coordinator.md`
@@ -69,6 +80,7 @@ Commit after each major phase completion:
69
80
  - `.claude/agents/doc-validator.md`
70
81
  - `.claude/agents/harvest-coordinator.md`
71
82
  - `.claude/rules/replicate-pipeline.md` — this file
83
+ - `.claude/rules/skill-interface-protocol.md` — skill composition rules
72
84
 
73
85
  ### Generated by /replicate (create new)
74
86
  - `.claude/commands/start.md`, `feature.md`, `plan.md`, `myinsights.md`, `deploy.md`
@@ -0,0 +1,148 @@
1
+ # Skill Interface Protocol
2
+
3
+ Standard protocol for how skills discover, reference, and interact in this ecosystem.
4
+ All skills, orchestrators, and agents MUST follow these rules.
5
+
6
+ ## 1. Skill Identity (Frontmatter)
7
+
8
+ Every `SKILL.md` MUST begin with YAML frontmatter containing:
9
+
10
+ ```yaml
11
+ ---
12
+ name: kebab-case-name # REQUIRED — unique identifier
13
+ description: > # REQUIRED — what, when, triggers (2-5 sentences)
14
+ What the skill does. When to use it. Trigger words/phrases.
15
+ version: "1.0" # RECOMMENDED — semver
16
+ maturity: production # RECOMMENDED — see Maturity Tagging below
17
+ ---
18
+ ```
19
+
20
+ A skill without `name` and `description` in frontmatter is invalid.
21
+
22
+ ## 2. view() Contract
23
+
24
+ Skills reference each other via `view()` — a read-only lookup that loads another skill's content at runtime.
25
+
26
+ **Rules:**
27
+ - `view()` is read-only. Never modify a referenced skill's files.
28
+ - Always resolve the path using the Path Mapping Rules below before reading.
29
+ - If the target file does not exist, apply the Fallback Protocol (section 6).
30
+ - Never inline another skill's content into your own SKILL.md. Always use view() at runtime.
31
+
32
+ **Syntax:**
33
+ ```
34
+ view() .claude/skills/[skill-name]/SKILL.md
35
+ view() .claude/skills/[skill-name]/references/[file].md
36
+ ```
37
+
38
+ ## 3. Path Mapping Rules
39
+
40
+ Skills originating from claude.ai use `/mnt/` paths. Apply these rewrites in order:
41
+
42
+ | Source Pattern | Target Pattern | Notes |
43
+ |----------------|----------------|-------|
44
+ | `/mnt/skills/user/[name]/` | `.claude/skills/[name]/` | Skill root directories |
45
+ | `/mnt/user-data/uploads/` | `docs/` | User-uploaded documents |
46
+ | `/output/` | `docs/` or project root | Generated artifacts |
47
+
48
+ **Skill Name Aliases:** `goap-research` always resolves to `goap-research-ed25519`.
49
+
50
+ **Rewrite order:** Resolve aliases first, then apply path pattern mapping.
51
+
52
+ ## 4. Module Interface Contract
53
+
54
+ Skills with `modules/` subdirectories MUST structure each module with these sections:
55
+
56
+ | Section | Required | Purpose |
57
+ |---------|----------|---------|
58
+ | **Input** | YES | Parameters with types, descriptions, required flag |
59
+ | **Process** | YES | Numbered steps describing the transformation |
60
+ | **Output** | YES | Artifacts produced, with location and format |
61
+ | **Quality Gate** | YES | Checks, thresholds, and whether they block |
62
+ | **Dependencies** | YES | External skills or system capabilities needed |
63
+ | **Reusability** | RECOMMENDED | How this module can be extracted or reused elsewhere |
64
+
65
+ Modules are numbered (`01-name.md`, `02-name.md`) to indicate execution order.
66
+ SKILL.md acts as orchestrator, referencing modules in sequence.
67
+
68
+ ## 5. Dependency Declaration
69
+
70
+ Skills declare dependencies in a table within SKILL.md under `## External Dependencies (loaded via view() at runtime)`:
71
+
72
+ | Phase | Skill | Path | Required | Purpose |
73
+ |-------|-------|------|----------|---------|
74
+ | Phase 1 | explore | `.claude/skills/explore/SKILL.md` | OPTIONAL | Task clarification |
75
+
76
+ **Dependency types:**
77
+ - **REQUIRED** — skill will not function without it. Pipeline halts if missing.
78
+ - **OPTIONAL** — skill has a documented fallback if missing.
79
+
80
+ ## 6. Fallback Protocol
81
+
82
+ Every OPTIONAL dependency MUST have a documented fallback immediately after the dependency table:
83
+
84
+ ```markdown
85
+ **Fallbacks:**
86
+ - `explore` unavailable → built-in 3-5 clarification questions
87
+ ```
88
+
89
+ **Rules:**
90
+ 1. Check if the dependency's SKILL.md exists before loading.
91
+ 2. REQUIRED and missing — halt with error naming the missing skill.
92
+ 3. OPTIONAL and missing — execute fallback and log warning in output.
93
+ 4. Never silently ignore a missing dependency.
94
+
95
+ ## 7. Maturity Tagging
96
+
97
+ Skills declare maturity in frontmatter. Consumers use this to decide trust level.
98
+
99
+ | Level | Meaning | Safe to Depend On |
100
+ |-------|---------|-------------------|
101
+ | `experimental` | Prototype, interface may change | No — use with fallback only |
102
+ | `beta` | Functional, interface stabilizing | Yes — with fallback recommended |
103
+ | `production` | Stable, tested in pipelines | Yes — safe for REQUIRED dependencies |
104
+ | `deprecated` | Being replaced, will be removed | No — migrate to replacement |
105
+
106
+ **Rule:** REQUIRED dependencies SHOULD point to `production` or `beta` skills only.
107
+
108
+ ## 8. Composition Rules
109
+
110
+ **Orchestrator skills** (e.g., `replicate-coordinator`, `pipeline-forge`):
111
+ - Invoke other skills in a defined phase sequence
112
+ - Own the checkpoint and context-passing logic
113
+ - Never duplicate skill logic — always delegate via view()
114
+ - Handle dependency resolution and fallbacks for the entire pipeline
115
+
116
+ **Foundation skills** (e.g., `explore`, `goap-research-ed25519`):
117
+ - Self-contained with no required cross-skill dependencies
118
+ - Provide a single well-defined capability
119
+ - Declare explicit input/output formats
120
+ - Can be used independently outside any pipeline
121
+
122
+ **Composite skills** (e.g., `sparc-prd-mini`, `cc-toolkit-generator-enhanced`):
123
+ - Combine multiple foundation skills to produce complex output
124
+ - Declare all dependencies (both required and optional)
125
+ - Split complex logic into `modules/` with SKILL.md as orchestrator
126
+
127
+ ## 9. Output Path Convention
128
+
129
+ All skill output goes directly into the project. Never create a separate output directory.
130
+
131
+ | Artifact Type | Path |
132
+ |---------------|------|
133
+ | Documentation (SPARC, validation, BDD, features) | `docs/` |
134
+ | Plans | `docs/plans/` |
135
+ | Commands, Agents, Rules, Skills | `.claude/commands/`, `.claude/agents/`, `.claude/rules/`, `.claude/skills/` |
136
+ | Hooks config | `.claude/settings.json` |
137
+ | Project context | `CLAUDE.md` (root) |
138
+ | Scaffolds (Dockerfile, docker-compose, .gitignore) | Project root |
139
+
140
+ ## Anti-Patterns
141
+
142
+ - Hardcoding `/mnt/` paths without a mapping table
143
+ - Using view() to write or modify another skill's files
144
+ - Declaring a dependency as OPTIONAL without providing a fallback
145
+ - Depending on an `experimental` skill as REQUIRED
146
+ - Duplicating another skill's logic instead of referencing via view()
147
+ - Creating output directories outside the project root
148
+ - Circular dependencies between skills (always detected, always blocked)
@@ -1,5 +1,7 @@
1
1
  ---
2
2
  name: cc-toolkit-generator-enhanced
3
+ version: "2.0"
4
+ maturity: production
3
5
  description: >
4
6
  Generate complete Claude Code toolkit from idea2prd-manual or SPARC documentation.
5
7
  Supports: PRD, SPARC, DDD, ADR, C4, Pseudocode, Gherkin, Fitness Functions.
@@ -9,6 +11,9 @@ description: >
9
11
  Feature suggestions: /next + feature-navigator skill + SessionStart hook.
10
12
  Insights: /myinsights + index/detail architecture. Plans: /plan with auto-commit.
11
13
  Automation: /go (smart pipeline), /run (autonomous build loop), /docs (bilingual RU/EN docs).
14
+ Harvest feedback: post-project learning loop from knowledge-extractor.
15
+ Cross-project learning: pattern reuse from previous projects via maturity model.
16
+ Skill composition: automated dependency resolution, copying, and path rewriting.
12
17
  Triggers: "cc-toolkit-enhanced", "generate toolkit from docs", "создай инструменты из документации".
13
18
  Three modes: AUTO, HYBRID (default), MANUAL.
14
19
  ---
@@ -17,6 +22,44 @@ description: >
17
22
 
18
23
  Generate production-ready Claude Code instruments from **SPARC or idea2prd-manual documentation**.
19
24
 
25
+ ## Modular Architecture
26
+
27
+ This skill uses a composable module system. Each phase is a self-contained module with
28
+ clear INPUT → PROCESS → OUTPUT → QUALITY GATE interface.
29
+
30
+ ### Core Pipeline Modules
31
+
32
+ | Phase | Module | File |
33
+ |-------|--------|------|
34
+ | 1 | Detect & Parse | `modules/01-detect-parse.md` |
35
+ | 2 | Analyze & Map | `modules/02-analyze-map.md` |
36
+ | 3 | Generate P0 (Mandatory) | `modules/03-generate-p0.md` |
37
+ | 4 | Generate P1 (Recommended) | `modules/04-generate-p1.md` |
38
+ | 5 | Generate P2-P3 (Optional) | `modules/05-generate-p2p3.md` |
39
+ | 6 | Package & Deliver | `modules/06-package-deliver.md` |
40
+
41
+ ### Extension Modules
42
+
43
+ | Module | File | Purpose |
44
+ |--------|------|---------|
45
+ | Harvest Feedback | `modules/07-harvest-feedback.md` | Post-project learning loop |
46
+ | Skill Composition | `modules/08-skill-composition.md` | Dependency resolution + path rewriting |
47
+ | Cross-Project Learning | `modules/09-cross-project-learning.md` | Pattern reuse via maturity model |
48
+
49
+ ### Module Execution Protocol
50
+
51
+ ```
52
+ view(modules/01-detect-parse.md) → IPM (Internal Project Model)
53
+ view(modules/02-analyze-map.md) → Instrument Map (scored items)
54
+ ↓ [OPTIONAL] view(modules/09-cross-project-learning.md) → Augmented Instrument Map
55
+ view(modules/03-generate-p0.md) → P0 files
56
+ ↓ view(modules/08-skill-composition.md) → Skills copied + paths rewritten
57
+ view(modules/04-generate-p1.md) → P1 files (conditional)
58
+ view(modules/05-generate-p2p3.md) → P2-P3 files (optional)
59
+ view(modules/06-package-deliver.md) → Validated package
60
+ ↓ [POST-PROJECT] view(modules/07-harvest-feedback.md) → Template improvements
61
+ ```
62
+
20
63
  ## Input Documents
21
64
 
22
65
  ### SPARC Pipeline
@@ -60,98 +103,76 @@ Generate production-ready Claude Code instruments from **SPARC or idea2prd-manua
60
103
 
61
104
  ## Workflow
62
105
 
106
+ > Each phase delegates to a self-contained module. Read the module file for full details.
107
+ > Modules can be used independently outside this skill for other pipelines.
108
+
63
109
  ### Phase 1: Detect & Parse
64
110
 
65
- 1. Scan `/mnt/user-data/uploads/` for documents
66
- - If no documents found: ask user to upload SPARC or idea2prd documentation set
67
- - Minimum required: at least PRD.md + Architecture.md (SPARC) or docs/ddd/ (idea2prd)
68
- 2. Detect source pipeline:
69
- - Has `docs/ddd/` → idea2prd-manual
70
- - Has `Architecture.md` + `Solution_Strategy.md` → SPARC
71
- - Has `Architecture.md` only → SPARC minimal
72
- - Mixed → Use unified mapping
73
- 3. Detect project characteristics:
74
- - **has_external_apis** — scan for API integrations
75
- - **has_database** — scan for DB services
76
- - **monorepo_packages** — extract from project structure
77
- - **docker_services** — extract from docker-compose
78
- 4. Build Internal Project Model (IPM)
111
+ **Read module:** `modules/01-detect-parse.md`
112
+
113
+ Summary: Scan docs directory, detect pipeline type (SPARC/idea2prd), detect project
114
+ characteristics, build Internal Project Model (IPM).
79
115
 
80
116
  **MANUAL Checkpoint 1:** Document Detection Review
81
117
 
82
118
  ### Phase 2: Analyze & Map
83
119
 
84
- **SPARC Pipeline:** See [SPARC Mapping](#sparc-document-mapping) below.
85
- **idea2prd Pipeline:** See `references/extended-mapping.md` for complete DDD/ADR/Gherkin/Fitness mappings.
120
+ **Read module:** `modules/02-analyze-map.md`
121
+
122
+ Summary: Map documents to toolkit instruments using scoring rules.
123
+ SPARC mapping: see [SPARC Document Mapping](#sparc-document-mapping) below.
124
+ idea2prd mapping: see `references/extended-mapping.md`.
86
125
 
87
126
  **MANUAL Checkpoint 2:** Mapping Approval
88
127
 
128
+ ### Phase 2.5: Cross-Project Learning (Optional)
129
+
130
+ **Read module:** `modules/09-cross-project-learning.md`
131
+
132
+ Summary: If a cross-project artifact registry exists, match proven patterns against the
133
+ new project's characteristics and augment the Instrument Map with battle-tested defaults.
134
+
89
135
  ### Phase 3: Generate P0 (Mandatory)
90
136
 
91
- Always generate these items:
92
-
93
- | # | Instrument | Template Source |
94
- |---|-----------|----------------|
95
- | 1 | **CLAUDE.md** | `references/claude-md-strategy.md` — pipeline-specific strategy |
96
- | 2 | **security.md** rule | From Specification NFRs or ADRs + Fitness Functions |
97
- | 3 | **coding-style.md** rule | From Architecture tech stack or DDD Tactical + ADRs |
98
- | 4 | **commands/start.md** | `references/templates/start-command.md` |
99
- | 5 | **commands/myinsights.md** | `references/templates/insights-system.md` |
100
- | 6 | **commands/feature.md** | `references/templates/feature-lifecycle.md` |
101
- | 7 | **rules/git-workflow.md** | Semantic commit conventions |
102
- | 8 | **rules/insights-capture.md** | `references/templates/insights-system.md` |
103
- | 9 | **rules/feature-lifecycle.md** | `references/templates/feature-lifecycle.md` |
104
- | 10 | **settings.json** hooks | insights + plans auto-commit, SessionStart |
105
- | 11-16 | **6 lifecycle skills** | `references/templates/feature-lifecycle.md` — copy protocol + path rewrite |
106
-
107
- **Conditional P0:**
108
- - **rules/secrets-management.md** + **skills/security-patterns/** — IF has_external_apis
109
- - **rules/domain-model.md** — IF has DDD Strategic docs
137
+ **Read module:** `modules/03-generate-p0.md`
138
+
139
+ Summary: Generate all mandatory toolkit items (CLAUDE.md, rules, commands, settings, lifecycle skills).
140
+ Uses `modules/08-skill-composition.md` for skill copying and path rewriting.
110
141
 
111
142
  **MANUAL Checkpoint 3:** P0 Review
112
143
 
113
144
  ### Phase 4: Generate P1 (Recommended)
114
145
 
115
- | Instrument | Source (SPARC) | Source (idea2prd) |
116
- |------------|----------------|-------------------|
117
- | planner.md agent | Pseudocode, PRD | Pseudocode, PRD |
118
- | code-reviewer.md agent | Refinement, Specification | Fitness, ADR |
119
- | architect.md agent | Architecture, Solution_Strategy | C4, ADR, DDD Strategic |
120
- | project-context/ skill | Research_Findings, Final_Summary | Research, .ai-context |
121
- | coding-standards/ skill | Architecture (tech stack) | DDD Tactical, ADR |
122
- | testing-patterns/ skill | Refinement (test strategy) | Gherkin, Fitness |
123
- | /plan command | PRD, Pseudocode | PRD, Pseudocode |
124
- | /test command | Refinement, Specification | Gherkin |
125
- | /deploy command | Completion | Completion Checklist |
126
- | testing.md rule | Refinement | Fitness Functions |
127
-
128
- **Enterprise Lifecycle (IF DDD detected) — see `references/templates/feature-lifecycle-ent.md`:**
129
- - /feature-ent command, feature-lifecycle-ent.md rule
130
- - Copy skills: idea2prd-manual/, goap-research-ed25519/
131
-
132
- **Feature Suggestions System — see `references/templates/feature-suggestions.md`:**
133
- - /next command, feature-navigator/ skill, feature-roadmap.json, SessionStart hook
134
-
135
- **Automation Commands — see `references/templates/automation-commands.md`:**
136
- - /go (smart pipeline), /run (autonomous build loop), /docs (bilingual RU/EN)
146
+ **Read module:** `modules/04-generate-p1.md`
147
+
148
+ Summary: Generate recommended items — agents, skills, commands, enterprise lifecycle,
149
+ feature suggestions, automation commands. All conditional on project characteristics.
137
150
 
138
151
  **MANUAL Checkpoint 4:** P1 Selection
139
152
 
140
153
  ### Phase 5: Generate P2-P3 (Optional)
141
154
 
142
- **P2:** tdd-guide.md agent, settings.json hooks, /review command
143
- **P2 DDD-only:** ddd-validator.md agent, aggregate-patterns/ skill, event-handlers/ skill, /validate-ddd
144
- **P3:** .mcp.json (see `references/templates/mcp.md`), Coolify MCP, Docker MCP
155
+ **Read module:** `modules/05-generate-p2p3.md`
156
+
157
+ Summary: Generate optional advanced items — TDD guide, DDD validators, MCP configs.
145
158
 
146
159
  **MANUAL Checkpoint 5:** P2-P3 Selection
147
160
 
148
161
  ### Phase 6: Package & Deliver
149
162
 
150
- Create output archive per [Output Structure](#output-structure).
151
- Run the [Master Validation Checklist](#master-validation-checklist) before delivery.
163
+ **Read module:** `modules/06-package-deliver.md`
164
+
165
+ Summary: Run Master Validation Checklist, verify all placeholders, create output package.
152
166
 
153
167
  **MANUAL Checkpoint 6:** Final Review
154
168
 
169
+ ### Post-Project: Harvest Feedback (After project completion)
170
+
171
+ **Read module:** `modules/07-harvest-feedback.md`
172
+
173
+ Summary: After /harvest extracts knowledge from a completed project, this module feeds
174
+ improvements back into toolkit templates for future generations.
175
+
155
176
  ## Output Structure
156
177
 
157
178
  ```
@@ -369,6 +390,38 @@ Run in Phase 6 before delivery.
369
390
 
370
391
  ## Dependencies
371
392
 
393
+ ### Required
372
394
  - SPARC documentation set (11 files) — primary pipeline
373
395
  - Alternatively: idea2prd-manual/auto output
374
- - Optional: .ai-context/ directory
396
+
397
+ ### Optional
398
+ - `.ai-context/` directory — enhanced CLAUDE.md integration
399
+ - `knowledge-extractor` skill — for harvest feedback loop (module 07)
400
+ - Cross-project artifact registry — for pattern reuse (module 09)
401
+
402
+ ### Skill Dependencies (managed by module 08)
403
+
404
+ | Skill | Copied To | Priority | Condition |
405
+ |-------|-----------|----------|-----------|
406
+ | sparc-prd-mini | .claude/skills/ | P0 | Always |
407
+ | explore | .claude/skills/ | P0 | Always |
408
+ | goap-research | .claude/skills/ | P0 | Always |
409
+ | problem-solver-enhanced | .claude/skills/ | P0 | Always |
410
+ | requirements-validator | .claude/skills/ | P0 | Always |
411
+ | brutal-honesty-review | .claude/skills/ | P0 | Always |
412
+ | idea2prd-manual | .claude/skills/ | P1 | IF DDD detected |
413
+ | goap-research-ed25519 | .claude/skills/ | P1 | IF DDD detected |
414
+ | feature-navigator | .claude/skills/ | P1 | Always (recommended) |
415
+
416
+ ## Reusability
417
+
418
+ This skill's modules are designed for reuse across different IT contexts:
419
+
420
+ | Module | Reuse Context |
421
+ |--------|--------------|
422
+ | 01-detect-parse | Any pipeline needing document type detection |
423
+ | 02-analyze-map | Any document-to-artifact mapping with scoring |
424
+ | 03-06 (generation) | Template-based code/config generation |
425
+ | 07-harvest-feedback | Any system with post-production learning loops |
426
+ | 08-skill-composition | Any project that composes AI skills/plugins |
427
+ | 09-cross-project-learning | Any AI pipeline that learns from past projects |