所得税の確定申告書をA4の様式の見た目で描く:第一表と第二表の試作から、青色申告決算書、収支内訳書、消費税の付表まで事例ごとに広げる

開発eurekapu-nuxt4

所得税の確定申告書をA4の様式の見た目で描く:第一表と第二表の試作から、青色申告決算書、収支内訳書、消費税の付表まで事例ごとに広げる

Excel の参照をたどるビューアー(excel-books)では、法人税の別表を国税庁の PDF の紙面に寄せて見せる表示を、11月13日から進めている(法人税申告書の別表をPDFの紙面に寄せて無限キャンバスに置く)。 この日はその所得税版に取りかかり、所得税ブックのシートを「申告書の見た目(A4)」に切り替えられるようにした。 セルの番地、式、値はそのままにして、並べ方だけを申告書の様式に寄せる。

様式には年がある。 既存の所得税ブックの第一表は令和3年分の様式で組んであり、国税庁の今の様式は令和7年分である。 事例の年と様式の年がずれるとき、紙面はどちらに合わせて描けばよいのか。

計画を立てて、第一表と第二表を試作する

12:22 に始めたセッションには、e-Tax の仕様を分析したリポジトリの名前と所得税ブックの URL を渡して、計画を立てさせた。 調べものは2本のサブエージェントに分けさせた(e-Tax の分析リポジトリの中身と、所得税ブックと別表の表示の作り)。 計画書の図には試作に使う事例の第一表の実数を入れさせ、令和7年分の第一表の様式を画像にして欄の並びを確かめさせた。 計画書は Codex のレビューに2回かけた。 1回目の指摘2件(第二表の文字と日付の欄、欄の取り違えを見つけるテスト)を反映すると、2回目では致命的な指摘が出なかった。 判断4件はフォームで答え、4件とも推奨どおりにした。 実装は「引き継ぎのセッションを作ってください」と頼んで、新しいセッションに渡した。

13:13 に始めた試作のセッションでは、令和7年分と令和3年分(申告書B)の様式を国税庁から取らせた。 令和3年分の第一表は、計画にあった読み替えの表と一致した。 ブックのセルも書き出させると、第二表の続柄が、書き起こしでは「配偶者」なのにブックでは「妻」になっていた。 実装の前に基準を取らせると、テスト 720 件がすべて通り、型チェックは 0 件だった。

欄の行き先は、様式の画像から手で作った正解の表と照らすテストで守らせた。 社会保険料控除と基礎控除の行き先をわざと入れ替えると、テストは落ちた。 Chrome で開くと、第一表は A4 の枠 1123px に対して中身の下端が 1034px で収まった。 ただし縦書きの小さな欄名(総合譲渡、延納の届出)が枠からはみ出し、⑰と⑱の数字が折り返していた。 縦書きの欄には改行を入れるかどうかを欄ごとに選べる指定を、数字の欄には大きさの指定を足させた。 それでも幅 22px の列に2列の縦書きが収まらず、幅と文字の大きさを詰めさせて、はみ出しは無くなった。

欄にポインタを乗せると、同じシートの中なら矢印(⑫ 合計 = C6+C7)、別のシートならのぞき窓(㉛)が出る。 第二表の続柄に乗せると、家族のシートののぞき窓が出た。 第一表の C9 の欄を押すと参照元の「所得控除の計算」G6 へ飛び、「↩ 第一表 C9」で戻れた。 無限キャンバスでは 20 枚のカードが重ならずに並んだ。 e-Tax の帳票間のチェック19件のうち、この事例に当たる3件もテストに足させた。

途中で、助言役のモデルが回数の制限で使えなくなった。 使えないときは Codex に相談してよいと伝えると、実装と計画書の突き合わせを Codex に見てもらう形に切り替わった。 指摘は medium 3件と low 1件で、部品のテストを足して補強させた。

試作を開いて、こう返した。

第1表と第2表、確かにね、決算の申告書っぽくなってて非常に良いですね。

