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.).