Project Doc Gen

Phase 1: Agent-Doc parsen und Inventar erstellen

Phase 1: Agent-Doc parsen und Inventar erstellen

1. Agent-Doc lesen (vollständig, ein Read-Call)
2. Frontmatter extrahieren: prozess, rolle, klasse
3. Agent-Vision (Blockquote > "...") extrahieren
4. Zyklen-Seed-Tabelle parsen: Pro Zyklus Fähigkeit + Quellen-Referenzen
5. Pro Aktivität inventarisieren:
   • Alle Regeln R1-RN mit konkretem Wert und Typ
   • Alle Ausnahmen A1-AN mit Bedingung und Aktion
   • Alle Schritte mit System-Bezug
   • Systeme (Primär, Sekundär, Zugriffspunkte)

Phase 2: Skill-Topologie ableiten

Phase 2: Skill-Topologie ableiten

Lade references/zyklen-regeln.md → Abschnitt "1. Skill-Identifikations-Algorithmus".

1. Aus Agent-Vision die gewünschten Outputs identifizieren
2. Aus Aktivitäts-Schritten die Output-produzierenden Schritte finden
3. Gruppieren: Schritte die denselben Output-Typ produzieren = 1 Skill
4. Benennung: {domain}-{output-typ} in kebab-case, Umlaute durch ASCII ersetzen (ae/oe/ue/ss)
5. Skill-Übersichtstabelle erstellen (Zyklus → Skill → Aktion: Erstellen/Aktualisieren)

Phase 3: Regeln den Zyklen zuordnen

Phase 3: Regeln den Zyklen zuordnen

Lade references/zyklen-regeln.md → Abschnitt "2. Regel-Zyklen-Zuordnungs-Algorithmus".

1. Explizit: Zyklen-Seed-Quellen ordnen Regeln direkt zu
2. Implizit: Nicht-referenzierte Regeln nach Typ zuordnen (Schwellwert → Z2, Entscheidungsregel → Z3, etc.)
3. Ausnahmen: Folgen der Regel die sie modifizieren
4. Vollständigkeits-Check: Jede R- und A-ID muss genau einem Zyklus zugeordnet sein

Phase 4: 6 Zyklen generieren

Phase 4: 6 Zyklen generieren

Lade references/projekt-doc-template.md → Zyklus-Block-Struktur.

Pro Zyklus (1-6) die Sektionen generieren:

4.1 Projekt-Sektion:

• Projektbeschreibung: 1-2 Sätze, dritte Person, Claude-Kachel-Stil
• Projektanweisung: Kumulativ wachsender Code-Block (Tabelle aus zyklen-regeln.md Abschnitt 3)

4.2 Skills-Sektion:

• 3 Felder: Name, Beschreibung (Anthropic 2-Satz-Konvention), Anweisungen
• Anweisungen = deterministisches Output-Template mit [Platzhaltern], exakten Tabellenformaten, Sortierung
• Bei Aktualisierung: Vollständiger neuer Text, kein Diff
• Skill-Definitionen MÜSSEN so formuliert sein, dass sie 1:1 als Input für skill-creator dienen können

4.3 Ablauf:

• Nummerierte Schritte, abgeleitet aus Aktivitäts-Schritten
• Dateinamen-Konvention mit Datum

4.4 Probiere zu fragen...

• 4 konkrete Starter-Prompts in Aktionsform ("Zeig mir...", "Welche...", "Klassifiziere...")

4.5 Template:

• Beispiel-Output als Blockquote mit fiktiven aber realistischen Daten
• Verwendet die konkreten Regeln/Schwellwerte aus dem Agent-Doc
• Pro Zyklus beispiel-format Feld angeben (.xlsx für Tabellen-Skills, .docx für Text-Skills)

Write-Strategie (2 Writes):

• Write 1: Frontmatter + Ergebnis-Spezifikation + Skill-Übersicht + Zyklen 1-3
• Write 2: Zyklen 4-6 + Regeln + Erkenntnisse (Append via Read+Write)
• Output-Pfad: {rolle-slug}/{prozess-slug}/projekt-doc.md

Phase 4.5: Agent-CLAUDE.md generieren

Phase 4.5: Agent-CLAUDE.md generieren

1. Aus dem gerade generierten Projekt-Doc extrahieren:
   • Kumulative Projektanweisung aus Zyklus 1 (Startversion)
   • Skill-Übersichtstabelle
   • Benötigte Stammdaten ("Einmalig im Projekt hinterlegt")
2. Agent-CLAUDE.md schreiben nach {rolle-slug}/{prozess-slug}/CLAUDE.md:

# {Prozess-Name}

{Projektbeschreibung aus Zyklus 1}

## Projektanweisung

{Projektanweisungs-Code-Block aus Zyklus 1}

## Dateien in diesem Projekt

