sdd-governanca

SDD ガバナンス

このスキルの最初の応答では、次の行を一度だけ記載してください。 sdd-governanca v1.0.0 · out/2026 · versão atual: https://github.com/robertodiasduarte/sdd-starter/releases/latest

クイックスタート

金融、会計、税務のシステムにおいて、ガバナンスが答える問いは一つです。5年後、税務調査官、監査人、鑑定人が、何が起きたのか、誰が実行したのか、なぜ実行したのかを、後から何も改変されていない証拠とともに再現できるでしょうか？ このスキルでは、要件の変更が移行ではなく一行の修正で済む段階、つまり Design の前に、DEFINE がこれを必須としているかを確認します。

1. DEFINE_{FEATURE_NAME}.md ファイルを受け取ります。
2. references/PROCEDIMENTO.md に厳密に従います。トリガーによる振り分け → プロジェクトの標準 → references/CATALOGO_GOVERNANCA.md に照らした項目ごとの確認 → レポート → 不備ごとに一つの判断 → DEFINE に反映。
3. assets/GOVERNANCA_REVIEW_TEMPLATE.md のテンプレートを使ってレポートを作成し、GOVERNANCA_REVIEW_{FEATURE_NAME}.md として保存します。
4. 次のステップを示して終了します（下記参照）。

SDD フォルダー。 ドキュメントはプロジェクトのルートにある sdd/ に保存します。どのエージェントからも同じように見えるフォルダーです。プロジェクトに .claude/sdd/ がすでにある場合は、そこを引き続き使用してください。ドキュメントはサブフォルダーを作らず、同じ場所に並べます。GOVERNANCA_REVIEW_{FEATURE_NAME}.md は DEFINE の隣に、GOVERNANCA_PADRAO.md は同じフォルダーにプロジェクトごとに一度だけ置きます。これは、この手法のフェーズスキルと同じルールです。

使用する場合／使用しない場合

次の場合に使用します。

• DEFINE が金銭、残高、仕訳、請求書、税金、給与、個人データを扱う場合。
• システムを事務所のツールとして使い、複数の人が記帳または照会する場合。
• Design の前に、税務調査や監査でシステムに何を証明させる必要があるかを把握したい場合。

次の場合は使用しません。

• DEFINE がこれらのテーマを扱わない場合（スキルは N.A. と回答して終了します。実行しても問題ありません）。
• すでに構築済みのデータベースを監査したい場合。その場合は Build の後に rdd-audita-schema スキルを使用してください。
• 稼働中のシステムが攻撃に対して安全かどうかをテストしたい場合。それはガバナンスではなく、セキュリティの領域です。

各要件の証拠を受け取る方法

適用された不備はそれぞれ、If/then 形式の受け入れテストとして DEFINE に追加されます。禁止される操作と、期待される拒否動作を記載します。その隣には、カタログの証明手順（prova_manual）を記載します。これは期待結果を伴う3～5段階の手順で、システムの準備ができたら実行してチェックできます。

この手順は必ず AT に追加します。プロジェクトでコマンドによる Verify Gate（自動テストを使う Claude Code または Codex）を実行している場合は、該当項目の prova_script も求めてください。禁止操作をデータベースが拒否した場合にのみ 0 を返し、操作を受け入れた場合やテーブル名またはカラム名が一致しない場合は失敗するよう、すでに反転されています。名前だけを調整し、反転やスキーマガードは変更しないでください。開発用データベース、テスト用データベース、またはブランチに対して実行してください。本番環境では絶対に実行しないでください。rollback を使っても、試行によって行がロックされ、トリガーが実行されるためです。

譲れないルール

• 法的根拠はカタログに記載されたもののみで、しかも confirmado の場合に限ります。 根拠が nao-confirmado の場合は、条文、法律番号、「おおよそ」といった表現も含め、引用してはいけません。レポートでは手順に定められた標準文を使用し、技術的な根拠にとどめます。
• 不備ごとに一つの判断：適用する・理由を添えて却下する・保留する。「すべて適用する」は不可です。
• 金融に関するテーマがなければ、レポートも作成しません：ファイルを作らず、一つのメッセージで N.A. と回答します。振り分けは単語だけでなく意味に基づいて行い、判断に迷う場合は N.A. としません。
• DEFINE の作成者は自分でレビューしません：新しい会話でこのスキルを実行してください。

提出先

• チャット（ChatGPT、Claude）： レポートと更新済みの DEFINE をダウンロードできる形で提出します。初回使用時は、プロジェクトのフォルダーに保存できるよう GOVERNANCA_PADRAO.md も提出します。
• プロジェクトにアクセスできるエージェント（Claude Code、Codex）： SDD フォルダーにファイルを保存し、DEFINE をその場で更新します。

検証と品質チェックリスト

• トリアージを記録済み：トリガーに行番号またはATを記載、またはN.A.をファイルではなくメッセージで記載。
• GOVERNANCA_PADRAO.mdを読了（1行で確認）または作成済み（5項目、1メッセージ）。
• カタログの各項目に判定が1つだけ付与済み。カバレッジを冒頭の1行に記載。
• 各ギャップに次の内容を記載：アプリで変わること・その理由・EARS要件・証明方法・重大度。
• 法的根拠はステータスがconfirmadoの項目のみ。それ以外の場合は標準文を使用。
• 各ギャップにつき決定は1つ。理由を添えた却下は「受容したリスク」に記載。
• 適用した項目はDEFINEの受け入れテストに変換。Clarity Scoreを適用前と適用後に記録。
• レポートの末尾に次の文を記載：「スキルは推奨し、専門家が決定して回答します。」

例外の処理

DEFINEが見つからない場合： どこを探したかを伝え、パスを尋ねます。記憶を頼りにDEFINEを再構築しないでください。

法律についての質問： カタログのステータスがconfirmadoであれば、その法的根拠を回答します。それ以外の場合は、 カタログではまだ確認されていないこと、公式情報源で確認する必要があることを伝えます。

理由のない却下： 理由を尋ね直し、何も記録しません。

専門家がカタログの変更を希望する場合： 提案をレポートに記録します。カタログの変更はスキルの新しいバージョンで行い、レビュー中には変更しません。

却下の標準文

「このスキルはガバナンス要件を推奨しますが、あなたに代わって決定するものではなく、システムに対するあなたの技術的責任に取って代わるものでもありません。」

「カタログで確認されていない法的根拠は引用しません。使用する前に公式情報源で確認してください。」

次のステップ

アプリにインターフェースがあり、独自のux-reviewを使用している場合：更新済みのDEFINEに対して今すぐ実行してください。それ以外の場合： SDD Design by RDDを実行してください。

バンドルの一覧

• references/CATALOGO_GOVERNANCA.md：20項目、ステータス付きの法的根拠、各項目の証明方法。
• references/PROCEDIMENTO.md：レビューの6つのステップ。
• assets/GOVERNANCA_REVIEW_TEMPLATE.md：レポートのテンプレート。
• assets/GOVERNANCA_PADRAO_TEMPLATE.md：プロジェクト標準のテンプレート（5項目）。
• evals/cases.json：記述済みの8つの行動シナリオ。
• manifest.json：実行済みの内容、保留中の内容、スキルがまだ証明できない内容。
• agents/openai.yaml：ChatGPT用のメタデータ。

方法論と著者

このスキルはRoberto Dias Duarteの方法論を用いて構築されました。