codymaster 7.0.1 → 7.0.3

package/skills/cm-content-factory/sites/docs-site/src/content/docs/sop/content-pipeline.md

@@ -0,0 +1,108 @@
+---
+title: "Content Pipeline"
+description: "Hướng dẫn step-by-step chạy Content Factory pipeline — từ extract đến publish."
+keywords: ["content pipeline", "SOP", "tutorial"]
+sidebar:
+  order: 2
+---
+
+# Content Pipeline — SOP
+
+> **Quick Reference**
+> - **Ai**: Content Manager
+> - **Thời gian**: ~30 phút setup, sau đó tự động
+> - **Điều kiện**: Config file + source documents
+
+## Prerequisites
+
+- [ ] Python 3.10+ installed
+- [ ] `content-factory.config.json` created
+- [ ] Source documents in configured path
+
+## Step-by-Step
+
+### Step 1: Extract Knowledge
+
+```bash
+python3 scripts/extract.py --config content-factory.config.json
+```
+
+Output: `knowledge-base/` with structured JSON per category.
+
+### Step 2: Plan Topics
+
+```bash
+python3 scripts/plan.py --config content-factory.config.json
+```
+
+Output: `topics-queue/batch-{DATE}.json` with prioritized topics.
+
+### Step 3: Write Content
+
+```bash
+python3 scripts/write.py --config content-factory.config.json --batch 1
+```
+
+Content generated với memory context, auto-scored.
+
+### Step 4: Audit
+
+```bash
+python3 scripts/audit.py --config content-factory.config.json
+# Auto-fix
+python3 scripts/audit.py --config content-factory.config.json --fix
+```
+
+### Step 5: SEO Optimize
+
+```bash
+python3 scripts/seo.py --config content-factory.config.json extract
+python3 scripts/seo.py --config content-factory.config.json apply
+```
+
+### Step 6: Publish
+
+```bash
+python3 scripts/publish.py --config content-factory.config.json
+```
+
+### Full Auto (Pipeline Mode)
+
+```bash
+python3 scripts/pipeline.py
+```
+
+Chạy toàn bộ từ Extract đến Publish tự động.
+
+## Expected Results
+
+- ✅ Knowledge base created
+- ✅ Topic queue generated
+- ✅ Content articles written
+- ✅ Audit passed
+- ✅ SEO optimized
+- ✅ Published live
+
+## Troubleshooting
+
+<details>
+<summary>Pipeline fails at Write step</summary>
+
+**Check**: Memory system initialized? Config valid?
+
+```bash
+python3 scripts/memory.py --config content-factory.config.json --init
+```
+
+</details>
+
+<details>
+<summary>Audit fails repeatedly</summary>
+
+**Check**: Run Learn mode to update patterns, then retry.
+
+```bash
+python3 scripts/memory.py --config content-factory.config.json --learn
+```
+
+</details>

package/skills/cm-content-factory/sites/docs-site/src/content/docs/sop/index.md

@@ -0,0 +1,22 @@
+---
+title: "Hướng dẫn SOP"
+description: "Tất cả hướng dẫn step-by-step cho Content Factory — pipeline, memory, SEO, troubleshooting."
+keywords: ["SOP", "user guide", "content factory"]
+sidebar:
+  order: 1
+---
+
+# Hướng dẫn SOP
+
+> **Quick Reference**
+> - **Tổng guides**: 4
+> - **Personas**: Content Manager, SEO Specialist, Content Writer
+
+## Directory
+
+| # | Guide | Persona | Độ khó |
+|---|-------|---------|--------|
+| 1 | [Content Pipeline](./content-pipeline) | Content Manager Lan | 🟡 Medium |
+| 2 | [Memory System](./memory-system) | Content Manager Lan | 🔴 Hard |
+| 3 | [SEO Optimization](./seo-optimization) | SEO Specialist Minh | 🟡 Medium |
+| 4 | [Troubleshooting](./troubleshooting-guide) | Tất cả | 🟢 Easy |

package/skills/cm-content-factory/sites/docs-site/src/content/docs/sop/memory-system.md

@@ -0,0 +1,52 @@
+---
+title: "Memory System"
+description: "Hướng dẫn sử dụng Memory System — cấu hình 3 lớp trí nhớ, Learn mode, và scoreboard."
+keywords: ["memory system", "self-learning", "SOP"]
+sidebar:
+  order: 3
+---
+
+# Memory System — SOP
+
+> **Quick Reference**
+> - **3 layers**: Semantic (patterns), Episodic (experiences), Working (context)
+> - **Auto-learn**: Từ user edits, deletes, praise
+> - **Scoreboard**: Reward/penalty tracking
+
+## Memory Architecture
+
+| Layer | Path | Mục đích | Lifecycle |
+|-------|------|---------|-----------|
+| Semantic | `memory/semantic/` | Writing patterns, SEO rules, mistakes | Long-term (persistent) |
+| Episodic | `memory/episodic/` | Per-session experiences | Medium-term (max 100) |
+| Working | `memory/working/` | Current session context | Short-term (session only) |
+
+## Setup
+
+### Initialize Memory
+
+```bash
+python3 scripts/memory.py --config content-factory.config.json --init
+```
+
+### Trigger Learn Mode
+
+```bash
+# After user feedback
+python3 scripts/scoreboard.py --config content-factory.config.json --detect-changes
+python3 scripts/memory.py --config content-factory.config.json --learn
+```
+
+### View Scoreboard
+
+```bash
+python3 scripts/scoreboard.py --config content-factory.config.json --summary
+```
+
+## How Learning Works
+
+1. **Detect**: Git diff detects user edits/deletes
+2. **Score**: Apply reward/penalty points
+3. **Extract**: Identify patterns from episodic memories
+4. **Update**: Save patterns to semantic memory
+5. **Apply**: Next Write mode uses updated context

