
AIに建設会社の業務システムを丸ごと作ってもらった話【6ヶ月の記録】
AIに「建設会社の基幹システム」を丸ごと作ってもらった半年間の話
はじめに:「仕様書を渡したら動くものが出てくる」の現実
最初にはっきり言っておくと、これは「AIすごい!一瞬で完成した!」という話ではない。
むしろ逆で、バグとの格闘・本番データの吹き飛びかけ・2ヶ月ものバックアップ欠損の発覚、そういうヒリヒリした出来事がたくさんあった記録だ。
担当したのは地方の建設会社の業務管理システム。案件管理・仕入管理・月次集計・支払表のExcel出力……既製品では細かいところが合わなくて自社向けに作ることになった、あのやつだ。これをNext.js + PostgreSQLで構築し、Claude Codeと一緒に半年かけて育てた。
コードを読める人に向けた技術ブログじゃなくて、「AIと一緒に仕事をするってどういう感じなのか」を正直に書き残したくてこの記事を書いている。
フェーズ1:仕様書を貼ったら動き出した
最初のフェーズはシンプルだった。Excelで運用していた「支払表」をWebアプリに移植する、というタスク。
Excelファイルのフォーマット仕様を詳細に書いた指示書(Markdownで5000字くらい)をClaude Codeに貼り付けて、「このとおりに作って」と投げた。
正直、ここまでスムーズにいくとは思っていなかった。
DBのスキーマ変更
月次集計のAPI
ExcelのエクスポートAPI(SheetJSで)
画面のUI
これを一気通貫で実装して、型チェックもパスして、「あとはデプロイするだけ」の状態まで持ってきた。体感2〜3時間の作業が、数十分の「指示書レビュー時間」に圧縮されていた。
でも、ここで一番最初の落とし穴がある。
最初の「ヒヤリ」:本番DBが消えかけた
実装が終わって「マイグレーション走らせよう」とClaude Codeが提案してきた。
npx prisma migrate dev --name add_tkc_code待ってくれ。
このプロジェクトのDBは本番と開発が同じNeonのクラウドDBを向いていた。`migrate dev`は既存のスキーマとのドリフトを検知すると「DBをリセットしますか?」と聞いてくる。本番データが全部消えるところだった。
Claude Code自身がこれを調査の途中で気づいて、「このプロジェクトは`db push`運用です。`migrate dev`は使用禁止(リセット=本番全消去リスク)」と自分でルールとして宣言してくれたのは助かった。でも、知らない人が同じことをやったら確実に事故になっていた。
AIは優秀だけど、インフラやDBのルールは「このプロジェクト特有の事情」を毎回ちゃんと伝えるか、指示書に書いておかないと危ない。ここは人間が守らないといけないラインだと思った。
フェーズ2:動いているシステムへの改修が始まる
本番稼働後、追加機能の要望が次々と来た。
仕入先にTKCコードを追加したい
支払表に来期回しフラグを
期末決算の処理を組み込んで
案件番号を「64-001」みたいな形式に変えたい
一つひとつは小さくても、積み重なると「動いているシステムの改修」になる。これが体感として全然違う難しさだった。
新規実装と違って、既存のデータと整合性を取りながら直さないといけない。Claude Codeに「案件番号を期別の連番に変えてほしい」と投げたら、まず既存データの状況を調べて、「240件は64期、10件は65期、264件は期不明」という分析をして、SQLのマイグレーションスクリプトを書いてきた。そのまま流すんじゃなくて、「実行する前にバックアップ取りますか?」と確認してくれた。
このあたりのやり取りが、ペアプログラミングっぽくなってきて面白かった。
一番しんどかった夜:バックアップが2ヶ月間止まっていた
「バックアップは毎日取れてるよね?」
ユーザーからそう聞かれて調べたら、最後に成功したバックアップが2ヶ月前だった。
原因は単純で、cronで実行しているシェルスクリプト(`backup.sh`)がいつのまにかサーバーから消えていた。毎晩0時に「ファイルが見つかりません」で静かに失敗し続けていたわけだ。誰も気づかないまま。
これはAIがどうこうという話ではなく、運用の怖さだと思う。「設定した」と「動き続けている」は別物で、監視がなければサイレント障害はずっと続く。
この事件を機に、Slackに毎朝バックアップの死活チェック通知を飛ばす仕組みを追加した。今は万が一バックアップが止まったら翌朝にアラートが来る。「やって!」の一言で作ってくれたのは正直ありがたかった。
サーバー移行という本番のスリル
セキュリティインシデントが発生して(Reactに重大な脆弱性が出た週だった)、旧サーバーから新サーバーへの緊急移行が必要になった。
シークレット類(DBパスワード、認証キー)はすべて漏洩したとみなして再生成。コードも旧サーバーのバイナリを持ち込まず、ソースから全部ビルドし直す。
移行後にユーザーから「ログイン画面にならないよ」と連絡が来た。
調べると、Next.jsのstandaloneモードで起動したサーバーがリダイレクト先に`localhost:3001`をそのまま書いてブラウザに返す、という既知の挙動だった。nginxで正規表現を使って書き換えることで解決したが、こういう「動かして初めてわかる問題」はAIも事前には教えてくれない。
proxy_redirect ~^https?://localhost:3001/(.*)$ https://example.com/$1;この1行を見つけるまでに、かなりの往復があった。
「来期回し」機能と、ビジネスロジックの複雑さ
建設業特有の話だけど、案件を「来期に繰り越す」という操作がある。会計上の計上期を翌期にずらすやつだ。
これを実装する過程が、個人的にはこのプロジェクトで一番面白い部分だった。
最初はシンプルに「orderDate(受注日)から期を計算して+1する」ロジックを書いた。でも実際の運用では、受注日が空の案件がたくさんある(建設業では契約より先に着工することがある)。受注日が前の期の案件もある。期のマスターデータがまだ登録されていないことだってある。
バグが起きるたびに「このビジネスロジックはこういう構造だ」という理解が深まっていって、最終的には「現行期のisCurrent=trueを基準にする」「次期マスタがなければnullのまま保持して決算実行時に一括セット」という設計に落ち着いた。
仕様書に書いてある通りに作るのが「実装」だとすれば、「どういうケースを想定するか」を一緒に考えるのが「設計」だ。AIはそのどちらもある程度やってくれるけど、「この会社の実際の運用はこうだ」という文脈は、やっぱり人間が持ち込まないといけない。
数字でふりかえる
半年で何をやったか、なんとなく可視化してみると:
実装フェーズ:6弾(第1弾〜第6弾の指示書)
追加/更新ファイル:おそらく50〜80ファイル
DB操作:本番への直接SQL実行が数十回(バックアップ取ってから)
緊急対応:サーバー移行1回・バグ修正多数・バックアップ復旧1回
コードの量でいえば、単独でゼロから書いていたら半年では終わっていなかったと思う。個人事業でやっているので工数を全部自分が抱えている。その意味ではAIが「同僚」として機能したという感覚は本当にある。
正直なところ
AIに任せればすべてうまくいく、という話ではない。
「DBが消えかける」「バックアップが止まってる」「本番で謎の500エラー」——こういうことは全部あった。
でも、「何かあっても自分で把握して対処できる」という感覚があれば、AIとの開発は本当に強い。指示書を書く力・問題を言語化する力・「これは危ない」と止める判断力——これは人間側に必要なスキルで、そこが磨かれていれば、AIは確実に仕事の速度を上げてくれる。
個人開発・フリーランス・副業で何か作ろうとしている人には、「完璧な仕様書がなくても始められる」「途中でどんどん育てていける」という体験をしてほしいなと思う。最初の一歩がとにかく軽くなった、というのが一番正直な感想だ。
あなたは今、AIと一緒に何か作っていますか?
あるいは「作りたいけど踏み出せていない」という感じですか?
もしよければコメントで教えてください。