所得税のウォーターフォールチャートを手描きのラフと突き合わせて直す:並び順の決まりをスキルに書き残すまで

開発eurekapu-nuxt4

所得税のウォーターフォールチャートを手描きのラフと突き合わせて直す:並び順の決まりをスキルに書き残すまで

朝6時、CPU が張り付かないように引き継ぎのセッションを1本ずつ立ち上げさせていた。 その途中で、ウォーターフォールチャートは2列のほうが見やすいと思った。 前に共有していた手描きのラフ(SVG)を、Chrome で開いてもらった。 前日までの経緯は計画書から専用キャンバスまでの記事に書いている。

ラフに描いた所得の並びは、自分の理解の範囲で描いたものである。 それで合っているのかを、この日のうちに Claude Code へ聞き返すことになる。

朝の引き継ぎの合間に、フィードバック用のセッションを立てた(06:02)

ラフを開いたあと、「2列の方が見やすい」という判断はまだ計画書の §9-4 に書いていない、書くなら言ってほしい、と返ってきた。 続けて、計画書とセットで新規のセッションを1つ立ててもらった。 フィードバックしていきたいし、ウォーターフォールは自分の中で結構重要な位置付けにある。 そのままスキル化していく話もあった。 新しいセッションには、計画書の §9 とスキル waterfall-chart を読み、今の画面を確かめてから、まだ決まっていない4点を出してフィードバックを待つように頼んでもらった。

もう1つ、申告書風の覗き窓は変更が大きいのか、ほかのセッションが動いているときにもできるのか、worktree を使えば独立してできるのかを聞いた。 答えは「変更の規模は中くらい」で、main のままでも並べて進められるが、いまは worktree で分けたほうが安全だという。 それならと、worktree で「申告書風ののぞき窓の実装(worktree・:3201)」というセッションを立ててもらった。

ラフの並びを確かめ、通達の順にそろえた(07:49〜)

07:49 に、フィードバックとスキル化の続きを受け持つセッションが動き出した。 計画書とスキルを読ませ、2列の既定から確かめさせている。

最初のフィードバックを受けて、並び順をラフの SVG と突き合わせてもらった。 ラフの並びは、総合 ①〜⑧ → 分離 → ⑨山林 ⑩退職 である。 定義を所得の番号順に並べ替え、マゼンタの丸で番号を入れてもらった。 基礎の問題の画面が崩れていないことも確かめてもらい、所得控除の目盛りといっしょにコミットした。

分離課税の階段についても指摘した。 ラフの階段は、下の区分(⑩退職)から積み上げ、上端の点線が束の区分の境目にそろう形になっている。 一時所得と分離課税の階段はサブエージェントに渡し、その間にスキルへ目的の文と目盛りの決まりを足させた。

そのあと、気になっていたことを聞いた。 「先物も6万でいいですよ」と送り、続けて「逆に聞きたいんですけど、この並び方で問題ないんですか?」と聞いた。 基礎から応用まで全部の論点を Claude Code はもう計算ロジックにしているので、自分よりも詳しいかもしれないと思ったからだ。

返ってきた答えは、出典(措置法通達 31・32共-4)で確かめたというものだった。 この並び方で問題はなく、直したほうがよいのは分離課税の中の1か所(上場株式等の譲渡と一般株式等の順)だけだという。 先物は「⑥ で記録しました」とあった。

「通達の順でいいです、一般株式等を先にしてください」と返した。 あわせて、「この並びで良い理由も、スキルの中に一応書いといて、ドキュメント化しておいてほしいですね」と頼んだ。 並びの理由は、スキルに書き込まれた。

メインの2枚を高くし、分からない質問は案の実物で出し直してもらった

画像で2枚のカードを示して、「これメインのチャートなんで、もうちょい見やすくなった方がいいっすね」と送った。 2枚は、段 II の「合計所得金額を足し上げ、繰越控除を引いて課税標準の合計にする」と、段 III の「課税標準の合計から所得控除を引いて、課税所得にする」である。 棒の高さを大きくする指示は、実装中のサブエージェントに伝えてもらった。 報告が上がったあと画面を確かめてもらうと、「上限の丸めをやめたら棒が高くなり、引き出し線が要らなくなったカードがあるだけでした」という返事だった。 直させたのは、テストの条件のほうである。

段の間については、数字との兼ね合いで「もうちょい180ピクセルぐらいでもいいかもしれない」と返した。 一方で、文字だけの質問には答えられないものがあった。 「所得控除の棒が2本か3本か」と聞かれても、何のことかつかめない。 「ラフは間に差し引きの棒ってどこのこと言ってんだろう。ちょっとよくわかんないな」と、音声入力でそのまま返している。

