@dzhechkov/p-replicator 1.0.0

package/templates/.claude/skills/knowledge-extractor/references/maturity-model.md

@@ -0,0 +1,153 @@
+# Artifact Maturity Model
+
+Lifecycle and versioning system for toolkit artifacts.
+
+---
+
+## Maturity Levels
+
+| Level | Symbol | Name | Meaning | Trust Level |
+|-------|--------|------|---------|-------------|
+| 0 | 🔴 | **Alpha** | First extraction, untested outside source project | Low — use with caution |
+| 1 | 🟡 | **Beta** | Used in 2+ projects, edge cases found and handled | Medium — works but watch for issues |
+| 2 | 🟢 | **Stable** | Used in 3+ projects, well-documented, community-tested | High — can be trusted by AI agents |
+| 3 | ⭐ | **Proven** | Core toolkit artifact, battle-tested, exemplary docs | Very high — reference implementation |
+
+## Promotion Criteria
+
+### 🔴 Alpha → 🟡 Beta
+
+**ALL of these must be true:**
+- [ ] Used successfully in at least 2 different projects
+- [ ] At least 1 edge case discovered and handled
+- [ ] "When to use" and "When NOT to use" sections refined
+- [ ] At least 1 variant documented
+- [ ] No project-specific references remain
+
+### 🟡 Beta → 🟢 Stable
+
+**ALL of these must be true:**
+- [ ] Used successfully in at least 3 different projects
+- [ ] All known edge cases documented
+- [ ] Multiple variants documented (≥2)
+- [ ] Performance characteristics known
+- [ ] No open issues / known bugs
+- [ ] Another developer (or AI agent) has used it without guidance
+
+### 🟢 Stable → ⭐ Proven
+
+**ALL of these must be true:**
+- [ ] Used in 5+ projects
+- [ ] Has been the subject of improvement iterations (v3+)
+- [ ] Exemplary documentation (could serve as tutorial)
+- [ ] Community or team consensus on quality
+- [ ] Has related artifacts (complementary patterns/rules)
+
+## Demotion Criteria
+
+Artifacts can be demoted:
+
+| From | To | When |
+|------|----|------|
+| Any | 🔴 Alpha | Breaking change in underlying tech makes it unreliable |
+| Any | ❌ Deprecated | No longer applicable (library/framework retired) |
+| ⭐ Proven | 🟢 Stable | Better alternative discovered |
+
+## Versioning
+
+### Version Format
+
+```
+v[MAJOR].[MINOR]
+```
+
+- **MAJOR** increment: Breaking change, fundamentally different approach
+- **MINOR** increment: New variant, edge case fix, documentation improvement
+
+### Changelog Block
+
+Every artifact must have:
+
+```markdown
+## Maturity: 🟡 Beta
+## Used in: project-a, project-b, project-c
+## Extracted: 2026-01-15
+## Last updated: 2026-03-01
+## Version: v2.1
+## Changelog:
+- v2.1: Added Redis-backed variant, performance notes
+- v2.0: Rewritten to use generic traits instead of concrete types
+- v1.1: Fixed edge case with zero-length input
+- v1.0: Initial extraction from project-a
+```
+
+### When to Increment Version
+
+| Change Type | Version Bump |
+|-------------|-------------|
+| Fix edge case | Minor (v1.0 → v1.1) |
+| Add new variant | Minor (v1.1 → v1.2) |
+| Improve documentation | Minor |
+| Change interface/API | Major (v1.x → v2.0) |
+| Rewrite implementation | Major |
+| Change target audience | Major |
+
+## Provenance Tracking
+
+### "Used in" Field
+
+Track every project where the artifact was used:
+
+```markdown
+## Used in:
+- project-a (v1.0, extracted here)
+- project-b (v1.1, found edge case with empty arrays)
+- project-c (v2.0, rewritten for async support)
+```
+
+### Source Attribution
+
+Always record:
+- **Original project** — where it was first discovered
+- **Extraction date** — when it entered the toolkit
+- **Extractor** — who performed the harvest (human or AI agent)
+
+## Maturity in Context
+
+### For AI Agents
+
+When an AI agent encounters a toolkit artifact:
+
+| Maturity | AI Behavior |
+|----------|-------------|
+| 🔴 Alpha | Use with explicit warning to user, suggest alternatives |
+| 🟡 Beta | Use normally, mention known limitations |
+| 🟢 Stable | Use confidently, reference documentation |
+| ⭐ Proven | Use as reference implementation, recommend to others |
+
+### For Human Developers
+
+| Maturity | Developer Action |
+|----------|-----------------|
+| 🔴 Alpha | Review code carefully before using, provide feedback |
+| 🟡 Beta | Use in non-critical paths, report edge cases |
+| 🟢 Stable | Use freely, contribute improvements |
+| ⭐ Proven | Recommend to team, use as template for new artifacts |
+
+## Lifecycle Visualization
+
+```
+Discovery in project
+    ↓
+[🔴 Alpha v1.0] ← First extraction
+    ↓ (used in 2nd project, edge case found)
+[🟡 Beta v1.1]  ← Edge case fixed
+    ↓ (rewritten for broader use)
+[🟡 Beta v2.0]  ← Major rewrite
+    ↓ (used in 3rd project, stable)
+[🟢 Stable v2.1] ← Variant added
+    ↓ (5+ projects, exemplary docs)
+[⭐ Proven v3.0] ← Reference implementation
+    ↓ (technology sunset)
+[❌ Deprecated]  ← Archived
+```

package/templates/.claude/skills/knowledge-extractor/templates/artifact-card.md

