CFパイプラインの全体把握と Excel vs Vue 比較ドキュメントの整備

CF精算表まわりのスキルが3つに分かれていて、どれが何をやっているのかが頭の中で繋がっていなかった。スキルを順に読み、Excel と Vue の両方でCF精算表を作る場合のアーキテクチャ比較ドキュメントに落とし込み、Codexレビューで6点指摘されて全反映した。最後に「最終的なキャッシュフロー計算書」シートが Excel側に存在しないことに気付き、3段階の作業計画を MoM として書き残した。

CFパイプライン3ステップを読み解く

株主資本ライフサイクルのCF精算表は、3つのスキルが順番にバトンを渡しながら出来上がる。これまでは個別に触っていたので、全体の流れが見えていなかった。

Step 1: 取引モジュール生成（cf-lifecycle-equity）

最初のスキルは取引モジュールを生成する。設立・増資・減資・配当・自己株式取得など、株主資本に関わるイベントを「いつ・誰が・いくら」で整理し、JSON形式の取引データに変換する。これが後続スキルの入力となる。

Step 2: 年次推移表をExcelに書き出す（cf-multi-year-worksheet）

取引モジュールを受け取って、年次推移表（multi-year worksheet）をExcelファイルとして書き出す。各年の貸借・損益・株主資本の動きを縦横に並べた表で、ここまでくると「どの年に何が起きたか」が一覧できる。

Step 3: HTMLビューア化（cfws-excel-to-html）

Excelで仕上げた精算表をHTMLビューアに変換する。Vue上で表示できる形に整形し、Webサイトの該当ページに埋め込む。ここで初めて読者の目に触れる形になる。

3つのスキルが「取引データ → 年次推移表 → HTML表示」というパイプラインを構成していることを、ようやく頭の中で1本につなげられた。

Excel vs Vue 比較ドキュメントを書く

CF精算表は Excel でも Vue でも作れる。どちらで作るべきかの判断材料を、比較ドキュメントとして残しておきたかった。

memo/2026-04-24/excel-vs-vue-cfws-architecture.md に書き始めた。観点は以下のあたり。

データソース（手入力 vs SQLite）
数式の扱い（セル参照 vs composable）
検証のしやすさ（目視 vs Vitest）
公開形態（PDF/Excel配布 vs Web表示）
編集コスト（セル単位 vs コミット単位）

最初の草案は「Excelは柔軟、Vueは再現性が高い」という抽象的なまとめになっていた。これだと判断材料にならない。

Codex レビューで致命点6点

書き終わってから Codex に投げた。瑣末な点ではなく致命点だけ指摘してもらう運用で投げると、6点返ってきた。

codex exec -m gpt-5.4 "このドキュメントをレビューして。瑣末な点へのクソリプはしないで。致命的な点だけ指摘して: memo/2026-04-24/excel-vs-vue-cfws-architecture.md"

返ってきた指摘は具体的だった。「データソース」の節が抽象論で止まっている、「数式の扱い」でVue側のcomposable例が無く読者が再現できない、「検証のしやすさ」でVitestのアサーション例が欠けている、といった調子。6点全てに具体的な反論が思いつかなかったので、全部反映して書き換えた。

書き換え後は、各項目に「具体的にどんなコードが書かれるか」「どこに不整合が出やすいか」を最低1ブロックずつ添える形になった。判断材料としての密度が上がった。

MoMを書く前に保存先を間違える

夕方、夕食前のタイミングで「最終的なキャッシュフロー計算書」シートが Excel 側に存在していないことに気付いた。Vue側はビューアで表示できる構造になっているのに、Excel側は精算表で止まっていてCF計算書本体のシートが無い。

このままだと「Excelで何が出来るか」の比較ができない。3段階の作業計画として MoM を残しておくことにした。

Excel側に「最終的なキャッシュフロー計算書」シートを追加する
cf-multi-year-worksheet スクリプトを更新し、新しいシートも書き出すようにする
cfws-excel-to-html スクリプトを更新し、Web表示にも反映させる

最初、急いでいたので memo直下にファイルを作ってしまった。memo/mom-cfws-final-sheet.md のような形で。あとで気付いて慌てて memo/2026-04-24/ に移動した。画像パスも ./image.png から ../images/... に書き直した。

# 移動後のパス
memo/2026-04-24/mom-cfws-final-sheet.md

ディレクトリ構造のルールは自分で書いたはずなのに、急ぐと守れない。MoMを書き始める前に保存先を確認する習慣を、もう一度自分に課す。

振り返り

CFパイプラインを「3ステップの全体像」として一度把握できたのが大きい。これまでスキルを個別に触ると、毎回「これは何の入力で何の出力だっけ」と頭の中で組み直していた。1本につなげた今は、どのスキルがどこを担当しているか即座に分かる。

Codexレビューを「致命点だけ」に絞って投げると、瑣末な体裁の指摘が消えて、本当に直すべき構造の穴だけが返ってくる。今日も6点全てが具体的で、書き換えに迷わなかった。レビュー指示の文章を「瑣末な点へのクソリプはしないで」と添える運用は、もう外せない。

明日以降のTODO

Excelに「最終的なキャッシュフロー計算書」シートを追加する（手作業）
cf-multi-year-worksheet スクリプトの出力に、追加した新シートを含める
cfws-excel-to-html スクリプトを更新し、Web表示に新シートを反映させる
比較ドキュメントの「データソース」節を、新シート対応後に再度更新する