連載『Claude Codeで会社を回す』#10 ── 一人会社が Claude Code で回す AI役員チームの実録。人間(@noracorn)がレビューして公開しています。
前回(#9)、Claude に財務の数字を触らせる前に、データを「凍らせる」――取得時点のスナップショットに固定して、計算の途中で足元が動かないようにする、という話を書いた。
今回は、その計算ロジックにこっそり混ざり込む別のものの話だ。給与額。返済方針。「この金額を超えたら一括計上とみなす」みたいな閾値。ロジックを書いていると、見せたくない前提値が、いつの間にかコードに同居する。 それをどう引き剥がすか。
ロジックは見せたい。でも、数字は見せたくない
財務担当の Claude に、キャッシュフローの試算をやらせている。「この案件は会社の取り分が何割だから、係数を掛ける」「この給与改定は何月から発動する」「見積中の案件は受注確率で割り引く」――こういう計算ロジックを Python に落とした。
ここで問題が起きる。計算ロジックそのものは、別に隠すほどのものじゃない。 むしろ公開して「こう考えてるよ」と見せられるくらいのものだ。記事にも書ける。
でも、そのロジックが掛ける具体的な数字は話が別だ。
- 役員の給与をいくら上げるのか
- 借入の残高がいくらで、毎月いくら返しているのか
- どの案件の取り分が何割なのか(これ、係数から逆算すると粗利が割れる)
これらは、コードの中に定数として座っている。SHOEI_COEFF = 0.X みたいに。ロジックを共有しようとすると、数字までくっついてくる。 数字を隠そうとすると、ロジックごと隠すことになる。最初、私はファイルまるごと .gitignore に放り込んでいた。安全ではある。でも、ロジックの履歴も、レビューも、AIとの共同編集も、全部できなくなった。隠しすぎだ。
やらかし:ダミーのつもりが、実値だった
分離する前に、一回ヒヤッとした。
「公開用のサンプルを作っておこう」と思って、ロジックのファイルをコピーして _example を付けた。数字はダミーに書き換えたつもりだった。つもり、だった。
後で見返したら、書き換え漏れの定数が一個残っていた。給与系の値が、実数のまま。コミットはまだしていなかったから事故にはならなかったが、「サンプルを手作業で作る」というやり方そのものが地雷だったと気づいた。本物をコピーして消していく方式は、消し忘れた一個が残る。しかも残ったやつは、いかにもそれっぽい顔をしてサンプルに紛れる。
人間(私)の目視で「実値かダミーか」を毎回判定するのは、いつか必ず漏らす。仕組みで弾かないとダメだ。
分け方:policy.py(隠す) と policy.example.py(見せる)
たどり着いた形はシンプルだ。設定ファイルを2枚にした。
-
policy.py… 実値が入っている。.gitignore済み。commit 禁止。 Claude にも、リポジトリにも、外には出さない。 -
policy.example.py… 構造だけ。全部の値がダミー。 これは commit する。公開してもいい。
ポイントは、この2枚が**「キー名と型」だけは完全に一致している**こと。中身(値)だけが違う。example の側は、こんな見た目になる。
# policy.example.py(commit 可・全値ダミー)
# 実値は機密の policy.py(.gitignore 済)にある。
# セットアップ時にこれをコピーして実値を出典コメント付きで埋める。
# 1. 案件分類の係数(board にタグが無い経営判断)
PROJECT_COEFF = 0.0 # 出典: <取り分係数の確認 decision を>
ANGLE_COEFF = {1: 0.0, 2: 0.0, 3: 0.0} # 出典: <受注確率を>
# 2. 給与改定(社内収入の前提)
SALARY_START = "YYYY-MM" # 出典: <発動月を memory から>
SALARY_INC = 0 # 出典: <増額を memory から>
# 3. 一括計上の判定閾値
LUMP_THRESHOLD = 0 # 出典: <この額超を一括とみなす境界を>
実物の policy.py のほうは、ここの 0 や "YYYY-MM" が実数と実日付に置き換わり、# 出典: の < > にはどこで岡田さんが決めたか(会議メモ・決定記録・通帳)が一行で埋まる。記事に書けるのは、ここまで。0 が何に化けるかは、書かない。それが機密の本体だから。
.gitignore 側は一行足すだけだ。
# 機密の実値ファイルは commit しない(example だけ commit する)
scripts/policy.py
そして、使う側のコードは実値ファイルだけを import する。ロジックは値を知らない。値は policy.py から流し込まれる。
import policy as pol # ← policy.py(実値)を読む
# ロジック側は「係数を掛ける」しか知らない。具体値は持たない
gross = revenue * pol.PROJECT_COEFF
if amount > pol.LUMP_THRESHOLD:
spread_over_months(amount) # 一括 → 月割り
計算ロジック(掛ける・比べる・割り振る)はリポジトリに残り、レビューもできる。化ける数字だけが、gitignore の向こうに隠れる。 ロジックは見せて、数字は隠す。やりたかったのはこれだ。
"消し忘れ"を仕組みで殺す:キー一致テスト
さっきの「ダミーのつもりが実値だった」やらかし。これを二度とやらないために、テストを一本足した。
中身はバカみたいに単純で、「policy.py と policy.example.py のキーの集合が完全に一致するか」だけを見る。値は比べない(比べたら実値がテストに漏れる)。キー名だけ。
def test_policy_keys_match():
import policy, policy_example
assert policy.KEYS == policy_example.KEYS # 値は見ない。鍵だけ。
これで何が起きるか。実値ファイルに新しい定数を足したら、example にも同名のダミーを足さない限りテストが落ちる。「実値だけ追加して、公開テンプレの更新を忘れる」が物理的にできなくなる。 逆に、もし example にうっかり実値を書いても――それは別の git diff 目視と、コミット前のシークレットスキャンで拾う多層防御にしている。
テストは「サンプルの作り忘れ」を、スキャンは「サンプルへの実値混入」を見る。一本では穴が残るから、両方置く。手で覚えておく前提の運用は、私はもう信用していない。
Season1 でやった線引きとの違い
実はこの連載、Season1 の #5「Claudeに『渡さないもの』を先に線引きする」 で、似たことを一度書いている。
ただ、あのときの線引きはディレクトリ単位だった。「この private/ フォルダは丸ごと Claude に渡さない」という、粗い・大きな仕切り。フォルダごと隔離する。
今回のは設定ファイル単位、もっと言えば一個の定数単位の線引きだ。同じ一枚のロジックの中で、「この係数は隠す、この計算式は見せる」を分ける。フォルダで隔離しきれない、ロジックと密着した機密を、どう剥がすか。粒度が一段細かい。
ディレクトリで大きく囲って、囲いきれなかった細かい数字を、設定ファイルの分離で拾う。二段構えになって初めて、「ロジックは共有、数字は秘匿」が成立した。
真似する時の最小形
大層な仕組みは要らない。順番はこうだ。
- 設定を、ロジックから引き剥がす。 給与・返済・係数・閾値みたいな「会社が決めた数字」を、計算コードに直書きせず、専用の設定ファイルに集める。ロジックは設定を import するだけにする。
-
設定ファイルを2枚にする。 実値の
policy.py(.gitignore・commit 禁止)と、全値ダミーのpolicy.example.py(commit 可)。example はコピー元の雛形になる。 - キー一致テストで"作り忘れ"を殺す。 値ではなくキー名の集合だけを突き合わせる。実値を足したら example も足さないと CI が落ちる、という強制力にする。
一個だけ、外せないコツがある。ダミーは「本物をコピーして消す」で作らない。 空っぽ(0 や "YYYY-MM")から書き起こす。消す方式は消し忘れる。最初から何も入っていなければ、漏れようがない。私の一回目の失敗は、ここを横着したことだった。
まとめ:見せる設定と、隠す設定を、最初に分ける
AIに財務ロジックを任せると決めた瞬間、コードには二種類のものが流れ込む。外に見せていい考え方と、絶対に見せたくない前提値だ。放っておくと、この二つは同じファイルの中で溶け合う。そして溶け合った状態で、うっかり一緒に外へ出る。
防ぎ方は、賢い後処理じゃなかった。最初に二枚に割っておくことだった。ロジックと公開テンプレは commit して、実値だけ gitignore の向こうへ。境界を後から引こうとすると、必ず一個漏らす。設定を書き始める前に、「これは見せる/これは隠す」を線引きしておく。
凍らせたデータ(#9)の上で、見せる設定と隠す設定を分ける(#10)。データの鮮度を固定し、設定の機密を分離して、ようやく Claude に数字を触らせる土台ができる。
公開テンプレに実値を一個書き残して、コミット直前に気づいたあの数秒。あれを「運が良かった」で終わらせなかったのは、たぶん正解だった。運で守る秘密は、いつか必ず漏れる。 だから、目視じゃなく、空っぽから書くテンプレと、キーを突き合わせるテストに、見張りを代わってもらった。
この記事について
本記事は、一人会社(合同会社)の経営を Claude Code 上の「AI役員チーム」で回している実録連載の一本です。筆者(@noracorn)が内容をレビューしたうえで公開しています。登場する金額・案件番号・顧客名・設定値はすべてダミーに置き換えており、実際の機密値・認証情報は含みません。
- 前回 #9: Claudeを動かす前に、データを"凍らせる"(※公開準備中)
- 次回 #11: 同じ"請求済み"が、用途で意味を変える――一つのステータスを、用途ごとに別のフィルタで読み分ける話です