Vibe Coding Playbook — AI活用のためのコーディング運用指針

ToolAI開発ワークフロープロンプト

llt22/vibe-coding-playbook

GitHub で見る

GitHub →

概要

Vibe Coding Playbook は、「AIでコードを書くのは速いが、保守可能なコードを書くのは難しい」という課題から生まれたガイドライン集です。AIによる自動生成・修正がプロジェクトを高速で変化させる際に、コード品質が低下したりAIが意図しない変更を行ったりする問題を防ぐため、実戦で検証されたプロンプト（指示文）や作業フロー、レビュー基準、チームで共有すべき規約を整理しています。フロントエンドのコンポーネント設計や状態管理、不変条件の保護、デザイン→コードのハンドオフ手順など、UI開発に特化した実務的な対策が中心です。

GitHub

リポジトリの統計情報

  • スター数: 23
  • フォーク数: 4
  • ウォッチャー数: 23
  • コミット数: 24
  • ファイル数: 6
  • メインの言語: 未指定

主な特徴

  • AIの出力を「制約」するプロンプト・テンプレートを多数収録。不要なリファクタリングや破壊的変更を抑制する指示が中心。
  • フロントエンド中心の品質基準（コンポーネント構造、状態管理、不変条件、テストしやすさ）に特化したベストプラクティス。
  • デザイン→コードの高速な受け渡し手順や、設計がない場合の代替ワークフロー（コンポーネントライブラリ＋AIデザインツール）。
  • 実務での導入を想定したチェックリスト、PRフローやレビュー指針、チーム運用ルールを明文化。

技術的なポイント

このPlaybookの技術的核は「AIをチームルールに従わせるためのプロンプト設計」と「変化を安全に受け入れるためのワークフロー設計」にあります。具体的には、システムプロンプトやグローバルルールでAIの権限を限定し（例：不許可の自動削除や全体リファクタリングを禁止）、変更提案は必ず差分単位で出すよう指示します。さらに、コンポーネント設計では単一責任・状態の局所化・不変条件の明示を推奨し、AIに出力させるコードはテスト可能な小さな単位に分割するテンプレートを用意しています。プロンプトのパターンとしては、意図（Intent）→制約（Constraints）→出力形式（Format）→例（Few-shot）の順で与えることで安定した結果を得やすくしています。

運用面では、AI生成コードをそのままマージしないルール（必ず人間のコードレビューと自動テスト）。CIに静的解析・リント・型チェック・スナップショットテストを組み込み、AIが生成した変更が破壊的でないことを自動検証します。デザインハンドオフは、デザインファイルをAIでコードに変換した後、人の手で「スタイルの不整合」「アクセシビリティ」「パフォーマンス弊害」をチェックする手順を明文化しています。また、経験集（experiences）には過去の失敗例と解決策が蓄積されており、新規導入時の学習コストを下げる工夫が見られます。総じて、ツール依存を避けつつAIを安全に利用するための「ガードレール」と「検証ライン」を整備しているのが技術的な特徴です。

プロジェクトの構成

主要なファイルとディレクトリ：

  • .gitignore: file
  • README.md: file
  • assets: dir
  • experiences: dir
  • prompts: dir

その他ファイルが計6つほど収録されています。prompts ディレクトリは各種テンプレートやグローバルルールの一覧、experiences は具体的な事例と改善ログ、assets は図やテンプレート素材を想定した構成です。リポジトリ自体は軽量で、導入時は自分のプロジェクトに合わせてプロンプト文言やチェックリストをカスタマイズして運用する想定です。

まとめ

AIを実務で安全に活用するための実践的なプロンプト＆ワークフロー集です。（約50字）

リポジトリ情報：

READMEの抜粋：

Vibe Coding Playbook

用 AI 写代码很快，但写出能维护的代码很难。

这个仓库解决的问题是：当你用 Cursor / Windsurf / Claude Code 等 AI 编程工具开发时，如何不让项目在高速迭代中失控——代码越写越乱、AI 越改越偏、Bug 修了又来。