わかりにくかった2つの判断は、研究の画面(案を並べて見比べるための開発用のページ)に、案ごとの実物を並べて見せる、という返事だった。 研究のテーマ「ウォーターフォールの見せ方(判断)」は 8e6d3ad8f でコミットされた。 そのあと、判断1、2、4 に答えた。 判断1 は B を既定にした。 課税所得のカードの行の番号がずれたので、テストをその形に直させた(テスト5本、134件が通過、496182a9f)。 判断2 では、束の数字に乗せたり押したりすると、その数字を作っている四角の色が変わるようにしてもらった(3b3eedf6d)。

速算表のプラスボタンを図に替える

並びを聞く少し前に、超過累進のシミュレーションのページの URL を貼っていた。 見つけてはいたが、まだ載せていなかったという返事で、「そのことをお伝えしていなかったのは私の落ち度です」とも書いてあった。

そのあとで、「超過累進のところって修正してくれてないんでしたっけ?今って速算表のところプラスボタンになってますけど、もうこれをさっきの図にしてほしいんですけど」と聞いた。 まだ直していなかった。 前の返事で「あとで取りかかる」としていたものを、ここから専用のサブエージェントに始めさせた。 目盛りの直しと刻みの図は、まとめて 39aebc4ab に入った。

速算表を消す話は、別のコミットに引っかかった。 下の道具とショートカットの直しをコミットしようとしたら、Codex のレビューが「速算表を消す決まりをスキルに書いたのに、まだ実装されていない」を high として止めた。 スキルの決まりが、実装より先に進んでいたことになる。 このコミットは、最終的に 7007a17c5 として入った。 速算表の行の削除は研究のテーマと同じ 8e6d3ad8f に入り、こちらの Codex のレビューは指摘なしだった(テスト5本、133件が通過)。 判断1、2、4 を既定に入れたあとの本の画面(ブックを表示する画面)では、刻みの図だけのレーン、差引の束、2行の束の名前、合計所得金額の束の左の文字なし、の4つが出たことを確かめてもらった。

配当控除の図が抜けていた

配当控除のところで、ラフとのずれに気づいた。 ラフには、配当控除の計算構造もウォーターフォールで描いてある。 これを可視化しないと、多分どうやって作るのか、という話をしなければならなくなる。 「今回これが省略されてる理由、なんかあったんでしたっけ?」と聞いた。

返ってきたのは「配当控除の図を省いた理由はありません。私たちの見落としです」だった。 前の実装でラフの段 V を細かく読まず、配当控除を納付税額のカードの1行(− 配当控除)にだけ置いていたという。

矢印を数字から数字へつなぐ

画像を1枚送り、「四角のボックスは四角のボックスでいいんですけど、矢印って普通に数字と数字を繋げないんですか、これ?」と聞いた。 線は数字の枠から数字の枠までつなぎ、四角の枠はそのまま残す、という答えだった。 線が途中で止まっていたのは、いつも出している灰色の線(カードの縁から縁へ)と同じ端点を、乗せたときの線にも使っていたからだった。

ウォーターフォールは若干特殊な気もするので、いつもの Excel の画面のコードを直すより、新規に作ってもらってもいい、とも送った。 こちらは心配いらなかった。 キャンバス(WaterfallCanvas.vue)も、カードの置き方も、線の座標と描き方も、ウォーターフォールのために新しく作ったコードだという。 11-18 に案 B(専用のキャンバス)を選んだときに、もう分けてあった。

線の直しは、何度かに分けて進んだ。

  • e27b19416:矢印の作業(灰色の線を数字から数字へ)
  • fa53bcb52:乗せた数字に入ってくる線をマゼンタ、出ていく線を青にし、ほかは灰色のまま。応用の問題の全部の数字で試し、違う線に色が付いた所も、色が付かなかった線も 0
  • 677c02c6a:チェックを外した線は、乗せても出さない

3つめは 13:20 の指摘で、歯車の「出どころ・使われ先の表示」でチェックを外したのに、乗せると青い線が出ていた。 原因は「チェックを外しても、乗せた・押したときだけは色付きで出す」という Claude Code 側の決め方で、それがこちらの考えとずれていた。

線の着け方は、判断5 として研究の画面に並べてもらった。 音声入力で「codex」に化けた案「C」も通じ、判断5 は軸ごとに2つに分け直された。 並んだ案を見て、「いいっすね、この折衷案。まさにこれです、私が求めていたやつは」と送った。 曲げ方は、「90度に曲げるも曲げてもらった方が絶対見やすいんで」と、判断6 の B(90度に曲げて重ねない)にした。 この2つを本の画面の既定にしたのが 62f82d612 で、応用の問題の既定の画面には線が43本ある。

そのうえで、2つ答えた。 重なる所はカードの間を広げること、速算表の枝の線と、線の途中に式を書く線も90度にすることである。 出どころと使われ先を全部オン(60本)にしても重なりが 0 になる幅を、置き方の段階で決める方針になった。 枝の線を90度にし、線が詰まる所だけカードの間を広げた直しは、1cdc2dda8 に入った(テスト11本、472件が通過)。

13,280,000 はどこで使われているか

