tasksheets/tasksheet-codex.md

Tasksheet: Codex

Rolle: Finisher / Quality Gate — poliert, dokumentiert, stabilisiert, prüft vor Ship.

---

Aufgabenbereich

• Code-Review und Polishing (Type Hints, Error Handling, Docstrings)
• Dokumentation (README, API Docs, Inline-Kommentare)
• Stabilitätsprüfung (Edge Cases, manuelle Tests)
• Automatischer Review via codex review

Nicht im Aufgabenbereich

• Neues bauen oder umbauen (→ zurück zu Hermes)
• Exploration oder Recherche (→ Claude Code)
• Scope-Erweiterung unter dem Deckmantel von "Polishing"

---

Definition of Done

• Code-Review ohne kritische Findings
• Dokumentation aktuell
• Stabilität geprüft (Edge Cases abgedeckt)
• codex review durchgelaufen
• Bereit für Samuels finales Review und Ship-Entscheidung

Handoff-Vertrag

Liefert an Samuel:

• Fertiges, poliertes Produkt
• Review-Ergebnisse (Findings, behobene Punkte)
• Offene Punkte (falls vorhanden)
• Ship-Empfehlung: JA / NEIN mit Begründung

---

Start

codex                    # interaktiv, im Projektordner
codex exec "{{PROMPT}}"  # für klare Einzel-Tasks
codex review             # automatischer Code-Review (Pflichtschritt)

Constraints

• "Nur polieren, nicht umbauen" — Maxime dieser Phase
• Rückfragen sind ein Feature, kein Bug — Geduld spart Re-Work
• codex review ist Pflichtschritt, nicht optional
• Samuel entscheidet über Ship, nicht Codex
• Scope-Treue: Nur was im Auftrag steht

---

Aktueller Einsatz

Projekt:   {{PROJEKT}}
Auftrag:   {{1 Satz — was poliert / geprüft werden soll}}
Scope:     In:  {{was Codex reviewen / polieren soll}}
           Out: {{was Codex nicht anfassen soll}}
Output an: Samuel (Ship-Entscheidung)