AI / Agent Ressourcen 1.4.0

Maschinenlesbare Discovery für VelinStyle 1.4.0: Manifeste, Skills, Komponenten, Atelier, CLI-Diagnostics und SAFE/REVIEW-Grenzen. Twin: English · AI Skills · Agenten-Workflows.

Versionsverlauf

3 Releasesv1.4.0

CLI-Referenz — Production, Security, Motion, Experience und Core-Befehle.

Änderungsprotokoll Aktualisieren

Keine Fähigkeiten erfinden. Nur Registry-Skills, generierte Komponenten-Docs, Atelier-Katalogfelder (id/title/href, plus optional related bei match: "direct") und Phase-5-Scanner-Semantik nutzen. Candidate ≠ Apply. links/* bleibt Detect-only.

Discovery-Hierarchie

.well-known/ai.json
        ↓
/dist/velin-agent.json
        ↓
/dist/llms.txt
        ↓
Skills · Docs · Komponenten · Atelier · CLI

/.well-known/ai.json — dünner Einstieg
/dist/velin-agent.json — Agent-Manifest
/dist/llms.txt — LLM-Einstieg + Site-Overlay (kein zweites Skill-Inventar)

Version

Öffentliche Agent-Discovery zielt auf VelinStyle 1.4.0. framework.version in velin-agent.json prüfen. Skills-Registry bleibt 1.0.0 (sprachneutrale Skill-IDs).

Skills

SoT: @birdapi/velinstyle/skills-registry (Registry 1.0.0)
Manifest: velin-agent.json → skills
CLI: npx velinstyle skills list|show|run|install
Docs: AI Skills (DE) · AI Skills (EN) · Agenten-Workflows
Öffentliche Skill-Prose: generierter Markdown-Spiegel unter docs/generated/skills/<skill-id>/SKILL.md (aus Registry prosePath). Manifest-Feld proseHref. Package-prosePath für CLI/npm. Keine per-Skill-HTML-Seiten; keine DE-Skill-IDs erfinden.

Komponenten

Generierte WC-API (Minimal-HTML wenn SoT vorhanden; Attribute, Events, Slots, A11y)
Design-Intelligence JSON
Human Docs unter docs/components/
CSS-Primitives (keine WC-Tags): z. B. Buttons mit .velin-btn — buttons.html / buttons-de.html. Es gibt kein <velin-button>; keines erfinden.

Atelier

Atelier · Library
Öffentlicher Maschinenkatalog: docs/generated/atelier/catalog.json (Spiegel der CLI-SoT)
Basisfelder immer: id, title, href (Showcase/Template — kein Component-API-Contract)
Optional related: nur bei DIRECT-CE-Match (match: "direct") — derzeit 7 Atelier→Component-Doc-Links. Fehlt related, gibt es keine beweisbare Kante (AMBIGUOUS und MISSING). Keine Zuordnung über Titel/Dateinamen erfinden.

CLI / Scanner / Diagnostics

CLI-Docs (DE) · CLI (EN)
Rules-Index: scanner.md (kann hinterherhinken)
Maschinenlesbare scan-policy.json (SAFE / Detect-only / Review-only aus Apply-Gates)
Detect ≠ Fix ≠ Apply.

SAFE / REVIEW / CANDIDATE / BLOCKED / UNKNOWN

Signal	Bedeutung	Auto Apply?
SAFE	Bestehender SAFE-Fix + Apply-Gates	Nur offizielle Apply-Pipeline / `--fix-dry-run`
REVIEW	Entwicklerentscheidung	Nein
CANDIDATE	Vorschlag in `diagnostic.candidates`	Niemals
BLOCKED	Keine sichere Auto-Aktion (`links/*` u. a.)	Nein
UNKNOWN	Runtime/AT nicht statisch bewiesen	Nein

links/* bleibt Detect-only. Candidate setzt niemals fixable: true.

Beispiel-Agent-Workflow

Aufgabe: „Erstelle eine barrierearme VelinStyle-Seite.“

/.well-known/ai.json → Manifest → llms.txt
Passende Skills über Registry/Manifest (keine IDs erfinden)
Komponenten-Docs / Intelligence lesen
Optional Atelier-Templates; related nur bei match: "direct" folgen
Mit dokumentierten velin-*-Mitteln erzeugen
npx velinstyle scan ausführen Machine-Ergebnisse: --json oder --sarif (gleiche Findings; Candidates ≠ Apply).
Diagnostics lesen; nur SAFE + fixable: true applyen
REVIEW/CANDIDATE/BLOCKED/UNKNOWN melden

DE / EN

Registry und Skill-IDs bleiben sprachneutral. Docs nutzen DE/EN-Twins. Keine erfundenen deutschen Skill-Seiten.

Partner / Motion AI (PixVerse)

Optionales AI-Video für Motion Clips ist als Partner-Guide dokumentiert (kein Skill). Auffindbar über Suche, Docs-Nav oder Agent-Manifeste:

PixVerse Partner-Setup (DE) · PixVerse (EN)
Velin Motion Clips (DE) · Motion Clips (EN)
Manifest-Pointer: documentation.guides.pixverseEn / pixverseDe in velin-agent.json; resources.pixverseGuideEn / pixverseGuideDe in /.well-known/ai.json
Affiliate-Signup-Links nutzen rel="noopener sponsored" — Scanner SAFE verlangt noopener; sponsored behalten; noreferrer nicht erzwingen (Attribution)