kunchenguid/vision

Agent skill that mines your repo's history to draft a VISION.md, stress-tests it with hard hypotheticals, and iterates with you on an interactive review board.

何を解決するか

プロジェクトの価値観や「空気感」が文書化されていないことで、意思決定が一貫性を欠く問題を解決します。記憶や一般的なエンジニアリングの美徳に頼るのではなく、実際にマージされたPRやコミット履歴に基づいて、プロジェクトが何を成し得るか、何を成さないかを明確に定義する検証可能な受入基準(VISION.md ファイル)を策定するのを支援します。

動作方法

このツールは構造化されたパイプラインに従ってプロジェクトのビジョンを生成します:

  1. 証拠の抽出:マージされたPRやコミットログを分析し、実際に構築されたものや断念されたものを実例として抽出します。
  2. ドラフト作成:アイデンティティ、原則、非目標をカバーする初期の VISION.md を作成します。
  3. ストレステスト:プロジェクトの原則が衝突する可能性のある「亀裂線」仮説(8~12件)を生成し、所有者が厳しい選択を迫られるようにします。
  4. インタラクティブレビュー:所有者は専用のレビュー板を使ってこれらの仮説に対する判断を下し、その根拠を最終文書に反映します。

対象ユーザー

貢献者やAIコーディングエージェント向けに、厳密で証拠に基づいた貢献基準を設定したいプロジェクトのメンテナーや所有者。

特徴

  • 証拠に基づく:一般的な美徳を排除。すべての原則は実際にマージされたPRやコミットを根拠にしなければならない。
  • 鋼鉄化された仮説:単なるブレインストーミングではなく、挑戦的なシナリオを使ってビジョンを洗練する。
  • 専用レビュー画面:集中したカードベースのレビュープロセスを可能にする、特定のスタイルシートとボードテンプレートを提供。
  • エージェント対応:スラッシュコマンドや自然言語で呼び出せるエージェントスキルとして提供。

関連

  • プロジェクト
  • プロジェクト
  • プロジェクト
  • プロジェクト
  • プロジェクト