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 検知からの提案で起動する。

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

計画・仕様など非コード成果物の確定に関わる2操作を提供する。提示操作: spec/plan確定点で毎回、確定前レビューをユーザーへ提示する（AIが呼ぶ）。実施操作: 3領域と反例・失敗経路の探索を覆う独立レビューを実証つきで行う（発動はユーザーの個別指示または承認済みの判断の分担による）。

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

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

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

サブエージェントへ作業を委譲する直前に使う。タスクの型を問わず、あらゆるスキル実行中の委譲で毎回適用する。実行を伴う検査では起動前と結果の受け取り時にも使う。

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

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

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