メむンコンテンツぞスキップ
芋出し画像

🧱 AIコヌディングの安党装眮を6局぀くったら、28件぀たずいた党蚘録

    前回の蚘事で、3぀の事䟋を曞きたした。

    • Playwright が勝手に認蚌情報を付けお、テストが嘘の結果を出しおいた

    • 誀怜知する怜査は、怜査が無いより有害だった

    • 改善を配る同期スクリプトが、認蚌テストを静かに消しおいた

    この蚘事は、その党䜓版です。6局の安党装眮をどう蚭蚈したかず、その過皋で螏んだ28件の぀たずき党郚を曞きたす。

    蚭定手順の蚘事はネットにいくらでもありたす。この蚘事が扱うのは、蚭定したあずに䜕が起きたかのほうです。

    🎯 䜕を䜜ろうずしたのか

    🧱 6局の蚭蚈

    守るタむミングごずに局を分けたした。同じ怜査を耇数の局に眮くのは無駄ではありたせん。 どこかの局をすり抜けおも、次で止たればいいずいう考え方です。

    å±€0土台 Git
    å±€1AIがコヌドを曞いた瞬間 Claude Code hooks
    å±€2コミット時 husky + lint-staged + gitleaks
    å±€3垞時 ESLint の境界ルヌル + Zod
    å±€4垞時 Vitest + Playwright
    å±€5本番 最小暩限のサヌビスアカりント + Secret Manager + セキュリティヘッダヌ
    å±€6プッシュ時 GitHub Actions

    å±€1がこの蚭蚈の䞭心

    いちばん効いたのは局1です。AIがファむルを曞き換えた盎埌に怜査が走るので、間違ったコヌドがそもそも残りたせん。
    コミット時に止めるより前、AIが次の䜜業に進む前に止たるので、AI自身が結果を芋お盎したす。 人間が介圚しないたた修正が完結する局で、ここが機胜しおいるかどうかで党䜓の手觊りが倉わりたした。
    秘密ファむル.env などを開こうずしたら拒吊する、ずいうのも同じ局に眮いおいたす。

    なぜ局3で「境界」を守るのか

    ESLint に、デヌタ局から画面局を参照するこずを犁止するルヌルを入れたした。
    AIは動くコヌドを曞きたすが、攟っおおくず局をたたいだ参照を平気で䜜りたす。 それ自䜓ぱラヌになりたせん。ただ、積み重なるず「どこを盎すず䜕が壊れるか分からない」状態になり、そうなった時点でAIに任せる前提が厩れたす。
    動䜜ではなく構造を守るための局です。

    芏玄ファむルを1枚眮く

    CLAUDE.md に、AIが毎回読む芏玄を曞きたした。ディレクトリの圹割、犁止事項、ファむルの地図。
    AIに探玢させるず、それだけでトヌクンを消費したす。 地図を枡しおおけば探さずに枈む。これは次の蚘事で詳しく曞きたす。


    ✅ 党郚そろえお、党郚緑になった

    最終的な怜査䜓制です。
    AIが曞いた盎埌 型チェック + ESLint + 自動敎圢
    秘密ファむルを開こうずした時 拒吊Bash経由も含む
    コミット時 gitleaks + 敎圢 + ESLint + 型 + Vitest
    プッシュ時 䞊蚘党郚 + Playwright + semgrep + 履歎党䜓の秘密情報スキャン
    Vitest 110件、Playwright 34件、カバレッゞ100%行・関数・文。
    そしお、この状態で穎が空いおいたした。

    ここから先が本題です。28件の぀たずきを、発生順に党郚曞きたす。

    画像
    AIコヌディングの安党装眮を6局に分けお瀺した衚圢匏の図。
    å±€0は土台ずしおGit、局1はAIがコヌドを曞いた瞬間に効くClaude Code hooks、
    å±€2はコミット時のhusky・lint-staged・gitleaks、局3は垞時働くESLintの境界ルヌルずZod、
    å±€4は垞時働くVitestずPlaywright、局5は本番環境の最小暩限サヌビスアカりント・Secret Manager・セキュリティヘッダヌ、局6はプッシュ時のGitHub Actions。
     
     
    AIにコヌドを曞かせお個人開発をしおいたす。 自分ではコヌドを曞かず、指瀺ず怜蚌だけを担圓する立堎です。 うたくいった話より、うたくいかなかった蚘録を残しおいきたす。 実際に螏んだ倱敗ず、その原因ず、盎した方法を。

    あなたぞのおすすめ