initializare

.claude/docs/EXAMPLE-NEW-SKILL.md

@@ -0,0 +1,539 @@
+# Exemplu Practic: Adăugare Skill "Email Drafting"
+
+Acest document demonstrează procesul complet de adăugare a unui skill nou în sistemul Nova PAI.
+
+## Skill Ales: Email Drafting
+
+**De ce acest skill?**
+- Use case comun (toată lumea scrie email-uri)
+- Necesită context și structură
+- Se combină bine cu alte skills (ex: research pentru content)
+
+---
+
+## Pas cu Pas
+
+### 1. Crearea Structurii
+
+```bash
+# Creează directorul skill-ului
+mkdir -p .claude/skills/email-drafting/
+
+# Verificare
+ls -la .claude/skills/
+# Should show: email-drafting/
+```
+
+### 2. Crearea SKILL.md
+
+**Fișier**: `.claude/skills/email-drafting/SKILL.md`
+
+```markdown
+---
+name: email-drafting
+description: "Skill pentru compunerea de email-uri profesionale: business communication, networking, follow-ups, și outreach. Folosește pentru orice task de scriere email."
+---
+
+# Email Drafting Skill
+
+## Prezentare
+
+Acest skill te ajută să compui email-uri profesionale, clare și eficiente pentru diverse contexte: business communication, networking, job applications, follow-ups, și outreach.
+
+## Când să Folosești
+
+- Utilizatorul cere "Scrie-mi un email..."
+- "Cum răspund la..."
+- Networking outreach
+- Cold emails
+- Follow-up messages
+- Business correspondence
+- Job applications / cover letters
+
+## Pre-requisite
+
+Înainte de a compune email-ul, trebuie să ai:
+- ✅ Destinatarul (cui scrii)
+- ✅ Scopul email-ului (ce vrei să obții)
+- ✅ Contextul (de ce acum, ce relație aveți)
+
+## Proces de Execuție
+
+### Pas 1: Clarificare Context
+
+**Întrebări obligatorii**:
+
+1. **Cui scrii?**
+   - Rol/poziție (CEO, recrutant, coleg, client)
+   - Relație existentă (cunoscut, cold outreach, follow-up)
+   - Nivel seniority
+
+2. **Ce vrei să obții?**
+   - Acțiune specifică (meeting, informații, aprobare)
+   - Deadline (urgent vs. flexibil)
+   - Importanță (high stakes vs. casual)
+
+3. **Ce ton e potrivit?**
+   - Formal vs. casual
+   - Direct vs. diplomatic
+   - Urgent vs. relaxat
+
+### Pas 2: Selectare Template
+
+În funcție de tip, alege structura potrivită:
+
+**A. Cold Outreach** (nu vă cunoașteți)
+```
+Subject: [Specific + Value proposition]
+
+Hi [Name],
+
+[Hook - de ce scrii + connection/relevance]
+
+[Value - ce oferi sau de ce e relevant pentru ei]
+
+[Ask - specific și rezonabil]
+
+[Close - ușor de răspuns]
+
+Best regards,
+[Your name]
+```
+
+**B. Follow-up** (după întâlnire/email)
+```
+Subject: Re: [Previous subject] - [Action item]
+
+Hi [Name],
+
+[Reference to previous interaction]
+
+[Update or reason for follow-up]
+
+[Next steps or ask]
+
+Thanks,
+[Your name]
+```
+
+**C. Request** (ceri ceva)
+```
+Subject: [Clear what you need]
+
+Hi [Name],
+
+[Context - de ce scrii]
+
+[Request - specific și clar]
+
+[Why it matters - benefit pentru ambii]
+
+[Timeline - când ai nevoie]
+
+Thank you for considering,
+[Your name]
+```
+
+**D. Professional Introduction**
+```
+Subject: Introduction - [Your name] from [Company/Context]
+
+Hi [Name],
+
+[Who you are - 1 sentence]
+
+[Why you're reaching out - connection/reason]
+
+[What you propose - meeting, call, collaboration]
+
+[Call to action - easy to respond]
+
+Looking forward to connecting,
+[Your name]
+```
+
+### Pas 3: Scriere Draft
+
+**Componentele esențiale**:
+
+1. **Subject Line**
+   - ✅ Clar și specific
+   - ✅ Sub 50 caractere
+   - ✅ Evită spam triggers (FREE, URGENT!!!, etc.)
+   - ❌ Nu folosi "Re:" dacă nu e răspuns real
+
+2. **Opening**
+   - ✅ Personalizat (folosește numele)
+   - ✅ Context imediat (de ce scrii)
+   - ❌ Nu începe cu "Sper că ești bine" în cold emails
+
+3. **Body**
+   - ✅ Paragrafe scurte (2-4 fraze)
+   - ✅ Un singur scop principal
+   - ✅ Beneficii clare
+   - ❌ Nu include multiple cereri nesupravegheate
+
+4. **Call to Action**
+   - ✅ Specific și actionable
+   - ✅ Ușor de executat
+   - ✅ Include opțiuni (dacă e relevant)
+   - ❌ Nu lăsa vag ("Aștept răspunsul tău")
+
+5. **Closing**
+   - ✅ Professional
+   - ✅ Pe ton cu restul email-ului
+   - ✅ Include contact info dacă e relevant
+
+### Pas 4: Revizuire și Optimizare
+
+**Checklist final**:
+
+- [ ] Subject line sub 50 caractere și clar
+- [ ] Email sub 150 cuvinte (ideal 75-100)
+- [ ] Un singur scop principal
+- [ ] CTA clar și specific
+- [ ] Fără greșeli gramaticale
+- [ ] Ton consistent
+- [ ] Mobile-friendly (testează pe telefon)
+- [ ] Include toate informațiile necesare pentru răspuns
+
+**Red flags** (evită):
+- 🚩 Email > 200 cuvinte (prea lung)
+- 🚩 Multiple CTA-uri confuze
+- 🚩 Prea formal sau prea casual
+- 🚩 Lipsa context (destinatarul nu știe de ce scrii)
+- 🚩 Vague asks ("să discutăm cândva")
+
+## Exemple Complete
+
+### Exemplu 1: Networking Cold Email
+
+**Context**: Vrei să te conectezi cu un VP Product din industria ta
+
+**Input**: "Scrie-mi un email de networking către Sarah Johnson, VP Product la TechCorp"
+
+**Output**:
+
+```
+Subject: Fellow Product Leader - Quick Question
+
+Hi Sarah,
+
+I'm Alex, VP Product at StartupXYZ, and I've been following TechCorp's product evolution—particularly your recent AI features launch.
+
+I'm currently navigating a similar product challenge (scaling personalization) and would love to hear about your team's approach, if you're open to a brief chat.
+
+Would you have 15 minutes in the next 2 weeks for a quick call? Happy to work around your schedule.
+
+Thanks for considering!
+
+Alex
+alex@startupxyz.com
+```
+
+**De ce funcționează**:
+- Relevance imediat (fellow VP, same field)
+- Specific despre ce admiri
+- Clear ask (15 min, 2 weeks = flexibil)
+- Respectful (nu cere mult timp)
+
+### Exemplu 2: Follow-up După Meeting
+
+**Context**: Ai avut un call cu un client potențial, acum trimiți follow-up
+
+**Input**: "Follow-up după meeting cu John despre implementarea platformei noastre"
+
+**Output**:
+
+```
+Subject: Re: Platform Demo - Next Steps
+
+Hi John,
+
+Thanks for taking the time yesterday to walk through your team's workflow challenges. The data synchronization issue you mentioned is definitely something our platform can address.
+
+As discussed, I'm attaching:
+- Custom proposal for your 50-person team
+- Case study from a similar fintech client
+- Pricing breakdown with the Q1 discount
+
+I've blocked time on Friday, Jan 12 at 2pm for our follow-up call, but let me know if you need to reschedule.
+
+Looking forward to moving this forward!
+
+Best,
+Alex
+```
+
+**De ce funcționează**:
+- Reference specific la discussion
+- Delivers pe promisiuni
+- Clear next step cu dată
+- Professional dar friendly
+
+### Exemplu 3: Request Email (Asking for Introduction)
+
+**Context**: Vrei o introducere către un investitor
+
+**Input**: "Cere-i lui Mark să mă introducă la Sarah Chen, investitor la Accel"
+
+**Output**:
+
+```
+Subject: Intro Request - Sarah Chen / Accel
+
+Hey Mark,
+
+Hope you're doing well! I'm reaching out because I saw you're connected with Sarah Chen at Accel, and I'm currently raising our Series A.
+
+Our traction (5x growth in Q4, 200+ enterprise customers) aligns well with Accel's B2B SaaS focus, and I'd love to get on Sarah's radar.
+
+Would you feel comfortable making a short intro? Happy to send a forwardable email if that helps.
+
+No worries if the timing isn't right—appreciate you either way!
+
+Best,
+Alex
+```
+
+**De ce funcționează**:
+- Respect relationship (asks permission)
+- Provides context (why Sarah specifically)
+- Makes it easy (offers forwardable)
+- No pressure close
+
+### Exemplu 4: Difficult Email (Saying No)
+
+**Context**: Trebuie să refuzi o cerere dar vrei să păstrezi relația
+
+**Input**: "Refuz politicos o cerere de parteneriat"
+
+**Output**:
+
+```
+Subject: Re: Partnership Proposal - Current Focus
+
+Hi Jessica,
+
+Thanks for the detailed partnership proposal—I can see you put a lot of thought into how our products could complement each other.
+
+After discussing with the team, we've decided to hold off on new partnerships this quarter while we focus on product improvements for our current customers.
+
+That said, I'm impressed with what you're building at [Company], and I'd love to revisit this conversation in Q3 when we have more bandwidth.
+
+I'll keep an eye on your progress!
+
+Best,
+Alex
+```
+
+**De ce funcționează**:
+- Respectful și appreciative
+- Clear "no" dar nu harsh
+- Leaves door open (specific timeframe)
+- Positive closing
+
+## Tools Folosite
+
+- **Read** - Pentru citire context anterior (threads)
+- **Write** - Pentru salvare drafts
+- **WebSearch** - Pentru research recipient (dacă e cold email)
+
+## Integrare cu Alte Skills
+
+**Combină cu**:
+- `research` - Pentru background check pe recipient
+- `copywriting` - Pentru subject lines mai creative
+- `translation` - Pentru email-uri în alte limbi
+
+## Troubleshooting
+
+### Problem: Email prea lung
+
+**Soluție**:
+1. Identifică scopul principal
+2. Elimină paragrafe care nu contribuie direct
+3. Target: 75-100 cuvinte
+4. Mută detalii extra în atașamente
+
+### Problem: Ton prea formal/casual
+
+**Soluție**:
+1. Verifică seniority destinatar
+2. Analizează industrie (tech = mai casual, legal = formal)
+3. Dacă unsure, alege profesional-neutral
+4. Match tonul emailurilor anterioare dacă există thread
+
+### Problem: Nu știi ce CTA să pui
+
+**Soluție**:
+**Template-uri CTA**:
+- **Ușor**: "Would [specific day/time] work for a quick call?"
+- **Flexibil**: "Let me know what works for your calendar"
+- **Urgent**: "Could we connect this week? I'm available [times]"
+- **Low commitment**: "Would you be open to a brief intro call?"
+
+### Problem: Nu primești răspuns
+
+**Soluție Follow-up**:
+1. Așteaptă 5-7 zile business
+2. Trimite bump scurt:
+```
+Hi [Name],
+
+Bumping this up in your inbox—wanted to make sure it didn't get lost!
+
+Any thoughts on [original ask]?
+
+Thanks,
+[You]
+```
+3. Maxim 2 follow-ups total
+
+## Best Practices
+
+### ✅ DO
+
+- **Personalizează**: Referă ceva specific despre destinatar
+- **Scurt**: Under 150 cuvinte ideal
+- **Scannable**: Paragrafe scurte, bullet points dacă e relevant
+- **Mobile-first**: Majoritatea citesc pe telefon
+- **Proofread**: Zero typos
+- **Time it right**: Trimite Marți-Joi, 10am-2pm pentru best response
+
+### ❌ DON'T
+
+- **Nu folosi cuvinte spam**: FREE, URGENT, GUARANTEED
+- **Nu trimiți la weekend**: Except dacă e industry norm
+- **Nu CC prea mulți**: Dilutes responsibility
+- **Nu folosești Reply All**: Except dacă relevant pentru toți
+- **Nu incluzi emoji**: În business formal
+- **Nu scrii când ești nervos**: Draft-uiește, review a doua zi
+
+## Variații pe Contexte
+
+### Intern (Coleg/Manager)
+- Mai casual
+- Mai direct
+- Poate fi mai lung dacă e complex
+
+### Client
+- Professional
+- Solution-focused
+- Clear deliverables
+
+### Recruiter/Job Application
+- Enthusiastic dar nu desperate
+- Highlight relevant experience
+- Show you did research
+
+### Investor
+- Concise
+- Data-driven
+- Clear traction
+
+## Metrics de Success
+
+Un email bun are:
+- **Open rate**: >40% (subject line bun)
+- **Response rate**: >20% (relevant + clear CTA)
+- **Action rate**: >10% (meeting booked, intro made, etc.)
+
+Dacă primești sub aceste rates, iterate pe:
+1. Subject lines
+2. Personalization
+3. Length (mai scurt)
+4. CTA clarity
+
+---
+
+**Versiune**: 1.0
+**Ultima actualizare**: 2025-01-06
+**Autor**: Claude (Nova PAI Demo)
+```
+
+### 3. Actualizare context/claude.md
+
+**Editează**: `.claude/context/claude.md`
+
+**Găsește secțiunea**:
+```markdown
+**Skills disponibile**:
+- `web-research/` - Cercetare avansată pe web
+- `research-report/` - Generare rapoarte profesionale
+```
+
+**Adaugă**:
+```markdown
+**Skills disponibile**:
+- `web-research/` - Cercetare avansată pe web
+- `research-report/` - Generare rapoarte profesionale
+- `email-drafting/` - Compunere email-uri profesionale
+```
+
+### 4. (Opțional) Testare
+
+**În conversație nouă**:
+
+```
+"Citește .claude/skills/email-drafting/SKILL.md și folosește-l pentru a-mi scrie un email de networking către un VP Engineering"
+```
+
+**Așteptat**:
+- Nova citește skill-ul
+- Întreabă clarificări (context, relație, etc.)
+- Generează email folosind template-ul potrivit
+- Verifică cu checklist-ul final
+
+---
+
+## Rezultat Final
+
+Ai acum:
+- ✅ Skill nou funcțional: `email-drafting`
+- ✅ Documentație completă cu 4 exemple
+- ✅ Integrare în sistemul Nova
+- ✅ Ready for production use
+
+**Locație fișiere**:
+```
+.claude/
+├── skills/
+│   └── email-drafting/
+│       └── SKILL.md  ← NOU
+└── context/
+    └── claude.md     ← ACTUALIZAT
+```
+
+---
+
+## Următorii Pași
+
+1. **Testează skill-ul** cu diverse scenarii
+2. **Documentează probleme** în troubleshooting
+3. **Adaugă în memory** orice învățări
+4. **Iterează** bazat pe feedback
+
+---
+
+## Template pentru Skill-ul Tău
+
+Folosește această structură ca starting point:
+
+```bash
+# 1. Creează
+mkdir -p .claude/skills/[nume]/
+
+# 2. Copiază structura din email-drafting ca template
+cp .claude/skills/email-drafting/SKILL.md .claude/skills/[nume]/SKILL.md
+
+# 3. Editează cu conținut specific
+
+# 4. Update context/claude.md
+
+# 5. Test!
+```
+
+---
+
+**Pro Tip**: Începe cu skills simple și concrete (ca email-drafting), apoi extinde la skills mai complexe (data analysis, code generation, etc.).

.claude/docs/HOW-TO-ADD-SKILLS.md

@@ -0,0 +1,505 @@
+# Ghid: Cum să Adaugi Noi Skills în Nova
+
+## Procesul de Adăugare Skill Nou
+
+### Pas 1: Creează Directorul Skill-ului
+
+```bash
+mkdir -p .claude/skills/[nume-skill]/
+```
+
+**Exemple**:
+- `.claude/skills/data-analysis/`
+- `.claude/skills/code-review/`
+- `.claude/skills/email-drafting/`
+
+### Pas 2: Creează SKILL.md cu YAML Frontmatter
+
+**Template**:
+
+```markdown
+---
+name: [nume-skill]
+description: "Descriere concisă ce face skill-ul și când să-l folosești. Maximum 2 fraze."
+---
+
+# [Nume Skill] Skill
+
+## Prezentare
+
+[1-2 paragrafe ce este skill-ul și ce face]
+
+## Când să Folosești
+
+[Listă cu situații când acest skill e relevant]
+- Situație 1
+- Situație 2
+- etc.
+
+## Pre-requisite
+
+[Dacă skill-ul depinde de altceva]
+- Prerequisit 1
+- Prerequisit 2
+
+## Proces de Execuție
+
+### Pas 1: [Nume Pas]
+
+[Descriere detaliată]
+
+**Input necesar**:
+- Item 1
+- Item 2
+
+**Output așteptat**:
+- Rezultat 1
+- Rezultat 2
+
+### Pas 2: [Nume Pas]
+
+[Continuă...]
+
+## Tools Necesare
+
+[Ce tools din sistem vei folosi]
+- `WebSearch` - pentru X
+- `Write` - pentru Y
+- etc.
+
+## Template de Lucru
+
+[Dacă există un template util]
+
+```
+[Template aici]
+```
+
+## Exemple Complete
+
+### Exemplu 1: [Scenariu Simplu]
+
+**Input**: "..."
+
+**Execuție**:
+```
+1. Pas 1
+2. Pas 2
+3. Pas 3
+```
+
+**Output**: [Descriere rezultat]
+
+### Exemplu 2: [Scenariu Complex]
+
+[Similar...]
+
+## Troubleshooting
+
+### Problem: [Problemă comună]
+
+**Soluție**: [Cum să rezolvi]
+
+### Problem: [Altă problemă]
+
+**Soluție**: [Soluție]
+
+## Best Practices
+
+### ✅ DO
+- Practice 1
+- Practice 2
+
+### ❌ DON'T
+- Anti-pattern 1
+- Anti-pattern 2
+
+## Integrare cu Alte Skills
+
+[Dacă skill-ul se combină cu altele]
+
+- Folosește împreună cu `[skill-name]` pentru [use case]
+- După `[skill-name]`, folosește acest skill pentru [next step]
+
+## Note Importante
+
+[Orice avertismente sau considerații speciale]
+
+---
+
+**Versiune**: 1.0
+**Ultima actualizare**: [DATA]
+**Autor**: [NUME]
+```
+
+### Pas 3: Actualizează context/claude.md
+
+Adaugă skill-ul în lista de skills disponibile:
+
+```markdown
+## Subsisteme Disponibile
+
+### 4. Skills System (`~/.claude/skills/`)
+
+**Skills disponibile**:
+- `web-research/` - Cercetare avansată pe web
+- `research-report/` - Generare rapoarte profesionale
+- `[nou-skill]/` - [Descriere scurtă]  ← ADAUGĂ AICI
+```
+
+### Pas 4: (Opțional) Creează Fișiere Suport
+
+În directorul skill-ului poți adăuga:
+- `template.md` - Template-uri
+- `examples/` - Exemple detaliate
+- `reference.md` - Documentație tehnică
+
+---
+
+## Exemple de Skills Noi
+
+### Exemplu 1: Data Analysis Skill
+
+```bash
+mkdir -p .claude/skills/data-analysis/
+```
+
+**SKILL.md**:
+```markdown
+---
+name: data-analysis
+description: "Skill pentru analiza de date folosind pandas, numpy și matplotlib. Folosește pentru task-uri de statistică, vizualizare, și data cleaning."
+---
+
+# Data Analysis Skill
+
+## Când să Folosești
+
+- Utilizatorul cere analiza unui CSV/Excel
+- Task-uri de statistică descriptivă
+- Vizualizare date
+- Data cleaning și preprocessing
+
+## Proces de Execuție
+
+### Pas 1: Încărcare Date
+
+Folosește pandas pentru a citi fișierul:
+
+```python
+import pandas as pd
+df = pd.read_csv('file.csv')
+```
+
+### Pas 2: Explorare Inițială
+
+```python
+# Overview
+df.info()
+df.describe()
+df.head()
+
+# Check missing values
+df.isnull().sum()
+```
+
+[...continuă cu pașii]
+```
+
+### Exemplu 2: Code Review Skill
+
+```bash
+mkdir -p .claude/skills/code-review/
+```
+
+**SKILL.md**:
+```markdown
+---
+name: code-review
+description: "Skill pentru review profesional de cod: securitate, best practices, performanță, și mentenabilitate."
+---
+
+# Code Review Skill
+
+## Când să Folosești
+
+- Utilizatorul cere review la cod
+- Pull request review
+- Audit de securitate
+- Optimizare performanță
+
+## Proces de Execuție
+
+### Pas 1: Citire și Înțelegere
+
+1. Read fișierele de cod
+2. Înțelege arhitectura
+3. Identifică purpose-ul
+
+### Pas 2: Analiza pe Categorii
+
+**Securitate**:
+- [ ] SQL injection
+- [ ] XSS vulnerabilities
+- [ ] Authentication issues
+- [ ] Sensitive data exposure
+
+**Best Practices**:
+- [ ] Naming conventions
+- [ ] Code organization
+- [ ] DRY principle
+- [ ] Error handling
+
+[...continuă]
+```
+
+### Exemplu 3: Email Drafting Skill
+
+```bash
+mkdir -p .claude/skills/email-drafting/
+```
+
+**SKILL.md**:
+```markdown
+---
+name: email-drafting
+description: "Skill pentru compunerea de email-uri profesionale: business, recrutare, networking, follow-ups."
+---
+
+# Email Drafting Skill
+
+## Când să Folosești
+
+- "Scrie-mi un email către..."
+- "Cum răspund la..."
+- Networking outreach
+- Follow-up messages
+
+## Proces de Execuție
+
+### Pas 1: Înțelege Contextul
+
+**Întrebări cheie**:
+- Cui scrii? (rol, relație)
+- Ce vrei să obții?
+- Ce ton e potrivit?
+- Cât de formal?
+
+### Pas 2: Structură Email
+
+**Template standard**:
+```
+Subject: [Clear, specific, action-oriented]
+
+[Greeting],
+
+[Opening - context/reference]
+
+[Body - main message in 2-3 paragraphs]
+
+[Call to action - specific ask]
+
+[Closing],
+[Signature]
+```
+
+[...continuă cu exemple]
+```
+
+---
+
+## Upgrade Skills Existente
+
+### Adăugare Funcționalitate Nouă
+
+1. **Editează SKILL.md**:
+```bash
+# Citește skill-ul existent
+cat .claude/skills/web-research/SKILL.md
+
+# Editează și adaugă secțiune nouă
+```
+
+2. **Adaugă noul proces/pas**
+
+3. **Actualizează versiunea**:
+```markdown
+**Versiune**: 1.1  ← increment
+**Ultima actualizare**: 2025-01-XX
+**Changelog**:
+- v1.1: Adăugat suport pentru [feature]
+- v1.0: Versiune inițială
+```
+
+### Îmbunătățire Exemple
+
+Adaugă mai multe exemple în secțiunea "Exemple Complete":
+
+```markdown
+### Exemplu 3: [Nou Scenariu]
+
+[Descriere completă]
+```
+
+### Adăugare Troubleshooting
+
+În secțiunea "Troubleshooting", adaugă noi probleme rezolvate:
+
+```markdown
+### Problem: [Problemă nouă descoperită]
+
+**Cauză**: [De ce se întâmplă]
+**Soluție**: [Pași de rezolvare]
+**Prevenire**: [Cum să eviți în viitor]
+```
+
+---
+
+## Upgrade Sistem General
+
+### 1. Adăugare Nou Subsistem
+
+**Exemplu**: Adăugare "Templates System"
+
+```bash
+mkdir -p .claude/context/templates/
+```
+
+Creează `templates/claude.md`:
+```markdown
+# Templates System
+
+## Scop
+[Descriere subsistem nou]
+
+## Când să folosești
+[Situații]
+
+## Template-uri disponibile
+- template-1
+- template-2
+```
+
+Actualizează `context/claude.md`:
+```markdown
+### 5. Templates System (`~/.claude/context/templates/`)
+
+**Scop**: [Scurt]
+**Când să folosești**: [Scurt]
+**Cum să accesezi**: [Instrucțiuni]
+```
+
+### 2. Adăugare Nou Tip Proiect
+
+```bash
+mkdir -p .claude/context/projects/[new-type]/
+```
+
+**Exemple**:
+- `projects/finance/` - Analiză financiară
+- `projects/marketing/` - Marketing content
+- `projects/coding/` - Development projects
+
+Creează `projects/[type]/claude.md` cu workflow specific.
+
+### 3. Upgrade Tools Documentation
+
+Editează `context/tools/claude.md`:
+
+```markdown
+### [Număr]. [Nume Tool Nou]
+
+**Scop**: [Ce face]
+
+**Când să folosești**: [Situații]
+
+**Sintaxă**:
+```
+[Cod exemplu]
+```
+
+**Best Practices**:
+- Practice 1
+- Practice 2
+```
+
+---
+
+## Checklist Post-Adăugare
+
+După ce adaugi un skill nou:
+
+- [ ] SKILL.md creat cu YAML frontmatter valid
+- [ ] Toate secțiunile completate (minimum: Prezentare, Când să folosești, Proces, Exemple)
+- [ ] Minim 2 exemple complete incluse
+- [ ] Troubleshooting section adăugată
+- [ ] context/claude.md actualizat cu noul skill
+- [ ] Testat skill-ul într-o conversație
+- [ ] Documentat în memory/learnings.md dacă e relevant
+
+---
+
+## Tips pentru Skills de Calitate
+
+### ✅ Best Practices
+
+1. **Claritate**: Scrie de parcă utilizatorul nu știe nimic despre task
+2. **Completitudine**: Include toate edge cases
+3. **Exemple**: Minimum 2, ideal 3-4 scenarii diferite
+4. **Troubleshooting**: Anticipează problemele comune
+5. **Tools specifice**: Listează exact ce tools folosești
+6. **Integrare**: Menționează cum se combină cu alte skills
+
+### ❌ Ce să Eviți
+
+1. **Ambiguitate**: "Fă cercetare bună" (prea vag)
+2. **Presupuneri**: Nu presupune cunoștințe implicite
+3. **Lips exemple**: Skill fără exemple concrete
+4. **Overflow**: Nu încărca TOT într-un singur skill (păstrează modular)
+5. **Duplicate**: Nu duplica logic din alte skills
+
+---
+
+## Versioning Skills
+
+**Schema**: `MAJOR.MINOR`
+
+- **MAJOR** (1.0 → 2.0): Schimbări majore în proces/workflow
+- **MINOR** (1.0 → 1.1): Adăugare features, îmbunătățiri
+
+**Changelog format**:
+```markdown
+**Changelog**:
+- v1.2: Adăugat suport pentru format X
+- v1.1: Îmbunătățit troubleshooting section
+- v1.0: Versiune inițială
+```
+
+---
+
+## Testare Skills Noi
+
+### Test Manual
+
+1. **Citește skill-ul** într-o conversație nouă
+2. **Execută task-ul** urmând pașii din skill
+3. **Verifică output-ul** vs. așteptări
+4. **Documentează** orice probleme în troubleshooting
+
+### Test Integrat
+
+1. **Combină cu alte skills**
+2. **Verifică flow-ul** natural între skills
+3. **Testează edge cases**
+
+---
+
+## Resurse
+
+- **Template blank**: Vezi secțiunea "Template" de mai sus
+- **Exemple existente**: `.claude/skills/web-research/` și `.claude/skills/research-report/`
+- **Documentație**: `.claude/context/claude.md`
+
+---
+
+**Întrebări?** Consultă `context/claude.md` sau creează un issue în memory/learnings.md

.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:"
+```