- `agent-doc.md` — Vollständiges Aktivitäts-Profil mit Regeln, Schwellwerten und Ausnahmen. Als Knowledge-Datei hochladen.
- `projekt-doc.md` — 6-Zyklen-Roadmap mit Skills und Output-Templates. Anleitung zum Projektaufbau.

## Skills

{Skill-Übersichtstabelle}

## Stammdaten

{Liste der benötigten Dateien, falls vorhanden, sonst Sektion weglassen}

## Hinweis

Dieses Projekt wächst in 6 Zyklen.
Sage in Cowork `setze Zyklus 1 um` um den ersten Zyklus einzurichten.
Bei jedem Zykluswechsel: `setze Zyklus X um` für den nächsten Zyklus.

3. Write-and-Forget

Phase 5: Validierung

Phase 5: Validierung

4 Quality Gates:

Bei BLOCKER: Sofort korrigieren bevor Handoff.

Phase 5.5: Status-Update (PFLICHT)

Phase 5.5: Status-Update (PFLICHT)

1. _status.yaml → status: agent-doc → projekt-doc
2. inventar.yaml → Prozess-Status auf projekt-doc aktualisiert
3. _changelog.yaml Append (ERSTELLEN falls nicht vorhanden):

   - datum: "{YYYY-MM-DD}"
     aktion: "projekt-doc"
     details: "Projekt-Doc mit 6-Zyklen-Fahrplan erstellt, {N} Skills identifiziert"
     artefakte:
       - "projekt-doc.md"
       - "CLAUDE.md"
   

Phase 6: Handoff (Intent+Constraints)

Phase 6: Handoff (Intent+Constraints)

• intent: User zum Start der Zyklen-Umsetzung einladen
• begründung: Das Projekt-Doc definiert den Fahrplan — jetzt wird der erste Zyklus operativ umgesetzt (Skills installieren, Beispiel-Dokumente erstellen)
• trigger_phrase: setze Zyklus 1 um für {prozess-slug}
• ton: Motivierend, Meilenstein betonen
• frischer_chat: Ja

Formulierung:

Projekt-Doc + CLAUDE.md erstellt:

Projekt-Doc als Markdown

{N} Skills identifiziert: {skill-namen} 6 Zyklen: Sichtbarkeit → Klassifikation → Empfehlung → Dokumentation → Automation → Proaktiv

Der Fahrplan steht. Im nächsten Schritt richten wir den ersten Zyklus ein — mit konkreten Skills und Beispiel-Dokumenten für Claude Desktop.

Starte einen frischen Chat und sage setze Zyklus 1 um für {prozess-slug}.

Zyklen-Umsetzung in Cowork: Wenn der User "setze Zyklus X um" sagt, MUSS der Workflow jeden Skill via Skill(skill='skill-creator') erstellen — nicht als Artifact schreiben. Claude erstellt, User klickt "Zu deinen Skills kopieren". Bei Aktualisierung (späterer Zyklus erweitert einen Skill): Skill via skill-creator NEU erstellen, User bestätigt "Hochladen und ersetzen".

Beispiel-Dokument-Generierung: Zusätzlich zu den Skills wird pro Skill ein Beispiel-Dokument aus dem Template-Block materialisiert (.xlsx oder .docx). Algorithmus: references/zyklen-regeln.md Abschnitt 7. Speicherort: {rolle-slug}/{prozess-slug}/beispiele/{skill-name}-beispiel.{ext}

Chat-Projekt-Handoff: Nach Bestätigung und Beispiel-Generierung folgt die Anleitung zum Einrichten des Claude Chat-Projekts. Die Agent-CLAUDE.md wird als Code-Block im Chat gezeigt, weil Claude Chat sie — anders als Cowork — nicht automatisch lädt. Der User muss die Projektanweisung manuell einfügen. Details und Zyklusbedingung (Ersteinrichtung vs. Aktualisierung): projektanweisung.md Schritt 7.

Regeln

1. Kreative Synthese: Aus Agent-Doc-Fakten neue Inhalte generieren (Skills, Output-Templates, Projektanweisungen) — NICHT 1:1 kopieren
2. Regel-Vollständigkeit: Jede R- und A-ID aus dem Agent-Doc MUSS in genau einem Zyklus auftauchen
3. Deterministische Skill-Anweisungen: Platzhalter in [], exakte Tabellenformate, benannte Sortierung
4. Kumulative Zyklen: Zyklus N enthält alles aus 1 bis N-1 plus Neues
5. Copy-Paste-Ready: Alle Skill-Felder direkt in Claude Desktop übernehmbar
6. Sprache: Deutsch — alle Inhalte auf Deutsch
7. Write-and-Forget: 2 Write-Calls pro Projekt-Doc, keine großen Artifacts im Chat
8. Kein Meta-Text: Keine Ergebnis-Blöcke, keine Zeitersparnis-Metriken, keine rhetorischen Fragen
9. Abschluss-Sektionen: "Regeln für dieses Dokument" + "Erkenntnisse" IMMER aus Template übernehmen