security: move hardcoded passwords to .env, fix file permissions
- Move ROA_API_PASSWORD and ORACLE_PASSWORD to .env - Update process_bon.py to use python-dotenv - chmod 600 on .env and credentials/* - Install python-dotenv dependency
This commit is contained in:
@@ -1,203 +1,108 @@
|
||||
# Claude Code Task System: Multi-Agent Orchestration
|
||||
# Claude Code Task System: ANTI-HYPE Agentic Coding
|
||||
|
||||
**Video:** [Claude Code Task System: ANTI-HYPE Agentic Coding (Advanced)](https://youtu.be/4_2j5wgt_ds)
|
||||
**Autor:** (Tactical Agentic Coding)
|
||||
**Durată:** ~30 min
|
||||
**Tags:** @work @tech @coding
|
||||
**Sursă:** https://youtu.be/4_2j5wgt_ds
|
||||
**Data:** 2026-02-03
|
||||
**Tags:** @work, #claude-code, #agents, #orchestration
|
||||
|
||||
---
|
||||
|
||||
## TL;DR
|
||||
|
||||
Sistemul de task-uri din Claude Code permite orchestrarea echipelor de agenți care lucrează în paralel, cu dependențe între task-uri și validare automată. Anti-hype: nu e despre tool-uri fancy, ci despre înțelegerea fundamentelor (context, model, prompt, tools) și construirea de sisteme reproductibile.
|
||||
Sistemul de task-uri din Claude Code permite crearea de **echipe de agenți** care lucrează coordonat. Nu e vorba de mai mulți agenți = mai bine, ci de **agenți organizați** care comunică pentru un scop comun. Include hooks pentru self-validation și templating pentru prompts reutilizabile.
|
||||
|
||||
---
|
||||
|
||||
## Concepte cheie
|
||||
|
||||
### Task System = Orchestrare Multi-Agent
|
||||
### 1. Task System Components
|
||||
- **Self-validation** - agenții își verifică propria muncă cu scripturi dedicate
|
||||
- **Agent orchestration** - coordonare între mai mulți agenți
|
||||
- **Templating** - prompts reutilizabile și standardizate
|
||||
|
||||
**Diferența față de generația anterioară:**
|
||||
- **Vechi:** To-do list simplu, sub-agenți ad-hoc fără comunicare
|
||||
- **Nou:** Task-uri cu dependențe, blocări, și comunicare între agenți
|
||||
### 2. Tipuri de agenți
|
||||
- **Builder Agent** - construiește/implementează cod
|
||||
- **Validator Agent** - verifică dacă implementarea e corectă
|
||||
- Lucrează în tandem: builder creează, validator confirmă
|
||||
|
||||
**Tools disponibile:**
|
||||
| Tool | Scop |
|
||||
|------|------|
|
||||
| `task_create` | Creează task nou |
|
||||
| `task_get` | Citește detalii task |
|
||||
| `task_list` | Listează toate task-urile |
|
||||
| `task_update` | Actualizează/comunică status |
|
||||
|
||||
**Key insight:** Sub-agenții și agentul principal comunică prin `task_update` - aceasta e "magic"-ul.
|
||||
|
||||
### Arhitectura: Builder + Validator
|
||||
|
||||
**Minimum viable team:**
|
||||
1. **Builder Agent** - construiește, face task-ul
|
||||
2. **Validator Agent** - verifică că builder-ul a făcut corect
|
||||
|
||||
**De ce 2 agenți:**
|
||||
- 2x compute = 2x încredere în rezultat
|
||||
- Fiecare agent are context window focusat pe UN lucru
|
||||
- Builder se auto-validează + Validator verifică overall
|
||||
|
||||
**Self-validation în Builder:**
|
||||
### 3. Self-Validation Hooks
|
||||
```yaml
|
||||
hooks:
|
||||
post_tool_use:
|
||||
- on: write, edit
|
||||
- if: file ends .py
|
||||
- run: ruff, mypy # linters
|
||||
stop:
|
||||
- validate_new_file: "path/to/expected/file.md"
|
||||
- validate_file_contains: "specific content"
|
||||
```
|
||||
- Pe hook-ul `stop`, agentul verifică că:
|
||||
- A creat fișierul așteptat
|
||||
- Fișierul conține conținutul specificat
|
||||
- **Rezultat:** Certitudine că task-ul s-a completat corect
|
||||
|
||||
### Template Meta-Prompt
|
||||
|
||||
**Definiție:** Un prompt care generează alt prompt într-un format specific și validat.
|
||||
|
||||
**Componente (3):**
|
||||
1. **Self-validation** - hooks care verifică că output-ul e corect
|
||||
2. **Agent orchestration** - instrucțiuni pentru construirea echipei
|
||||
3. **Templating** - format specific pentru plan/output
|
||||
|
||||
**Exemplu workflow:**
|
||||
1. User → Meta-prompt "plan with team"
|
||||
2. Meta-prompt → Generează plan cu echipă
|
||||
3. Stop hook → Validează că fișierul există și conține secțiunile cerute
|
||||
4. Kick off → Agenții încep lucrul în paralel
|
||||
5. Agenții finalizează → Ping înapoi la orchestrator
|
||||
6. Orchestrator → Raportează rezultat
|
||||
|
||||
### Flux Multi-Agent
|
||||
|
||||
```
|
||||
┌─────────────────────────────────────────┐
|
||||
│ ORCHESTRATOR AGENT │
|
||||
│ (primary, face planning) │
|
||||
└─────────────────┬───────────────────────┘
|
||||
│ task_create (multiple)
|
||||
▼
|
||||
┌─────────────────────────────────────────┐
|
||||
│ TASK LIST │
|
||||
│ [1] Build hook A (parallel) │
|
||||
│ [2] Build hook B (parallel) │
|
||||
│ [3] Build hook C (parallel) │
|
||||
│ [4] Validate A (depends: 1) │
|
||||
│ [5] Validate B (depends: 2) │
|
||||
│ [6] Update README (depends: 4,5,6) │
|
||||
└─────────────────┬───────────────────────┘
|
||||
│ sub-agents work
|
||||
▼
|
||||
┌────────┐ ┌────────┐ ┌────────┐
|
||||
│Builder1│ │Builder2│ │Builder3│
|
||||
└───┬────┘ └───┬────┘ └───┬────┘
|
||||
│ │ │
|
||||
└────┬─────┴─────┬────┘
|
||||
│ task_update (done!)
|
||||
▼
|
||||
┌─────────────────────────────────────────┐
|
||||
│ Orchestrator primește events și │
|
||||
│ deblochează următoarele task-uri │
|
||||
└─────────────────────────────────────────┘
|
||||
```
|
||||
### 4. Team Task List
|
||||
- Fiecare task are un **owner** (agent specific)
|
||||
- Task-urile au **dependency blockers** - ordinea de execuție
|
||||
- Task-urile fără dependențe rulează în **paralel**
|
||||
|
||||
---
|
||||
|
||||
## Anti-Hype: Fundamentele
|
||||
## Workflow practic
|
||||
|
||||
**Core 4 al Agentic Coding:**
|
||||
1. **Context** - ce știe agentul
|
||||
2. **Model** - ce LLM folosești
|
||||
3. **Prompt** - cum îi spui ce să facă
|
||||
4. **Tools** - ce poate face
|
||||
|
||||
**Greșeala comună:** Oamenii folosesc Moltbot/Clawdbot fără să înțeleagă ce se întâmplă sub capotă.
|
||||
|
||||
**Soluția:** Învață primitivele, apoi folosește tool-uri avansate.
|
||||
|
||||
> "Don't work on the application anymore. Work on the agents that build the application for you."
|
||||
|
||||
### Evoluția Agentic Engineering
|
||||
### Plan with Team (Meta-prompt)
|
||||
1. Creează un plan structurat cu echipă
|
||||
2. Fiecare task e asignat unui agent specific
|
||||
3. Definește dependențele între task-uri
|
||||
4. Agenții rulează în paralel unde e posibil
|
||||
|
||||
### Execuție
|
||||
```
|
||||
1. Base Agent (un singur agent)
|
||||
↓
|
||||
2. Context & Prompt Engineering (mai bun)
|
||||
↓
|
||||
3. Multi-Agent (mai mulți agenți)
|
||||
↓
|
||||
4. Specialized Agents (customizați)
|
||||
↓
|
||||
5. Orchestrator Agent (conduce echipa)
|
||||
/plan → generează task list cu owners
|
||||
/bu → kick off building
|
||||
```
|
||||
- Sub-agenții raportează progresul (text-to-speech în video)
|
||||
- Fiecare sub-agent summarizează munca la final (stop hook)
|
||||
|
||||
---
|
||||
|
||||
## Aplicare practică
|
||||
## 💡 Aplicare pentru setup-ul meu
|
||||
|
||||
### Când să folosești Task System?
|
||||
**Relevant pentru Marius și proiectele ROA:**
|
||||
|
||||
**DA:**
|
||||
- Task-uri complexe care pot fi paralelizate
|
||||
- Când ai nevoie de validare la fiecare pas
|
||||
- Proiecte cu multe fișiere/componente
|
||||
- Update-uri documentație + cod simultan
|
||||
1. **Pentru task-uri complexe** - pot folosi sessions_spawn cu task-uri specifice
|
||||
2. **Self-validation** - ideea de hooks care verifică output-ul e aplicabilă:
|
||||
- Script care verifică dacă fișierul s-a creat
|
||||
- Script care validează conținutul
|
||||
3. **Orchestrare** - când am task-uri mari, le pot descompune în sub-task-uri cu dependențe
|
||||
|
||||
**NU neapărat:**
|
||||
- Task-uri simple, one-shot
|
||||
- Când nu ai nevoie de validare
|
||||
- Când overhead-ul de orchestrare > beneficiu
|
||||
|
||||
### Cum să construiești echipa
|
||||
|
||||
1. **Identifică task-urile** care pot rula în paralel
|
||||
2. **Definește dependențe** (ce depinde de ce)
|
||||
3. **Creează 2 tipuri de agenți:** builder + validator
|
||||
4. **Adaugă self-validation** în builder (linters, type checkers)
|
||||
5. **Template-uiește** într-un meta-prompt reutilizabil
|
||||
|
||||
### Exemplu: Update codebase vechi
|
||||
|
||||
**Task list generat:**
|
||||
1. Build session_end hook (parallel)
|
||||
2. Build permission_request hook (parallel)
|
||||
3. Build setup hook (parallel)
|
||||
4. Validate session_end (depends: 1)
|
||||
5. Validate permission_request (depends: 2)
|
||||
6. Validate setup (depends: 3)
|
||||
7. Update README (depends: 4,5,6)
|
||||
|
||||
**Rezultat:** 2 minute, toate fișierele actualizate, logs generate, documentație completă.
|
||||
**Exemplu concret:**
|
||||
- Task: "Actualizează documentația proiectului X"
|
||||
- Sub-tasks:
|
||||
1. Citește codul actual (builder)
|
||||
2. Generează documentație (builder)
|
||||
3. Verifică completitudinea (validator)
|
||||
4. Verifică acuratețea (validator)
|
||||
|
||||
---
|
||||
|
||||
## Conexiuni cu munca noastră
|
||||
## Diferența față de Clawdbot/Moltbot
|
||||
|
||||
1. **Clawdbot folosește Claude Code** - putem aplica aceste tehnici
|
||||
2. **Vending Master:** Ar putea beneficia de multi-agent pentru UI + backend + docs
|
||||
3. **Overnight coding:** În loc de un agent, orchestrează echipă
|
||||
4. **Validare automată:** Adaugă self-validation în task-urile de coding
|
||||
> "I'm not talking about the very powerful but very dangerous maltbot or previously cloudbot."
|
||||
|
||||
- Claude Code Task System = tool pentru ingineri, control fin
|
||||
- Clawdbot/Moltbot = autonomie mai mare, risc mai mare
|
||||
- Task system = mai organizat, mai predictibil
|
||||
|
||||
---
|
||||
|
||||
## Citate cheie
|
||||
|
||||
> "More agents, more autonomy, and more compute doesn't always mean better outcomes. What we want is more ORGANIZED agents that can COMMUNICATE together."
|
||||
> "More agents, more autonomy, and more compute doesn't always mean better outcomes. What we want is more organized agents that can communicate together to work toward a common goal."
|
||||
|
||||
> "The more agents you have with focused context windows doing one specific thing, the better."
|
||||
|
||||
> "There's going to be a big gap between engineers that turn their brain off and engineers that keep learning."
|
||||
> "Not only is our agent planning out work, building a team, it's also setting up the tasks and the order that the tasks need to operate in."
|
||||
|
||||
---
|
||||
|
||||
## Resurse menționate
|
||||
|
||||
- Claude Code Hooks Mastery (repo)
|
||||
- Tactical Agentic Coding (curs)
|
||||
- Agentic Horizon (curs avansat)
|
||||
- Ralph Wickham technique
|
||||
- Repo: `cloud-code-hooks-mastery` (GitHub)
|
||||
- Documentație hooks: https://docs.anthropic.com/claude-code
|
||||
|
||||
---
|
||||
|
||||
*Procesat: 2026-02-03*
|
||||
*Sursă: https://youtu.be/4_2j5wgt_ds*
|
||||
*Notă procesată de Echo pentru knowledge base*
|
||||
|
||||
Reference in New Issue
Block a user