バイブスの完全性
あなたは、このバイブスコードされたコードベースをレビューするよう依頼されています。見つけた問題を修正するよう求められているわけではなく、推奨事項を示すだけです。
プロセス
大まかなプロセスは次のとおりです。
- 利用可能なすべての製品ドキュメントを収集する。
- ユーザーに質問して、アプリケーションへの理解を深める。
- 品質の柱に基づいてコードをレビューする。
- 調査結果を含むレポートを作成する。
品質の柱
これらは高品質なソフトウェアを書くための柱です。重要度の高い順に並んでいます。このプロジェクトを評価するレンズとして使用してください。
- セキュリティ - 認証、権限、データの露出、安全でないブラウザの動作。
- 信頼性 - クリティカルフロー、ルートの健全性、アサーション、コンソールエラー、壊れた状態。
- パフォーマンス - 読み込み動作、レスポンシブネス、高コストなアセット、ユーザーが認識するレイテンシ。
- UI/UX - ナビゲーション、明瞭さ、バリデーション、コンテンツの期待、視覚的な一貫性。
- アクセシビリティ - キーボード操作、セマンティクス、ラベル、ARIA、コントラスト、支援技術へのシグナル。
プロセスの詳細
1. 利用可能な製品ドキュメントを収集する
このフェーズでは、利用可能な製品ドキュメントを探します。これがレビューの基礎となるため、品質の柱に関連する可能性のあるものはすべて見つけてください。
よく探す場所:
- PRODUCT.md
- PRD.md
- README.md
- docs/
2. ユーザーに質問する
製品ドキュメントは不完全であったり、現在のアプリケーションの状態と同期していない場合があります。プロジェクトとその要件への理解を深めるために、ユーザーに質問してください。質問ツールが利用可能な場合はそれを使用し、そうでない場合はユーザーとチャットしてください。
質問の例:
- このアプリケーションにアクセスする必要があるのは誰ですか?
- 継続的なメンテナンスの計画はありますか?
- このアプリケーションをどのように監視し、パフォーマンスと信頼性を検証しますか?
- このアプリケーションはどこにホストされる予定ですか?
3. コードをレビューする
収集した情報を使用して、各品質の柱についてコードをレビューするサブエージェントを起動します。コンテキストの混入を避けるために、それらを分離してください。各サブエージェントには、問題を見つけ、それぞれの品質の柱に基づいてGo/No-Go評価を提供するタスクを割り当てます。
各問題:
- 具体的で実行可能な問題であるべき
- 問題の影響評価を含む
- 各問題に次の影響レベルのいずれかを割り当てる:Showstopper、Critical、Moderate、Nice to have
- 問題の明確な説明と、関連するファイル名と行番号(ある場合)を含む
- 解決策の推奨事項を提供する
4. レポートを作成する
最後に、サブエージェントからのすべての結果を収集し、詳細なHTMLベースのレポートを作成し、チャットでハイレベルな要約を提供します。ユーザーが確認できるように、ブラウザでHTMLレポートを開きます。
レポートの主要機能:
- Go/No-Goの推奨事項
- 要件:製品とそのコア要件のハイレベルな要約
- 問題:影響レベルの高い順(最も深刻なものから)に並べられた問題のリスト
- その他の情報:レビュー担当者が知っておくべきその他の重要な発見事項
レポートの例:
推奨事項: No-Go
Fourgroundsコーヒーランキングは、Fourgroundsコーヒーショップの顧客がお気に入りのコーヒー飲料をランク付けできる公開アプリケーションです。
コア要件:
- ユーザーにFourgroundsで現在提供されている飲料のリストが表示される必要がある
- ユーザーはドラッグして飲料を並べ替え、好みのランキングを作成できる必要がある
- ユーザーはランキングを送信し、選択した無料のベーカリーアイテムのリワードを受け取れる必要がある
- ユーザーはランキングを1回のみ送信できる必要がある
問題:
ユーザーは木曜日に複数回送信できる
影響:CRITICAL - ユーザーは無料リワードを複数累積できる。
date.js 42行目の日付解析エラーにより、未処理の例外が発生すると、check-reward.js 16行目で以前の送信チェックがスキップされる可能性がある。
推奨事項:組み込みの日付パーサーを使用し、日付解析をtry/catchでラップして、例外がアプリケーションの他の領域に影響を及ぼさないようにする。
その他の情報:
coffee-products.jsonファイルは毎日生成されます。製品が日中に変更された場合、このファイルが古くなっている可能性があります。ランキングの外部コンシューマーは、製品の存在を検証するように注意する必要があります。