这里沉淀了一套经过实战验证的提示词、工作流和协作规范，帮你：

  • 约束 AI 行为：让它遵守你的代码风格、不擅自重构、不乱删代码
  • 控制代码质量：前后端核心质量问题有章可循（组件结构、状态管理、不变量、可测结构等）
  • 高效交付 UI：有设计稿用工具转码 + AI 重构，没设计稿用组件库 + AI 设计工具
  • 管理复杂度：从项目启动到维护修复，每个阶段都有明确的过程规范

所有内容持续迭代中，欢迎提 Issue 或 PR 分享你的 Vibe Coding 经验。

内容索引

提示词

文件 说明
[AI IDE 全局规则](prompts/global…

関連記事

Tool

best-skills：汎用高品質スキル集

本リポジトリは、Cursor、Claude Code、Codex、OpenClaw などの Agent ツールにそのまま導入できる「skills（SKILL.md）」のコレクションです。チャット用のプロンプト集と異なり、各 Skill はメタ情報（description やトリガー）を持ち、Agent がキーワードや利用シーンから自動で呼び出せる設計になっています。論文作成・要約・データ処理など用途別のテンプレ化されたスキルを集め、容易に導入・拡張できる点が特徴です。（約300字）

エージェントスキルプロンプト
AI/ML

Codex Master（コデックスマスター）

Codex Masterは、AIによるウェブサイトやアプリ生成の品質と一貫性を高めるための「マスター・コデックス」フレームワークです。32個のMarkdownファイルでガバナンス、実行フロー、設計基準、検証・回復手順、設定を厳密に定義し、マスタープロンプトジェネレータで堅牢なプロンプト出力を作成します。デザイン多様性を促すブループリント生成と実行系による検証で、生成物の再現性と品質を高めることを目的としています（約300字）。

プロンプトウェブ開発ガバナンス
AI/ML

仕様駆動開発エージェント (Spec-Driven Develop)

Spec-Driven Developは、大規模で複雑な開発タスクを開始する前に、AIエージェントが標準化された準備パイプラインを自動実行するためのクロスプラットフォームな「スキル」実装を提供します。プロジェクト解析、タスクの分解と計画、進捗追跡ドキュメント作成、タスク別サブスキル自動生成、反復的な開発ワークフローなど、コードを書く前の事前準備を自動化して、移行作業や大規模リライト（例：Rust移行やマイクロサービス化）を効率化することを狙いとしています。

AIエージェント開発ワークフロー自動化
AI/ML

prompt-review — プロンプトレビュー（生成AI対話履歴分析ツール）

Claude Codeのスキルとして動作する、生成AIとの対話履歴（プロンプト）を自動収集・分析して日本語のレポートを生成するツールです。過去のプロンプトから技術理解度・プロンプティングパターン・AI依存度などを推定し、指導や振り返りに使える洞察を提供します。軽量なPython実装でプロトタイプ的に設計されています（ログ形式や対応ツールはREADMEに記載）。

プロンプト分析生成AI
AI/ML

best-prompts — 高品質汎用プロンプト集

best-promptsは、汎用的かつ高品質なプロンプトをシーン別に整理したコレクションです。Claude4.6、Gemini3、GPT‑5.2、Composer1.5など主要モデルで良好に動作することが確認されたテンプレート群を収録し、論文執筆、開発支援、自媒体作成など実務でそのまま使える形で提供します。再利用可能な形式と運用上の工夫により、プロンプト調整の手間を大幅に削減します。

プロンプトAIリソース
AI/ML

Prompt Factory — 自動化された高品質プロンプト生成

Prompt Factoryは、要件を入力するだけで多役割のエージェントが協調して高品質なAIプロンプト群を自動生成するフレームワークです。要件解析（Analyzer）、プロンプト生成（Generator）、品質評価（Reviewer）を順に実行し、役割設計やシステム構成まで含めたプロンプトスイートを出力します。クライアント／サーバ構成のサンプル実装を備え、画像解析や分鏡生成などの具体例も収録。Pythonベースで手早くプロンプト設計の自動化を試せます（約300字）。

AIプロンプトマルチエージェント