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

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

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

Vibe Coding Playbookは、Cursor・Windsurf・Claude CodeなどのAIコーディング支援ツールを利用するチーム向けに、AIの振る舞いを制約しつつ高品質なコードを維持するためのプロンプト、ワークフロー、協作ルールをまとめた実践集です。設計から実装、レビュー、保守まで各フェーズに適したテンプレートやチェックリストを備え、AIによる過剰なリファクタリングやコード崩壊を防ぐ運用ノウハウを提供します。（300字程度）

https://github.com/llt22/vibe-coding-playbook

概要

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…