package/skills/cm-content-factory/sites/docs-site/src/content/docs/sop/seo-optimization.md

@@ -0,0 +1,58 @@
+---
+title: "SEO Optimization"
+description: "Hướng dẫn sử dụng SEO mode — keyword research, meta optimization, competitor analysis."
+keywords: ["SEO", "optimization", "content factory", "SOP"]
+sidebar:
+  order: 4
+---
+
+# SEO Optimization — SOP
+
+> **Quick Reference**
+> - **Ai**: SEO Specialist
+> - **Modes**: SEO + Research
+> - **Thời gian**: ~15 phút per batch
+
+## Step-by-Step
+
+### Step 1: Extract SEO Data
+
+```bash
+python3 scripts/seo.py --config content-factory.config.json extract
+```
+
+Scans all content articles và extracts current SEO metadata.
+
+### Step 2: Apply Optimization
+
+```bash
+python3 scripts/seo.py --config content-factory.config.json apply
+```
+
+Auto-generates optimized title tags, meta descriptions, and keyword placements.
+
+### Step 3: Competitor Research (Optional)
+
+```bash
+python3 scripts/research.py --config content-factory.config.json \
+  --topic "target keyword"
+```
+
+Analyzes competitor content structure và identifies content gaps.
+
+### Step 4: Review Monetization Score
+
+```bash
+python3 scripts/monetize.py --config content-factory.config.json --score-all
+```
+
+Scores articles for monetization potential: commercial intent × conversion × demand.
+
+## SEO Checklist
+
+- [ ] Title tags unique và < 60 characters
+- [ ] Meta descriptions compelling và < 155 characters
+- [ ] H1 unique per page
+- [ ] Keywords in first 100 words
+- [ ] Internal links to related content
+- [ ] Alt text on images

package/skills/cm-content-factory/sites/docs-site/src/content/docs/sop/troubleshooting-guide.md

@@ -0,0 +1,92 @@
+---
+title: "Troubleshooting"
+description: "Xử lý vấn đề thường gặp với Content Factory — config errors, pipeline failures, memory issues."
+keywords: ["troubleshooting", "content factory", "debugging"]
+sidebar:
+  order: 5
+---
+
+# Troubleshooting
+
+> **Quick Reference**
+> - **Ai**: Tất cả users
+> - **Format**: Symptom → Cause → Solution
+
+## Common Issues
+
+### 1. Config File Errors
+
+| Symptom | Cause | Solution |
+|---------|-------|---------|
+| `FileNotFoundError: config` | Config path sai | Check `CF_CONFIG_PATH` env var |
+| `JSONDecodeError` | Invalid JSON syntax | Validate JSON online |
+| `KeyError: 'niche'` | Missing required field | Check schema in `config.schema.json` |
+
+### 2. Pipeline Failures
+
+<details>
+<summary>Extract mode fails</summary>
+
+**Cause**: Source path không tồn tại hoặc file format không supported.
+
+**Fix**:
+```bash
+# Verify paths
+ls -la $(jq -r '.sources.paths[]' content-factory.config.json)
+```
+
+</details>
+
+<details>
+<summary>Write mode produces low quality</summary>
+
+**Cause**: Memory system chưa initialized hoặc knowledge base trống.
+
+**Fix**:
+```bash
+python3 scripts/memory.py --init
+python3 scripts/extract.py --config content-factory.config.json
+```
+
+</details>
+
+<details>
+<summary>Audit always fails</summary>
+
+**Cause**: Audit rules quá strict hoặc brand voice chưa defined.
+
+**Fix**: Check `config.audit` section, adjust thresholds.
+
+</details>
+
+### 3. Memory Issues
+
+<details>
+<summary>Memory not improving over time</summary>
+
+**Cause**: Learn mode chưa được chạy, hoặc not enough episodic data.
+
+**Fix**:
+```bash
+# Run learn mode manually
+python3 scripts/scoreboard.py --detect-changes
+python3 scripts/memory.py --learn
+```
+
+</details>
+
+## Quick Diagnostic
+
+```bash
+# Check config
+python3 -c "import json; json.load(open('content-factory.config.json'))"
+
+# Check memory status
+python3 scripts/scoreboard.py --summary
+
+# Check knowledge base
+ls -la knowledge-base/
+
+# Dry run pipeline
+CF_DRY_RUN=true python3 scripts/pipeline.py
+```