Mut README.md în directorul principal pentru vizibilitate în Gitea
- Mutat .claude/README.md → README.md - README va fi acum afișat automat în interfața Gitea 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
205
README.md
Normal file
205
README.md
Normal file
@@ -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.
|
||||
Reference in New Issue
Block a user