所得税の計算ロジックをウォーターフォールチャートで見せる:計画書から専用キャンバスの実装、速算表の直しまで

開発eurekapu-nuxt4

所得税の計算ロジックをウォーターフォールチャートで見せる:計画書から専用キャンバスの実装、速算表の直しまで

所得税の申告書作成の問題集を、Excel のブックにしたものがある。 その計算の流れを、ウォーターフォールチャートで見せたかった。 手元には手書きのラフがあった。

朝8時のセッションで計画書を作らせ、8時44分のセッションで実装に入った。 実装が動き出してすぐ、「これ個人的にめちゃくちゃ楽しみにしてるんで、引き続きお願いします」と送っている。 その日のうちに、「まだできないですかね」と聞くことになる。

計画書は見本の図から作った(08:06)

まず手書きのラフ(SVG)を Chrome で開かせ、ブックのコードと突き合わせさせた。 見本の図には、ブックから取り出した本物の数字を使わせた。 使ったのは、基礎の問題と応用の問題の1問ずつである。 図は4枚から5枚に増えた。

判断フォームを出すまでに、計画書を Codex に3回レビューさせた。 1回目の指摘は、行の対応と定義の受け渡しの2点だった。 2回目には、山林所得の5分5乗と、ある1問だけにある例外が指摘された。 指摘を入れるたびに、再レビューにかけさせている。

計画書は判断フォームつきで Chrome に出してもらい、3つの判断を選んで送った。 回答は計画書の §9 に入り、コミットまで済んだ。 このセッションは計画までと決めていたので、最後に実装用の新しいセッションを立ち上げさせた。 その名前には「ウォーターフォールだけの無限キャンバスの実装」と入っている。

置き場所を専用のキャンバスに決めた(08:44)

実装のセッションでは、サブエージェントを2体出させた。 Step 1 と Step 2 を書く実装役と、20問それぞれで「計算のどの役割がブックのどの行か」を調べる調査役である。

  • Step 1(純粋関数とテスト)は 28件 pass。Claude Code にも自分で流して確かめさせた。応用の問題で、辺の計算は約 14ms だった
  • 調査は 227件 pass。基礎の問題と応用の問題は、答案の全行と一致した。計画との食い違いは計画書 §9-6 に書き足させた
  • ここまでをコミットした(db7069a67)。Codex は「無限大の値を検算が見逃す」を high と判定したが、Claude Code の判定は low だった。評価器は 0 除算をエラーで返すので、その値が来る経路がない、という判断である。1行で直せたので直した
  • Step 2 のコミットでは、ピンチで拡大したあとに指を1本離すと倍率が戻る、という指摘が Codex から出た。こちらは Claude Code も high 相当と判定した。iPad やスマホで触ると必ず起きる、というのが理由だった

Step 2 では、置き場所の案を2つ作らせて切り替えられるようにした。 今あるキャンバスに乗せる案 A と、ウォーターフォールだけの専用のキャンバスに置く案 B である。 案 B でよいかと聞かれ、案 B で進めると返した。

自分からは、「税率の枝」と「所得控除の別カード」の2点を指摘した。 どちらも案 B の側に入った。 Claude Code のレビューでも、別に4点が見つかっている。 速算表の写しの式に段の番号をじかに書いていること、使った行がマウスを乗せないと分からないこと、Excel のカードと棒の間がつながっていないこと、所得控除の線が税率の文の横を通ることだ。 あわせて、速算表を既定で開いた形にすること(?wfrate=closed で閉じた形も残す)と、歯車の「開く」が押せない件も実装役に渡してもらった。

速算表の「1段目」はいらない

画面の速算表には、行ごとに「1段目」「2段目」と名前が付いていた。 「所得税の速算表の1、1段目とか別にいらないっすよ。書かなくていいっすよ」と送った。

原因は2つ重なっていた。 実装役は、ブック本体の「税率と控除の表」のシートを、行の名前ごと写していた。 そのうえ Claude Code は自分のレビューで、「式に段の番号を直に書かないように、その列を数にして段目と見せる」と指示していた。 外すべき名前を、残す方向に直させていたことになる。

続けて、速算表の見せ方も1つ提案した。 「INDEX MATCHでやる分には別にこれでいいんすけど、せっかくなんでわかりやすくするために」、課税される所得金額の範囲を「以上」と「以下」の2列で金額表示する。 そうすれば、課税所得がどの範囲に入ったかが分かるだろう、と考えた。

もう1つ、なぜ IF にしているのかも聞いた。 答えは「IF でないとダメ、ではありません」だった。 ブック本体の税額の計算も、INDEX MATCH の形になっている。

税率     = INDEX(税率の列, MATCH(課税総所得金額, 以上の列, 1))
算出税額 = 課税総所得金額 × 税率 − 控除額

画面には、INDEX MATCH と IF の2案を両方載せることになった。

「y」とだけ返したら、ブック本体のシートからも名前を外すのかと確かめられた。 所得税の申告書の全部の冊でシートが変わるので、念のための確認だった。 「はい、ブック本体からも外してください」と答えた。 この作業は別の実装役に渡した。 対象は速算表だけでなく、生命保険料、扶養、基礎控除など同じシートの全部の表である。 式と値は1つも変えず、変わるのは名前のセルだけであることを、前後の比較で確かめる段取りにした。

この時点で、ウォーターフォールの画面には自分が指摘した分がすべて入った。 既定で開く形、歯車の直し、以上と以下の2列、段目の削除、INDEX MATCH と IF の2案である。 残りは、Claude Code が自分の確認で見つけた見た目の3点だった。

11:22 に落ちて、引き継ぎで再開した

Excel のカードの直し3点と「段目」を外す作業の途中で、11:22 に端末ごとセッションが落ちた。 原因は 別の記事 に書いた。

