0
1

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

【Claude Codeで会社を回す #10】Claudeに見せる設定と、隠す設定を分ける

0
Posted at

連載『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 に渡さない」という、粗い・大きな仕切り。フォルダごと隔離する。

今回のは設定ファイル単位、もっと言えば一個の定数単位の線引きだ。同じ一枚のロジックの中で、「この係数は隠す、この計算式は見せる」を分ける。フォルダで隔離しきれない、ロジックと密着した機密を、どう剥がすか。粒度が一段細かい。

ディレクトリで大きく囲って、囲いきれなかった細かい数字を、設定ファイルの分離で拾う。二段構えになって初めて、「ロジックは共有、数字は秘匿」が成立した。

真似する時の最小形

大層な仕組みは要らない。順番はこうだ。

  1. 設定を、ロジックから引き剥がす。 給与・返済・係数・閾値みたいな「会社が決めた数字」を、計算コードに直書きせず、専用の設定ファイルに集める。ロジックは設定を import するだけにする。
  2. 設定ファイルを2枚にする。 実値の policy.py(.gitignore・commit 禁止)と、全値ダミーの policy.example.py(commit 可)。example はコピー元の雛形になる。
  3. キー一致テストで"作り忘れ"を殺す。 値ではなくキー名の集合だけを突き合わせる。実値を足したら example も足さないと CI が落ちる、という強制力にする。

一個だけ、外せないコツがある。ダミーは「本物をコピーして消す」で作らない。 空っぽ(0 や "YYYY-MM")から書き起こす。消す方式は消し忘れる。最初から何も入っていなければ、漏れようがない。私の一回目の失敗は、ここを横着したことだった。

まとめ:見せる設定と、隠す設定を、最初に分ける

AIに財務ロジックを任せると決めた瞬間、コードには二種類のものが流れ込む。外に見せていい考え方と、絶対に見せたくない前提値だ。放っておくと、この二つは同じファイルの中で溶け合う。そして溶け合った状態で、うっかり一緒に外へ出る。

防ぎ方は、賢い後処理じゃなかった。最初に二枚に割っておくことだった。ロジックと公開テンプレは commit して、実値だけ gitignore の向こうへ。境界を後から引こうとすると、必ず一個漏らす。設定を書き始める前に、「これは見せる/これは隠す」を線引きしておく。

凍らせたデータ(#9)の上で、見せる設定と隠す設定を分ける(#10)。データの鮮度を固定し、設定の機密を分離して、ようやく Claude に数字を触らせる土台ができる。


公開テンプレに実値を一個書き残して、コミット直前に気づいたあの数秒。あれを「運が良かった」で終わらせなかったのは、たぶん正解だった。運で守る秘密は、いつか必ず漏れる。 だから、目視じゃなく、空っぽから書くテンプレと、キーを突き合わせるテストに、見張りを代わってもらった。

この記事について

本記事は、一人会社(合同会社)の経営を Claude Code 上の「AI役員チーム」で回している実録連載の一本です。筆者(@noracorn)が内容をレビューしたうえで公開しています。登場する金額・案件番号・顧客名・設定値はすべてダミーに置き換えており、実際の機密値・認証情報は含みません。

  • 前回 #9: Claudeを動かす前に、データを"凍らせる"(※公開準備中)
  • 次回 #11: 同じ"請求済み"が、用途で意味を変える――一つのステータスを、用途ごとに別のフィルタで読み分ける話です
0
1
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
0
1

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?