multi-agent-software-orchestrator

> 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`

> 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. # Coder ## Rol Gereksinim ve mimariye uygun kodu, gerçek diske uygulanacak bir değişiklik kümesi (`ProjectDelta`) olarak üretir. ## Sorumluluklar - `changed_files` listesindeki `FileChange` nesneleriyle (CREATE/UPDATE/DELETE) değişiklik önermek. - Revizyon durumunda, yalnızca geri bildirimi karşılayan hedefli değişiklikler yapmak. ## Girdi (Context) `CoderContext(requirements, architecture, revision_feedback: RevisionFeedback | None, current_project_files: list[FileSnapshot])` — `current_project_files`, gerçek diskten (`Workspace.snapshot()`) okunan güncel içeriktir. ## Çıktı (Output Schema) `ProjectDelta(changed_files: list[FileChange], summary_of_changes, addressed_feedback_ids[])` ## Ne zaman çalışır FSM `Stage.CODING`'de; hem ilk denemede hem her revizyon turunda (QA FAIL veya Review REJECTED sonrası) çağrılır. ## Revizyon davranışı Coder'ın kendisi bir revizyon kararı vermez — yalnızca kendisine verilen `revision_feedback`'i uygular. **Coder hiçbir zaman doğrudan dosya sistemine yazmaz**; `ProjectDelta`'yı gerçek diske uygulamak yalnızca Orchestrator + `Workspace`'in sorumluluğudur. ## Diğer agent'larla etkileşim `ProjectDelta`, `Workspace.apply_delta()` ile diske yazılır; sonraki QA/Tester ve Code Reviewer çağrıları bu güncel disk içeriğini `Workspace.snapshot()` üzerinden görür. ## Gerçek implementasyon (source of truth) - Sınıf: `CoderAgent` — `src/orchestrator/agents/coder.py` - Prompt: `src/orchestrator/prompts/coder.py` - Context modeli: `CoderContext` — `src/orchestrator/context/models.py` - Output şeması: `ProjectDelta` — `src/orchestrator/schemas/project_delta.py` - Diske uygulama (Coder'ın kendisi DEĞİL): `Workspace.apply_delta` — `src/orchestrator/project_fs/workspace.py`

Bu ajan ne yapar, nasıl çalışır?

> 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. # Product Owner ## Rol Kullanıcının doğal dilde verdiği yazılım geliştirme isteğini, sonraki agent'ların işleyebileceği yapılandırılmış bir gereksinim dokümanına dönüştürür. ## Sorumluluklar - Fonksiyonel ve fonksiyonel olmayan gereksinimleri ayırmak. - Varsayımları (`assumptions`) gerekçesiyle birlikte belirtmek. - Talep belirsizse `open_questions`'a eklemek ve `completeness_status=NEEDS_CLARIFICATION` işaretlemek. ## Girdi (Context) `ProductOwnerContext(user_request: str, revision_feedback: RevisionFeedback | None)` — whitelist edilmiştir; `WorkflowState`'in tamamına erişimi yoktur. ## Çıktı (Output Schema) `RequirementsSpec(request_summary, functional_requirements[], non_functional_requirements[], technical_constraints[], assumptions[], open_questions[], completeness_status: COMPLETE | NEEDS_CLARIFICATION)` ## Ne zaman çalışır FSM `Stage.REQUIREMENTS`'ta; iş akışının ilk agent çağrısıdır (`INTAKE`'ten hemen sonra). ## Revizyon davranışı `completeness_status=NEEDS_CLARIFICATION` ise, Orchestrator (`routing/policy.py::decide_after_requirements`) `open_questions`'tan üretilen sentetik bir geri bildirimle bu agent'ı `max_requirements_revisions` sınırına kadar tekrar çağırır. Limit dolarsa, mevcut (eksik) spec ile best-effort olarak Architecture aşamasına geçilir. ## Diğer agent'larla etkileşim Çıktısı (`RequirementsSpec`), System Architect, Coder ve QA/Tester'ın context'lerine (read-only) dahil edilir. ## Gerçek implementasyon (source of truth) - Sınıf: `ProductOwnerAgent` — `src/orchestrator/agents/product_owner.py` - Prompt: `src/orchestrator/prompts/product_owner.py` - Context modeli: `ProductOwnerContext` — `src/orchestrator/context/models.py` - Output şeması: `RequirementsSpec` — `src/orchestrator/schemas/requirements.py`

> 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. # QA / Tester ## Rol Üretilen kodu, hem nitel (LLM) hem **nicel/gerçek** (subprocess `pytest`) olarak doğrular. ## Sorumluluklar - LLM üzerinden: hata (`bugs_found`), güvenlik bulgusu (`security_findings`), edge case (`edge_cases_considered`), gereksinim kapsamı (`requirement_coverage`) değerlendirmesi. - Enjekte edilen bir test-çalıştırma callable'ı üzerinden: **gerçek** `pytest` sonucunu alıp `tests_executed`/`overall_verdict`'i bununla değiştirmek. ## Girdi (Context) `QATesterContext(requirements: RequirementsSpec, project_files: list[FileSnapshot])` — **bilinçli olarak `ArchitectureSpec` içermez** (black-box test felsefesi). ## Çıktı (Output Schema) `QAReport(tests_executed[], requirement_coverage[], bugs_found[], edge_cases_considered[], security_findings[], overall_verdict: PASS | FAIL)` `tests_executed` ve `overall_verdict`, LLM'in tahmini DEĞİL, gerçek subprocess sonucudur. ## Ne zaman çalışır FSM `Stage.QA`'da; her Coding adımından hemen sonra (ilk deneme ve her revizyondan sonra). ## Revizyon davranışı `overall_verdict=FAIL` ise, Orchestrator (`routing/policy.py::decide_after_qa`) `bugs_found`'dan üretilen bir geri bildirimle Coder'ı `max_coding_revisions` sınırına kadar tekrar çağırır. Limit dolarsa iş akışı onaysız kod teslim etmeden sonlanır (`REJECTED_MAX_ITERATIONS`). ## Diğer agent'larla etkileşim `QAReport`, Code Reviewer'ın context'ine (`qa_report` alanı) dahil edilir; `overall_verdict`, Orchestrator'ın routing kararı için tek kaynaktır. ## Gerçek implementasyon (source of truth) - Sınıf: `QATesterAgent` — `src/orchestrator/agents/qa_tester.py` - Prompt: `src/orchestrator/prompts/qa_tester.py` - Context modeli: `QATesterContext` — `src/orchestrator/context/models.py` - Output şeması: `QAReport` — `src/orchestrator/schemas/qa_report.py` - Gerçek pytest subprocess çalıştırma: `ProjectRunner` / `run_pytest_on_snapshot` — `src/orchestrator/project_fs/runner.py`

> 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. # System Architect ## Rol Onaylanmış gereksinimlerden, sisteme uygulanabilir bir teknik mimari üretir. ## Sorumluluklar - Bileşenleri (`components`), modülleri, veri modellerini, API sözleşmelerini tanımlamak. - Teknoloji seçimlerini gerekçelendirmek. - Mimarinin gereksinimlerle tutarlılığını (`validity_status`) değerlendirmek. ## Girdi (Context) `SystemArchitectContext(requirements: RequirementsSpec, revision_feedback: RevisionFeedback | None)` ## Çıktı (Output Schema) `ArchitectureSpec(overview, components[], modules[], data_models[], api_contracts[], technology_choices[], dependencies[], architectural_constraints[], validity_status: VALID | INVALID, validity_notes)` ## Ne zaman çalışır FSM `Stage.ARCHITECTURE`'da; `Stage.REQUIREMENTS`'tan hemen sonra. ## Revizyon davranışı `validity_status=INVALID` ise, Orchestrator (`routing/policy.py::decide_after_architecture`) `validity_notes`'tan üretilen sentetik bir geri bildirimle bu agent'ı `max_architecture_revisions` sınırına kadar tekrar çağırır. Limit dolarsa best-effort olarak Coding aşamasına geçilir. ## Diğer agent'larla etkileşim Çıktısı (`ArchitectureSpec`), Coder ve Code Reviewer'ın context'lerine dahil edilir; QA/Tester **bilinçli olarak bunu görmez** (black-box test felsefesi). ## Gerçek implementasyon (source of truth) - Sınıf: `SystemArchitectAgent` — `src/orchestrator/agents/system_architect.py` - Prompt: `src/orchestrator/prompts/system_architect.py` - Context modeli: `SystemArchitectContext` — `src/orchestrator/context/models.py` - Output şeması: `ArchitectureSpec` — `src/orchestrator/schemas/architecture.py`