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:
Echo
2026-02-03 21:12:13 +00:00
parent db4b57f5a3
commit 9a6446070a
9 changed files with 283 additions and 175 deletions

View File

@@ -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*