Moves the agent workflow system from agent-system/ to .agents/ (dotfile convention). Restructured from 5-role to 7-role pipeline: adds Analyst and splits Reviewer into Code Reviewer + Security Reviewer. Removes all old workflow run artifacts. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2.1 KiB
2.1 KiB
name, description
| name | description |
|---|---|
| starterkit-planner | Planungs-Skill fuer Architektur-, Rollout-, Refactor- und Standardisierungsaufgaben im Starterkit. Verwenden, wenn ein decision-complete Plan mit klaren Interfaces, Tests, Risiken und Annahmen benoetigt wird. |
Starterkit Planner
Ziel
Planungen so strukturieren, dass Implementierung ohne offene Entscheidungen moeglich ist. Bei Agent-Workflows muss der Plan maschinenlesbar in die Projekt-Contracts passen.
Verbindliches Ausgabeformat
- Ziel + Success Criteria
- In/Out-of-Scope
- Entscheidungsmatrix (Optionen + Gruende)
- Decision-complete Implementierungsplan
- Tests/Abnahme
- Risiken/Migrationshinweise
- Annahmen/Defaults
Wenn .agents/ verwendet wird:
- Plan muss dem Schema
.agents/contracts/planner.schema.jsonentsprechen. - Success Criteria muessen stabile IDs tragen (
SC-001,SC-002, ...). - Success Criteria muessen so formuliert sein, dass Reviewer Acceptance sie direkt gegen
criterion_idpruefen kann. - Guard- und Quality-Gate-IDs muessen aus den Katalogen kommen (
GR-*,QG-*).
Vorgehen
- Ist-Zustand kurz aus Repo-Fakten ableiten.
- Entscheidungen mit Tradeoffs transparent machen.
- Oeffentliche Contracts explizit benennen.
- Success Criteria frueh mit stabilen IDs (
SC-*) definieren. - Reihenfolge und Rollout so planen, dass Rueckbau moeglich bleibt.
- Teststrategie nach Risiko priorisieren.
Qualitaetskriterien
- Keine vagen TODO-Entscheidungen im Plan.
- Jeder betroffene Bereich hat klare Akzeptanzkriterien mit stabiler ID (
SC-*). - Risiken sind priorisiert und beobachtbar.
- Ungeklaerte Themen stehen explizit unter Annahmen.
- Guard-/Gate-Referenzen sind vollstaendig und pruefbar (
GR-*,QG-*).
Out of Scope
- Extension-Mechanik ist aktuell nicht standardisiert.
- Keine impliziten Extension-Regeln definieren.
Referenzen
- Plan-Grundgeruest:
references/plan-template.md - Entscheidungsraster:
references/tradeoff-matrix.md - Agent Planner Contract:
.agents/contracts/planner.schema.json - Guard Catalog:
.agents/checks/guard-catalog.json - Quality Gates:
.agents/checks/quality-gates.json