リポジトリコンテキスト
このリポジトリはGRACEマーケットプレイスパッケージであり、エンドユーザーアプリケーションではありません。
GRACEとはGraph-RAG Anchored Code Engineeringの略で、セマンティックマークアップ、XML計画アーティファクト、知識グラフナビゲーション、検証/ログ駆動実行を中心とした、コントラクトファーストのAIエンジニアリング手法です。
このリポジトリの内容
skills/grace/*には標準のスキルソースが含まれています。plugins/grace/skills/grace/*には、Claudeマーケットプレイス/プラグイン配布用にパッケージ化されたミラーが含まれています。.claude-plugin/marketplace.jsonはマーケットプレイスエントリを定義します。plugins/grace/.claude-plugin/plugin.jsonはパッケージ化されたプラグインマニフェストを定義します。openpackage.ymlはOpenPackageメタデータを定義します。README.mdはユーザー向けの概要とインストールガイドです。package.json、src/grace.ts、src/grace-lint.tsは公開されているBunベースのCLIパッケージ@osovv/grace-cliとgrace lintコマンドを定義します。scripts/validate-marketplace.tsはパッケージング、パスの安全性、バージョンの同期、パッケージ化されたバージョンと標準バージョンの乖離を検証します。
コアの目的
このリポジトリはGRACEスキルをパッケージ化して配布し、コーディングエージェントが以下を実行できるようにします。
- GRACEプロジェクトアーティファクトの初期化
- モジュールアーキテクチャとコントラクトの計画
- 検証とログ証跡の設計
- 計画の逐次または並列安全な実行
- プロジェクト健全性の検査、ドリフトの更新、整合性のレビュー、GRACEの説明、プロジェクト質問への回答
このリポジトリは主に方法論コンテンツ、スキル指示、マーケットプレイスパッケージングに関するものです。
重要な作業ルール
- タスクが明示的にパッケージ化された出力に関するものでない限り、
skills/grace/*を主要な情報源として扱ってください。 - 公開されたスキルが変更された場合、
plugins/grace/skills/grace/*を標準のskills/grace/*コピーと同期させてください。 README.md、openpackage.yml、.claude-plugin/marketplace.json、plugins/grace/.claude-plugin/plugin.jsonの間でバージョンを同期させてください。- パッケージングまたはメタデータの変更後は、
bun run ./scripts/validate-marketplace.tsを実行してリポジトリの整合性を検証してください。 - CLIの変更時や公開リントワークフローの確認時は、
bun run grace lint --path . --allow-missing-docsも使用してください。 skills/grace/以下のすべてのディレクトリが公開されるとは想定しないでください。実際に出荷されるセットは.claude-plugin/marketplace.jsonで宣言されています。
変更についての考え方
- スキルテキストの変更は製品変更です。
- パッケージング/マニフェスト/メタデータの変更はリリースサーフェスの変更です。
- 検証の変更は、標準スキルとパッケージ化されたコピー間の乖離を防ぎます。
- READMEと変更履歴の更新はリリース衛生の一部であり、オプションの仕上げではありません。
将来のセッションのためのデフォルトのメンタルモデル
リクエストが不明確な場合、ユーザーは以下の領域のいずれかに取り組んでいると想定してください。
- GRACE方法論の指示の改良
- スキルの追加または更新
- パッケージング/マーケットプレイスインストールの修正
- 公開された
graceCLIとそのリントワークフローの保守 - 標準スキルツリーとパッケージ化スキルツリーの同期維持
- リリースに関する検証の強化