11:49 に引き継ぎのセッションで再開した。 Excel のカードの直し3点は入っていて、ブック本体の「段目」も外れていた。 コミットは、こちらの了承を待つ形で止まっていた。

スキルにしたら、デザインの話が載っていなかった

再開した時点で画面に出るのは、基礎の問題だけだった。 次の応用の問題は、Opus の実装役に渡した。

ウォーターフォールは、全コンテンツに広げていくつもりでいる。 スキルとしてしっかり育てる前提を伝えて、プロジェクトにスキル waterfall-chart を作らせた(751fa9bda)。 ブラウザで表示してほしいと頼むと、決まり、指示の記録、実装の3つが1枚に並んで出てきた。

「意外とそのウォーターフォールチャートをどうデザインするかみたいな話とかは載ってない気がするんですけど」と送った。 そっち系のスキルだと思っていたのに、その方向性はあまり書かれていなかった。 Claude Code も、最初の版には「どう描くか」が足りていなかったと認めた。 「図のデザイン」を references/design.md に足させた(a28085fd0)。

応用の問題は、繰越控除の形で一度食い違った

「これね、楽しみにしてるんですけど、まだできないですかね」と聞いた。 まだ見せられる状態ではなく、応用の問題の定義が約280行書けたところだった。

そのあとラフを読ませ、普通のウォーターフォールでは描けない所を6つ拾わせた。 案を図にした討議用のページに、選択肢のボタンを付けて出してもらった。 ところが繰越控除について、Claude Code はこちらのイメージと違う結論を出してきた。 スクリーンショットで返すと、Claude Code はその結論を誤りだったと認めた。 繰越控除は、こちらのイメージどおりカードの形で作ることになった。 積み上げ棒の、区分の高さで引く形である。 全体は積み上げ棒とレーンの形に決まった。

作り直しを待つあいだ、「OK。これだからまだ途中ってことっすよね」と確かめている。

作り直しが上がると、関係するテスト 309件が通った。 Claude Code が Chrome で撮るスクリーンショットは途中で固まったので、先に実装役が撮った画像で確認していた。 あとから届いたスクリーンショットでは、キャンバスの段 II〜V が横に4列で収まり、カードの重なりも、線がカードの上を通る所もなかった。 ただ、段 I は9枚のカードが縦に長く並び、「全体」で見ると 38% まで縮んで文字が読めなかった。

3列をすすめられ、測ると2列だった

38% の画面を見て、段 I を1列ではなく2列とかに分けてもいいし、なんなら3ぐらいの方がいいかもしれない、と送った。 Claude Code がすすめてきたのも3列だった。 9枚がちょうど3行×3列になり、段 I の高さがほかの段とそろう、という理由である。

ところが測ってみると、「全体」を押したときの倍率は3列より2列のほうが高く、文字が大きくなった。 3列のすすめは、Claude Code が自分で訂正した。

途中で進捗の更新も頼んでおき、計画書の §9-4 で Step 2 と基礎の問題の Step 3 を完了にしてもらった。 応用の問題の作り直し、段 I の複数列、スキルの追記、計画書の進捗をまとめて、17ファイルをコミットした(6ca42e42b)。 Codex のレビューは、重要な指摘なしで通った。 続きの確認は翌朝6時にやることにして、カレンダーに登録してもらった。

申告書風の窓は「乗せている間だけ」出す計画に(12:44)

並行して 12:44 のセッションでは、同じリポジトリで別の表示の計画を作らせていた。 ウォーターフォールではなく、申告書風の表示で数字にマウスを乗せたときに出る窓の話である。 判断は2つ選んだ。 全部の窓を紙面にする案と、無限キャンバスで関係するシートを寄せる表示もいっしょにやる案である。

そのあと、「乗せている間だけ出る形でいいので、計画を書き直してください」と頼んだ。 自分は 4K の画面で見ている。 右側をどこまで出すかは、作ってみて考えればいいと思った。 今は、マウスを乗せた数字のすぐ右横に表が出る。 これを第1表の真横に高さをほぼそろえて出し、数字からマウスを移しても消えないようにつなげるほうがいいのではないか、と送った。 この挙動にするのは申告書風のときだけで、Excel 風のときは今の Excel の挙動のままにする。 申告書風で見づらければ、Excel 風に戻せばいい。

計画は「申告書風のとき専用の新しい部品を作り、本体の真横に帳票を丸ごと出す」形に書き直してもらった。 Codex は指摘なしで通った。 今日は厳しそうなので、実装のプロンプトを説明欄に入れて、翌朝 6:00〜6:30 の予定としてカレンダーに入れてもらった。

夕方の時点

  • 計画書(判断3つの回答は §9)
  • Step 1、Step 2、基礎の問題の Step 3
  • ブック本体の「税率と控除の表」から「段目」を外す
  • スキル waterfall-chart と、図のデザインの追記
  • 応用の問題(積み上げ棒とレーンに作り直し、段 I は複数列)。自分の目での確認は翌朝6時
  • 申告書風の窓を本体の真横に出す実装。計画の書き直しまでで、実装は翌朝6時

振り返り

  • 「1段目」は、ブック本体から写した行の名前だった。Claude Code のレビューはそれを消さず、見せ方を整える方向に直させていた。外すと決めたのは、画面を見て送った自分の一言だった
  • 列の数は、自分も Claude Code も3に傾いていた。「3行×3列でそろう」という見た目の理屈は、「全体」の倍率を測った数字に負けた
  • スキルは、ブラウザで1枚に並べて読んだところで、デザインの話が無いことに気づいた
#所得税#ウォーターフォールチャート#Excel#無限キャンバス#Claude Code#Codex#サブエージェント