Plně autonomní

AI-Powered
Development Pipeline

Od YouTrack issue k nasazené aplikaci na staging. Bez lidského zásahu. Orchestrátor + 5 specializovaných AI agentů.

YouTrack Claude Code GitHub Docker Nginx Proxy Manager Playwright OpenRouter

// Architektura

Systémový přehled

🔗

Webhook Trigger

YouTrack webhook spustí pipeline. Skript detekuje novou Open issue a přiřadí ji AI agentovi (Claude / Gemini).

📋

YouTrack Integration

Plná integrace s API — čtení issues, komentářů, změna stavů. Komentáře slouží jako instrukce, novější mají přednost.

🤖

AI Orchestrátor

Hlavní Claude session řídí celý workflow. Deleguje práci na 5 specializovaných agentů — nikdy neimplementuje přímo.

🐙

GitHub CI/CD

Automatický clone, branch podle issue ID, commit, push a vytvoření Pull Requestu — vše bez lidského zásahu.

🐳

Docker Deployment

Každá issue běží ve vlastním Docker Compose projektu s izolovaným prostředím a pojmenováním podle issue ID.

🌐

Nginx Proxy Manager

Automatická konfigurace reverse proxy přes API. Wildcard SSL certifikát na *.staging.nknop.cz.

// Workflow

13 kroků pipeline

01

Research direct

Načtení issue z YouTrack API — popis, požadavky, všechny komentáře. Detekce potřeby grafických assetů.

02

Změna stavu direct

Issue → In Progress. První viditelná akce v YouTrack.

03

Setup direct

Vytvoření pracovního adresáře /opt/staging/<ISSUE-ID>/

04

Clone & Branch direct

Git clone repozitáře, vytvoření feature větve pojmenované podle issue. Respektuje zdrojovou větev z YouTrack.

05

🎨 Grafika Agent podmíněný

Pokud issue vyžaduje grafické assety — generování obrázků přes OpenRouter API. Max 1 retry při selhání.

06

🔧 Coder Agent agent

Implementace kódu, testy, ověření buildu. Přijímá grafické assety z kroku 5 pokud existují.

07

📋 Reviewer Agent agent

Code review — kvalita, bezpečnost, konvence. APPROVED / CHANGES_REQUESTED. Max 2 iterace s Coderem.

08

🧪 Tester Agent agent

Unit testy, build verification, Docker build, smoke test. PASS / FAIL. Max 2 iterace s Coderem.

09

Pull Request direct

Vytvoření PR na GitHubu s popisem provedených změn.

10

Deployment direct

docker compose -p <issue-id> up -d — spuštění služby v izolovaném kontejneru.

11

Proxy konfigurace direct

NPM API → proxy host <prefix>.staging.nknop.cz směřující na Docker kontejner.

12

👁 Visual Tester Agent agent

Playwright screenshoty běžícího UI → vizuální verifikace oproti zadání. Max 1 iterace s Coderem.

13

Finalizace direct

Issue → To Verify. Komentář se shrnutím, PR URL a staging URL.

// Specializace

5 AI agentů

🎨

Grafika Agent

Generuje grafické assety (loga, ikony, bannery) přes OpenRouter API. Podmíněné spuštění — jen když issue vyžaduje vizuální prvky.

SUCCESS | PARTIAL | BLOCKED max 1 retry

🔧

Coder Agent

Jádro pipeline. Implementuje kód, píše testy, ověřuje build. Přijímá feedback z Reviewera, Testera i Visual Testera pro opravy.

SUCCESS | PARTIAL | BLOCKED

📋

Reviewer Agent

Code review zaměřený na kvalitu kódu, bezpečnost a dodržování konvencí. Kontroluje git diff a vrací verdikt.

APPROVED | CHANGES_REQUESTED max 2 iterace

🧪

Tester Agent

Spouští unit testy, ověřuje build, buildí Docker image a provádí smoke testy na výsledném kontejneru.

PASS | FAIL max 2 iterace

👁

Visual Tester Agent

Pořizuje screenshoty nasazeného UI přes Playwright a vizuálně ověřuje, že implementace odpovídá zadání issue.

PASS | FAIL max 1 iterace

🚫 Klíčové pravidlo

Orchestrátor NIKDY neimplementuje kód, nedělá review ani netestuje přímo — ani pro "triviální" změny. Vždy deleguje na příslušného agenta. Přímá implementace orchestrátorem je porušení workflow.

// Flow diagram

Orchestrace a feedback smyčky

        ▸ Orchestrátor (hlavní Claude session)
      
├── Kroky 1-4: Research, stav, setup, clone
├── Krok 5: → grafika (generování obrázků) [PODMÍNĚNÝ]
├── Krok 6: → coder (implementace)
├── Krok 7: → reviewer (code review)
│      └── CHANGES_REQUESTED → coder → reviewer (max 2×)
├── Krok 8: → tester (unit + smoke testy)
│      └── FAIL → coder → tester (max 2×)
├── Kroky 9-11: PR, deploy, proxy
├── Krok 12: → visual-tester (Playwright screenshoty)
│      └── FAIL → coder → redeploy → visual-tester (max 1×)
└── Krok 13: Finalizace → To Verify

⟳ Review loop

Coder ↔ Reviewer
Max 2 iterace

⟳ Test loop

Coder ↔ Tester
Max 2 iterace

⟳ Visual loop

Coder ↔ Visual Tester
Max 1 iterace

// Infrastruktura

Deployment & konvence

🌐 Staging doména

Vzor <prefix>.staging.nknop.cz

SSL *.staging.nknop.cz (wildcard)

LIN-33 → lin.staging.nknop.cz ✓

LIN-33 → lin-33.staging.nknop.cz ✗

          // Wildcard cert pokrývá jen jednu úroveň

          // lin-33 = dvě úrovně → SSL error

          prefix = issueId.split("-")[0].toLowerCase()

🐳 Docker

Projekt prefix -p <issue-id-lowercase>

Pracovní dir /opt/staging/<ISSUE-ID>/

Forward host 172.17.0.1 (bridge)

NPM API localhost:81

          # Spuštění projektu

          docker compose -p lin-33 up -d

          # Proxy: UPDATE existující, nikdy DELETE

          PUT /api/nginx/proxy-hosts/<id>

// Životní cyklus

Stavy YouTrack issue

Open

→

In Progress

→

To Verify

→

Done

Alternativní cesta při blockeru: