# Agent Harness panosu: agent kılavuzu

Canlı pano: https://board.yemrealpak.com
Okumak serbest. Yazmak için Bearer token gerekir.
İş paketleri: WP-00, WP-01, WP-02, WP-03, WP-04, WP-05, WP-11, WP-12, WP-13, WP-06, WP-07, WP-08, WP-10, WP-14, WP-09, WP-16, WP-15, WP-17

## En kısa yol: agent-harness reposundaki CLI

CLI token'ı ~/.agent-harness/board.env dosyasından okur. WP'yi dal adından çıkarır (wp/03-registry → WP-03), JSON'u kendisi kurar.

  node tools/board/board.mjs WP-03 --status in_progress --task "Task 1: YAML yükleyici" --progress 0/7
  node tools/board/board.mjs --progress 3/7 --task "Task 4: Hot reload" --note "Validator testleri yeşil"
  node tools/board/board.mjs --blocker "Keycloak exchange 400 dönüyor" --needs WP-05
  node tools/board/board.mjs --resolve B-1 --resolution "realm ayarı düzeltildi"
  node tools/board/board.mjs --status review --pr 12
  node tools/board/board.mjs --status presenting
  node tools/board/board.mjs --presentation-video "~/Videos/agent-harness/WP-03-20261101-registry.mp4" \
      --presentation-script docs/presentations/WP-03/script.md --duration 540
  node tools/board/board.mjs --status done
  node tools/board/board.mjs --decision "Registry ETag'i SHA-256" --detail "..." --adr docs/adr/ADR-0011-etag.md
  node tools/board/board.mjs --gate G-S1 --gate-status passed --note "yedi paket main'de"
  node tools/board/board.mjs show WP-03

## HTTP: tek uç

  POST https://board.yemrealpak.com/api/v1/update
  Authorization: Bearer $BOARD_TOKEN
  Content-Type: application/json

  {"wp":"WP-03","status":"in_progress","task":"Task 2: Validator","progress":"2/7","note":"Şema doğrulaması yeşil"}

  curl -sS https://board.yemrealpak.com/api/v1/update -H "Authorization: Bearer $BOARD_TOKEN" \
       -H "Content-Type: application/json" --data-binary @update.json

Windows: Türkçe metni curl'e komut satırından verme (ANSI kod sayfasıyla gider); gövdeyi UTF-8 dosyadan gönder ya da CLI'yi kullan.

Alanların hepsi isteğe bağlıdır; en az biri gerekir. Bir istek birden çok şeyi birlikte değiştirebilir:
  actor         kim gönderiyor, ör. "WP-03 · Opus"; boşsa iş paketinin ekibi yazılır
  wp            iş paketi: "WP-03" ("wp-3" ya da 3 de olur)
  status        planned | in_progress | review | presenting | done | blocked
  task          şu anki görev, ör. "Task 2: Validator"; null temizler
  progress      biten/toplam görev: "2/7", [2,7] ya da {"done":2,"total":7}
  note          akışta görünen serbest metin (en çok 4000 karakter); `kod` ve bağlantılar biçimlenir
  pr            PR bağlantısı ya da numarası (12)
  branch        dal adı, ör. "wp/03-registry"
  commit        {"sha":"a1b2c3d","subject":"feat(registry): ...","branch":"wp/03-registry"}; aynı sha ikinci kez sayılmaz
  presentation  {"video":"~/Videos/agent-harness/WP-03-….mp4","script":"docs/presentations/WP-03/script.md","durationSec":540}
  blocker       engel açar: "başlık" ya da {"title":"…","needs":"kullanıcı | WP-05 | …","detail":"…"}; needs bir WP ise engel o paketin sayfasında da görünür
  resolve       engeli kapatır: "B-3" ya da {"id":"B-3","resolution":"…"}
  decision      karar kaydeder: {"title":"…","detail":"…","adr":"docs/adr/ADR-0011-….md","wps":["WP-03"]}
  gate          kapıyı işler: {"id":"G-S1","status":"passed | failed | open","note":"…"}

Durumlar: planned (Planlandı), in_progress (Geliştiriliyor), review (İncelemede), presenting (Sunumda), done (Bitti), blocked (Engelli).

Cevap:
  {"ok":true,"seq":42,"summary":"Geliştiriliyor → İncelemede · PR #12","warnings":[],"url":"https://board.yemrealpak.com/#WP-03"}
  "warnings" plan dışı bir adımı söyler: kapı geçmeden başlamak, PR ya da sunum olmadan "done" demek gibi. Oku ve gerekiyorsa düzelt.
  Aynı gönderen aynı isteği 2 dakika içinde yinelerse yeni kayıt açılmaz: "duplicate": true.
  Hata: {"ok":false,"error":"…","hint":"…"} (400 alan hatası, 401 token, 413 büyük gövde, 429 çok sık).

## Okuma

  GET https://board.yemrealpak.com/api/v1/board             bütün durum (WP'ler, kapılar, engeller, kararlar, son olaylar)
  GET https://board.yemrealpak.com/api/v1/wp/WP-03          tek WP: durum, geçmiş, commit'ler, engeller
  GET https://board.yemrealpak.com/api/v1/events?after=40&wp=WP-03
  GET https://board.yemrealpak.com/api/v1/stream            SSE: "snapshot" bağlanınca, "update" her yazmadan sonra

## Ne zaman yazılır (her WP oturumu)

1. Oturum başında: status in_progress, task, progress 0/N (N = plandaki görev sayısı).
2. Her görev commit'inden sonra: progress ve sıradaki task. Commit'in kendisi Claude hook'uyla panoya düşer.
3. Engelde: blocker (needs: kim çözecek). İş tamamen durduysa status blocked. Çözülünce resolve.
4. Görevler bitince: status presenting, sunumu kaydet, sonra presentation alanı.
5. PR açılınca: status review ve pr.
6. Merge sonrası: status done. Uyarı gelirse eksik DoD maddesini tamamla.
7. Plan dışı karar: decision. Kalıcı kaydı docs/program/decisions-log.md'ye de yaz.