initializare

.claude/README.md

@@ -0,0 +1,205 @@
+# Nova - Personal AI Infrastructure Demo
+
+## Prezentare
+
+Acesta este un sistem demonstrativ de **Personal AI Infrastructure (PAI)** bazat pe principiile lui Daniel Miessler și conceptul de **Agent Skills** de la Anthropic.
+
+## Versiune
+
+**v1.0 Demo** - Ianuarie 2025
+
+## Concepte Fundamentale
+
+### Progressive Disclosure
+Sistemul încarcă doar contextul necesar pentru task-ul curent, nu tot contextul dintr-o dată. Acest lucru:
+- Reduce consumul de tokeni
+- Îmbunătățește performanța
+- Permite scalabilitate
+
+### Skills Modulare
+Capabilități specializate, auto-documentate, compozabile:
+- `web-research` - Cercetare web profesională
+- `research-report` - Generare rapoarte
+
+### Context Engineering
+Structură organizată de context care ghidează AI-ul în utilizarea corectă a capabilităților.
+
+## Structura Sistemului
+
+```
+.claude/
+├── output_style.md              # Identitatea Nova
+├── context/                     # Sistemul de context
+│   ├── claude.md               # Documentație master (START HERE)
+│   ├── memory/                 # Sistem de învățare
+│   │   ├── claude.md
+│   │   ├── user-preferences.md
+│   │   ├── work-patterns.md
+│   │   └── learnings.md
+│   ├── projects/               # Context specific proiecte
+│   │   └── research/
+│   │       └── claude.md
+│   └── tools/                  # Documentație tools
+│       └── claude.md
+├── skills/                      # Capabilități modulare
+│   ├── web-research/
+│   │   └── SKILL.md
+│   └── research-report/
+│       ├── SKILL.md
+│       └── report-structure-template.md
+└── hooks/                       # Automatizări
+    └── load-context.ts
+```
+
+## Quick Start
+
+### Pentru Nova (AI Assistant)
+
+La începutul fiecărei conversații:
+
+1. **Citește** `.claude/context/claude.md` pentru a înțelege arhitectura
+2. **Identifică** subsistemele relevante pentru task
+3. **Încarcă** doar contextul necesar
+4. **Execută** task-ul folosind skills și tools
+5. **Documentează** învățările în memory/
+
+### Pentru Utilizator
+
+Exemple de comenzi:
+
+```
+"Cercetează despre [subiect]"
+→ Nova folosește web-research skill
+
+"Cercetează despre [subiect] și fă raport"
+→ Nova folosește web-research + research-report skills
+
+"Ce skills ai disponibile?"
+→ Nova citește context/claude.md și listează
+```
+
+## Capabilities
+
+### Cercetare Web
+- Strategie de căutare în 5 pași
+- Evaluare credibilitate surse
+- Sinteză și analiză critică
+- Minimum 5-10 surse per cercetare
+
+### Generare Rapoarte
+- Structură profesională standardizată
+- Format Markdown
+- Executive summary, analiză, concluzii
+- Citații complete și corecte
+
+### Învățare Continuă
+- Stochează preferințe utilizator
+- Optimizează workflow-uri
+- Documentează best practices
+- Evoluție în timp
+
+## Teste Efectuate
+
+✅ **Test 1: Context Loading** - Verificare structură și documentație
+✅ **Test 2: Simple Research** - Workflow cercetare completă
+✅ **Test 3: Research + Report** - Integrare skills
+✅ **Test 4: Memory Persistence** - Sistem învățare
+
+## Files Count
+
+- **Total fișiere**: 13
+- **Context files**: 5
+- **Skills**: 2 (+ 1 template)
+- **Memory files**: 4
+- **Hooks**: 1
+- **Documentation**: 1 (README)
+
+## Extindere Sistem
+
+### 📖 Documentație Disponibilă
+
+- **[QUICK-REFERENCE.md](docs/QUICK-REFERENCE.md)** - Referință rapidă pentru task-uri comune
+- **[HOW-TO-ADD-SKILLS.md](docs/HOW-TO-ADD-SKILLS.md)** - Ghid complet adăugare skills noi
+
+### 🚀 Adăugare Skill Nou (Quick)
+
+```bash
+# 1. Creează directorul
+mkdir -p .claude/skills/[nume-skill]/
+
+# 2. Creează SKILL.md cu YAML frontmatter
+# Vezi template în docs/HOW-TO-ADD-SKILLS.md
+
+# 3. Actualizează context/claude.md
+# Adaugă în lista "Skills disponibile"
+
+# 4. Testează în conversație
+```
+
+### 💡 Idei pentru Skills Noi
+
+**Development**: `code-review`, `debug-assistant`, `api-design`, `test-generation`
+**Data**: `data-analysis`, `visualization`, `sql-query`, `data-cleaning`
+**Content**: `email-drafting`, `presentation`, `documentation`, `copywriting`
+**Business**: `market-research`, `competitive-analysis`, `financial-analysis`
+
+### 🔄 Upgrade Componente Existente
+
+- **Skills**: Editează SKILL.md, adaugă features, increment version
+- **Context**: Adaugă subsisteme în `context/`
+- **Projects**: Creează `projects/[tip]/claude.md` cu workflow specific
+- **Tools**: Actualizează `context/tools/claude.md` cu tool-uri noi
+
+## Technical Details
+
+### Progressive Disclosure Levels
+
+**Nivel 0**: Awareness că există sistem de context
+**Nivel 1**: Citește `context/claude.md` → înțelege subsisteme
+**Nivel 2**: Încarcă subsistemele relevante
+**Nivel 3**: Încarcă fișiere specifice din subsisteme
+
+### Skills Format
+
+Toate skills folosesc:
+- YAML frontmatter (`name`, `description`)
+- Markdown content structurat
+- Secțiuni standard (Scop, Când să folosești, Proces, Exemple)
+- Troubleshooting și best practices
+
+### Memory Format
+
+```markdown
+## [DATA] - [CATEGORIE]
+
+**Context**: [Situația]
+**Învățare**: [Ce s-a învățat]
+**Aplicabilitate**: [Când să aplici]
+
+---
+```
+
+## Philosophy
+
+> "The best AI assistant is one that learns your preferences, adapts to your workflow, and gets better over time while using resources efficiently."
+
+Acest sistem demonstrează că AI-ul poate fi:
+- **Eficient** (progressive disclosure)
+- **Adaptabil** (memory system)
+- **Modular** (skills system)
+- **Transparent** (context engineering)
+
+## Credits
+
+**Inspirație**:
+- Daniel Miessler - Personal AI Infrastructure (PAI)
+- Anthropic - Agent Skills concept
+- Claude Code - Implementation platform
+
+**Implementare**: Ianuarie 2025
+
+**Licență**: Demo/Educational purposes
+
+---
+
+Pentru întrebări despre acest sistem, consultă `context/claude.md` pentru detalii complete despre arhitectură și utilizare.