Implementation
リリース前QAチェックリストを作る
1人自動開発では、重い品質プロセスよりも、壊れやすいところを毎回確認する軽いチェックリストが効きます。
ui.design: qaui.design: report-quality
まず確認する症状
- LPコピー修正でフォームや計測が壊れる。
- レポート表示変更でzipやtasks.jsonとの整合が崩れる。
なぜ問題か
- 小さく速いリリースでも、壊れやすい契約を固定すると負債が溜まりにくくなります。
- チェックリストは人間とコーディングエージェントの両方が使える運用資産になります。
診断で見る指標
主要導線
モバイル表示
artifact生成
計測タグ
法務/課金表示
修正方法
最小修正
壊れやすい導線を列挙する
Scan、結果表示、Learnリンク、Review Pack、account、billingを対象にします。
推奨修正
自動テストと手動確認を分ける
build/lint/testで見るものと、スクショや実ジョブで見るものを分けます。
さらに改善
Issueテンプレート化する
リリース前確認をGitHub IssueやPRコメントで再利用します。
受け入れ条件
- 01PCとスマホの両方で目視確認し、主なCTAまたは操作対象が迷わず見つかる。
- 02キーボード操作、読み上げ補助、または自動検査で再発しやすい項目を確認する。
- 03修正後にui.designで再スキャンし、同じ所見が残る場合は原因を分解する。
コーディングエージェント向け修正指示
目的: リリース前に見るべき導線、表示、成果物、計測、課金/認証影響をチェックリスト化してください。自動テストで担保する項目と人間が見る項目を分けてください。
参考資料
よくある失敗
- 毎回全部を詳細レビューしようとして、運用が続かない。
- 見た目だけを整え、見出し、リンク、フォームラベルなどの意味構造を直さない。
- 1つの指摘だけを直し、同じ原因から出た別画面の再発を確認しない。