@dzhechkov/p-replicator 1.0.0 → 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.
- package/README.md +25 -3
- package/package.json +7 -4
- package/src/commands/doctor.js +2 -2
- package/src/commands/list.js +1 -1
- package/templates/.claude/rules/replicate-pipeline.md +13 -1
- package/templates/.claude/rules/skill-interface-protocol.md +148 -0
- package/templates/.claude/skills/cc-toolkit-generator-enhanced/SKILL.md +116 -63
- package/templates/.claude/skills/cc-toolkit-generator-enhanced/modules/01-detect-parse.md +329 -0
- package/templates/.claude/skills/cc-toolkit-generator-enhanced/modules/02-analyze-map.md +449 -0
- package/templates/.claude/skills/cc-toolkit-generator-enhanced/modules/03-generate-p0.md +630 -0
- package/templates/.claude/skills/cc-toolkit-generator-enhanced/modules/04-generate-p1.md +537 -0
- package/templates/.claude/skills/cc-toolkit-generator-enhanced/modules/05-generate-p2p3.md +512 -0
- package/templates/.claude/skills/cc-toolkit-generator-enhanced/modules/06-package-deliver.md +710 -0
- package/templates/.claude/skills/cc-toolkit-generator-enhanced/modules/07-harvest-feedback.md +286 -0
- package/templates/.claude/skills/cc-toolkit-generator-enhanced/modules/08-skill-composition.md +378 -0
- package/templates/.claude/skills/cc-toolkit-generator-enhanced/modules/09-cross-project-learning.md +461 -0
- package/templates/.claude/skills/cc-toolkit-generator-enhanced/modules/README.md +83 -0
- package/templates/.claude/skills/cc-toolkit-generator-enhanced/references/maturity-integration.md +198 -0
- 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 |
|
|
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** |
|
|
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` |
|
|
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,10 +1,10 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@dzhechkov/p-replicator",
|
|
3
|
-
"version": "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
|
-
"p-replicator": "
|
|
7
|
+
"p-replicator": "bin/cli.js"
|
|
8
8
|
},
|
|
9
9
|
"files": [
|
|
10
10
|
"bin/",
|
|
@@ -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",
|
package/src/commands/doctor.js
CHANGED
|
@@ -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
|
|
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)) {
|
package/src/commands/list.js
CHANGED
|
@@ -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': '
|
|
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
|
-
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
|
|
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
|
-
**
|
|
85
|
-
|
|
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
|
-
|
|
92
|
-
|
|
93
|
-
|
|
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
|
-
|
|
116
|
-
|
|
117
|
-
|
|
118
|
-
|
|
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
|
-
**
|
|
143
|
-
|
|
144
|
-
|
|
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
|
-
|
|
151
|
-
|
|
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
|
-
|
|
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 |
|