vaibhav-space/my-ai-coding-workflow

Production-grade AI coding instructions, curated skills, and a 3-stage review pipeline (Planning → Critical Review → Diff Audit) built after 4,500+ hours with AI agents. Agent-agnostic.

解決する問題

AIコーディングエージェントは、しばしば高コストなミスを犯します。単純なタスクを過剰に設計したり、APIを幻覚したり、ファイルを静かに再フォーマットしたり、テストを実際に実行せずに合格したと主張したりします。このプロジェクトは、エージェントにまず計画を立てさせ、その計画を批判させ、マージ前に実際のdiffとテスト出力で作業を証明させる、一連のグローバルルールとレビュープロンプトを提供します。

仕組み

リポジトリには、1つのグローバルルールファイル(CLAUDE.md)と3つのプロンプト(planning.md、critical-plan-review.md、production-readiness-review.md)が含まれています。ワークフローは次のとおりです。

  1. /plan(または計画プロンプトを貼り付け)と入力し、タスクを説明します。エージェントはコードベースを検査し、チェック可能なステップを含むインタラクティブな計画ページを生成します。まだ何も構築されません。
  2. 計画を承認したら、新しいチャットを開き、/review-plan(または重要な計画レビュープロンプトを貼り付け)を実行します。新しいコンテキストは、書いた本人の偏見なしに計画を見る必要があるため、仮定をレッドチームし、欠陥を見つけることができます。
  3. エージェントが承認された計画を実装したら、別の新しいチャットを開き、/review-prod(または本番準備レビュープロンプトを貼り付け)を実行します。これは実際のgit diffを読み取り、テストを実行し、証拠として文字通りのコマンド出力を要求します。証明できなかったものについては「検証できませんでした」リストで終了します。

CLAUDE.mdのルールには、YAGNI(投機的な抽象化をしない)、会話の要約よりもdiff検査、決定的な算術(お金の暗算をしない)、リスクのある変更への明示的な承認などの原則も組み込まれています。オプションのヘルパーファイルは、ハードロックを追加します。テストが失敗したときにコミットをブロックするpre-commitフックと、強制プッシュや.envの読み取りなどの危険なコマンドに対する拒否ルールです。

対象読者

AIエージェントに実際のコードを書かせ、変更が安全であるという約束ではなく証拠を求める個人開発者と小規模チーム向けです。この設定はLinux上のClaude Codeでテストされていますが、プロンプトはプレーンテキストであり、prompts/フォルダからコピーすればGemini CLIやCursorに貼り付けることができます。

ハイライト

  • 3段階のレビューワークフロー:計画、計画の批判、結果の監査。それぞれ新しいコンテキストで行い、自己確認バイアスを回避します。
  • 個々のリポジトリを汚染せずにすべてのプロジェクトに適用されるグローバルなCLAUDE.mdルール。
  • 厳選されたオープンソーススキルパック:Superpowers(プロセス規律)、Ponytail(最小限のコード)、I Have ADHD(明確なコミュニケーションの好み)。
  • オプションの強制ファイル:危険なシェルコマンドの拒否ルールと、壊れたコミットをブロックするpre-commitゲート。

関連

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