@@ -0,0 +1,60 @@
+# Artifact Card Template
+
+Universal documentation format for any toolkit artifact.
+Replace all `{{PLACEHOLDERS}}` with actual content.
+
+---
+
+```markdown
+# {{CATEGORY}}: {{ARTIFACT_NAME}}
+
+## Maturity: {{🔴/🟡/🟢/⭐}} {{Alpha/Beta/Stable/Proven}}
+## Used in: {{source-project}}
+## Extracted: {{YYYY-MM-DD}}
+## Last updated: {{YYYY-MM-DD}}
+## Version: v{{MAJOR}}.{{MINOR}}
+
+## When to Use
+
+{{Conditions where this artifact is valuable.}}
+
+## When NOT to Use
+
+{{Explicit anti-conditions. When this is the wrong choice.}}
+
+## Prerequisites
+
+{{What must exist before using this artifact.}}
+- {{Prerequisite 1}}
+- {{Prerequisite 2}}
+
+## Implementation
+
+{{The actual artifact content — code, config, pattern description, etc.}}
+
+## Variants
+
+### Variant A: {{Context/Language/Framework}}
+
+{{Alternative implementation for different context.}}
+
+### Variant B: {{Context/Language/Framework}}
+
+{{Another alternative.}}
+
+## Gotchas
+
+{{Things that can go wrong. Edge cases. Common mistakes.}}
+
+- {{Gotcha 1}}
+- {{Gotcha 2}}
+
+## Related Artifacts
+
+- {{Related artifact 1}} — {{relationship}}
+- {{Related artifact 2}} — {{relationship}}
+
+## Changelog
+- v{{N}}: {{What changed and why}}
+- v1: Initial extraction from {{source-project}}
+```

package/templates/.claude/skills/knowledge-extractor/templates/harvest-report.md

@@ -0,0 +1,70 @@
+# Harvest Report Template
+
+Generated at the end of a harvest session. Summarizes what was extracted.
+
+---
+
+```markdown
+# Harvest Report: {{PROJECT_NAME}}
+
+**Date:** {{YYYY-MM-DD}}
+**Mode:** {{QUICK / FULL}}
+**Duration:** {{N}} minutes
+
+## Summary
+
+| Metric | Value |
+|--------|-------|
+| Files scanned | {{N}} |
+| TOOLKIT_HARVEST.md markers | {{M}} |
+| Candidates found (Phase 1) | {{K}} |
+| Classified for extraction (Phase 2) | {{J}} |
+| Successfully decontextualized (Phase 3) | {{L}} |
+| Integrated into toolkit (Phase 4) | {{I}} |
+| Skipped (with reasons) | {{S}} |
+
+## Extracted Artifacts
+
+| # | Name | Category | Maturity | Version | Location |
+|---|------|----------|----------|---------|----------|
+| 1 | {{name}} | {{cat}} | 🔴 Alpha | v1.0 | {{path}} |
+| 2 | {{name}} | {{cat}} | 🟡 Beta | v2.1 | {{path}} |
+
+### By Category
+
+| Category | Count | New | Updated |
+|----------|-------|-----|---------|
+| Skills | {{N}} | {{X}} | {{Y}} |
+| Commands | {{N}} | {{X}} | {{Y}} |
+| Hooks | {{N}} | {{X}} | {{Y}} |
+| Rules | {{N}} | {{X}} | {{Y}} |
+| Templates | {{N}} | {{X}} | {{Y}} |
+| Patterns | {{N}} | {{X}} | {{Y}} |
+| Snippets | {{N}} | {{X}} | {{Y}} |
+
+## Skipped Items
+
+| # | Name | Reason |
+|---|------|--------|
+| 1 | {{name}} | {{reason}} |
+
+## Toolkit Status (after harvest)
+
+| Maturity | Count |
+|----------|-------|
+| 🔴 Alpha | {{N}} |
+| 🟡 Beta | {{M}} |
+| 🟢 Stable | {{K}} |
+| ⭐ Proven | {{J}} |
+| **Total** | **{{T}}** |
+
+## Recommendations
+
+- {{Recommendation 1 — e.g., "Promote X to Beta after next project use"}}
+- {{Recommendation 2 — e.g., "Pattern Y needs Rust variant"}}
+- {{Recommendation 3 — e.g., "Consider merging A and B into single pattern"}}
+
+## Next Harvest
+
+Suggested after: {{next project/sprint/milestone}}
+```

package/templates/.claude/skills/knowledge-extractor/templates/toolkit-harvest.md

@@ -0,0 +1,38 @@
+# TOOLKIT_HARVEST.md Template
+
+Drop this file into any project to collect harvest markers during work.
+Takes 30 seconds per marker — zero workflow interruption.
+
+---
+
+```markdown
+# Что забрать в тулкит / Toolkit Harvest
+
+> Mark things worth extracting as you work. Don't interrupt your flow —
+> just add a checkbox entry under the right category.
+> Run `/harvest` after project completion to process these markers.
+
+## Skills
+- [ ] <!-- Description — what technique improved, see file:line -->
+
+## Commands
+- [ ] <!-- Slash command worth generalizing — what it does -->
+
+## Hooks
+- [ ] <!-- Automation trigger — what event, what action -->
+
+## Rules
+- [ ] <!-- Constraint/lesson — don't do X because Y -->
+
+## Templates
+- [ ] <!-- File structure worth reusing — what it templates -->
+
+## Patterns
+- [ ] <!-- Architectural approach — what problem it solves -->
+
+## Snippets
+- [ ] <!-- Small code fragment — what it does, where it is -->
+
+## Lessons (unclassified)
+- [ ] <!-- Anything else worth remembering -->
+```