Initial Commit

config/company.yaml

@@ -0,0 +1,169 @@
+# Paperclip Company-Konfiguration für BMAD Phase 4 Automation
+# ===========================================================
+# REFERENZ-Dokument, keine direkt einspielbare Config.
+# Paperclip legt Companies/Agents über UI oder API an.
+# Konkrete API-Payloads: config/agents.jsonc
+# Schritt-für-Schritt-Setup: docs/RUNBOOK.md
+
+company:
+  name: "BMAD Phase 4 Executor"
+  mission: >
+    Automatisierte Ausführung der BMAD-V6-Implementation-Phase mit
+    getrennten Dev- und QA-Rollen. Phasen 1–3 sowie Sprint Planning
+    sind manuell durchgeführt. Diese Company führt ausschließlich den
+    Create → Dev → Review Loop pro Story mit max. 3 Retries bei
+    Review-Fails und Retrospectives pro abgeschlossenem Epic aus.
+
+  # Pfad auf das BMAD-Projekt-Verzeichnis, in dem OpenCode arbeitet.
+  project_root: "/srv/projects/<dein-projektname>"
+
+  # Wohin Eskalationen gehen. Optional – wenn leer, nur Dashboard.
+  operator:
+    name: "<dein Name>"
+    notification_webhook: "<optional>"
+
+# Agents – Details siehe config/agents.jsonc
+# -------------------------------------------
+agents:
+
+  - id: pm-supervisor
+    role: "Supervisor"
+    adapter: opencode_local
+    session_behavior: resume-or-new
+    skills: [monitor-bmad-progress]
+    budget_monthly_usd: 20
+    heartbeat: event-only      # wake-on-assignment, kein Timer
+    governance:
+      can_create_child_issues: true
+      can_complete_own_work: false
+      can_escalate: true
+
+  - id: dev-worker
+    role: "Developer"
+    adapter: opencode_local
+    session_behavior: new      # fresh chat pro BMAD-Skill (BMAD-Doku-Anforderung)
+    skills: [execute-bmad-dev-tasks]
+    model: "<starkes Code-Modell>"
+    budget_monthly_usd: 300
+    per_task_usd_max: 10
+    heartbeat: event-only
+    reports_to: pm-supervisor
+    assigned_task_types: [create-story, dev-story]
+    governance:
+      can_modify_files: true
+      can_git_commit: true
+      can_git_push: false
+      can_create_child_issues: false
+
+  - id: qa-engineer
+    role: "QA"
+    adapter: opencode_local
+    session_behavior: new      # fresh session = unabhängiges Review
+    skills: [execute-bmad-qa-tasks]
+    model: "<anderes Modell als dev-worker>"
+    budget_monthly_usd: 150
+    per_task_usd_max: 5
+    heartbeat: event-only
+    reports_to: pm-supervisor
+    assigned_task_types: [code-review, retrospective]
+    governance:
+      can_modify_files: false    # QA schreibt keinen Code
+      can_git_commit: false
+      can_git_push: false
+      can_create_child_issues: false
+
+  # Hinweis: Der Supervisor oben nutzt `heartbeat: event-plus-timer`
+  # mit Intervall 900s (15 Min) – siehe agents.jsonc. Das ist
+  # beabsichtigte Abweichung vom Event-only-Muster der Worker:
+  # Der Supervisor patrouilliert proaktiv und räumt Blocker auf.
+
+# Concurrency- und Sequenzierungs-Policies
+# -----------------------------------------
+# Diese Policies werden vom Supervisor-Skill ERZWUNGEN (nicht nur
+# empfohlen). Das Skill prüft sie vor jedem Ready-Setzen eines Tasks.
+policies:
+
+  single_epic_sequence:
+    id: A
+    enabled: true
+    description: >
+      Höchstens ein Epic ist zu einem Zeitpunkt "aktiv". Das nächste
+      Epic startet erst, wenn die Retrospektive des vorigen Epics
+      completed ist. Kein Task aus einem späteren Epic wird ready
+      gesetzt, solange ein früheres Epic nicht abgeschlossen ist.
+
+  single_task_per_agent:
+    id: B
+    enabled: true
+    description: >
+      Jeder Agent bearbeitet zur selben Zeit genau einen Task.
+      Supervisor setzt einen neuen Task für einen Agent erst dann auf
+      ready, wenn dieser Agent keinen anderen Task ready oder
+      in-progress hat. Paperclips atomisches Task-Checkout verstärkt
+      das auf Infrastruktur-Ebene.
+
+  strict_story_order:
+    id: C
+    enabled: true
+    description: >
+      Innerhalb eines Epics werden Stories strikt in Reihenfolge
+      abgearbeitet: Story 1.1 bis zum approved, dann Story 1.2,
+      dann Story 1.3 und so weiter. Story N.(M+1) rührt sich nicht,
+      solange Story N.M nicht approved ist. Keine Vor-Arbeit, keine
+      Parallelität über Story-Grenzen hinweg.
+
+  idempotent_task_creation:
+    id: invariant-zero
+    enabled: true
+    description: >
+      Jede Task-Anlage läuft durch Duplikats-Prüfung. Kompositschlüssel
+      ist (type, epic_id, story_id, retry_count). Kein Task mit
+      identischem Schlüssel wird je zweimal angelegt. Gilt für
+      Bootstrap, Retry-Logik und Patrol-autonome Aktionen gleichermaßen.
+
+# Patrol-Policy
+# -------------
+patrol:
+  enabled: true
+  interval_seconds: 900           # 15 Min (siehe agents.jsonc)
+  meta_stall_threshold_minutes: 60  # ab hier Eskalation statt Weiter-Patrol
+  autonomous_resolutions:
+    - stuck_in_progress_task       # Agent-Hang, Task reset-to-ready
+    - orphan_ready_task             # kein Agent assigned, re-assign
+    - lost_ready_propagation        # Vorgänger completed, Folge blocked
+    - duplicate_task                # jüngere Duplikate cancellen
+    - idle_workflow                 # kein aktiver Task trotz offenem Goal
+    - dirty_worktree                # WIP-Commit, kein Code-Verlust
+  mandatory_escalations:            # Operator muss ran, keine autonome Aktion
+    - retry_limit_reached           # inhaltliche Entscheidung
+    - missing_agent                 # Agent dereferenziert oder gelöscht
+    - meta_stall                    # >1h kein Fortschritt trotz Patrol
+
+# Skill-Config – werden als persistent_facts an Agents übergeben
+# --------------------------------------------------------------
+skill_config:
+  monitor-bmad-progress:
+    max_review_retries: 3
+    timeout_retry_limit: 3
+    consecutive_crash_limit: 2
+    stall_detection_minutes: 30
+    patrol_interval_seconds: 900
+
+# Governance-Eskalationen (harte Stops, kein Approval-Gate)
+# ---------------------------------------------------------
+hard_escalations:
+  - retry_limit_reached
+  - sprint_status_missing
+  - sprint_status_inconsistent
+  - no_epic_source_found
+  - planning_incomplete
+  - dirty_worktree
+  - consecutive_crash_limit_reached
+  - concurrent_task              # Concurrency-Verletzung – STOPP
+  - duplicate_task_detected      # Idempotenz-Verletzung erkannt durch Worker
+  - partial_bootstrap_detected   # unvollständige Task-Hierarchie
+  - budget_exhausted
+
+audit_trail:
+  enabled: true
+  retention_days: 90