Aura Skill
Aura Skill
Der Aura-Dokumentationsskill ist der praktische Einstieg in den Standard. Er hilft dabei, bestehende Repositories nach docs/aura/ zu migrieren, neue Dokumentation anzulegen oder vorhandene Aura-Dokumente gegen die Spezifikation zu prüfen.
Download
Aura Documentation Skill
Die ZIP enthält SKILL.md, die Aura-Spezifikation, Templates, Research-Protokoll und Interview-Protokoll für .cursor/skills/aura-documentation/.
1. Wofür der Skill da ist
Der Skill wird genutzt, wenn ein Repository eine strukturierte Aura-Dokumentation braucht:
- bestehende Doku nach
docs/aura/migrieren - Brownfield-Repositories automatisch vorrecherchieren
- Greenfield-Repositories mit Skeleton und TODOs starten
- einzelne Dokumente wie ADRs, Integrationen oder Product-Entities ergänzen
- vorhandene
docs/aura/gegen die Spezifikation auditieren
Der wichtigste Unterschied zu einer normalen Vorlage: Der Skill startet nicht mit einem langen Interview. Er recherchiert zuerst im Code.
2. Research-First-Prinzip
Der Skill arbeitet in acht Phasen:
1. Discover
2. Mode Selection
3. Research Planning
4. Parallel Research
5. Synthesis
6. Targeted Interview
7. Refinement
8. Final Review
Bei Brownfield-Projekten starten mehrere spezialisierte Recherchen parallel:
| Subagent | Zielbereich |
|---|---|
| Architecture Research | 02-architecture/overview.md, components.md |
| Data Model Research | 02-architecture/data-model.md, data-model/*.md |
| Integrations Research | 03-integrations/* |
| Technical Components Research | 05-technical/* |
| Operations Research | 06-operations/* |
| Development Research | 07-development/* |
04-product/ und 01-overview/glossary.md werden bewusst nicht frei erfunden. Code kann dort Hinweise liefern, aber fachliche Bedeutung muss ein Mensch bestätigen.
3. Output
Der Skill produziert:
docs/aura/
├── README.md
├── 01-overview/
├── 02-architecture/
├── 03-integrations/
├── 04-product/
├── 05-technical/
├── 06-operations/
└── 07-development/
Jede Aussage wird mit Konfidenz markiert, wenn sie nicht offensichtlich bestätigt ist:
<!-- confidence: high — direkt aus Code oder Konfiguration abgeleitet -->
<!-- confidence: inferred — plausibel, aber nicht bestätigt -->
<!-- AURA-TODO: Welche fachliche Bedeutung hat diese Entity? -->
Diese Marker machen die Dokumentation ehrlich: Was aus Code abgeleitet wurde, ist verwendbar. Was nur vermutet ist, wird im Targeted Interview bestätigt oder bleibt als offene Lücke sichtbar.
4. Installation im Repository
Ein Projekt kann den Skill als Cursor Skill ablegen:
.cursor/skills/aura-documentation/
├── SKILL.md
└── references/
├── aura-spec.md
├── templates.md
├── research.md
└── interview.md
Danach kann ein Agent ihn verwenden, wenn ein User etwa sagt:
Migriere dieses Repository nach Aura.
Lege docs/aura an.
Auditier die vorhandene Aura-Doku.
Erstelle einen ADR nach Aura.
5. Warum der Skill zur Website gehört
Die Website beschreibt nicht nur das Zielbild. Sie muss auch den Weg dorthin lieferbar machen. Der Skill ist deshalb Teil des Standards:
- Er macht
docs/aura/reproduzierbar. - Er reduziert Interview-Aufwand durch Repository-Recherche.
- Er verhindert Halluzinationen durch Konfidenzmarker.
- Er trennt technische Wahrheit von fachlicher Bedeutung.
- Er erzeugt die gleiche Struktur, die AURA später ingestieren, prüfen und als KI-Kontext bereitstellen kann.
Weiterlesen
- Repository-Standard — verbindliche
docs/aura/-Struktur - Dokumentation — Dokumenttypen und Regeln
- Vorlagen und Skill — Templates und CLI-Idee
- Einführung — Rollout in Phasen