ai-driven-dev-principles

重要な意思決定をADR（Architecture Decision Record）として記録・管理する。設計判断、プロセス決定、スコープ決定、方針決定を構造化して記録する。意思決定を検出した瞬間に呼ぶこと。実行中の他スキルの完了を待ってはならない。

ガイドラインの拡張（原則追加・Skillの新規作成/改定・AGENTS.md更新）を行う際のゲートウェイ。CONTRIBUTING.mdを読み込み、brainstormingへ接続する。

brainstorming で合意した全体方針を、疎結合な機能ブロックに分割し、各ブロックの詳細仕様をディレクトリ分割形式（docs/current/specs/YYYY-MM-DD-<topic>/）で作成または更新する。brainstorming と writing-plans の間で発動する。

docs/inbox/ に置かれた未分類の情報を、フォルダ構成定義（docs/overview/folder-structure.md）の分類基準に照らして1件ずつ整理するスキル。移動だけでなく、複数分類への分割、既存ドキュメントへの追記統合も行う。ユーザーの明示実行、または start-work の inbox 検知からの提案で起動する。

不可逆操作や重要な変更の前に、実行内容のサマリーとリスク評価をユーザーに提示する。リスクレベルに応じてログのみ・サマリー表示・承認必須を切り替える。

計画・仕様など非コード成果物の確定前に、実証を課した独立レビューを実施するスキル。3 観点（敵対的・実装整合性・仕様適合）を独立サブエージェントへ委譲し、成果物中のコードはスクラッチで実際に実行させる。発動はユーザーが実施を指示したときのみ。確定点での提示・推奨順位の規則は start-work の「確定前レビューの提示規則」が正。反復のフル巡では観点 3 つを維持し、体数のみ 1〜3 体へ縮小できる。

サブプロジェクト1サイクル完了直後（feature ブランチを master へマージ後、handoff finalize 前）に実施する、サイクル末尾の課題抽出記録スキル。AI が plan / git log / handoff から課題候補（事象/原因/影響、system/flow 分類つき）を一括提示し、ユーザーが修正と起票判断を行う。フロー課題は delta 型（worklog で捕捉可能）か構造観察型かを振り分け、delta 型で急がないものは worklog パイプラインへ委ねる（ADR-0056）。抽出課題は docs/working/issues/system|flow/ へ起票し（ADR-0028）、対策の採否・設計・ADR化は次サイクルへ委ねる（ADR-0021）。rubber-duck 独立レビューはユーザー要求時のみのオプション。

セッション間で作業を継続するためのハンドオフファイル（docs/working/handoff/<branch>.md）を読む・作成する・更新する・確定する・サイクル完了時にリセット（cycle-reset）する。マイルストーン到達時・セッション終了時・retrospective 完了時に呼ばれる。

新しい作業（新規開発、改修、デバッグ、レビュー、調査など）を開始する起点スキル。セッション継続チェック、状況診断、次手ナビゲーションを行い、横断関心（handoff更新、ADR検出、不可逆操作レビュー）を一貫して適用する。

サブエージェントへ作業を委譲する直前に、委譲プロンプトへ入れる制約ブロックを組み立てるスキル。常時適用の A 群 4 件を無条件で含め、B 群の発火条件表 6 行を全行読み下ろして判定行を残し、該当項目のみ展開する。委譲の要否・タスク分割は扱わない。あらゆるスキル実行中のサブエージェント委譲で毎回発動する。

中央ストアに蓄積された作業ログをオンデマンドで走査し、スキル化・ルール化する価値のある候補をクラスタリング・評価してランク付き候補リストとして人間に提示する。処理済み台帳で既処理を除外し、人間の採否を Issue 草案と台帳へ反映する。ユーザーが明示的に実行するスキル。

作業の節目（スキル完了・plan タスク完了・重要な分岐通過）とセッション切り替え直前で、AI のデフォルト挙動と実際に必要だったことの差分（delta）を中央ストアへ1件記録する。start-work の Post ラッパーおよびセッション終了処理から発火。記録ゲート（既存スキルで実施済みでない かつ AI 自律で毎回再現できない）を満たす場合のみ追記する。

worklog-extract で採用された候補から、writing-skills 委譲で新規スキル作成または既存スキル拡張を行う。スコープ（汎用/プロジェクト固有/固有ルール）で成果物の配置先を振り分け、汎用パスをガイドライン配信元リポジトリ以外で実行しようとした場合は警告する。ユーザーまたは worklog-extract から起動。