Ein Projekt für Agenten vorbereiten

Dieser Leitfaden erklärt die Vorbereitung eines Unternehmensprojekts für spezifikationsgetriebene Arbeit mit Coding-Agenten. Sie erfolgt in Zyklus 1, Phase 2, parallel zur UX-Ausrichtung und Erstellung erster Funktionsspezifikationen. Product Engineer, Architekt und relevante Plattform- oder Sicherheitsverantwortliche arbeiten je nach Thema und Risiko zusammen.

Ziel ist ein technisch solider, auffindbarer Ausgangspunkt ohne schwergewichtige verpflichtende Freigabezeremonie vorab. Bestehende Unternehmensfreigaben gelten weiterhin, wenn eine gewählte Abhängigkeit, Integration, Sicherheitsfähigkeit oder Architekturausnahme sie erfordert.

Verantwortliche Rollen: Product Engineer und Architekt / Senior Engineer; bei Bedarf Plattform- und Sicherheitsverantwortliche. Der Architekt führt Architekturentscheidungen; der Product Engineer verantwortet fortlaufende Produktarbeit und Agentenkoordination.

Eingaben: Produktziele, vorläufige Funktionsspezifikationen, technische und Sicherheitsstandards, freigegebene wiederverwendbare Bausteine, relevante Designsystem-Vorgaben und bekannte geschäftliche/technische Abhängigkeiten.

Ergebnisse: Ein Projekt mit ausreichender technischer Anfangsstruktur und Anweisungen, freigegebenen technischen Entscheidungen, zugänglichen Spezifikationen und einer durch geeignete Berechtigungen beschränkten Coding-Agenten-Ausführungsumgebung.

1. Anfängliche Produktgrenze bestätigen. Prüfen Sie Ziele, zentrale Abläufe, vorläufige Akzeptanzbedingungen, bekannte Einschränkungen und wichtige offene Entscheidungen. Erkennen Sie technische Fragen mit wesentlichem Einfluss auf die Implementierung. Klären Sie offene Geschäftsrichtlinien mit den zuständigen Verantwortlichen; machen Sie aus technischen Vermutungen keine Geschäftsentscheidungen.

2. Freigegebene Unternehmensfähigkeiten auswählen. Bestimmen Sie passende freigegebene Anwendungsstacks, Startprojekte, gemeinsame Dienste, vorhandene Komponenten und Bibliotheken. Nutzen Sie geeignete Unternehmensbausteine statt redundanter Implementierungen. Neue Abhängigkeiten oder Architekturabweichungen folgen dem etablierten Ausnahmeprozess.

3. Ausreichend Architektur für die nächste Iteration schaffen. Definieren Sie relevante Systemgrenzen, Daten- und Integrationsverantwortlichkeiten, Komponententrennung und Repository-Konventionen. Dokumentieren Sie die Entscheidungen, die der Coding-Agent zur konsistenten Implementierung des Anfangsumfangs braucht. Vermeiden Sie vollständige Vorabentwürfe von Details, die sich sicher während der Implementierung verfeinern lassen.

4. Auffindbare Anweisungen und Kontext vorbereiten. Halten Sie das zentrale AGENTS.md minimal und lassen Sie es auf alle Markdown-Dokumente unter agent_instructions/ verweisen. Jede Datei dort erklärt ihren Zweck in der ersten Zeile. Stellen Sie sicher, dass Anweisungen stimmig, aktuell, widerspruchsfrei und mit freigegebenen Standards vereinbar sind. Dateinamen und Anzahl der Anweisungsdokumente bleiben Projektentscheidungen.

5. Produktverhalten in Spezifikationen halten. Pflegen Sie vereinbartes Funktionsverhalten im gesonderten Bereich specs/. Dauerhafte Anweisungen bestimmen Arbeitsweise und beständige Einschränkungen; Spezifikationen beschreiben das verlangte Produktverhalten. Duplizieren Sie keine Funktionsanforderungen in permanenten Coding-Regeln und führen Sie kein zusätzliches Pflichtartefakt mit SHAPE-spezifischem Namen ein.

6. Agentengrenzen technisch durchsetzen. Lassen Sie Zugriffe auf Repositories, Systeme, Geheimnisse, Werkzeuge und Netzwerke durch autorisierte Verantwortliche konfigurieren. Schriftliche Anweisungen leiten Verhalten, erzwingen jedoch keine Berechtigungen. Zugriff muss dem angemessenen Mindestbedarf der Aufgabe entsprechen.

7. Implementierung beginnen und verantwortungsvoll verfeinern. Bestätigen Sie, dass der Coding-Agent Anweisungen und relevante Spezifikationen findet, freigegebene Bausteine nutzt und innerhalb der autorisierten Umgebung arbeitet. Der Product Engineer beginnt, sobald wesentliche Voraussetzungen erfüllt sind. Beziehen Sie den Architekten bei folgenreichen Fragen, Ausnahmen oder Risiken ein. Technische Vorbereitung kann mit neuen Erkenntnissen wachsen, ohne ein zusätzliches dauerhaftes Freigabetor zu werden.

Der Anfangsumfang ist für einen Implementierungsschritt ausreichend verstanden; relevante Architekturentscheidungen folgen freigegebenen Unternehmensstandards; Funktionsspezifikationen sind zugänglich; dauerhafte Agentenanweisungen sind auffindbar und intern stimmig; notwendige technische Kontrollen sind durchgesetzt. Der Product Engineer kann produktive Implementierung anleiten und weiß, welche offenen Entscheidungen eskaliert werden müssen.

SHAPE verlangt weder ein zusätzliches Architecture-Readiness-Review-Zertifikat noch eine feste sechsteilige Prüfung, ein langes Architekturdokument, eine Pflichtliste von Anweisungsdateinamen oder eine Übergabezeremonie.

Einen Agenten geschäftliche oder architektonische Ausnahmen erfinden lassen; Textanweisungen anstelle technischer Zugriffskontrollen verwenden; Spezifikationen in dauerhaften Coding-Regeln duplizieren; vollständigen Vorabentwurf verlangen; unnötige Bibliotheken einführen; und jeden Implementierungsschritt zu einer Architektenfreigabe machen.