Zum Hauptinhalt springen
VelinStyle v1.4.0
⌂ Home

Agenten-Workflows 1.4.0

So arbeiten KI-Agenten mit VelinStyle Skills 2.0: Registry, Domains, Reuse-first, Contracts, Permissions, Stop Rules, Migrationsintelligenz und Rewrite-Gates. Twin: English · Runtime/CLI: KI-Skills · Migrationsintelligenz.

Ehrlicher Pilot-Stand: SAFE_REWRITE = 0, Catalog-Einträge 0, Manifest-Einträge 0. Apply ist nicht automatisch. Tailwind ist nicht „automatisch sicher“. Öffentliche Produktnamen: Kernfunktionen / Kernarchitektur / Kernsicherheit.

Was sind VelinStyle Skills?

Skills sind registry-gestützte Agenten-Playbooks: Domain, Zweck, Capabilities, erlaubte/verbotene Actions, Permission, Stop-Bedingungen und Risiko. Agenten entdecken Skills über Registry und Workflow-Graphs — sie erfinden keine Parallel-Toolchains.

Für wen?

Verwendung durch KI-Agenten

Ablauf: Intent klären → Reuse-Gate → Domain-Skill(s) → Permission einhalten → bei fehlender Evidenz stoppen. Keine erfundenen APIs, Tokens oder Mapping-Targets.

Skill Registry

Quelle der Wahrheit: packages/velinstyle-skills/registry.json (Version 1.0.0, 58 Skills). Packs, Graphs, Bundles und Templates referenzieren Skill-IDs. Validierung: npm run skills:validate. Siehe KI-Skills.

Domains

Reuse-First

SEARCH → MATCH → COMPATIBILITY → REUSE / ADAPT → BUILD (nur mit belegter Lücke)

Skill Routing

REQUEST → INTENT → REUSE-GATE → DOMAIN → SKILL → ACTION → OUTPUT → REVIEW/GATE → NEXT

Unklarer Scope → Stop (Fail Closed). Beispiel: „Prüfe mein Rewrite-Manifest“ → Preflight, nicht Manifest-Erstellung.

Routing-Beispiele Phase 4.15–5.1 (Fail Closed, sofern nicht anders vermerkt):

Conditional Freeze: Apply bleibt aus; SAFE_REWRITE = 0. Manche Alltags-Multi-Intent-Formulierungen failen weiterhin closed, bis die Phrasierung passt — Security first; Routing-Abdeckung wird weiter verbessert.

Skill Contract

Ein Skill darf nicht „alles“. Plan-only plant; Review-only prüft; Write nur im Scope; Apply braucht Gate + Freigabe.

Capabilities

Capabilities sind Punkt-Notationen. Sie beschreiben die Arbeitsklasse — keine Lizenz zum Target-Erfinden oder Permission-Eskalieren.

Permissions

Default ist sicher. Keine stille Eskalation.

Actions

u. a. PLAN, ANALYZE, VALIDATE, DRY_RUN, ACCEPT, WRITE, PREFLIGHT, APPLY. Privilegierte Actions brauchen passende Permission.

Stop Rules

Stop Rules (SR-…) erzwingen Fail Closed: Target erfinden, Reuse überspringen, Acceptance als Mapping, Hash/Path-Drift, fehlende Freigabe, unklarer Scope u. a. Agenten müssen stoppen — nie still weiterarbeiten.

Agent Orchestration

REQUEST → INTENT → REUSE → BUILD / REVIEW / MIGRATION
→ CLASSIFY → INTELLIGENCE → ACCEPTANCE → FREIGABE
→ CATALOG → MANIFEST → PREFLIGHT → DRY-RUN → APPLY-GATE → APPLY

Jeder Pfeil ist eine Entscheidungsgrenze. Überspringen ohne Evidenz ist verboten.

Acceptance vs Mapping vs Catalog vs Manifest vs Apply

Dry-Run

Dry-Run meldet Mapped / Warning / Unresolved. Das ist kein Write und kein Apply.

Write-Gates

Write braucht Write-Permission, erlaubte Pfade und belegte Mappings bei Migration. Unresolved bleibt unresolved.

Apply-Gates

Apply braucht GATE_READY, ggf. Dry-Run OK, Freigabe, Snapshot, Path/Hash-Integrität. Fehlt etwas → Fail Closed. SAFE_REWRITE bleibt 0.

Fail Closed

Bei Unsicherheit: stoppen. REUSE / BLOCKED-BY-DESIGN / STOP statt Raten.

Tailwind-Migration

CLI + L-Domain: Scan → Plan → Dry-Run → Review/Stop. Bekannte Katalog-Aliases dürfen mappen; Residuals und Strategy-Blocks (THEME, STATE, PALETTE, DIM_PX, TYPO, HALF_STEP) nicht per Namensähnlichkeit. Beispiel: kein Auto-Target für bg-background. Leitfäden: Tailwind migrate, Migrationsgrenzen.

Migrationsintelligenz

M-Domain inventarisiert/klassifiziert Residuals und unterstützt Acceptance — erfindet keine Mappings und führt kein Apply aus. Siehe Migrationsintelligenz.

Rewrite-System

Preflight ≠ Freigabe ≠ Apply. Catalog/Manifest bleiben im Pilot bei 0 Einträgen, bis echte Freigabe-Pfade sie füllen.

Best Practices für KI-Agenten

  1. Zuerst Reuse prüfen.
  2. Keine APIs/Komponenten erfinden.
  3. Keine Tokens erfinden.
  4. Keine Targets erraten.
  5. Keine Migration-Write ohne belegtes Mapping.
  6. Acceptance ist kein Mapping.
  7. Catalog ist kein Manifest.
  8. Dry-Run ist kein Apply.
  9. Bei fehlenden Infos stoppen.
  10. Bestehende Architektur erweitern — keine Parallel-Systeme.
  11. Accessibility von Anfang an.
  12. Danach reviewen.
  13. Scope einhalten.
  14. Keine unerlaubten Writes.
  15. Bei Unsicherheit: Fail Closed.

Beispiele

Card

User: „Erstelle eine VelinStyle Card mit Header, Content und Actions.“

  1. Intent → build/card → Reuse-Gate
  2. Vorhandenes .velin-card nutzen
  3. Header/Body/Actions nach bestehendem Muster — kein zweites Card-System
  4. Review (Page/A11y)

Tailwind

User: „Analysiere Tailwind-Klassen und erstelle einen Migrationsplan.“

  1. L-Domain Scan/Plan/Dry-Run
  2. Mapped vs Residual trennen
  3. THEME/PALETTE/STATE unklar → STOP
  4. Residuals → Intelligence/Acceptance

Manifest prüfen

User: „Prüfe mein Rewrite-Manifest.“ → Preflight, nicht Manifest-Erstellung. Kein Apply.