soumatheusgomes/vibe-coding-toolkit

🎧 Vibe Coding Toolkit – AI支援開発の実用的ワークフロー

何であるか – 大規模言語モデルによるコーディングアシスタント（Claude Code、OpenAI Codexなど）を、組織の一員として disciplined に活用できるようにする、ドキュメント化されたツール、プロンプト、設定テンプレートのコレクション。このリポジトリは新しいモデルを提供するものではなく、プロセスと、そのプロセスを本番環境で再現可能にするための「接着剤」（プラグイン、フック、Lintルール、サブエージェントオーケストレーション）を提供する。

なぜ重要か – 多くのAIコーディングガイドは「大きなプロンプトを貼り付けて、うまくいくのを祈る」で終わる。このツールキットは、実際の生産環境でのフィンテックプロジェクトで直面した具体的な課題を解決する現実世界のフローを示している：

• セッションの継続性（実行間でのメモリ保持）
• エージェントが過剰に生成したり、要求から逸脱したりすることの防止
• ファイルを競合せずに専門分野（レビュー、DB、テスト）に特化した並列サブエージェントの実行
• 警告を追跡可能なエラーに変える自動品質ゲート（ESLint/Biome）の強制
• コードを書く前に「ブレインストーミング → 計画 → 実装 → レビュー」のループを強制する軽量な「スーパーパワーズ」規律

主要構成要素

構成要素	機能	使用方法
スーパーパワーズ (docs/tools/01‑superpowers.md)	ブレインストーミング→計画→実装→レビューのサイクルを強制。最も影響力のある習慣。	superpowers@claude-plugins-official プラグインを Claude-Code にインストールし、コード作成の前にスキルを呼び出す。
サブエージェントオーケストレーション (02‑subagent‑orchestration.md)	複数の専門エージェントインスタンスを「波」で実行し、同時に同じファイルを編集することを防ぐ。	ドキュメントに記載されたプロトコルに従う。波ディスパッチプロンプトのテンプレートもリポジトリに含まれている。
RTKトークンプロキシ (03‑rtk-token-proxy.md)	git status、diff、logなど繰り返しのコマンドをコンパクトでトークン節約型に変換するCLI。	セッション内でこれらのコマンドの代わりに提供されたスクリプトを使用。
ポニーテール & カブマンのキャラクター (04‑ponytail.md / 05‑caveman.md)	エージェントの集中と簡潔さを保つためのシンプルな意思決定・コミュニケーションポリシー。	作業開始前に Claude/Codex セッションにキャラクターのプロンプトを追加。
品質ゲート（ESLint/Biome） (06‑eslint‑biome‑quality‑gates.md)	選択されたLint警告をハードエラーに変換し、1ファイルあたり350行の上限を強制し、違反を記録。	事前準備済みのプロンプト 08‑eslint‑quality‑gates‑install.md を実行する（または templates/eslint/ から設定ファイルをコピー）。
Graphify & Context7 (07‑graphify.md / 12‑context7.md)	コードベースの永続的知識グラフを構築し、最新のライブラリドキュメントをモデルのコンテキストに注入。	説明されたオプションのMCPサーバーをデプロイ。Claudeに接続する方法をツールキットが示す。
Obsidianメモリ (08‑obsidian‑memory.md)	Obsidianバウルに保存された長期的なプロジェクトノート。MCPプロトコル経由でエージェントがアクセス可能。	バウルを初期化し、MEMORY.md インデックスをその場所に設定。
プロンプトライブラリ (docs/prompts/*.md)	lintのクリーンアップ、マルチエージェントコードレビュー、ファイルサイズのリファクタリングなど、一般的なタスク用のコピー可能なプロンプト。	Claude/Codex（またはURLを読み取れる任意のLLM）にプロンプト全体を貼り付け、エージェントに実行させる。
テンプレート (templates/…)	ボイラープレートの CLAUDE.md、ESLint設定、フック例、CLI用最小限の settings.json。	プロジェクトに必要なファイルをコピーし、Playbookに記載された通りパスを調整。

導入手順

1. Claude Code をインストール し、公式プラグインマーケットプレイスを追加（READMEのワンライナー）。

   npm install -g @anthropic-ai/claude-code
   /plugin marketplace add anthropics/claude-plugins-official
   /plugin install superpowers@claude-plugins-official
   cp templates/CLAUDE.md.template CLAUDE.md
   

2. Playbook を読む – docs/02-playbook-onboarding.md。エンドツーエンドの例プロジェクトを歩みながら、各ツールがタイムラインにどのように組み込まれるか（インストール → 設定 → ブレインストーミング → 計画 → サブエージェント波 → レビュー → 配信）を示す。
3. 1つのツールだけ選ぶ。たとえば、350行ルールを強制するには、READMEに示されたワンライナーのプロンプトを実行するか、templates/eslint/ からESLint設定をコピーする。

誰に向けか

• Claude Code、Codex、または同等のLLMコーディングアシスタントにアクセスしている開発者で、再現可能で本番環境対応のワークフローを求める人。
• 「プロンプトを貼り付けて希望する」セッション、コンテキストの喪失、エージェント同士のファイル上書きに悩んでいるチーム。
• CLI作業に多少慣れており、短いポルトガル語ドキュメントを読むことに抵抗のない人（コアコンセプトはインラインで説明されており、実際のプロンプトは英語で提供）。

成熟度と状態

• リポジトリは、プライベートなフィンテックプロジェクトから抽出されたメソドロジーである。元のコードはNDA下にあるため非公開。作者は実際の本番環境でこれらの実践を用いてきたと述べているが、リポジトリ自体にはコンパイル済みバイナリは含まれず、ドキュメント、プロンプト、設定テンプレートのみ。
• 歴史が短いのは、このリポジトリが生きているガイドを意図しているため。作者がワークフローを洗練させたり、新しいプラグインを追加したりするたびに更新が予想される。

ライセンス – MIT（LICENSE を参照）。

---

結論 – Vibe Coding Toolkit は、AIコーディングアシスタントを disciplined なチームメイトに変えるための具体的でオープンソースのマニュアルである。プロンプトの即興的ハッキングから、再現可能で本番環境対応の開発フローへと移行できるよう、欠けている「接着剤」（プラグイン、プロンプト、Lintゲート、サブエージェントオーケストレーション）を提供する。