engram-architecture-guardrails について
Engramのサブシステム追加や、ストレージ、クラウド、ダッシュボード、プラグイン、同期の境界変更に携わる開発者向けのアーキテクチャスキルです。コンポーネントの責務を定め、ローカル、リモート、ダッシュボードの動作を回帰テストで確認するよう促します。
主な機能
- 01ローカルSQLiteを信頼できる情報源に設定
- 02ストアとクラウドの境界を明示
- 03プラグインとアダプター層を薄く維持
- 04責務の割り当て方針
- 05境界変更の回帰テスト
活用シーン
- 01サブシステムや主要パッケージの追加
- 02永続化や信頼できる情報源のルール変更
- 03ローカルとクラウド間の同期フロー変更
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/インストール後、Claude Code で/engram-architecture-guardrailsを入力して読み込まれたか確認します。
詳細
使用するタイミング
このスキルは、次の場合に使用します。
- 新しいサブシステムまたは主要なパッケージを追加するとき
- ローカルストア、クラウド、ダッシュボード、プラグイン間で責務を移すとき
- 同期フロー、信頼できる情報源のルール、永続化の境界を変更するとき
基本的なガードレール
- ローカルの SQLite を信頼できる情報源とし、クラウドはレプリケーションと共有アクセスのために使用します。
- プラグイン／アダプターレイヤーは薄く保ち、実際の動作は Go パッケージに実装します。
- ストア、cloudstore、サーバー、ダッシュボード、自動同期の境界を明示します。
- 新機能は UI に組み込む前に、既存のローカルファーストの考え方に沿う必要があります。
- ヘルパーやテンプレートにシステム間の密結合を隠さないでください。
判断基準
- ローカルのみの処理 →
internal/store - クラウドへのデータ実体化または組織全体の制御 →
internal/cloud/cloudstore - HTTP 契約または適用処理 →
internal/cloud/cloudserver - ブラウザーのレンダリングと UX →
internal/cloud/dashboard - バックグラウンドのオーケストレーション →
internal/cloud/autosync
検証
- 境界を変更するたびに、リグレッションテストを追加します。
- ローカル、リモート、ダッシュボードの動作が、引き続き一貫したプロダクト体験を提供することを確認します。
- 同期に関わる変更の場合は、プッシュとプルの両方の経路をテストします。
コメント
Markdown 対応