所得税の設例をExcelでたどる教材の素材探し:蔵書の調査から計画書6本と指示書11本まで
所得税の設例をExcelでたどる教材の素材探し
ある出版社の設例ブックを、excel-trace のビューアで開いたところから一日が始まった。 excel-trace は、Excel のセルの参照を Web 上でたどる開発用のページである。 同じ形で、所得税の設例も追えるようにしたい。 最初に当たったのは、国税庁の「確定申告の手引き」(令和7年分)だった。
手引きの次に、蔵書を当たる
Claude Code に手引きの PDF を取ってこさせ、記載例の数字を読ませて計画書の初版を書かせた。 Codex のレビューでは、寄附金の税額控除 14,000 円の出どころを問われ、2回目で承認が出た。 判断事項の D1〜D4 には、計画書の HTML に付けた回答ボタンで答えた。
D1 には音声入力で答えた。 蔵書にある所得税の本から、決算書から申告書まで数字が通しでつながる事例を使う。 古い年分でもよく、税率や控除の額は令和7年分に置き換える。 そういう趣旨だった。 音声入力は「よしなに」を「吉田に」、「通しで」を「投資で」と書き起こしていた。 Claude Code はそれを読み替えたうえで、違っていたら教えてほしいと返してきた。
問題は、そんな本が手元にあるかどうかである。
4組の候補を調べさせる
Turso の蔵書 DB を検索し、所得税の本の候補4組を、サブエージェントに1組ずつ調べさせた。 報告は1組ずつ戻ってきた。
- 1組目:決算書から申告書まで数字はつながる。ただし所得は事業所得だけで、控除の内訳の一部は図の吹き出しに隠れて読めない。総合の事例には向かない
- 2組目:資料から決算書、第一表の所得、所得控除まではつながる。しかし課税所得から税額の行が合わず、配当、株式の譲渡、外国税額控除は本の中で数字が食い違っている。候補には残すが、そのままでは使いにくい
2組続けて、数字はつながるのに使えない、という報告だった。 ここで方針を一つ決めた。 使える本が見つかったら、その最新年度版を買う。 まず手元の古い年度で組み、購入後に数値を置き換える。 年度が変わっても、計算のロジックは同じだからだ。 Claude Code からは、置き換えが数字だけで済むようにブックを作る、という返事があった。
3組目の報告で流れが変わった。 決算書の所得が第一表の欄にそのまま入る通しの事例が、令和3年分で3つある。 4組目の報告もそろったところで、3組目の参考書にある青色申告の事業所得の設例を中心に、計画書の D1 を書き直させた。
Codex の再レビューは、新しく足した D6「年分の切り替え」を指摘した。 年分を切り替えると、年齢や取引の年まで一緒に動いてしまう。 年分を数字の一つとして置き換えると、変えたくない欄まで変わる、という指摘である。 D6 を直させて承認をもらい、D5 と D6 を足した第2版の計画書にまとめさせた。
書き起こした設例が58か所で一致する
参考書の該当ページを 200dpi の画像にして Claude Code に読ませ、資料を JSON に書き起こさせた。 資料の数字だけから解答を計算し直すと、照合した58か所がすべて一致した。 計画どおり、組み立てに入る前で止まった報告に、「Y」とだけ返して先へ進めた。
組み上がったブックは21シートで、第一表の申告納税額まで、資料からすべて式でつながった。 ブラウザと Excel の両方で、書籍の解答と照合した436セルはすべて一致し、検算の53セルはすべて0だった。 参照元の本を聞き直しながら、自分でも数字を確かめた。 完璧に近いと思った。
手引きに足りないのは決算書の側
このパターンが通るなら、国税庁の手引きでは何が足りなかったのか。 改めて聞いた。
足りないのは、第一表の記載例にある事業所得 5,367,200 円と不動産所得 1,279,200 円を生む、決算書の側の数字だった。 損益計算書の売上や経費の内訳も、貸借対照表も載っていない。 申告書の側は閉じていて、所得 8,170,400 円から課税所得 2,960,000 円、税額 198,500 円、申告納税額 167,900 円まで、手引きの計算どおり端数まで合う。 手引きだけでは、申告書に載る所得の出どころを決算書までさかのぼれない。
事例ごとに計画書を分けられるか
次に、10問載っている総合計算の問題集も、申告書の計算の流れに当てはめられるか聞いた。 あわせて、同じ参考書の残り2例と、ある入門書の数値例も取り込みたいと伝えた。 入門書は確定申告の基礎だけを取り上げているので、数値例として取り込むにはいいと考えた。
それぞれを独立した計画書にすれば、セッションを分けて一気に進められる。 計算ロジックが同じなら、データの取り込み方も同じにできるはずだ。 そう考えて聞いたところ、独立した計画書にはできるが、先に共通の土台を1回だけ作ってから分けたほうが安全だ、という答えだった。 取り込み方はほぼ同じだという。 推奨の順で進めてもらうことにした。 セッションを分けて共通化が難しくなるなら、逐次実行で構わない、とも伝えた。
Claude Code は、先の調査記録を読んで同じ本を読み直さないようにしたうえで、残りの3組をサブエージェントに調べさせた。
- 同じ参考書の不動産所得の2例:どちらも第3期分の税額まで閉じていて、読めない数字はない
- 入門書:白色と青色の2例とも、第一表まで閉じている
- 総合計算の問題集:3組のうち最後に報告が戻った
計画書は、共通の土台①、不動産所得の2例②、入門書③、問題集④と、4本をたばねる親の計画書の5本になった。 調査メモはセッションの一時フォルダに置かれていて、あとで掃除される。 後のセッションが読めるよう、リポジトリにコピーさせた。
Codex は、5本のレビューで止めるべき指摘を1件出した。
計画①が使う予定の import.meta.glob は、Vite を通したときにしか動かない。
xlsx の書き出しはビルドを Node で直接走らせるので、そこで壊れる。
計画①を直すと、承認が出た。
親の計画書の決裁フォームで、5問に答えた。 消費税の問いには、以前のプロジェクトで作った消費税の計算を指して答えた。 回答を計画書に入れさせた。 ④は全20問を対象に書き直し、消費税は別の計画⑤として足すことになった。 Codex は⑤にも穴を見つけた。 旧サイトの75%ルールの判定が実装されておらず、常に大きいほうの控除を選んでいた。 これを⑤に足して、全部の計画書が承認になった。
1セッションでは終わらない
計画書が何本も並んだのを見て、進めるのは1セッションなのかと聞いた。 答えは、1セッションではなく、計画書ごと(④は段ごと)に分けて順に進め、全部で約10セッションというものだった。
それなら、引き継ぎのプロンプトもセッションごとに違うはずだ。
Downloads に、各セッションへ渡す指示書を書き出してもらうことにした。
最初の書き出しは失敗した。
スクリプトが長く、引用符だらけで、シェルが解釈できなかった。
スクリプトをファイルに書いてから実行する形に変えると、書き出しが通った。
指示書は11本になり、最初は 01-土台と不動産.md を新しいセッションに貼り付けて始める。
最後にコミットさせた。 計画書6本(md と html)、判断の選択肢と回答の json、図、調査メモ、検算スクリプト2本で、20ファイルである。 Codex のコミットレビューでも、止めるほどの指摘はなかった。
夕方、1本目の指示書を渡したセッション
1本目の指示書は、別のセッションに貼って始めた。 そのセッションが最初の手順で計画書をコミットしようとすると、計画を作ったセッションが同じ時刻にコミットを済ませていた。 1本目のセッションは夕方までに、共通の土台①と不動産所得の2例②を作り終えた。
今日はここで終えることにした。
引き継ぎのプロンプトを Downloads のテキストファイル(shotoku-handoff-2026-11-02.txt)に書かせ、ここまでの進捗を計画書に書き戻してコミットさせた。
学びメモ
- 4組のうち2組は、数字がつながっていても教材には使えなかった。所得が事業所得だけだったり、税額の行が合わなかったりした
- 古い年度で組んで後から数値を置き換える方針は、年分を切り替えると年齢や取引の年まで動く、という指摘を受けて、数字だけの話ではなくなった
- 計画書を分けると、引き継ぎもセッションの数だけ要る。指示書を11本書き出し、1本目はその日のうちに別のセッションへ渡した
最新年度版の参考書は、まだ買っていない。 数値の置き換えが本当に数字だけで済むかは、購入してから試すことになる。