メインコンテンツへスキップ
見出し画像

AI初心者がClaude Codeで助成金の進捗管理アプリを作ってみた。つまずいたのは「コード」じゃなく「決めること」だった

    助成金の仕事をしています。

    なかでもキャリアアップ助成金は件数が多く、管理はずっとスプレッドシートでした。

    ・契約と進捗の台帳:約1,800行・55列

    ・書類回収の表:約1,000行

    ・申込フォームの回答

    そして、見出しが空欄の列が約20列。何列目に何が入っているかを知っているのは、わたしだけです。

    助成金は、申請期限を1日でも過ぎると支給されません。その期限を、スプレッドシートの目視で守っていました。

    さすがに怖くなって、Claude Code に進捗管理のアプリを作ってもらうことにしました。わたしはコードを書けないので、役割は「決める人」に徹します。

    結論から書くと、いちばん時間がかかったのはコードではありませんでした。自分の仕事を、言葉にすることでした。

    画像

    どれくらいの規模になったか

    要件を決める → 設計 → 作る → テスト → 確認、の順で進めました。途中で、わたしが止まって判断する場所を3か所つくっています。

    ・追加した画面:15画面

    ・作業の数:24件

    ・かかった時間:実質3日(うち約1.5日は、使用量の上限で待っていた時間)

    上限で止まった話は長くなるので、次回に書きます。今回は「決めること」でつまずいた4つの話です。

    つまずき① AIより先に、わたしが表を読めていなかった

    スプレッドシートを CSV にして渡すと、最初に返ってきたのはこうでした。

    「見出しが空欄の列が約20列あります。意味を教えてください」

    質問は6つ。答えられなかったのが1つありました。A列に入っている「済」「●」「▲」です。途中でルールが変わっていて、自分でも意味が分からなくなっていました。結局「無視でいい」と答えています。

    もう1つ。「人数」という列を、AIは人数だと推測しました。実際は、会社ごとの通し番号です。推測は外れていました。

    AIに表を読ませる前に、まず「この列は何か」を書いた一覧(列定義書)を自分で作る。これがないと何も始まりませんでした。

    なお、本物のデータは開発に使っていません。見出しだけ本物で、中身は架空のサンプルを作って渡しています。

    つまずき② 期限の数え方を4往復した

    判断の場所でAIから質問が次々に出てきて、4往復しました。往復のたびに、要件も設計も全部書き直しになります。

    たとえば、こんな質問です。

    「支給申請期限の"2か月以内"、最終日はどう数えますか?」

    普段は感覚でやっていたので、即答できませんでした。最後は、厚生労働省の令和8年度のパンフレットを丸ごと渡して、該当ページで答え合わせをしました。

    要領や手引きは、最初に全部渡す。後から出すと往復が増えます。

    つまずき③ 「総額で比べる」は間違いだった

    キャリアアップ助成金には「賃金を3%以上増やす」という要件があります。

    わたしは最初、「転換前と後の6か月の総額で比べる」と答えました。ところが要領を読み直すと、原則は所定労働時間1時間あたりの金額で比べると書いてありました。総額で比べてよいのは、月給で所定労働時間が変わらないときだけです。

    時給から月給への転換はよくあるので、総額のまま作っていたら判定を間違えるところでした。

    要領に載っている計算例3つは、そのままテストにしてもらいました。

    ・月給20万円 → 21万円:5%

    ・時給1,603円 → 1,693円:5%

    ・時給1,250円 → 1,313円:5%

    画像

    実務で毎日やっている「いつもの手順」ほど、言葉にすると間違っていました。

    つまずき④ 期限が1日ずれた

    支払日が6月30日だと、申請期限はいつでしょうか。

    AIの最初の答えは、「2か月後の同じ日」の8月30日でした。

    正しくは8月31日です。民法の期間の数え方では、翌日の7月1日から数え始めて、2か月後の同じ日の前日が期限になります。月末払いの会社だと、1〜3日ずれることがあります。

    早いほうにずれているので、不支給にはなりません。それでも、正式な期限を間違えて表示するのは困ります。境目になる日付は、わたしから指定してテストに入れてもらいました。

    ・10月15日 → 12月15日

    ・6月30日 → 8月31日

    ・12月31日 → 2月28日(うるう年は2月29日)

    AIは、それっぽい日付を出します。境目のケースは、人間が指定する必要があります。

    画像

    うまくいったこと

    ・「決める人」と「作る人」を分けた。わたしは判断の場所で答えるだけ。作るのとチェックはAI側で回してもらいました

    ・迷ったら「データを消さず、警告を出す」。この方針を最初に決めたら、細かいところはAIが自分で判断して進めてくれました

    ・確認が終わるまで本番には触らない。これも最初にルールにして、実際に守れました

    おわりに

    AIに作ってもらって、いちばん時間がかかったのはコードではなく、自分の仕事を言葉にすることでした。

    でも、そのとき書いた「決めたことの一覧」が手元に残りました。これまで頭の中にしかなかったものです。いちばんの成果は、アプリよりもこっちだったかもしれません。

    次回は、一晩動かしたら週の使用量が92%になって止めた話と、パソコンを閉じても動くようにクラウドへ移した話を書きます。

    あなたは、自分の仕事のルールを人に説明できますか? それとも、手が覚えている派ですか?

    関連記事


    あなたへのおすすめ