続けて、決算書の1、2、3ページと減価償却の所、給料賃金の所にもおそらく様式があるので、そこまでやってほしいと頼んだ。 これも引き継ぎのセッションに渡した。

給料賃金の重複を削るか

引き継ぎのセッションが立ち上がったあとで、給料賃金の情報が二重に入っている気がした。 「もともと重複してるんじゃないんでしたっけ」と聞くと、もともと重複している、という答えだった。 書籍の資料が、損益計算書の側で給料賃金の合計 2,000,000 円を出し、給料賃金の資料の側で人ごとの内訳(給与 1,800,000 円と賞与 200,000 円)を出しているという。

それなら引き継ぎのセッションに削ってもらえばいいと思い、そう持ちかけた。 返ってきたのは、今の形は残すほうがよいという意見だった。 打ち込みが二重なのではなく、書籍が合計と内訳を別々に出していて、それを照合しているからだという。

あ、そうなんだ。一緒の方がいいんだ。書籍の通りなんだ。そうなんだ。じゃあ残すか。

横向きの青色申告決算書

14:39 に始めた決算書のセッションでは、令和7年分と令和3年分の決算書の様式を画像にして読ませた。 国税庁の決算書の様式は横向きなので、紙面の部品に横向きの A4 を足させた。 幅 1900px の画面だと、横の紙がシートごとの表示の枠から右へ 87px はみ出して隠れた。 はみ出すときは枠の中で横にスクロールする形にさせた(のぞき窓は body に出すので切れない)。

3ページのテストでは、わざと壊したのに落ちない壊し方があった。 資産の並びを逆にする壊し方は、名前と値が一緒に動くので誤りにならず、通るのが正しい動きだった。 名前と値をずらす壊し方に変えて、確かめ直させた。

Chrome DevTools MCP は4回試して4回とも接続待ちのまま時間切れになり、描画は Playwright で測らせた。 同じ症状の issue(11月12日)には、再発として追記させた。 最後にもう一度つなぎ直すとつながり、自分の Chrome(幅 3072px)でも3枚とも A4 横に収まった(中身の下端は 581px、693px、719px)。 紙面は最終的に4ページ(貸借対照表)まで作り、横のままでよいことはフォームの判断で答えた。 全体のテストは 541 ファイル、26,262 件がすべて通り、型チェックも 0 件だった。

3つのセッションに分けて事例を広げる

残りの事例は、3つのセッションに分けて広げることになった。

その前に、共有の部品のフォルダ(common/)に、家族のシートを変えた未コミットの変更が残っていた。 別のセッションのコミットを待てばいいのではないか、そちらにメッセージを送っておけばいいのではないか、もう送ったのか、と聞いた。 まだだったので送ってもらうと、送った先からは持ち主ではないという返事が来た。 そのあとで、変更は今日の 12:05 ではなく11月5日 12:05 のものだったと訂正が入った。 時刻だけを見て、日付を見落としていたという。 「今の形でコミットでいいんじゃない?」と返して、そのままコミットさせた。

コミットのあと、共有の紙面のファイルを整理し、3つの事例の受け皿(空の登録ファイル3つと、事例の一覧につないだ事例ごとの雛形)を先にコミットさせてから、セッションごとの指示書を書かせた。 立ち上げは、CPU を測りながら1本ずつ進んだ。 1本目(青色申告の弁護士の事例)は、CPU 50%、空きメモリ 30GB の時点で立ち上がった。 直後に CPU が 84%、92% と上がったので、20秒ごとに測って 36% まで下がるのを待ってから、2本目(不動産所得の事例2件)が立ち上がった。 3本目(白色申告の弁護士の事例)は、CPU が 30〜90% を行き来していたので、60% 以下になったら立ち上げる形になった。 3本そろったあとは、CPU が約 54%、空きメモリが 33GB だった。

