データは契約 — 妥協なし。
データは副作用ではなく契約:breaking change は新バージョンを要求し、配信は Outbox 経由、安全な idempotency と replay、悪いデータは隔離へ、アクセスは deny-by-default。
$ schematize install data譲れない基準
「速くするため」に無効化しない。完全な一覧はスキルに。
データは契約
境界を越えるすべてのデータはバージョン付き schema を持つ。削除/リネーム/型変更は破壊的変更:v2 と文書化された共存期間を要求する。
配信は Outbox 経由
Transactional Outbox(またはデータベースログの CDC)。dual-write は禁止。すべての consumer が DLQ を持ち、retry は backoff 付きで有限、無限は禁止。
安全な idempotency と replay
idempotent な consumer(2 回実行しても壊れない)。決定的な replay が同じ状態を再構築し、副作用は idempotency-key で重複排除。
悪いデータは downstream を汚染しない
境界で検証。落ちたものは理由と出所を付けて隔離/DLQ へ — 良いデータセットには決して入らず、黙って消えない。
可逆な expand-contract migration
expand → migrate → contract、各ステップに検証済みの down。1 ステップでの破壊的な DROP/rename は禁止。Timestamp は UTC、ID は UUIDv7/ULID。
Deny-by-default + 統制された PII
アクセスはデフォルト拒否、tenant ごとにサーバー側で。SQL はパラメータ化。PII は法的根拠 + retention がある場合のみ、log/URL の外。追跡可能な lineage、archive は常に。
コマンド
.claude/commands/ にインストール。いつでも /data-help を実行。
/data-helpすべてのコマンドを一覧表示。/data-contractデータ契約を定義/監査:バージョン付き schema、互換性(back/forward/full)、registry、進化ポリシー。新バージョンなしの breaking change を止める。/data-pipelineパイプラインを設計/監査(ETL/ELT バッチ、streaming、CDC/event sourcing):idempotency、Outbox 経由の配信、replay、backpressure、DLQ。/data-quality品質ゲートを構築/監査:境界での検証、データテスト/expectations、隔離と dead-letter、データの SLA。/data-load規範全体を強制読み込み:契約、パイプライン、品質、ストレージ、ガバナンス。/data-claude常時オンのデータ CLAUDE.md をリポジトリのルートに作成またはマージ。/data-ccContext compact:handoff をアーカイブに書き出し、/compact を実行。/data-handoffコンパクトせずに handoff(context.md + checklist.md)を作成。AI エージェント向け
人手を介さずにインストール。メタデータは llms.txt。
- 実行: git clone https://github.com/schematizeme/skill-data.git && ./skill-data/install.sh
- またはダウンロード: https://github.com/schematizeme/skill-data/releases/latest/download/skill-data.zip を .claude/skills/ に展開
- assets/CLAUDE.md をリポジトリのルートにコピー(常時オンのルール)。
- /data-help で確認。
ディスカッション
読み込み中…