# 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