共有の紙面のファイルに足りない欄は、ほかの3つのセッションがメッセージで頼み、決算書のセッション(まとめ役)が足して知らせた。 頼まれたのは、青色申告の弁護士の事例が第二表の所得の内訳の欄(uchi1、uchi2)、不動産所得の事例が事業税の欄2つ、白色申告の弁護士の事例が内訳の3つ目の欄(uchi3)と personOf の直しである。 不動産所得と白色申告の弁護士のセッションは、共有のファイルに触っていなかった。

途中、CPU が 96% で高止まりした場面もあった(空きメモリ 22GB)。 dev サーバー(3200番)で今朝と同じ 0xC0000142 のエラーが出たときは、白色申告の弁護士のセッションが、立て直すとほかのセッションに知らせてきた。 18:25 から流した全体のテスト(約35分)では、落ちたのは参考書の記載例のセッションの変更だけで、申告書風の分は全部通り、型チェックも 0 件だった。 落ち着いたところで CPU は 13%、空きメモリは 34GB になり、見張りもそこで止まった。

試作で見つかった第二表の続柄の差は、ここで決めた。 家族のシートはそのままにして、第二表のセルだけを書籍の書き方にする案に「Y」と返した。 紙面では、ある家族の障害者の欄が「特障」、別の家族の欄が空欄、専従者の続柄が「配偶者」と、書籍と同じ文字で出るようになった。

消費税の付表をどの版で描くか

17:12 に始めたセッションは、青色申告の弁護士の事例(給与あり、還付)の担当である。 範囲は第一表、第二表、青色申告決算書の1〜4ページ、消費税の付表と申告書で、あわせて10様式だった。 最初の6様式は A4 に収まり、テスト 43 件が最初から通った。 そこで行き先をわざと4か所入れ替えて、4か所ともテストが落ちることを確かめさせた。

消費税だけは判断が要るとして、判断のページが用意された。 推奨は A で、ブックにすでにある付表4-1と5-1のまま描く案だった。 まとめ役のセッションには、何を判断すればいいのかをターミナルに出させた。 17:12 のセッションには、年度ごとに版を合わせるのはだめなのか、1対1で描けない年度があるなら、その年度に合わせた付表の紙面を別に作ればいいだけではないか、と聞いた。

返ってきたのは「違いません。」だった。 事例ごとに版を合わせるのが正しいとして、推奨の A は取り下げられた。 しかも、事例ごとに版を選ぶ仕組みはすでにあった。 消費税のシートを組む共通の部品は事例ごとに form: '4-3' を選べて、令和2年分の消費税だけの事例は、もう付表4-3と5-3で組んであった。

「Ok」と返すと、この事例の付表のシートはまとめ役のセッションで付表4-3と5-3に切り替わった。 続いて、消費税の紙面4枚(付表4-3、付表5-3の1ページ目、消費税の第一表(簡易課税用)、第二表)が組まれた。 令和2年分の事例で当てた欄がすべて紙面に出て重なりが無いこと、取り違えを4通り入れると4通りともテストが落ちることも確かめさせた。 これで依頼の10様式は10様式とも描けて、残りは決算書3ページの書き方の判断1件になった。

令和2年分の事例では、別の指摘も上がってきた。 消費税の第一表の参考事項「課税売上高(千円)」は、円の値に千円で見せる表示形式をかけて出している。 この表示形式は千円未満を四捨五入するので、第4種の 254,545 円が「255」と出る。 ここはまだ直していない。

iPad で見た収支内訳書

17:20 に始めたセッションは、白色申告の弁護士の事例(給与あり)の担当で、範囲は第一表、第二表、収支内訳書(一般用)の表面と裏面である。 収支内訳書は令和7年分と令和3年分を見比べさせた。 表面の左は欄番号と並びが同じで、違うのは令和7年分の「区分」の欄と ⑳ の※だけだった。 テストは 38 件すべて通り、4枚とも A4 に収まった。

報告を受けて、こう頼んだ。

