initializare

.claude/docs/QUICK-REFERENCE.md

@@ -0,0 +1,219 @@
+# Nova PAI - Quick Reference Card
+
+## 🚀 Adăugare Skill Nou - 4 Pași
+
+```bash
+# 1. Creează directorul
+mkdir -p .claude/skills/[nume-skill]/
+
+# 2. Creează SKILL.md
+cat > .claude/skills/[nume-skill]/SKILL.md << 'EOF'
+---
+name: [nume-skill]
+description: "Scurtă descriere (max 2 fraze)"
+---
+
+# [Nume] Skill
+
+## Prezentare
+[Ce face skill-ul]
+
+## Când să Folosești
+- Situație 1
+- Situație 2
+
+## Proces de Execuție
+
+### Pas 1: [Nume]
+[Descriere]
+
+### Pas 2: [Nume]
+[Descriere]
+
+## Exemple Complete
+
+### Exemplu 1: [Scenariu]
+**Input**: "..."
+**Output**: ...
+
+## Troubleshooting
+
+### Problem: [Problemă]
+**Soluție**: [Fix]
+
+---
+**Versiune**: 1.0
+**Ultima actualizare**: [DATA]
+EOF
+
+# 3. Actualizează context/claude.md
+# Adaugă în lista "Skills disponibile":
+# - `[nume-skill]/` - [Descriere]
+
+# 4. Testează
+# În conversație: "Folosește skill-ul [nume-skill] pentru..."
+```
+
+---
+
+## 📁 Structura Fișiere
+
+### Skill Simplu
+```
+.claude/skills/[nume]/
+└── SKILL.md
+```
+
+### Skill Complex
+```
+.claude/skills/[nume]/
+├── SKILL.md
+├── template.md
+├── examples/
+│   ├── example1.md
+│   └── example2.md
+└── reference.md
+```
+
+---
+
+## 🔧 Upgrade Sistem
+
+### Adaugă Subsistem Nou
+```bash
+mkdir -p .claude/context/[subsistem]/
+# Creează [subsistem]/claude.md
+# Actualizează context/claude.md secțiunea "Subsisteme Disponibile"
+```
+
+### Adaugă Tip Proiect Nou
+```bash
+mkdir -p .claude/context/projects/[tip]/
+# Creează [tip]/claude.md cu workflow specific
+# Actualizează context/claude.md
+```
+
+### Adaugă Tool Documentation
+```bash
+# Editează .claude/context/tools/claude.md
+# Adaugă secțiune nouă cu sintaxă și best practices
+```
+
+---
+
+## 📝 Template YAML Frontmatter
+
+```yaml
+---
+name: skill-name
+description: "Concise description in 1-2 sentences"
+version: "1.0"
+author: "Your Name"
+tags: ["tag1", "tag2"]
+requires: ["other-skill"]  # optional
+---
+```
+
+---
+
+## ✅ Checklist Post-Skill
+
+- [ ] YAML frontmatter valid
+- [ ] Secțiune "Când să folosești"
+- [ ] Proces în pași numerotați
+- [ ] Minimum 2 exemple
+- [ ] Troubleshooting section
+- [ ] context/claude.md actualizat
+- [ ] Testat în conversație
+
+---
+
+## 🎯 Skills Ideas
+
+### Development
+- `code-review` - Review cod profesional
+- `debug-assistant` - Debugging workflow
+- `api-design` - Design REST APIs
+- `test-generation` - Generare teste
+
+### Data & Analysis
+- `data-analysis` - Pandas, numpy, stats
+- `visualization` - Charts, graphs
+- `sql-query` - Query optimization
+- `data-cleaning` - Preprocessing data
+
+### Content & Communication
+- `email-drafting` - Email profesionale
+- `presentation` - Slides și prezentări
+- `documentation` - Docs tehnice
+- `copywriting` - Marketing copy
+
+### Business
+- `market-research` - Analiză piață
+- `competitive-analysis` - Analiză competitori
+- `financial-analysis` - Analiză financiară
+- `business-plan` - Business planning
+
+---
+
+## 🔄 Workflow Adăugare
+
+```
+Idee Skill → Template → Scriere → Test → Update Context → Deploy
+     ↓          ↓          ↓        ↓          ↓            ↓
+  Validare   SKILL.md   Content   Manual   claude.md    Production
+```
+
+---
+
+## 📚 Fișiere Importante
+
+| Fișier | Scop | Când Modifici |
+|--------|------|---------------|
+| `context/claude.md` | Master doc | La fiecare skill nou |
+| `output_style.md` | Identitate | Schimbări personalitate |
+| `context/tools/claude.md` | Tools docs | Tool nou/updated |
+| `memory/learnings.md` | Învățări | Post probleme rezolvate |
+
+---
+
+## 💡 Tips
+
+### ✅ DO
+- Păstrează skills modulare și focusate
+- Include multe exemple
+- Documentează edge cases
+- Testează înainte de deploy
+
+### ❌ DON'T
+- Nu face skills prea largi
+- Nu duplica logică din alte skills
+- Nu uita să updatezi context/claude.md
+- Nu omite troubleshooting
+
+---
+
+## 🆘 Help
+
+**Documentație completă**: `.claude/docs/HOW-TO-ADD-SKILLS.md`
+**Exemple**: `.claude/skills/web-research/` și `/research-report/`
+**Arhitectură**: `.claude/context/claude.md`
+**README general**: `.claude/README.md`
+
+---
+
+## 🔗 Links Rapide
+
+```bash
+# Vezi toate skills
+ls -la .claude/skills/
+
+# Citește arhitectura
+cat .claude/context/claude.md
+
+# Ghid complet
+cat .claude/docs/HOW-TO-ADD-SKILLS.md
+
+# Template skill
+cat .claude/docs/HOW-TO-ADD-SKILLS.md | grep -A50 "Template:"
+```