Das Tutorial
4Notice, von null in den App Store: eine echte App, gebaut mit Plänen, Tickets, atomaren Commits, Skills, fastlane und App-Store-Connect-Automatisierung.
Agent Fundamentals
Ein Terminal-Agent, ein Kanban-Board und einfache Dateien im Repository — der vollständige Workflow hinter einem echten Softwareprojekt, vom Plan bis in den App Store.
Der Workflow im Überblick
Abschnitt betitelt „Der Workflow im Überblick“Das Projekt trägt sein Betriebshandbuch im Repository: Ein
.agent/-Ordner hält Plan, Board, Skills und Tools als einfaches
Markdown und JSON. Der Agent liest und schreibt diese Dateien vom
Terminal aus; die Apps rendern dieselben Dateien für den Owner. Ein
Zustand, keine Synchronisation, alles im Diff reviewbar.
| Baustein | Rolle |
|---|---|
| Agent | Ein Terminal-Agent (z. B. Claude Code) implementiert Tickets, schreibt Tools und committet — gebunden an den Workflow-Vertrag .agent/AGENT.md. |
| Plans | Absicht als Markdown in .agent/plans/; genau ein Plan ist aktiv. Der Agent schneidet ihn in Tickets auf dem Board (.agent/board/: Backlog → Doing → Done, append-only-History je Ticket). |
| Skills | Wiederverwendbare Prozeduren in .agent/skills/ — Auslöse-Beschreibung plus Schritte im Checklisten-Stil mit Verify:-Zeilen. |
| Tools | Kleine Programme in .agent/tools/ unter JSON-Vertrag (TOOL.md): schema-typisierter Input und Output, Beispiele als maschinell geprüfte Abnahmetests. |
| MCPs | Model-Context-Protocol-Server, deklariert in .mcp.json — Fähigkeiten in laufenden Prozessen, etwa der allowlisted Exec-Server für Projekt-Kommandos. |
Zwei Anwendungen orchestrieren diesen Zustand:
- iKanban AI (macOS) — das Cockpit des Owners: Board, Pläne, Skills und Toolbar-Aktionen über den Exec-Server; Frageprotokoll und Ticket-History inklusive.
- Speccify (plattformübergreifend) — Quellen- und
Lifecycle-Verwaltung für Skills und Tools:
Expand → Execute → Evaluate, Herkunft in
expansions.yaml— plus eigene Plans/Skills/Tools-Verwaltung, damit der Workflow auch auf Windows weiterläuft, wo iKanban AI nicht läuft.
Beide arbeiten auf demselben Repository. Fällt eine weg, bleiben die Dateien gültig und das Projekt arbeitsfähig.
Einstiege
Abschnitt betitelt „Einstiege“Grundlagen
Skills, Tools und Tool-Specs, MCPs — die Bausteine im Detail.
Speccify
Expand, Execute, Evaluate: von einer Quelle aus Skills und Tools zu geprüften Implementierungen.
iKanban AI
Das dateibasierte Kanban-Board: Pläne, Tickets, History und das Frageprotokoll zwischen Owner und Agent.
Praktiziert, nicht theoretisiert
Jedes Beispiel dieser Site stammt aus einem echten Projekt, das diesen Workflow täglich fährt — diese Site eingeschlossen.