Projekt Living Docs
Nutze NOC Living Docs als ausführbares Projektgedächtnis. Leite die Arbeit über noc_docs/, lies nur die betroffenen Dokumente, aktualisiere die Living Docs bei Änderungen von Code oder Absicht und überprüfe abschließend mit der CLI.
Trigger
Verwende diesen Skill für:
- Initialisieren oder Migrieren von
noc_docs/ - Besprechen einer Anforderung und anschließendes Ändern von Code
- neue Funktionen, Fehlerbehebungen, Refactorings, API-/Daten-/Sicherheits-/Bereitstellungsänderungen
- Prüfen, ob Codeänderungen Dokumentationsupdates benötigen
- Abfragen oder Überprüfen der Projekt-Living-Docs
Nicht verwenden für allgemeine Fragen, die kein Projektgedächtnis, Codeverhalten, Anforderungen, Leitplanken, Tests oder die NOC-Dokumentation betreffen.
Ausführung
- Identifiziere das betroffene Feature/Domain aus der Anfrage, den geänderten Pfaden und
noc_docs/.living-docs/feature-map.json. - Führe einen Arbeitsplan aus, wenn Code sich ändern könnte:
python scripts/noc.py work /path/to/project --feature <feature> --intent "<vereinbarte Anforderung>"
Verwende --path <code/path> wenn Pfade eindeutiger als Feature-Namen sind.
- Lies die kleinsten relevanten Docs:
agent-guide.md,requirements.md,status.md,guardrails.md,test-record.mdplus Domain-Leitplanken, falls vorhanden. - Schreibe bestätigte neue/geänderte Absicht in
requirements.md; unsichere Diskussionen innotes.md. - Ändere Code.
- Aktualisiere
status.md,test-record.md,change-record.mdundguardrails.md, wenn sich Verhalten, Verifikation, wichtige Änderungen oder Constraints geändert haben. - Führe
python scripts/noc.py index <project>nach Docs-, Feature- oder Mapping-Änderungen aus. - Führe
python scripts/noc.py check <project> --staged --warn-onlyvor dem Commit aus, wenn Git verfügbar ist.
Ausführliche Workflow-Regeln findest du in references/workflow.md.
Nicht fortfahren
Halte an und frage den Benutzer, bevor du Code bearbeitest, wenn:
- die Anfrage mit
guardrails.mdoder Domain-Leitplanken kollidiert - die Produktabsicht mit
requirements.mdkonfligiert und die gewünschte Richtung unklar ist - das betroffene Feature/Domain nicht identifiziert werden kann und die Änderung nicht offensichtlich global ist
- erforderliche Dokumente fehlen und die Aufgabe von unbekannten Anforderungen oder Constraints abhängt
- der Benutzer verlangt, Anforderungen stillschweigend an den aktuellen Code anzupassen
- die Änderung Sicherheit, Berechtigungen, Abrechnung, Datenverlust, Migrationen oder öffentliche API-Verträge betrifft und das gewünschte Verhalten mehrdeutig ist
Definition of Done
Eine Aufgabe mit diesem Skill ist nur dann erledigt, wenn:
- betroffene Docs über Feature-Map, Pfade oder expliziten Feature-Namen identifiziert wurden
- erforderliche Docs gelesen oder fehlende Docs benannt wurden
- Code- und Dokumentänderungen übereinstimmen
requirements.mdnur für beabsichtigte Verhaltensänderungen aktualisiert wurdestatus.mddas aktuelle Verhalten nach Codeänderungen widerspiegelttest-record.mddie Verifikation festhält oder erklärt, warum keine Verifikation durchgeführt wurdechange-record.mdwichtige Implementierungsänderungen dokumentiert- Indizierungen/Prüfungen durchgeführt oder mit Begründung übersprungen wurden
Abschließendes Antwortformat
Beende mit:
NOC Living Docs:
- docs gelesen:
- docs aktualisiert:
- docs absichtlich unverändert:
- ausgeführte Befehle:
- ausgeführte Tests:
- verbleibende Risiken:
Halte die Listen kurz. Verwende keine, wenn eine Kategorie nicht zutrifft.
Referenzen
references/workflow.md: Modusauswahl, Fallback-Regeln, Konflikthandhabung, Arbeitszyklusreferences/feature-doc-template.md: Inhalt eines Feature-Dokumentsreferences/domain-mode-guide.md: Wann und wie der Domain-Modus verwendet wirdreferences/codex-prompts.md: Empfohlene Benutzer-Prompts für Codex-Plan-/Ziel-/Code-Workflows