@dzhechkov/p-replicator 1.3.0 → 1.5.2

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

@@ -55,6 +55,47 @@ All generated files go directly into the project. Never create a separate output
 | Dev guide | `DEVELOPMENT_GUIDE.md` |
 | Scaffolds | `docker-compose.yml`, `Dockerfile`, `.gitignore` |
 
+## Alternative entry: starting from existing technical documentation
+
+The pipeline officially supports starting from user-provided technical
+documentation as an alternative to the full Phase 0 (Product Discovery) flow.
+
+### Trigger detection
+
+The orchestrator switches to this entry mode when user input contains any of:
+- A path reference (e.g., "use my docs in `docs/existing/`")
+- An explicit skip request ("skip discovery", "skip Phase 0")
+- A statement of available docs ("I already have technical documentation")
+- The semantic flag `--from-docs <path>` or `--skip-discovery`
+
+### Behavior
+
+When triggered:
+1. Phase 0 is SKIPPED (no reverse-engineering-unicorn invocation)
+2. Phase 1 runs sparc-prd-mini in AUTO mode with pre-filled context from user docs
+3. Phase 1 skips internal Explore/Research/Solve sub-phases (those exist to
+   generate answers that the user already has)
+4. Phase 2 (validation) runs UNCHANGED
+5. Phase 3 (toolkit generation) and Phase 4 (finalize) run UNCHANGED
+
+### Three supported sub-paths
+
+| Path | Use case | Skills invoked |
+|---|---|---|
+| **A** | Full pipeline with existing docs as input | sparc-prd-mini (AUTO) → requirements-validator → cc-toolkit-generator-enhanced |
+| **B** | SPARC docs only, no toolkit/scaffold | sparc-prd-mini (AUTO) only |
+| **C** | Validation-only (docs already SPARC-shaped) | requirements-validator only |
+
+### Test contract preserved
+
+The alternative entry mode preserves:
+- All pre-shipped artifacts (init contract intact)
+- Manifest schema (.p-replicator.json including shippedDefaults)
+- `verify` and `doctor` exit codes
+- All meta-tests (replicate.md ↔ replicate-pipeline.md consistency)
+
+No new flags or state-file fields are required.
+
 ## Architecture Constraints
 
 Always pass these constraints to sparc-prd-mini (Phase 1):
@@ -73,27 +114,59 @@ Commit after each major phase completion:
 - After Phase 3: `feat: Claude Code toolkit for [project-name]`
 - After Phase 4: `chore: initial project setup from SPARC documentation`
 
-## What Gets Generated vs Pre-existing
-
-### Pre-existing (template files — do NOT overwrite)
-- `.claude/skills/*` — all 10 skills (with modules/ subdirectories)
-- `.claude/commands/replicate.md` — this pipeline
-- `.claude/commands/harvest.md` — knowledge extraction pipeline
-- `.claude/agents/replicate-coordinator.md`
-- `.claude/agents/product-discoverer.md`
-- `.claude/agents/doc-validator.md`
-- `.claude/agents/harvest-coordinator.md`
-- `.claude/rules/replicate-pipeline.md` — this file
-- `.claude/rules/skill-interface-protocol.md` — skill composition rules
-
-### Generated by /replicate (create new)
-- `.claude/commands/start.md`, `feature.md`, `plan.md`, `myinsights.md`, `deploy.md`
-- `.claude/agents/planner.md`, `code-reviewer.md`, `architect.md`
-- `.claude/rules/git-workflow.md`, `insights-capture.md`, `feature-lifecycle.md`, `security.md`, `coding-style.md`
-- `.claude/settings.json` — hooks
-- `docs/*` — all documentation
+## What Gets Generated vs Pre-shipped (post v1.4)
+
+### Pre-shipped by `npx @dzhechkov/p-replicator init` (do NOT overwrite)
+
+These files arrive with the package and form the stable workflow toolkit. They
+are project-agnostic and can be enhanced (read by Phase 3) but never recreated.
+
+**Skills (10):** all skills in `.claude/skills/` (`explore`, `sparc-prd-mini`,
+`goap-research-ed25519`, `problem-solver-enhanced`, `requirements-validator`,
+`brutal-honesty-review`, `cc-toolkit-generator-enhanced`,
+`reverse-engineering-unicorn`, `pipeline-forge`, `knowledge-extractor`)
+
+**Commands (11):** `replicate`, `harvest`, `start`, `plan`, `feature`, `go`,
+`run`, `next`, `myinsights`, `docs`, `deploy`
+
+**Agents (4):** `replicate-coordinator`, `product-discoverer`, `doc-validator`,
+`harvest-coordinator`
+
+**Rules (5):** `replicate-pipeline`, `skill-interface-protocol`, `git-workflow`,
+`insights-capture`, `feature-lifecycle`
+
+**Hooks:** `.claude/settings.json` (SessionStart + Stop) + cross-platform Node
+scripts in `.claude/hooks/` (`session-insights.cjs`, `autocommit-roadmap.cjs`,
+`autocommit-insights.cjs`, `autocommit-plans.cjs`)
+
+### Generated by /replicate Phase 3 (project-specific — create new)
+
+These exist only AFTER `/replicate` runs because they encode project-specific
+data extracted from SPARC docs.
+
+- `.claude/agents/planner.md` — algorithm templates from Pseudocode.md
+- `.claude/agents/code-reviewer.md` — edge cases from Refinement.md
+- `.claude/agents/architect.md` — system design from Architecture.md
+- `.claude/rules/security.md` — NFRs from Specification.md
+- `.claude/rules/coding-style.md` — tech-stack conventions
+- `.claude/rules/secrets-management.md` — IF external APIs detected
+- `.claude/rules/testing.md` — test strategy from Refinement.md
+- `.claude/skills/project-context/` — domain knowledge
+- `.claude/skills/coding-standards/` — tech-specific patterns
+- `.claude/skills/security-patterns/` — IF external APIs
+- `.claude/feature-roadmap.json` — feature list from PRD MVP scope
+- `.claude/commands/feature-ent.md` — IF DDD docs (idea2prd-manual)
+- `.mcp.json` — IF external integrations
 - `CLAUDE.md`, `README.md`, `DEVELOPMENT_GUIDE.md`
 - `docker-compose.yml`, `Dockerfile`, `.gitignore`
+- `docs/*` — all SPARC documentation
+
+### Post-pipeline verification
+
+After `/replicate` completes, run `npx @dzhechkov/p-replicator verify` to
+confirm both contracts (pre-shipped + post-/replicate). The `verify` command
+detects whether `/replicate` was run (via CLAUDE.md or feature-roadmap.json)
+and reports per-artifact status.
 
 ## Checkpoint Format
 

package/templates/.claude/settings.json

@@ -0,0 +1,44 @@
+{
+  "$schema": "https://www.schemastore.org/claude-code-settings.json",
+  "_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"
+  },
+  "hooks": {
+    "SessionStart": [
+      {
+        "matcher": "*",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node .claude/hooks/session-insights.cjs",
+            "timeout": 5
+          }
+        ]
+      }
+    ],
+    "Stop": [
+      {
+        "matcher": "*",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node .claude/hooks/autocommit-roadmap.cjs",
+            "timeout": 10
+          },
+          {
+            "type": "command",
+            "command": "node .claude/hooks/autocommit-insights.cjs",
+            "timeout": 10
+          },
+          {
+            "type": "command",
+            "command": "node .claude/hooks/autocommit-plans.cjs",
+            "timeout": 10
+          }
+        ]
+      }
+    ]
+  }
+}