Initial project setup

Add project structure with package.json, source code, tests, documentation, and GitHub workflows.

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>

docs/brief.md

@@ -0,0 +1,214 @@
+# Project Brief: YouTube Subtitle Extraction & AI Summarization Bookmarklet
+
+## Executive Summary
+
+**YouTube Subtitle Extraction & AI Summarization Bookmarklet** este un instrument JavaScript care permite utilizatorilor să obțină rapid un rezumat structurat al conținutului video YouTube prin extragerea și procesarea subtitrărilor auto-generate cu Claude.ai. Soluția rezolvă problema pierderii de timp cu videoclipuri educaționale care pot să nu corespundă nevoilor utilizatorului, oferind o decizie rapidă despre relevanța conținutului.
+
+**Problema principală:** Utilizatorii Android Chrome investesc timp prețios vizionând videoclipuri YouTube educaționale pentru a descoperi abia după minute că conținutul nu le este relevant sau util.
+
+**Piața țintă:** Utilizatori mobili care consumă conținut educațional pe YouTube și au abonament Claude.ai, căutând eficiență în selectarea videoclipurilor de vizionat.
+
+**Propunerea de valoare cheie:** Transformă 10-20 minute de vizionare incertă în 2-3 minute de decizie informată prin rezumat AI structurat (Overview, Essential Points, Value Proposition, Beginner Summary).
+
+## Problem Statement
+
+**Starea actuală și punctele de durere:**
+Utilizatorii Android Chrome petrec în medie 10-20 minute vizionând videoclipuri educaționale YouTube doar pentru a descoperi că conținutul nu le este relevant, util sau la nivelul lor de înțelegere. Aceștia nu au o metodă eficientă de pre-evaluare a conținutului video fără să investească timpul complet de vizionare.
+
+**Impactul problemei:**
+- **Timp pierdut:** 60-80% din tentativele de vizionare rezultă în abandonarea videoclipului după constatarea irelevantei
+- **Frustrare cognitivă:** Întreruperea fluxului de învățare prin content nepotrivit
+- **Oportunitate pierdută:** Ratarea de conținut relevant din cauza ezitării să încerce videoclipuri noi
+
+**De ce soluțiile existente nu reușesc:**
+- Thumbnail-urile și titlurile sunt adesea clickbait sau vagi
+- Comentariile sunt inconsistente și subiective
+- Descrierea video-urilor este adesea incompletă sau promotional
+- Nu există modalități de preview pentru conținutul real al video-ului
+
+**Urgența și importanța soluționării acum:**
+Volumul crescând de conținut educațional YouTube face selecția din ce în ce mai dificilă, iar utilizatorii cu abonamente Claude.ai au deja instrumentele AI necesare pentru a procesa eficient textul subtitrărilor.
+
+## Proposed Solution
+
+**Conceptul central și abordarea:**
+Un bookmarklet JavaScript pentru Android Chrome care extrage automat subtitrările auto-generate ale videoclipurilor YouTube și le procesează prin Claude.ai pentru a genera un rezumat structurat în 4 secțiuni: Overview, Essential Points, Value Proposition și Beginner Summary. Soluția funcționează printr-un singur click în timpul vizionării și deschide rezultatul într-un tab nou.
+
+**Diferențiatorii cheie față de soluțiile existente:**
+- **Integrare seamless:** Funcționează direct în browser fără instalări sau permisiuni speciale
+- **Processing automat:** Combină extragerea de subtitrări cu AI processing într-un singur flux
+- **Structură optimizată pentru decizie:** 4 secțiuni specifice pentru evaluarea rapidă a relevanței
+- **Tehnologie existentă:** Folosește Claude.ai subscription-ul utilizatorului, nu necesită API-uri noi
+
+**De ce această soluție va reuși unde altele nu au reușit:**
+Spre deosebire de extension-uri complexe sau servicii separate, bookmarklet-ul elimină fricțiunea de adoptare prin simplitatea activării (un click) și prin faptul că utilizează infrastructura deja disponibilă (Claude.ai + downloadyoutubesubtitles.com API). RPA automation approach-ul mimează workflow-ul natural uman.
+
+**Viziunea high-level pentru produs:**
+O experiență transparentă unde utilizatorul poate evalua orice videoclip YouTube educațional în 2-3 minute printr-o structură de informații consistentă și acționabilă, păstrând controlul complet asupra deciziei de a continua vizionarea.
+
+## Target Users
+
+### Primary User Segment: Mobile Educational Content Consumers
+
+**Profil demografic:**
+- Vârstă: 25-45 ani, profesionali sau studenți avansați
+- Tehnologie: Utilizatori Android Chrome cu abonament Claude.ai activ
+- Educație: Nivel universitar+, obișnuiți cu tehnologia și AI tools
+- Venit: Suficient pentru abonamente premium (Claude.ai + eventual alte AI tools)
+
+**Comportamente și workflow-uri actuale:**
+- Consumă 3-7 videoclipuri educaționale YouTube pe săptămână pe mobil
+- Folosesc deja Claude.ai pentru alte taskuri (work, learning, research)
+- Navighează adesea între multiple videoclipuri, căutând conținut relevant
+- Vizionează în momente de timp limitat (transport, pauze, seară)
+
+**Nevoi specifice și puncte de durere:**
+- **Eficiență temporală:** "Nu vreau să pierd 15 minute pe un video care nu mă ajută"
+- **Evaluare rapidă:** "Vreau să știu dacă video-ul e la nivelul meu înainte să mă investesc"
+- **Context pentru decizie:** "Am nevoie să știu ce voi învăța exact și de ce e relevant"
+- **Flexibilitate de consum:** "Vreau să pot evalua rapid chiar și când sunt pe mobil"
+
+**Obiectivele pe care încearcă să le atingă:**
+- Învățare eficientă în timp limitat
+- Selecție inteligentă de conținut educațional
+- Maximizarea ROI-ului pentru timpul investit în învățare
+- Integrarea seamless cu toolchain-ul existent (Claude.ai)
+
+## Goals & Success Metrics
+
+### Business Objectives
+- **Adoptare utilizatori:** 100+ utilizatori activi în primele 3 luni după lansare, cu măsurare prin distribuție organică
+- **Retenție comportamentală:** 70% din utilizatori să folosească bookmarklet-ul săptămânal după prima lună de utilizare
+- **Eficiență demonstrabilă:** Reducerea cu 60% a timpului petrecut pe videoclipuri irelevante (măsurat prin survey utilizatori)
+
+### User Success Metrics
+- **Timp de procesare:** Sub 3 minute de la click la rezumat complet disponibil
+- **Acuratețe evaluare:** 80% din utilizatori raportează că rezumatul i-a ajutat să ia decizia corectă despre vizionare
+- **Utilizare consistentă:** Utilizatori activi folosesc bookmarklet-ul pentru 60%+ din videoclipurile educaționale accesate
+
+### Key Performance Indicators (KPIs)
+- **Success Rate:** % videoclipuri procesate cu succes fără erori tehnice - Target: 85%
+- **User Satisfaction Score:** Rating mediu pentru utilitatea rezumatelor (1-5) - Target: 4.2+
+- **Technical Reliability:** % requests care nu necesită manual CAPTCHA intervention - Target: 70%
+- **Engagement Quality:** % utilizatori care salvează sau partajează rezumatele generate - Target: 40%
+
+## MVP Scope
+
+### Core Features (Must Have)
+- **YouTube Video ID Extraction:** Detectare automată a video ID-ului din URL-ul curent și extragerea acestuia pentru API calls
+- **Subtitle API Integration:** Conectare la downloadyoutubesubtitles.com API cu handling pentru CAPTCHA intervention când e necesar
+- **Claude.ai Tab Opening:** Deschidere automată Claude.ai într-un tab nou cu sesiune de chat pregătită pentru input
+- **Clipboard Fallback:** Copiere automată în clipboard a textului subtitrărilor formatat pentru manual paste în Claude.ai dacă RPA fail
+- **Basic Error Handling:** Mesaje clare pentru utilizator când videoclipul nu are subtitrări auto-generate sau API-ul e indisponibil
+
+### Out of Scope for MVP
+- RPA automation pentru Claude.ai (fill textbox + click) - va fi Phase 2
+- Multi-language subtitle support - doar English auto-generated
+- Batch processing pentru multiple videoclipuri
+- Custom prompt templates pentru diferite tipuri de conținut
+- iOS Safari sau desktop browser support
+- Sharing direct în WhatsApp/Email/etc - doar clipboard copy
+
+### MVP Success Criteria
+MVP-ul este considerat reușit când un utilizator poate: (1) activa bookmarklet-ul pe orice videoclip YouTube educațional cu subtitrări auto-generate, (2) primi textul subtitrărilor în clipboard în sub 60 secunde, (3) deschide automat Claude.ai și să paste manual pentru rezumat, (4) să obțină un răspuns structurat care îi permite să decidă dacă continuă vizionarea - toate acestea fără erori tehnice în 85% din cazuri.
+
+## Post-MVP Vision
+
+### Phase 2 Features
+**RPA Automation for Claude.ai (2-3 weeks after MVP):** Implementarea automation pentru fill textbox + click submit în interfața Claude.ai, eliminând necesitatea manual paste. Includes DOM structure analysis, JavaScript injection pentru form manipulation, și fallback graceful la clipboard când automation fail.
+
+**Enhanced Mobile UX (1-2 weeks after MVP):** Optimizare pentru Android Chrome cu loading indicators, progress feedback, și mobile-optimized error messages. Includes responsive design pentru rezultate și improved visual cues pentru starea procesării.
+
+### Long-term Vision
+În 1-2 ani, bookmarklet-ul devine instrumentul standard pentru pre-evaluarea conținutului educațional YouTube pe mobil, cu integrare seamless în workflow-urile de învățare ale utilizatorilor Claude.ai. Visiunea include processing automat în background, rezultate instant cache-uite pentru videoclipuri procesate anterior, și intelligence despre preferințele utilizatorului pentru personalizarea rezumatelor.
+
+### Expansion Opportunities
+**Cross-Platform Extension:** Portarea la iOS Safari și desktop browsers cu menținerea simplității core experience-ului. **Multi-Language Support:** Extinderea la subtitrări în română, spaniolă, franceză pentru utilizatori internaționali. **Direct API Integration:** Colaborare cu Anthropic pentru Claude API access direct, eliminând dependency-ul pe RPA approach. **Content Intelligence:** Machine learning pentru predicția relevanței pe baza istoricului utilizatorului și pattern recognition în tipurile de conținut preferate.
+
+## Technical Considerations
+
+### Platform Requirements
+- **Target Platforms:** Android Chrome browser exclusively (initial focus)
+- **Browser/OS Support:** Chrome 90+ pe Android 8+, JavaScript ES6+ support required
+- **Performance Requirements:** Sub 3 secunde pentru video ID extraction + API call, sub 60 secunde total pentru subtitle retrieval including CAPTCHA handling
+
+### Technology Preferences
+- **Frontend:** Vanilla JavaScript (ES6+) pentru bookmarklet simplicity, fără dependencies externe
+- **Backend:** Utilizează downloadyoutubesubtitles.com API extern, no custom backend needed
+- **Database:** None pentru MVP - stateless operation
+- **Hosting/Infrastructure:** GitHub Pages pentru documentation și bookmarklet distribution
+
+### Architecture Considerations
+- **Repository Structure:** Single-file bookmarklet cu development version separată pentru debugging și minified version pentru production
+- **Service Architecture:** Client-side only cu external API dependencies (downloadyoutubesubtitles.com + Claude.ai)
+- **Integration Requirements:** DOM manipulation pentru YouTube pages, Cross-Origin Resource Sharing handling pentru API calls, Clipboard API pentru fallback functionality
+- **Security/Compliance:** No data storage, no user tracking, funcționează cu public APIs și user's own Claude.ai account - privacy by design
+
+## Constraints & Assumptions
+
+### Constraints
+- **Budget:** Zero budget pentru external services - tool-ul trebuie să funcționeze cu infrastructura gratuită disponibilă
+- **Timeline:** MVP functional în 1-2 săptămâni pentru development solo, Phase 2 în următoarele 2-3 săptămâni
+- **Resources:** Un developer JavaScript cu experiență în DOM manipulation și API integration
+- **Technical:** Limitări bookmarklet (no persistent storage, same-origin policy restrictions), dependența de API-uri externe (downloadyoutubesubtitles.com availability), CAPTCHA intervention requirements
+
+### Key Assumptions
+- Utilizatorii au abonament Claude.ai Pro activ și sunt familiari cu interfața
+- YouTube menține structura actuală de URL-uri pentru video ID extraction
+- DownloadYoutubeSubtitles.com API rămâne disponibil și funcțional
+- Utilizatorii acceptă CAPTCHA intervention ocasional pentru accesul la subtitrări
+- Majoritatea videoclipurilor educaționale target au subtitrări auto-generate în engleză
+- Claude.ai își menține interfața web actuală pentru eventual RPA integration
+- Utilizatorii sunt dispuși să învețe un workflow nou pentru beneficiul de eficiență
+
+## Risks & Open Questions
+
+### Key Risks
+- **API Dependency Risk:** DownloadYoutubeSubtitles.com poate deveni indisponibil sau să își schimbe API-ul, blocând complet funcționalitatea core
+- **CAPTCHA Escalation:** Site-ul poate să introducă CAPTCHA mai frecvent, degradând user experience sub threshold-ul de acceptabilitate
+- **Claude.ai Interface Changes:** Modificări în UI-ul Claude.ai pot întrerupe RPA automation plans pentru Phase 2
+- **YouTube Structure Changes:** Modificări în DOM structure sau URL patterns pot afecta video ID extraction
+- **Browser Policy Updates:** Chrome poate introduce restricții noi pentru bookmarklets care să limiteze funcționalitatea cross-domain
+
+### Open Questions
+- Cum gestionăm videoclipurile fără subtitrări auto-generate sau cu subtitrări de calitate foarte scăzută?
+- Care e strategia de fallback dacă downloadyoutubesubtitles.com devine complet inaccesibil?
+- Cum optimizăm pentru videoclipuri foarte lungi (2+ ore) unde subtitrările pot fi masive?
+- Este nevoie de rate limiting pentru API calls pentru a evita blocking-ul de pe serviciul extern?
+- Cum măsurăm și îmbunătățim calitatea rezumatelor generate de Claude.ai?
+
+### Areas Needing Further Research
+- Alternative APIs pentru subtitle extraction ca backup options
+- Feasibility study pentru direct YouTube API integration (oficial sau reverse-engineered)
+- User behavior analysis pentru optimal timing de activare a bookmarklet-ului
+- Performance optimization techniques pentru processing de text masiv în Claude.ai
+- Error recovery strategies și user feedback mechanisms pentru failure scenarios
+
+## Appendices
+
+### A. Research Summary
+**Brainstorming Session Results (September 5, 2025):**
+- Comprehensive 4-phase brainstorming session identifying technical architecture
+- Discovery of downloadyoutubesubtitles.com API with specific endpoints for auto-generated English subtitles
+- RPA automation approach validation for Claude.ai integration
+- User journey mapping pentru mobile Android Chrome workflow
+- Prioritization matrix establishing MVP → RPA → UX enhancement roadmap
+
+### B. Stakeholder Input
+**Primary Stakeholder (User) Requirements:**
+- Emphasis pe "cât mai simplu și rapid" pentru evaluarea videoclipurilor
+- Specific need pentru structured summary format (Overview, Essential Points, Value Proposition, Beginner Summary)
+- Mobile-first approach cu focus pe Android Chrome
+- Integration preference cu existing Claude.ai subscription
+
+## Next Steps
+
+### Immediate Actions
+1. **Set up development environment** - Create GitHub repository și development bookmarklet structure
+2. **Test API integration** - Validate downloadyoutubesubtitles.com API endpoints cu real YouTube video IDs
+3. **Implement core video ID extraction** - Build JavaScript function pentru parsing YouTube URLs
+4. **Create basic error handling** - Implement user-friendly messages pentru common failure scenarios
+5. **Test clipboard functionality** - Ensure cross-browser clipboard API compatibility pe Android Chrome
+
+### PM Handoff
+This Project Brief provides the full context pentru **YouTube Subtitle Extraction & AI Summarization Bookmarklet**. Please start în 'PRD Generation Mode', review the brief thoroughly to work with the user to create the PRD section by section as the template indicates, asking for any necessary clarification or suggesting improvements.