4枚の見た目なんですけど、これスクリーンショットを撮ってこのターミナル上で共有してもらえますか。今 iPad で見てるんです。

あわせて、書籍が空欄でも値が 0 なら 0 で構わない、書き起こしどおりなら問題ないと伝え、全部問題なくいったのかと聞いた。

撮らせようとすると、まず dev サーバーの目録の API が 503 を返し、立ち上がるのを待つことになった。 撮れた画像には見切れが2つあった。 横の紙(収支内訳書)は右端が切れていたが、欠けていたのではなかった。 幅 1900 の画面では表示の枠(1036px)より横の紙(1123px)が広く、横にスクロールする状態だったので、幅 2400 で撮り直させた。 縦の紙は画面の高さで下が切れていて(第二表の住民税と事業税の欄)、高さも広げて撮り直させた。 4枚を送ってきたあとの答えでは、頼んだ範囲は全部できていて、決めることも残っていなかった。

並行して進んだ、参考書の記載例12件のブック

16:18 に始めたセッションでは、所得税の参考書(令和5年分)の記載例12件を Excel ブックにしていた。 試作の2件目のコミットは、Codex のゲートで止まった。 扶養親族の所得要件が式から抜けているという指摘で、今の数字では結果は変わらない。 それでもセッションの側で中身を読み、high 相当と判定して、式を直してからコミットさせた。 残りの記載例のうち、判断に左右されない5件はサブエージェント(Opus)に分担させた。

判断のフォームは7問あったが、iPad で見ていたので、全部ターミナルに出してもらった。 1問目は、記載例3件の決算書と1件の住宅の明細書を、どちらも起こすことにした。 照合できる値は無くても最終的な値は照合できるので、内訳は仮定の値で構わないと答えた。 寄付先の名称や借入先のような文字の欄は、税務申告ソフトに取り込んで出力した帳票を見て直すので、可能な限り全部載せると決めた。 2〜4問目にもその場で答え、残りは推奨どおりにした。 仮定の内訳は、最後の1科目を「総額 − ほかの科目」の式にして、総額は設例と必ず合うように組ませた。

最終的に記載例12件と収支内訳書2件の計14ブックが入り、全体のテストは 26,899 件が通り、型チェックのエラーも 0 件だった。 14ブックとも Excel で全体を再計算し、エラー、####、外部リンクは 0 だった。 収支内訳書(一般用)では、書籍の値と法令どおりの計算が合わない所が4か所あり、式は書籍に合わせて曲げずに比較の表を置かせた。

このセッションの変更は、決算書のセッションが 18:25〜18:55 の全体テストで見つけた3つの落ちにつながっていた。 出してはいけない言葉の検査が、国税庁の手引き(政府の著作物の出典の表記)にも当たっていた。 その言葉は、市販の書籍だけを指す言い方に絞られた。

振り返り

第一表では、令和7年分と令和3年分の様式を読み替えの表でつないだ。 消費税の付表でも、最初の推奨はブックにある付表4-1と5-1のまま描く案だった。 年度ごとに版を合わせればいいのでは、と聞いたところで、事例ごとに版を選ぶ仕組みがすでにあったと分かり、付表は事例の課税期間に合う版で描くことになった。

学びメモ

  • わざと壊して落ちるかを確かめるテストでは、名前と値が一緒に動く壊し方だと、落ちないのが正しい動きになる。名前と値をずらす壊し方を選ぶ
  • スクリーンショットの見切れは、表示の崩れとは限らない。表示の枠と紙の幅、画面の高さを先に見る
  • 共有の紙面のファイルに足りない欄は、ほかのセッションがメッセージで頼み、まとめ役のセッションが足した。この形で3つの事例が並んで進んだ
  • 未コミットの変更の持ち主を探すときは、時刻だけでなく日付まで見る(今日の 12:05 と思った変更は、11月5日のものだった)
#所得税#確定申告#青色申告決算書#消費税#A4印刷#Claude Code#Codex#複数セッション