Export

# multi-agent-software-orchestrator

Autonomous multi-agent software development orchestrator with requirements analysis, architecture design, code generation, real pytest QA, revision loops and code review.

## Orchestration instructions (chief)

> Bu dosya yalnızca MySkillOS / Claude Code Skill Visualizer görselleştirmesi
> içindir. Gerçek çalışma zamanı davranışı, Anthropic Python SDK'sını
> doğrudan çağıran ayrı bir Python sınıfına aittir; bu dosyanın içeriği
> orchestrator'ın gerçek davranışını değiştirmez veya temsil etmez.

# Code Reviewer

## Rol
Üretilen kodu mimari uyumluluk, kod kalitesi, sürdürülebilirlik ve güvenlik
açısından inceler; nihai teslim kararını (APPROVED/REJECTED) verir.

## Sorumluluklar
- `architecture_conformance` (CONFORMS/DEVIATES) değerlendirmesi.
- QA bulgularını (`qa_findings_considered`) dikkate almak.
- `decision=REJECTED` ise zorunlu bir `rejection_feedback` (`target_agent=CODER`)
  üretmek.

## Girdi (Context)
`CodeReviewerContext(requirements, architecture, generated_code: list[FileSnapshot], qa_report: QAReport | None)`

## Çıktı (Output Schema)
`CodeReviewReport(architecture_conformance: CONFORMS | DEVIATES, code_quality_notes[], maintainability_notes[], security_notes[], qa_findings_considered[], decision: APPROVED | REJECTED, rejection_feedback: RevisionFeedback | None)`

## Ne zaman çalışır
FSM `Stage.REVIEW`'da; yalnızca QA `overall_verdict=PASS` verdikten sonra
(gerçek testleri geçmemiş kod hiçbir zaman Review'a ulaşmaz).

## Revizyon davranışı
`decision=REJECTED` ise, Orchestrator
(`routing/policy.py::decide_after_review`) `rejection_feedback`'i kullanıp
`max_coding_revisions` sınırına kadar (QA ile paylaşılan sayaç) Coder'ı
tekrar çağırır. `decision=APPROVED` ise iş akışı **`COMPLETED`** olarak
sonlanır — bu, iş akışının tek "başarı" çıkış noktasıdır.

## Diğer agent'larla etkileşim
Kararı doğrudan iş akışının sonlanma biçimini belirler: `APPROVED` →
iş akışı tamamlanır; `REJECTED` (limit dahilinde) → Coder'a yeni bir
revizyon turu.

## Gerçek implementasyon (source of truth)
- Sınıf: `CodeReviewerAgent` — `src/orchestrator/agents/code_reviewer.py`
- Prompt: `src/orchestrator/prompts/code_reviewer.py`
- Context modeli: `CodeReviewerContext` — `src/orchestrator/context/models.py`
- Output şeması: `CodeReviewReport` — `src/orchestrator/schemas/code_review.py`

## Roles
- **coder** (Sub-agent): RequirementsSpec ve ArchitectureSpec doğrultusunda projenin kaynak kodunu, testlerini, yapılandırma dosyalarını ve gerekli dokümantasyonunu üretir. İlk aşamada bir FileManifest oluşturarak gerekli dos
- **code-reviewer** (Sub-agent): QA aşamasını başarıyla geçen projeyi RequirementsSpec ve ArchitectureSpec doğrultusunda inceler. Kodun gereksinimleri karşılamasını, belirlenen mimariye uyumunu, modülerliğini, sürdürülebilirliğini ve
- **product-owner** (Sub-agent): Kullanıcının doğal dilde verdiği yazılım geliştirme isteğini analiz ederek amaç, kapsam, fonksiyonel gereksinimler, kısıtlar ve kabul kriterlerini belirler. Bu bilgileri sistemin sonraki aşamalarında 
- **qa-tester** (Sub-agent): Coder tarafından üretilen proje dosyalarını ve RequirementsSpec gereksinimlerini değerlendirir. Kod üzerinde LLM tabanlı nitel analiz yaparken aynı zamanda gerçek bir pytest alt sürecini çalıştırarak 
- **system-architect** (Sub-agent): Product Owner tarafından oluşturulan RequirementsSpec çıktısını analiz ederek yazılımın teknik mimarisini tasarlar. Sistemin bileşenlerini, modüllerini, veri modellerini, API sözleşmelerini, bağımlılı

## Workflow
- **Chief:** orchestrator — splits tasks and delegates.
- **Sub-agent:** coder, code-reviewer, product-owner, qa-tester, system-architect — specialists under the chief.

## Coordination / communication
- coder → orchestrator: result returns to the chief
- code-reviewer → orchestrator: result returns to the chief
- product-owner → orchestrator: result returns to the chief
- qa-tester → orchestrator: result returns to the chief
- system-architect → orchestrator: result returns to the chief