762ac21681
- New: tools/yt_download.py with cookies support + rate limit tracking - New: docs/YOUTUBE-SETUP.md complete documentation - Updated: night-execute jobs to use new script - Updated: TOOLS.md with YouTube section - Added: 5 new YouTube notes (OpenClaw, cost optimization, task system, leads) - Added: credentials/ to .gitignore
181 lines
4.7 KiB
Markdown
181 lines
4.7 KiB
Markdown
# Turn Claude Code into Your Full Engineering Team with Subagents
|
|
|
|
**Sursă:** [YouTube](https://www.youtube.com/watch?v=-GyX21BL1Nw)
|
|
**Data:** 2026-02-02
|
|
**Tags:** @work @growth
|
|
|
|
## TL;DR
|
|
|
|
Video despre "agent harnesses" - cum să transformi un coding agent într-un inginer complet prin:
|
|
- Persistence și progress tracking între sesiuni
|
|
- Integrare cu Linear (tasks), GitHub (commits/PRs), Slack (updates)
|
|
- Sub-agenți pentru context isolation
|
|
- Claude Agents SDK + Arcade MCP pentru autentificare
|
|
|
|
**Ideea cheie:** Context window = cea mai prețioasă resursă. Harness-ul permite sesiuni multiple cu state management.
|
|
|
|
---
|
|
|
|
## Ce e un Agent Harness?
|
|
|
|
Un **wrapper** peste coding agent care oferă:
|
|
- **Persistence** - stare între sesiuni
|
|
- **Progress tracking** - ce s-a făcut, ce mai e de făcut
|
|
- **Git workflow** - commits automate per feature
|
|
- **Task management** - Linear/Jira integration
|
|
- **Communication** - Slack updates
|
|
|
|
**De ce:** Agenții de coding cad când context window se umple. Harness-ul permite sesiuni fresh cu handoff de state.
|
|
|
|
---
|
|
|
|
## Arhitectura
|
|
|
|
### Flux Inițializare
|
|
```
|
|
AppSpec (PRD) → Initializer Agent → Linear Agent (tasks) → GitHub Agent (repo)
|
|
```
|
|
|
|
### Flux Coding Loop
|
|
```
|
|
1. Read Linear project (ce task urmează?)
|
|
2. Linear Agent → pick next task
|
|
3. Regression testing (verifică că nu s-a stricat nimic)
|
|
4. Implementare feature
|
|
5. GitHub Agent → commit + push
|
|
6. Linear Agent → mark done
|
|
7. Slack Agent → update (opțional)
|
|
8. Loop până toate task-urile sunt done
|
|
```
|
|
|
|
### Sub-agenți (context isolation)
|
|
- **Linear Agent** - management tasks/projects
|
|
- **GitHub Agent** - commits, PRs, repo management
|
|
- **Slack Agent** - notificări și updates
|
|
- **Coding Agent** - implementare efectivă
|
|
|
|
Fiecare sub-agent are propriul context, nu bloatează orchestratorul.
|
|
|
|
---
|
|
|
|
## Setup Tehnic
|
|
|
|
### Dependențe
|
|
- **Claude Agents SDK** - wrapper pentru orchestrare
|
|
- **Claude Code** - subscription (cost-effective)
|
|
- **Arcade** - MCP gateway pentru Linear/GitHub/Slack (free tier)
|
|
- **Playwright MCP** - validare browser în background
|
|
|
|
### Configurare
|
|
```
|
|
.env:
|
|
- ARCADE_URL (MCP gateway)
|
|
- ARCADE_API_KEY
|
|
- EMAIL
|
|
- GITHUB_REPO
|
|
- SLACK_CHANNEL
|
|
- MODEL_CODING / MODEL_LINEAR / MODEL_GITHUB (haiku/sonnet/opus)
|
|
```
|
|
|
|
### Structură proiect
|
|
```
|
|
prompts/
|
|
orchestrator.md # system prompt principal
|
|
initializer.md # prima sesiune
|
|
continuation.md # loop-uri următoare
|
|
linear_agent.md # sub-agent Linear
|
|
github_agent.md # sub-agent GitHub
|
|
slack_agent.md # sub-agent Slack
|
|
```
|
|
|
|
---
|
|
|
|
## AppSpec Format
|
|
|
|
PRD-ul trebuie să aibă task list în **JSON format specific** (recomandare Anthropic):
|
|
|
|
```json
|
|
{
|
|
"tasks": [
|
|
{"id": 1, "title": "...", "description": "..."},
|
|
...
|
|
]
|
|
}
|
|
```
|
|
|
|
Dă AppSpec-ul la coding agent și cere-i să-l formateze corect.
|
|
|
|
---
|
|
|
|
## Exemplu: Aplicație complexă
|
|
|
|
- **44 tasks** create automat în Linear
|
|
- **Pull requests** per feature
|
|
- **Commits** per task completat
|
|
- **Slack updates** după sesiunea 1, 2 și la final
|
|
- Aplicație cu agent în spate care generează layout dinamic
|
|
|
|
---
|
|
|
|
## Arcade - MCP Gateway
|
|
|
|
**Ce rezolvă:**
|
|
- Nu trebuie setup individual MCP servers pentru Linear/GitHub/Slack
|
|
- Agent authorization (OAuth flows automate)
|
|
- Sharing cu echipa fără a partaja credențiale
|
|
- Tool discovery (91 tools, nu dump în context)
|
|
|
|
**Setup:**
|
|
1. Cont free tier pe Arcade
|
|
2. Crează MCP gateway
|
|
3. Adaugă tools: GitHub + Linear + Slack
|
|
4. Copiază URL + API key în .env
|
|
|
|
---
|
|
|
|
## Cost Optimization
|
|
|
|
- **Haiku** pentru tasks simple (Linear updates)
|
|
- **Sonnet** pentru coding
|
|
- **Opus** pentru orchestrare complexă
|
|
|
|
Configurabil per sub-agent în .env.
|
|
|
|
---
|
|
|
|
## Extinderi posibile
|
|
|
|
- Watch 24/7 pentru issues noi în Linear → auto pick-up
|
|
- GitHub Issues în loc de Linear
|
|
- Asana/Jira integration
|
|
- Multiple coding agents în paralel
|
|
- Custom harness pentru workflow-ul tău specific
|
|
|
|
---
|
|
|
|
## Viitor: Archon
|
|
|
|
Autorul lucrează la **Archon** - "N8N pentru AI coding":
|
|
- Define și orchestrează propriile workflow-uri
|
|
- Build harnesses custom
|
|
- Visual builder pentru AI coding pipelines
|
|
|
|
---
|
|
|
|
## Citate cheie
|
|
|
|
> "Context window is the most precious resource when engineering with agents."
|
|
|
|
> "The whole point of this agent being able to go for a longer time is that we're stringing together different agent sessions - each one we want to start over so that we have fresh context."
|
|
|
|
> "If you build your own optimized workflow, it's going to be way better than anything that's off the shelf."
|
|
|
|
---
|
|
|
|
## Link-uri
|
|
|
|
- [GitHub Repo](https://github.com/...) - harness complet
|
|
- [Arcade](https://arcade.dev) - MCP gateway
|
|
- [Archon](https://github.com/.../archon) - command center AI coding
|
|
- [Anthropic Harness](https://github.com/anthropics/...) - baza pe care e construit
|