GRACE-Marktplatz (osovv/grace-marketplace)

Repository-Kontext

Dieses Repository ist das GRACE-Marktplatz-Paket, keine Endbenutzer-Anwendung.

GRACE steht für Graph-RAG Anchored Code Engineering: eine vertragsorientierte KI-Engineering-Methodik, die auf semantischem Markup, XML-Planungsartefakten, Wissensgraphen-Navigation und verifizierungs-/loggesteuerter Ausführung basiert.

Was dieses Repository enthält

• skills/grace/* enthält die kanonischen Skill-Quellen.
• plugins/grace/skills/grace/* enthält das gepackte Spiegelbild für die Claude-Marktplatz-/Plugin-Verteilung.
• .claude-plugin/marketplace.json definiert den Marktplatz-Eintrag.
• plugins/grace/.claude-plugin/plugin.json definiert das gepackte Plugin-Manifest.
• openpackage.yml definiert OpenPackage-Metadaten.
• README.md ist die benutzerorientierte Übersicht und Installationsanleitung.
• package.json, src/grace.ts und src/grace-lint.ts definieren das veröffentlichte Bun-basierte CLI-Paket @osovv/grace-cli und den Befehl grace lint.
• scripts/validate-marketplace.ts validiert die Paketierung, Pfadsicherheit, Versionssynchronisation und Abweichungen zwischen gepackter und kanonischer Version.

Kernzweck

Das Repository verpackt und verteilt GRACE-Fähigkeiten, damit Codierungsagenten:

• GRACE-Projektartefakte initialisieren können
• Modularchitektur und Verträge planen können
• Verifizierung und Log-Nachweise entwerfen können
• Pläne sequentiell oder in parallel-sicheren Wellen ausführen können
• Projekthygiene überprüfen, Abweichungen aktualisieren, Integrität prüfen, GRACE erklären und Projektfragen beantworten können

Dieses Repository handelt hauptsächlich von Methodikinhalten, Skill-Anweisungen und Marktplatz-Paketierung.

Wichtige Arbeitsregeln

• Behandeln Sie skills/grace/* als Hauptquelle der Wahrheit, es sei denn, eine Aufgabe bezieht sich explizit auf die gepackte Ausgabe.
• Halten Sie plugins/grace/skills/grace/* synchron mit den kanonischen Kopien in skills/grace/*, wenn sich die veröffentlichten Fähigkeiten ändern.
• Halten Sie die Versionen in README.md, openpackage.yml, .claude-plugin/marketplace.json und plugins/grace/.claude-plugin/plugin.json synchron.
• Validieren Sie die Repository-Integrität mit bun run ./scripts/validate-marketplace.ts nach Paketierungs- oder Metadatenänderungen.
• Verwenden Sie für CLI-Änderungen oder zur Überprüfung des öffentlichen Lint-Workflows auch bun run grace lint --path . --allow-missing-docs.
• Gehen Sie nicht davon aus, dass jedes Verzeichnis unter skills/grace/ veröffentlicht wird; die tatsächlich ausgelieferte Menge ist in .claude-plugin/marketplace.json deklariert.

So denken Sie über Änderungen nach

• Änderungen an Skill-Texten sind Produktänderungen.
• Änderungen an Paketierung/Manifesten/Metadaten sind Release-Oberflächen-Änderungen.
• Validierungsänderungen schützen vor Abweichungen zwischen kanonischen Fähigkeiten und gepackten Kopien.
• README- und Changelog-Aktualisierungen sind Teil der Release-Hygiene, keine optionale Verschönerung.

Standard-Denkmodell für zukünftige Sitzungen

Wenn eine Anfrage mehrdeutig ist, nehmen Sie an, dass der Benutzer an einem dieser Bereiche arbeitet:

• Verfeinerung der GRACE-Methodik-Anweisungen
• Hinzufügen oder Aktualisieren einer Fähigkeit
• Behebung der Paketierung/Marktplatz-Installation
• Wartung des veröffentlichten grace-CLI und seines Lint-Workflows
• Synchronisierung der kanonischen und gepackten Fähigkeitsbäume
• Verschärfung der Validierung rund um Veröffentlichungen