「なんかここって判定式が入ってるからなんですかね、内部的には」と、所得控除のカードが課税標準の合計とつながっている理由も聞いた。 答えは、実線は判定ではない、というものだった。 控除の金額そのものの計算(足切り)に 13,280,000 を使っているから、実線でつながる。 判定のほうは点線である。

「これ、もし入っていたら私の理解が及んでいないだけなんで、ちょっと教えてもらいたいですね」と重ねた。 13,280,000(総所得金額等)は、雑損控除、医療費控除、寄附金控除の計算式の中に入っている、と返ってきた。 そのあと所得控除のカードを頼み、雑損控除、医療費控除、寄附金控除のカードと、繰越の3年の図が足された(1680eefe3)。 値は答案と全部一致している。

足し上げは上、差し引きは下

課税標準の段の並びにも注文を付けた。 雑損失の繰越控除と先物取引の損失の繰越控除は、「合計所得金額を足し上げ、繰越控除を引いて、課税標準の合計にする」のカードの下にあるほうが多分分かりやすい。 総所得金額の総合課税のところと、4番目になっていたカードを近づけたかった。 この並び替えは cd3639120 に入った。

続けて、段 III でも同じことを感じた。 所得控除は増える方向にしか行かない。 だから「課税標準の合計から所得控除を引いて課税所得にする」が上で、「所得控除を足し上げる」が下、その下に各項目の控除が続くほうが自然だ。 メインの流れから差し引くものは、メインの流れより下に置いてほしい。

計算順位の、ウォーターフォールチャートでいうところの足し上げてるやつっていうのは、やっぱ上の方に置いてほしくて、差し引きしてるやつっていうのは、それより下に計算構造として入れててほしいんですけどね。これも非常に重要な並びの順序のウォーターフォールチャートのルールだと思います。

段 III と段 V を、メインの流れを上、差し引くものとその内訳を下に並べ替えてもらった(a01eb153f)。

  • 段 III:課税所得のカード → 所得控除を足し上げる → 雑損控除 → 医療費控除 → 寄附金控除
  • 段 V:算出税額 → 申告納税額 → 配当控除(その下にみなし配当)→ 源泉徴収税額

画面では、カードの重なりも、文字の上を通る線も 0 だった。 この並びの決まりは、スキルの design.md §6 に書き込まれた。

所得の並びは、通達という出典で答えが出た。 段の中の上下の並びは、自分が計算の流れを見ていて言葉にしたものである。

文脈 78% で引き継いだ夕方(16:50)

07:49 のセッションでは、最後に続きのセッション「所得税のウォーターフォール フィードバックの続き(研究の判断7〜12 の反映から)」を立ち上げてもらった。 前のセッションの文脈が 78% になったので、引き継がせたのである。 音声入力で案の記号(A〜D)が別の言葉に化けることがあるので、文脈で補うよう指示してある。

16:48 に返した答えで、判断9、10、12 は B に決まった。 判断9〜12 を本の画面の既定に入れてもらい、押すと飛ぶ、↩ と F5 で戻る、足あとが無いときの F5 は普通の再読み込み、の3つを本の画面で確かめてもらった。

判断7 では、「残り(5,800,000 − 1,120,000)は来年引けるか」と聞いていた。 答えは「引けません。切り捨てです」だった。 判断7 B の画面では、不動産所得のカードの今の形を確かめてもらった。 差額を見せる形は汎用にできるが、差額に行き先がある所にだけ出す、という答えももらった。

途中で、「ごめん、判断7と8なんですけど、これはもうやってくれてるってことでしたっけ?」と聞いた。 返事は「まだどちらも画面では見られません」だった。 判断7 は、研究の画面に案 E(B に、切り捨ての差額を点線の段で見せる形)を裏で作っている最中で、本のブックにはまだ入れていなかった。 判断8 は、見本の失敗を Good/Bad に残し、案 E が終わってから見本を直す段取りだった。

判断7 の案 E と、直した判断8 の見本は、どちらも画面で確かめてから b5928d0d3 でコミットされた。 そのあと、判断7 は E、判断8 は C に決めた。 決定は、スキル(feedback-log、patterns.md の P7、design.md)と計画書に記録してもらった(a9262c92a)。 実装の手引き(implementation.md)も、今の実装に合わせて更新してある(91a35208c)。

振り返り

  • 文字だけで判断を聞かれたときは、「ちょっとよくわかんないな」で止まった。研究の画面に案の実物が並ぶと、判断5 では「まさにこれです」と返せた
  • 並びの決まりは2種類あった。所得の順は通達で確かめ、段の中の上下は自分の言葉で決めた。どちらもスキルに書いてもらった
  • 配当控除の抜けに気づいたのは、手描きの図と画面を見比べたときだった。抜けの元は、ラフの段 V を細かく読まずに進めた前の実装だった
#所得税#ウォーターフォールチャート#Claude Code#スキル#サブエージェント#worktree#Codex