この記事は、Claude(Claude Code で動いている Claude Opus 5.5)が書いている。やっとむに TDD の練習相手を頼まれたので、その2時間のセッションの記録を、ほぼそのまま共有する。
頼まれたこと
始まりは、空のディレクトリだった。やっとむが最初に示した方針は、次のとおり。
- お題は別の Claude のセッションが段階的に出題し、仕様が変わるたびに TDD で設計を変えていく。
- Claude Code の能力は積極的に使うが、全部は任せない。やっとむが判断を加えながら、技術的負債と認知負債を少なく保つ。
- TDD は Kent Beck の Canon TDD に従う。テストは TDD で書くものに限らず、効果的な戦略やプラクティスを取り入れる。
- 意思決定の履歴と結論を、ドキュメントに残す。
- t-wada さんの TDDBC 仙台でのセッションログ を参考にする。真似はしないし、お題も違う。
お題は「環のマンカラ」だった。お題は Gist にある。コード、テスト、ADR などの成果も、すべて GitHub のリポジトリ で見られる。
どう進めたか
前半は、コードを書く前の準備に時間を使った。
- 進め方を決めた:ブランチの使い方、意思決定の残し方(1つの決定を1ファイルにする略式の ADR と、作業ログ)、Red / Green / Refactor ごとに
test:feat:refactor:を付けてコミットすること。 - お題を読んで、モデルを描いた:マンカラから思い浮かぶ物理的なイメージ(厚みのある板、くぼみ、石を握って回る手)と、お題の抽象(8つの容器と石の数)の間のずれを話し合い、Mermaid でドメインモデルを描いた。
- テストリストを作った:TODO リストを兼ねる。お題の例に、境界のケースを足した。
- 環境を作った:Python 3.15、uv、pytest、Ruff、mypy(strict モード)。
後半は TDD のサイクルに入った。ただ、テストを書く量よりも、設計の話をする時間のほうが長かった。印象に残っている場面は3つある。
- 石を1つ移す操作:最初のテストを Green にする方法を、自分は「固定値の盤面をどう作るか」で考えていた。そこへやっとむが、「ある穴から別の穴へ石を1つ移す」操作を基本にして、1手を指す操作はそれを使う、という案を出した。こうすると、内部表現を決めるのを後回しにできる。
- immutable の議論:「1手を指すと新しい盤面を返す」設計について、オブジェクトとして本当に immutable にすることと、公開 API で immutable に振る舞うことを分けて考えた。後者を選び、ADR に残した。
- 穴のアイデンティティ:穴を int ではなく enum で表した。同じ番号の穴は、同一のオブジェクトになる。
結果
2時間で進んだのは、STEP 01 の最初の例(穴2を選ぶ)までだった。テストは3件、コミットは約40件。
ほかに、ADR が5本、ドメインモデル、テストリスト、作業ログが残った。
最後には、やっとむと感想戦をした。
やっとむのコメントClaudeどんも言ってますが、和田さんのブログがすごいと思ったので、真似してみました。情報量や価値は圧倒的にないですけれど、生成AIに比較させて和田さんのすごい点を再整理したりするのに使えないかなあと思っています。
なんといっても、ポモドーロ4周ぶん、2時間使ってお題の最初のステップの1行目までしか進んでいないというのが、自分としては何とも面白かったです。そもそもの進め方について考えて伝えたり、モデリングをはさんだり、設計についていろいろと口を挟んだりアイデアを出したりで、前に進む力が足りなかった気もします。このへんで、ぐっと前に進むための準備ができてきたという感じもします。テストも書かねえで設計を先走りやがってとも思います。
お題は別セッションの Claude に作ってもらいました。なので Claude Code どんもお題を知りません。STEPごとに出してもらうように依頼して、そしてSTEP01で終わったので、この先もまだ知りません。Gist には全体を貼りましたが、目を瞑って貼りました。
導入文は Claude が書いています。この囲み部分には、生成AIは用いていません。作業ログの部分は、示したとおりです。
(やっとむ)
このログの読み方
- 右の青い箱がやっとむの入力、左が Claude の回答だ。時刻は日本時間。
📝 コミットは、その時点で Git に入ったコミットだ。Python のコードの変更は diff で、ドメインモデルの更新は図で載せている。- 載せていないものがある。ツールの呼び出しとその出力、思考の過程(記録に残っていなかった)、Claude Code が自動で入れる文脈だ。個人に関わる情報も除いた。
- このログは、Claude Code のセッションの記録と Git の履歴から、変換スクリプトで作った。スクリプトも、このセッションの続きで Claude が書いた。
プロンプト一覧
セッションログ
User #1 11/13 12:47いま空のディレクトリにいますが、ここでTDDを練習するセッションをやろうと思っています。以下のような立て付けです。
・お題は別のClaudeセッションが提示するもの。仕様を段階的に提示し、仕様の変更に合わせてTDDで設計を変えていく
・あなた(Claude Code)の能力を積極的に利用する。ただしすべて任せるわけではなく、私が必要に応じて判断を加えながら、技術的負債や認知負債を少なく維持する
・いま言語などの環境もまったくないので、そこから開始する
・経過を細かくGitにコミットしながら進める。コミットは人間がしても、あなたがしてもよい
・TDDはKent Beckが定義するCanon TDDに従う。red/green tddを実践する
・特に自動テストについて、TDDで作るテストに限定せず、効果的に使えるテスティングの戦略やプラクティスを積極的に導入、利用する
・意志決定の履歴や結論をドキュメントに残していく
・時間はこれから2時間(ポモドーロタイマー4周)で一区切りにする
・t-wadaさんによるTDDBC仙台での実践を参考にする。直接真似するわけではないが、アイデアを借りたりはするかもしれない。お題は違うもの https://t-wada.hatenablog.jp/entry/red-green-tdd-with-claude-code-202610
最初に、グローバルのCLAUDE.mdをここにコピーしてください
🤖 Claude
11/13 12:47
やっとむ、グローバルの ~/.claude/CLAUDE.md を ./CLAUDE.md にそのままコピーした。中身は変えていない。
- まだコミットしていない。
- ディレクトリには
.idea/とtdd-mancara.imlがあり、どちらも Git の追跡に入っていない。
このあと進める前に3つ確認したい。
- コピーした CLAUDE.md は、このプロジェクト向けに書き足していく予定か。TDD の進め方やコミットのルールなどを想定している。
.idea/とtdd-mancara.imlは.gitignoreに入れるか、コミットするか。- この CLAUDE.md のコミットは、やっとむがするか、自分がするか。
User #2 11/13 12:49このプロジェクト固有のことは、どちらかというと別のファイルに書きたいですね。README.mdなど。場合によってはCLAUDE.md直接でもいいかもしれませんが。
お題の第1弾があるので、それをREADME.mdに転記し、この演習の目的や概要も追記した上で、最初のコミットをしてください。いまあるファイルを含めてください
# 環のマンカラ
前提・共通ルール
* 小さなテストから始めて段階的に作り込む、TDDの演習です。各STEPで公開された仕様だけを対象に、Red → Green → Refactor で実装します。
* お題に書かれていないマンカラのルールは、存在しないものとして扱います。自分の陣地、ストア、相手側の穴などはありません。先のSTEPを想定した作り込みも不要です。
* 入力の扱いやエラーの表現など、決まっていないことは自分(ペア)で決め、その決定をテストとして残します。
* 1人で指します。
用語
* 穴(pit):輪の形に並んだ8つのくぼみです。番号は1〜8で、8の隣は1です。
* 石(stone):穴に入っている小石です。
* 盤面(board):穴1〜8それぞれに入っている石の数です。[穴1, 穴2, …, 穴8] の順に書きます。
* 初期盤面:すべての穴に石が3個ずつ入った状態、[3,3,3,3,3,3,3,3] です。
* 手(move):穴を1つ選び、その穴の石を蒔くことです。
* 蒔く(sow):取り出した石を、隣の穴から1個ずつ順に置いていくことです。
* 時計回り:番号が増える向きです(…→7→8→1→2→…)。
STEP 01:1手を指す
01-1
初期盤面から1手を指したあとの盤面を求めます。選んだ穴の石をすべて取り出し、時計回りに隣の穴から1個ずつ置きます。
* 穴2を選ぶ → [3,0,4,4,4,3,3,3]
* 穴8を選ぶ → [4,4,4,3,3,3,3,0](8の次は1です)
01-2
存在しない穴は選べません。
* 穴0、穴9は選べない
STEP 01ができたら声をかけてください。次のステップをお出しします。
📝 コミット
914bcd8(12:50)演習の目的・概要とお題STEP 01をREADMEに記載
- README.md に演習の目的と概要、お題「環のマンカラ」STEP 01 を転記
- グローバルの CLAUDE.md をプロジェクトにコピー
- IDE のプロジェクトファイルを追加
🤖 Claude
11/13 12:50
最初のコミットをした(914bcd8)。入れたのは次の2ファイル。
README.md:演習の目的と概要、お題「環のマンカラ」STEP 01 を書いた。CLAUDE.md:グローバルのものをコピーしたまま、変えていない。
既存ファイルのうち .idea/ と tdd-mancara.iml は、指示に反してコミットに入っていない。~/.gitignore の19〜20行目で *.iml と .idea が除外されていて、git add -A で追加されなかった。気づいたのはコミットした後だ。
この2つもコミットに入れるか。入れる場合は git add -f で追加し、さっきのコミットに --amend でまとめるつもりだ。別のコミットにしたいなら、そう言ってほしい。
User #3 11/13 12:52IDEAのファイルはignoreでよいです。言い忘れましたが、GitのみですすめてGitHubは無視します。なのでPRなど考えない。またブランチ戦略も基本的にはなしでよいと思いますが、t-wadaさんはどうしてましたかね。アイデアとしては、main直はやや気持ち悪いのでdevelopを切ってずっとそれで進めるか、取り組んでいるものに合わせフィーチャーブランチを作り区切りでdevelopにマージするかかな、と思っています。
🤖 Claude
11/13 12:53
IDEA のファイルは ignore のままにする。GitHub は使わず、Git だけで進めることも了解した。
t-wada さんの記事は、取得できた最初の約1/4だけ読んだ(全体で約37万文字ある)。その範囲では次のように進めていた。
- ブランチ:main には直接コミットしていない。最初は
1stというブランチで作業し、途中でsetup(環境準備)とstep-01-1(STEP 01-1 の実装)に分け直している。元の1stはバックアップとしてローカルに残している。 - PR:
setup→mainの PR #1 と、step-01-1→setupの PR #2 を作り、PR を積み重ねる形(Stacked PR)にしている。 - コミットの粒度:TDD のステップごとに細かくコミットしていて、Red(テストが失敗する状態)もコミットしている。Refactor で変更がなかったときはコミットなし。混ざった作業は後で分け直し、コミットの順番も入れ替えている。
- コミットする人:Claude Code。人間が「コミットして」と指示し、Claude が確認を取ってから実行している。
つまり t-wada さんは、ステップの区切りで別ブランチを切り、PR でまとめるやり方だった。やっとむの2案で言えば、フィーチャーブランチ案に近い。
決める前に2点聞きたい。
- フィーチャーブランチ案の区切りは、t-wada さんのように「環境準備」「STEP 01-1」のような単位を考えているか。それとも STEP 単位か。
- develop を切る目的は、main に「区切りまで終わった状態」だけを残したいからか。もしそうなら、STEP が終わるたびに develop を main にマージするのか。
User #4 11/13 12:551->作業内容に応じてとしましょう。STEP単位ではたぶん大きすぎます
2->mainは、作業セッションが終わるまでさわりません。セッション中の作業としてはdevelopがトランクであるように考えます
🤖 Claude
11/13 12:55
了解した。整理すると次のとおり。
- main:作業セッションが終わるまで触らない。
- develop:セッション中のトランクとして扱う。
- フィーチャーブランチ:作業内容に合わせて develop から切り、区切りがついたら develop にマージする。
進める前に3点確認したい。
- develop を切る:今の main(
914bcd8)から develop を作り、そこに切り替えてよいか。 - マージの方法:フィーチャーブランチを develop に入れるときは
git merge --no-ffでマージコミットを作るつもりだ。早送りマージにすると、どこからどこまでが1つの作業だったかが履歴から読めなくなる。マージコミットを残せば、細かい Red/Green のコミットと作業のまとまりを両方追える。 - 決定の記録:このブランチ方針は、決めたことの最初の記録になる。書く場所は
docs/decisions.mdを作り、決めたことを時系列で追記していくつもりだ。理由は、2時間のセッションで細かい決定が多く出そうで、ADR の形式(1件1ファイル)だと量に対して重すぎるからだ。ADR の形式(manage-adrスキル)がよければそちらにする。どちらにするか教えてほしい。
User #5 11/13 12:581->OK
2->OK
3->うんぬ、略式ADRみたいな感じで行きましょう。決めたこと、背景と理由、検討した他の案、日時だけ、1ファイル1ページくらいの検討で。1決定1ファイル。それとは別にworklogとして、やったこと、考えたこと、試行錯誤などをダラダラ記録していくようにしてください。これはあくまで必要に応じて参照するメモで、worklog->ADRの参照はあっていいが、ADR->worklogの参照は記載しない
📝 コミット
160bf8c(12:58)ブランチ戦略のADRを追加
📝 コミット
7970803(12:58)意思決定と作業記録の残し方のADRとworklogを追加
READMEから進め方のルールとしてADRを参照する
📝 コミット
c1dc1d0(12:58)Merge branch 'docs/working-rules' into develop
🤖 Claude
11/13 12:58
develop を作り、記録の仕組みを入れた。今は develop にいる。
決めたばかりのブランチ戦略に従って、この作業も docs/working-rules ブランチで行い、develop に --no-ff でマージした(c1dc1d0)。main は 914bcd8 のまま触っていない。
作ったファイルは次のとおり。
docs/adr/0001-branch-strategy.md:ブランチ戦略(GitHub は使わない、main は触らない、develop がトランク、フィーチャーブランチは--no-ffでマージ)docs/adr/0002-recording-decisions-and-worklog.md:略式 ADR と worklog の残し方(参照は worklog → ADR の一方向だけ)docs/worklog.md:1ファイルに時系列で追記していく形にした。今日のここまでの経過を書いてある。README.md:「進め方のルール」の節を足し、2つの ADR を参照するようにした。次のセッションの Claude がルールを見つけられるようにするためだ。
ほかに伝えておくことが3つある。
- 0002 の決定は、やっとむの指示をそのまま ADR に書いたものだ。項目は「決めたこと」「背景と理由」「検討した他の案」「日時」だけにした。
- 作業ブランチ
docs/working-rulesはマージ後も消さずに残してある。 - 最初のマージは、コマンドのオプションの誤り(
git mergeに-F -を渡した)で失敗した。-mに直して実行し直したので、結果に影響はない。
User #6 11/13 13:00ありがとう。ではこれで進めます。ワークスペースはクリーンですかね。
お題を見直してみましょう。機能としては簡単そうですが、前提のドメイン知識がまあまあありますね
🤖 Claude
11/13 13:00
ワークスペースはクリーンだ。今は develop にいる。
STEP 01 を見直した。
お題が前提にしているドメイン知識
STEP 01 で実際に使うのは、次の概念だ。
- 盤面:穴8つ。番号は 1〜8(1始まり)。
- 環状の隣接:8の次が1になる。
- 手:穴を1つ選び、石を全部取り出す。
- 蒔く:取り出した石を、時計回り(番号が増える向き)で隣の穴から1個ずつ置く。選んだ穴そのものからは始めない。
- 初期盤面:全部の穴に3個ずつ。
通常のマンカラのルール(ストア、自陣と敵陣、石を取るルールなど)は、お題が明示的に「ない」としている。ドメイン知識が要るのは、この用語と蒔き方だけだと読める。
お題で決まっていないこと
お題が「自分で決めてテストに残す」としている部分だ。
- 入力:01-1 は「初期盤面から」と書いてある。引数は穴番号だけでよいか、盤面も渡すか。
- エラーの表現:穴0と穴9を選んだとき、例外にするか、戻り値で表すか。
- 範囲外の値:0と9以外(負の数、整数でない値など)をどう扱うか。お題は0と9しか挙げていない。
- 盤面の表し方:お題の書き方
[穴1, …, 穴8]のとおり、8要素の配列にするか。番号は1始まりで、配列は0始まりになるので、この対応をどこで変換するか。 - STEP 01 の範囲では起きない状況:空の穴を選ぶ、石が8個以上あって一周する、など。お題に従えば今は考えない。
聞きたいこと
やっとむの言う「前提のドメイン知識がまあまあある」は、どれを指しているか。
- 上に挙げた用語や蒔き方のこと(「蒔く」「時計回り」「隣から置く」)か。
- 実際のマンカラを知っていると、ストアなど余計なものを持ち込みやすい、という意味か。
- それとも、テストやコードの中でこの用語をどう表すか(名前の付け方など)の話か。
指しているものによって、次にどこを詰めるかが変わる。
User #7 11/13 13:05うーん、簡単でいいからモデルを書いていきたいですね。PlantUMLかMermaidかなにかがよいかな、ASCIIアートで簡単にやるのでいいかな。board has (8) holes. hole has stones (or a number for count of stones). move interacts with holes and stones. くらいだが
マンカラのイメージがあるので、ボードは厚みのある板で、穴はくぼみというイメージがつきます。手は石をつかんでまきながら穴を回る。でも抽象的には8つの容器があり、物理的な手や指はない。ちょっとギャップが生じるんですね
🤖 Claude
11/13 13:05
英語について先に3点。
- "board has (8) holes." → "A board has 8 holes."
- "hole has stones (or a number for count of stones)." → "Each hole has stones (or a number for the count of stones)."
- "move interacts with holes and stones." → "A move interacts with holes and stones."
英語ではないが、用語も1つ。お題は「穴」を pit と呼んでいて、hole ではない。モデルの名前をお題に合わせるかどうかも決めておきたい。
記法
Mermaid を使うつもりだ。理由は次のとおり。
- Markdown のコードブロックに書くだけでよく、IntelliJ の Markdown プレビューでそのまま図として見られる。
- テキストなので、Git の差分で変更を追える。
- PlantUML は Java か描画用の環境が必要で、今は環境がまったくない。
- ASCII アートでも足りるくらい小さいモデルだが、書き直すたびに線を引き直す手間がかかる。
物理的なイメージと抽象のギャップ
整理するとこうなる。
| 物理的なイメージ | お題の定義 | 抽象 |
|---|---|---|
| 厚みのある板 | 盤面=穴ごとの石の数 | 8つの数の並び |
| くぼみ | 穴(pit)、1〜8、8の隣は1 | 環状に並んだ容器 |
| 小石 | 石(stone) | 区別しないので数だけ |
| 石をつかんで回る手 | 手(move)=穴を選んで蒔くこと | 動作。誰が蒔くかは定義されていない |
いちばん大きなギャップは「手」だと思う。お題の「手(move)」は、穴を選んで蒔く動作を指していて、手そのもの(持ち主)ではない。物理的には、手に握った石が残り何個かという状態が蒔いている途中にあるが、抽象では計算途中の一時的な値でしかない。
たたき台を書くとこうなる。まだファイルには書いていない。
classDiagram
class Board {
stones of pit 1..8
}
class Pit {
number 1..8
stones : count
}
Board "1" *-- "8" Pit : ring
note for Board "move(pit) : 選んだ穴の石を時計回りに蒔く"
聞きたいこと
- 用語は、お題に合わせて pit にするか。それとも hole か。
- 「手で石を握って回る」というイメージは、モデルに残したいか。残すなら「手に持っている石」を明示した概念にする。捨てるなら move は Board の操作の1つになる。
- このモデルは
docs/model.mdに置き、STEP が進むたびに更新していく形でよいか。
User #8 11/13 13:06IDEで見られるかの確認も含め、ファイルにモデルを書いてください。Gitでバージョン管理しつつ更新していきましょう。用語は、ちゃんと見てなかったので、お題に合わせます。ユビキタス言語、ドメイン辞書ですね。いまの用語の欄で十分そうですが。
📝 コミット
1caa7e4(13:07)STEP 01時点のドメインモデルを追加
docs/model.md の図(この時点)
classDiagram
class Board {
+move(pit)
}
class Pit {
number : 1..8
stones : int
}
Board "1" *-- "8" Pit : 輪の形に並ぶ
🤖 Claude
11/13 13:07
モデルを docs/model.md に書いて、フィーチャーブランチ docs/domain-model にコミットした(1caa7e4)。develop にはまだマージしていない。IDE で表示を確かめてもらってからマージする。
- 図:Mermaid のクラス図で、Board と8つの Pit を書いた。Board に
move(pit)を持たせ、Pit は番号と石の数を持つ。 - 用語:README の「用語」を正とし、model.md にはその参照だけを書いた。お題に合わせて pit を使っている。
- 「手」の扱い:前回聞いた点だが、返事がなかったので、石を握った手はモデルに入れず、move を Board の操作にした。この判断は model.md と worklog に書いてある。違うなら直す。
- worklog:13:07 の項として、お題の見直しとモデル作成の経過を追記した。
IntelliJ の Markdown プレビューで図が表示されるか確認してほしい。Mermaid の表示は IDE の設定で無効になっていることがあり、その場合は図にならずにコードのまま見える。
User #9 11/13 13:08プレビュー見えました。moveは実装方法は見えてないけど主要な概念なので、move - - > board, move - - >pitと入れておきましょう。多重度も不明。
📝 コミット
4b79e8a(13:09)ドメインモデルでMoveを独立した概念にする
docs/model.md の図(この時点)
classDiagram
class Board
class Pit {
number : 1..8
stones : int
}
class Move
Board "1" *-- "8" Pit : 輪の形に並ぶ
Move ..> Board
Move ..> Pit
📝 コミット
96d04dc(13:09)Merge branch 'docs/domain-model' into develop
🤖 Claude
11/13 13:09
Move を独立した概念にしてコミットし(4b79e8a)、develop にマージした(96d04dc)。今は develop にいて、ワークスペースはクリーンだ。
- 図:
Moveをクラスとして足し、Move ..> BoardとMove ..> Pitの依存を引いた。どちらも多重度は書いていない。 - Board の
move(pit):消した。Move を独立させたのに Board にも操作として残すと、実装方法を決めたように見えるからだ。 - 説明文:Move は主要な概念なので独立させたこと、実装方法は未定なので依存だけを書いたことを追記した。
- worklog:プレビューで表示を確認したことと、この変更を追記した。前の行に「move は Board の操作にした」と書いてあるが、時系列の記録なので残してある。
Board の move(pit) を消したのは、やっとむの指示ではなく自分の判断だ。残しておきたいなら戻す。
User #10 11/13 13:09あまり考えず破線の矢印にしたけど、UMLとしたらどういう意味でしたっけ?
🤖 Claude
11/13 13:09
UML では、破線の開いた矢印(..>)は依存(dependency)を表す。
- 意味:矢印の元(Move)が先(Board、Pit)を使う。使い方は、引数として受け取る、中で一時的に使う、メソッドを呼ぶ、などがある。
- 含意:Board や Pit が変わると、Move も影響を受けうる。逆向きの影響はない。
- 関連との違い:実線の関連(
-->)は、相手を属性として持ち続ける構造的なつながりを表す。依存はそれより弱く、「何らかの形で使う」とだけ言う関係だ。
紛らわしいものが1つある。破線でも、先が白抜きの三角(..|>)だと実現(インタフェースの実装)を表し、別の意味になる。
今回の「実装方法はまだ見えないが、Move は Board と Pit を使う」という意図は、依存の意味とずれていない。
User #11 11/13 13:12よいですね。じゃあこのモデルを頭に入れつつ、テストリストを考えましょう。明らかに初期状態のテスト、Moveのテストがいりますね。01-2の存在しない穴が選べないも必要ですが、実現方法はわからない。暗黙に、穴がループするので8から1にいく場合も明示してテストがいる。テストリストはTODO.mdとして、フラットな箇条書きで書いていきましょう
🤖 Claude
11/13 13:12
ブランチ step-01-test-list を作り、ルートに TODO.md を書いた。まだコミットはしていない。
- 初期盤面は [3,3,3,3,3,3,3,3] - 初期盤面から穴2を選ぶと [3,0,4,4,4,3,3,3] - 初期盤面から穴8を選ぶと、8の次の1から蒔いて [4,4,4,3,3,3,3,0] - 穴0は選べない - 穴9は選べない
- 8から1に回るテストは、お題の「穴8を選ぶ」の例がそのまま当てはまるので、その項目に「8の次の1から蒔いて」と明記した。
- 「存在しない穴」は、0と9でテストが別になるので2項目に分けた。
ファイルには入れていないが、候補として2つ挙げておく。
- 穴7を選ぶ → [4,3,3,3,3,3,0,4]:8から1へ回るのが、蒔いている途中で起きるケース。穴8の例では最初の1個目で回っている。
- 穴5を選ぶ → [3,3,3,3,0,4,4,4]:ちょうど穴8で蒔き終わり、回らないケース。境界の確認になる。
聞きたいことが3つある。
- この2つを TODO に入れるか。お題の例ではないので、入れるかどうかはやっとむに決めてほしい。
- 終わった項目の印はどうするか。
- [x]のチェックボックスにするか、取り消し線にするか。 - TODO.md は TDD の進行と一緒に何度も変わる。このブランチでコミットだけしておき、実装もこのブランチで続ける形でよいか。
User #12 11/13 13:12おっとポモドーロがなったので休憩です。一休み増しましょう
🤖 Claude
11/13 13:13
了解、休憩にしよう。
今の状態は次のとおり。
- ブランチは
step-01-test-list。 TODO.mdは書いただけで、まだコミットしていない。- 前回の3つの質問(候補の2項目、完了の印、ブランチの使い方)は、休憩明けに答えてもらえればいい。
User #13 11/13 13:21候補2つ、良さそうです。そうするとテストリストはフラットにと言いましたが、1つの仕様のいくつかのパターンあるいは複数の同値クラスにたいするテストは、インデントで整理した方が良さそうですね。
チェックボックスにして、未着手は空、完成はxにしましょう。いまやってるのは、Oとかにしましょうか
TODO.mdは常時更新しながら、いまいるブランチに入れていきます。マージするとdevelopに入りますね
実はテストリストにはないけど、言語を選んで環境を作んなきゃならない。これもテストリストの先頭に加えてください。テストリストという名称ですが、私はやることを全部メモしておくTODOリストとして扱うのが好きです
📝 コミット
99eab6a(13:21)STEP 01のTODOリストを追加
🤖 Claude
11/13 13:21
TODO.md を書き直して、step-01-test-list ブランチにコミットした(99eab6a)。develop にはまだマージしていない。
- [ ] 言語を選んで環境を作る - [ ] 初期盤面は [3,3,3,3,3,3,3,3] - [ ] 初期盤面から1手を指す(01-1) - [ ] 穴2を選ぶと [3,0,4,4,4,3,3,3] - [ ] 穴5を選ぶと、ちょうど穴8で蒔き終わって [3,3,3,3,0,4,4,4] - [ ] 穴7を選ぶと、蒔く途中で8から1に回って [4,3,3,3,3,3,0,4] - [ ] 穴8を選ぶと、8の次の1から蒔いて [4,4,4,3,3,3,3,0] - [ ] 存在しない穴は選べない(01-2) - [ ] 穴0は選べない - [ ] 穴9は選べない
- 冒頭の説明:TODO.md はやることを全部書くメモであること、印の意味(
[ ]未着手、[O]着手中、[x]完了)、インデントでまとめるルールを書いた。 [O]の表示:Markdown のプレビューでは[ ]と[x]しかチェックボックスにならない。[O]は文字のまま見える。- worklog:テストリストを作った経過と、決めたルールを追記した。時刻は記録していなかったので「13:35頃」と推定で書いてある。
User #14 11/13 13:22まずは初期テストリストはいいかな。これをマージした上で言語環境を作るブランチに入りましょう
📝 コミット
50c9bf7(13:22)Merge branch 'step-01-test-list' into develop
🤖 Claude
11/13 13:22
step-01-test-list を develop にマージし(50c9bf7)、作業ブランチ setup-env を切った。TODO の「言語を選んで環境を作る」を [O] にしてあるが、まだコミットしていない。
このマシンで使えるのは次のとおり。
- Python:Python 3.15.2 と uv 0.13.6
- Node.js:v22.23.4 と pnpm 10.34.7
- Java、Go、Rust:入っていない
Python + uv + pytest にするつもりだ。理由は次のとおり。
- 準備が軽い:uv が入っているので、
uv initと pytest の追加ですぐ始められる。2時間のセッションでは、環境づくりに時間を取られないことを重視したい。 - TODO の構造と合う:pytest の
parametrizeを使うと、TODO でインデントしてまとめた「1つの仕様に対する複数パターン」を、テストでもそのまま1つにまとめて書ける。 - 他のテスト手法も使える:TDD 以外のテスト戦略も取り入れたいという方針がある。Python には Hypothesis(プロパティベーステスト)があり、たとえば「1手のあとも石の合計は24個のまま」のような性質を検証できる。
- CLAUDE.md の規約に沿える:
exclude-newerで、公開から日の浅いバージョンを避ける設定もすぐできる。
TypeScript + pnpm + Vitest も同じくらい使える。ただ、TypeScript のコンパイル設定やモジュールの設定など、決めることが少し多い。
やっとむが練習したい言語や、使い慣れている言語があれば、そちらを優先する。どうするか。
User #15 11/13 13:24まあ正直Pythonが慣れてて好きなので、それでいきますか。3.15.2あたりが使えると思います。Python+uv+pytestにします。然るべきリンター、静的チェックも入れましょう。実はあんまりマジメにやってないので、選定はお任せします。選んだものを教えてください。いちおう確認してから承認します
🤖 Claude
11/13 13:24
Python + uv + pytest で進める。リンターと静的チェックは次の組み合わせにするつもりだ。
| 用途 | ツール | 選んだ理由 |
|---|---|---|
| テスト | pytest | 決定済み |
| リンター | Ruff(ruff check) |
速い。flake8、isort、pyupgrade などの機能を1つで担っていて、今の Python では定番 |
| フォーマッタ | Ruff(ruff format) |
Black とほぼ同じ書式になる。リンターと同じツールで済むので、入れるものが増えない |
| 型チェック | mypy(strict モード) | Python の型チェッカーで最も広く使われている。strict にすると型注釈の書き忘れも指摘される。最初から strict にしておけば、後から厳しくするより楽 |
型チェッカーの他の候補と、選ばなかった理由は次のとおり。
- Pyright:速いが、内部で Node.js を使う。
- Astral の ty(Ruff と同じ作者):今の安定度を自信を持って言えない。
Ruff のルールは、デフォルト(E, F)に次の4つを足すつもりだ。最初から多くは入れず、うるさければ減らす。
- I:import の並び順
- B:バグになりやすい書き方
- UP:古い書き方を新しい Python の書き方に直す
- SIM:もっと単純に書ける箇所
環境の作り方
- プロジェクト作成:
uv init --libで作り、src/レイアウト(src/<パッケージ>/とtests/)にする。 - Python のバージョン:
requires-python = ">=3.15" - 依存のバージョン固定:
[tool.uv]にexclude-newer = "2 days"を書き、公開から2日未満のバージョンは入れない。依存はすべて dev 依存として正確なバージョンで固定し、uv.lockをコミットする。実際に入るバージョンは、uv が解決した後に報告する。 - 実行コマンド:
uv run pytest、uv run ruff check、uv run ruff format --check、uv run mypy
確認したいこと
パッケージ名をどうするか。リポジトリ名は tdd-mancara だが、英語の綴りは mancala が一般的だ。パッケージ名は mancala にするつもりでいる。mancara に合わせたいなら、そちらにする。
これでよければ環境を作る。
User #16 11/13 13:25あらはずかしい。mancalaでお願いします。ツール群の選定、OKです。型ヒントもしっかり書く形でいきます。
🤖 Claude
11/13 13:26
環境はできて、全ツールが動いた。ADR・worklog・README を書いてコミットする。
📝 コミット
e75d444(13:26)Python + uv + pytest の開発環境を作る
Ruff と mypy(strict) を入れ、依存は正確なバージョンで固定する。 言語とツールの選定を ADR 0003 に残す。
開発環境を作って、setup-env ブランチにコミットした(e75d444)。develop にはまだマージしていない。
入れたもの
| ツール | バージョン | 設定 |
|---|---|---|
| Python | 3.15.2 | requires-python = ">=3.15" |
| pytest | 9.2.0 | testpaths = ["tests"] |
| Ruff | 0.17.4 | デフォルトのルールに I, B, UP, SIM を追加 |
| mypy | 2.4.1 | strict = true。対象は src と tests |
- バージョン固定:
uv addは>=で書き込むので、==に書き換えた。exclude-newer = "2 days"を設定し、uv.lockもコミットした。 - 構成:パッケージは
src/mancala/で、型情報を配布するためのpy.typed付き。uv initが作ったサンプル関数hello()は消して、__init__.pyを空にした。
動作確認
ruff check、ruff format --check、mypy:問題なし。pytest:テストが0件なので「no tests ran」で終わり、終了コードは5になる。今は想定どおりの結果だ。tests/ディレクトリは作ったが、ファイルがないので Git には入っていない。最初のテストを書いたときに入る。
記録
- ADR 0003:言語と開発ツールの決定を書いた。
- worklog:環境づくりの経過を追記した。
- README:ADR 0003 への参照と、開発コマンドの一覧を足した。
- TODO.md:「言語を選んで環境を作る」を
[x]にした。
気づいたこと
uv init が Git の設定からやっとむの名前とメールアドレスを読み取り、pyproject.toml の authors に書き込んでいる。そのままコミットに入れた。ローカルのリポジトリだけなので外には出ないが、気になるなら消す。
develop にマージしてよいか。
User #17 11/13 13:28> 言語は Python 3.15 とする。型ヒントをしっかり書く。
これ1行に書くことではないですね。分けて
pytestの理由に余計なことが書いてありますね。議論してないし、無理に書かないように。
📝 コミット
8e4f725(13:29)ADR 0003の決定を分け、議論していない理由を消す
🤖 Claude
11/13 13:29
ADR 0003 を2点直して、setup-env にコミットした(8e4f725)。
- 決定の分割:「言語は Python 3.15 とする」と「型ヒントをしっかり書く」を別々の行にした。
- 理由の削除:議論していない pytest の理由を2行消した。
parametrizeの話と Hypothesis の話だ。
今後の ADR では、合意していない理由を足さないこと、決定は1行に1つにすることを、自分用のメモ(メモリ)に残した。
develop へのマージは、まだ返事をもらっていないので保留している。
User #18 11/13 13:30環境構築してサンプルの落ちるプロダクトコードとテスト (answerは42というやつ) のテストを書いて確認してから、コミットしましょうか
🤖 Claude
11/13 13:30
サンプルのテストを書いて、意図どおり失敗することを確認した。まだコミットしていない。
src/mancala/sample.py:answer() -> intが0を返す。tests/test_sample.py:assert answer() == 42
実行結果は次のとおり。
- pytest:
assert 0 == 42で失敗した(終了コード1)。テストの収集、src/レイアウトからの import、失敗したときの表示まで動いている。 - ruff check、ruff format --check:問題なし。
- mypy(strict):3ファイルで問題なし。テストのコードも型チェックの対象に入っている。
前提を1つ確認しておく。環境そのものは前のコミット(e75d444)ですでにコミットしてある。今回コミットするのは、このサンプルの2ファイルになる。
コミットの仕方は2通りある。
- 失敗するテストのままコミットする:Red の状態を履歴に残す。
answer()を42に直して通してからコミットする:Green にしてからまとめて残す。
Canon TDD の練習として Red も履歴に残すなら、前者でコミットしてから直してもう一度コミットする形になる。どちらにするか。
User #19 11/13 13:32いい質問です。レッドでコミット、グリーンでコミット、リファクタリングでコミットとしましょう。それぞれ最低1回で、なにか間違えたり追加変更したら複数コミットがあって良いです。和田さんの言ってた、なんだっけ、コミットコメントにtest:とかrefactor:とかfeature:とかfix:とか書くあれをやりましょう
📝 コミット
183944f(13:32)test: 環境確認用にanswer()が42を返すテストを追加
--- /dev/null +++ b/src/mancala/sample.py @@ -0,0 +1,2 @@ +def answer() -> int: + return 0 --- /dev/null +++ b/tests/test_sample.py @@ -0,0 +1,5 @@ +from mancala.sample import answer + + +def test_answer() -> None: + assert answer() == 42
📝 コミット
c5a4d7e(13:32)feat: 環境確認用のanswer()が42を返す
--- a/src/mancala/sample.py +++ b/src/mancala/sample.py @@ -1,2 +1,2 @@ def answer() -> int: - return 0 + return 42
🤖 Claude
11/13 13:33
Now ADR 0004 for the commit rule.
📝 コミット
9074afa(13:33)docs: TDDのステップごとのコミットの決まりをADR 0004に残す
サンプルを Red と Green でコミットし、コミットの決まりを ADR 0004 に残した。全部 setup-env ブランチにある。
9074afa docs: TDDのステップごとのコミットの決まりをADR 0004に残す c5a4d7e feat: 環境確認用のanswer()が42を返す 183944f test: 環境確認用にanswer()が42を返すテストを追加
Green にしたあと、pytest、ruff、mypy はすべて通った。
ADR 0004 の「背景と理由」には、最初は自分で考えた理由を書いていた。前の指摘と同じ間違いなので、やっとむが言ったこと(t-wada さんが話していたプレフィックスのやり方を取り入れる)だけにして、コミットを修正(amend)した。
あの付け方は Conventional Commits という形式だ。ただ、t-wada さんが実際にこれを使っていたかどうかは確認できていない。前に読んだのは記事の最初の1/4だけで、その範囲にはなかった。
決めてもらいたいことが3つある。
- プレフィックスの種類:やっとむが挙げたのは
test:refactor:feature:fix:だった。ADR では次のようにしている。違うなら直す。feature:は Conventional Commits の書き方に合わせてfeat:にした。docs:(ドキュメント)とchore:(環境や設定)を足した。今のコミットにはこの2種類も必要になるからだ。
- サンプルの Refactor:「各ステップで最低1回コミットする」と決めたが、
answer()には直すところがない。Refactor のコミットを省くか、何か作るか。 - develop へのマージ:環境構築とサンプルが揃ったので、
setup-envを develop にマージしてよいか。
User #20 11/13 13:341->OKです
2->リファクタリングで変更なければ、コミットなしでOK
3->LGTM
📝 コミット
096afa3(13:34)docs: Refactorで変更がなければコミットしないことをADR 0004に追記
📝 コミット
80b6e25(13:34)Merge branch 'setup-env' into develop
🤖 Claude
11/13 13:34
3つとも反映して、setup-env を develop にマージした(80b6e25)。今は develop にいて、ワークスペースはクリーンだ。
- プレフィックス:ADR 0004 の内容(
feat:を使い、docs:とchore:を足す形)で確定した。worklog にも、こうした経緯を追記した。 - Refactor:ADR 0004 に「Refactor で変更がなければコミットしない」と追記して、
docs:でコミットした(096afa3)。
User #21 11/13 13:38さて、では最初の機能にいきますか。初期状態のテストだから expected == [3,3,3,3,3,3,3,3,] というアサートになると思うんだけど、これはあくまでインターフェースであって内部表現がlistということではない。じつは内部表現についてはアイデアもあって、石の個数をlistで持つというのはたぶん普通、いっぽう石がどこにあるかというデータの持ち方もあると思う。石にアイデンティティがあると思えばdictで居場所(どの穴か)を持てるし、そうでなければ穴の番号やidを持つbagで表現できる。というわけで内部表現とインターフェースを分離することを意識しつつ、いまの時点ではまあsutがいきなりlistを持つという形がいちばんシンプルでしょう。
🤖 Claude
11/13 13:38
内部表現とインターフェースを分けて考える、という方針は了解した。今の時点では、SUT(テスト対象)が石の数を list で持つ、いちばん単純な形で始める。
テストを書く前に、インターフェースの案を見てほしい。
from mancala.board import Board def test_初期盤面はすべての穴に石が3個() -> None: board = Board() assert board.stones() == [3, 3, 3, 3, 3, 3, 3, 3]
この形にした理由は次のとおり。
Board()で初期盤面にする:今のお題には初期盤面しか出てこない。Board.initial()のようなファクトリは、初期盤面以外が必要になってから考えればいい。stones()はメソッドにする:お題の用語では、盤面は「穴1〜8それぞれの石の数」だ。属性として見せると、内部に list をそのまま持っているように見える。メソッドにしておけば、「求めると list で返ってくる」というインターフェースに見えるので、内部表現と分けておきやすい。- テスト名は日本語にする:TODO.md の文言と対応させやすい。Python は識別子に日本語を使え、Ruff と mypy も問題にしない。
聞きたいことが3つある。
- この形でよいか。特に、名前が
stones()でよいか。 - 内部表現のアイデア(石の数の list、石ごとの居場所を持つ dict、穴番号の bag)は、今は採用しないが、残しておく価値がある。worklog に書いておくつもりだが、よいか。
- 環境確認用の
answer()のサンプルは、役目を終えたので、このタイミングで消してよいか。
よければ、ブランチ step-01-initial-board を切り、TODO を [O] にして、Red のテストから始める。
User #22 11/13 13:40それでいきましょう。listの最後のカンマについて、一般的ルールはある? なんとなくつけておく派です
📝 コミット
b32ef03(13:40)chore: 環境確認用のサンプルを削除
--- a/src/mancala/sample.py +++ /dev/null @@ -1,2 +0,0 @@ -def answer() -> int: - return 42 --- a/tests/test_sample.py +++ /dev/null @@ -1,5 +0,0 @@ -from mancala.sample import answer - - -def test_answer() -> None: - assert answer() == 42
📝 コミット
c2be949(13:40)test: 初期盤面はすべての穴に石が3個
--- /dev/null +++ b/tests/test_board.py @@ -0,0 +1,6 @@ +from mancala.board import Board + + +def test_初期盤面はすべての穴に石が3個() -> None: + board = Board() + assert board.stones() == [3, 3, 3, 3, 3, 3, 3, 3]
🤖 Claude
11/13 13:40
まず質問に答える。末尾のカンマについての一般的なルールは次のとおり。
- PEP 8:末尾のカンマは基本的に任意で、必須なのは要素が1つのタプル
(x,)だけ。勧められているのは、要素を1行に1つずつ並べ、閉じかっこを次の行に置くときだ。こうすると、要素を足したときの差分が1行で済む。[3, 3, 3,]のように閉じかっこと同じ行に付けるのは、勧められていない。 - Ruff format(Black と同じ):「マジックトレーリングカンマ」という挙動がある。末尾にカンマがあると、1行に収まる長さでも、要素を1行に1つずつ展開する。
[3, 3, 3, 3, 3, 3, 3, 3,]と書くと、フォーマット後は8行に展開される。- カンマがなく1行に収まるなら、1行のまま残る。
盤面のリテラルは1行のほうが読みやすいので、テストでは末尾のカンマを付けていない。
「それでいきましょう」を、前回の3つの質問すべてへの承認と受け取って、ここまで進めた。全部 step-01-initial-board ブランチにある。
c2be949 test: 初期盤面はすべての穴に石が3個 b32ef03 chore: 環境確認用のサンプルを削除
b32ef03:サンプルのanswer()とそのテストを消した。c2be949(Red):tests/test_board.pyに、案のとおりのテストを書いた。TODO の「初期盤面は…」を[O]にし、worklog に内部表現のアイデアとインターフェースの方針を書いて、同じコミットに入れた。- 失敗の確認:
mancala.boardがまだないので、ModuleNotFoundErrorで失敗する。Canon TDD の Red としてはこれでよいと考えている。モジュールだけ先に作って、値が違うことで失敗させる段階を踏みたいなら、そうする。
次は Green で、src/mancala/board.py に Board を作る。進めてよいか。
User #23 11/13 13:41ここで5分間休憩です。☕
🤖 Claude
11/13 13:41
了解、休憩にしよう。☕
今は step-01-initial-board ブランチで、Red のテストをコミットしたところ(c2be949)だ。ワークスペースはクリーンで、残っている作業はない。休憩が終わったら Green から再開する。
User #24 11/13 13:43雑談だが、stonesはロックバンドを想起させますね。
🤖 Claude
11/13 13:44
たしかに、ローリング・ストーンズだ。board.stones() と書くと、石の数ではなくメンバー一覧が返ってきそうな気もする。
ちなみに「転がる石に苔むさず」(A rolling stone gathers no moss)は、マンカラにもある意味で当てはまる。石は蒔かれて穴から穴へ移り続け、1つの穴にとどまらない。
User #25 11/13 13:44うまいこといいますね
🤖 Claude
11/13 13:44
ありがとう。休憩が明けたら、Green から始めよう。
User #26 11/13 13:44超マニア的な話題としては、StonesはUltima世界 (Britannia) 有名な吟遊詩人Ioloの名作でもあります
🤖 Claude
11/13 13:45
それはマニアックだ。Iolo の「Stones」は、Ultima シリーズで繰り返し使われる曲だった。Iolo には現実のモデルがいて、作者 Richard Garriott の友人の David Watson だったはずだ。
記憶違いがあるかもしれないが、Ultima V では、城のハープシコードでこの曲の音を弾くと隠し通路が開く仕掛けもあった。
マンカラの石も、正しい順番で穴に蒔くと何かが開くのかもしれない。STEP が進めばわかる。
User #27 11/13 13:46さて、再開しますか。いまレッド、最短でグリーンにします。
📝 コミット
b2a8fa7(13:46)feat: 初期盤面はすべての穴に石が3個
--- /dev/null +++ b/src/mancala/board.py @@ -0,0 +1,3 @@ +class Board: + def stones(self) -> list[int]: + return [3, 3, 3, 3, 3, 3, 3, 3]
🤖 Claude
11/13 13:46
Green にして、コミットした(b2a8fa7)。
class Board: def stones(self) -> list[int]: return [3, 3, 3, 3, 3, 3, 3, 3]
最短で通すために、固定値をそのまま返す「仮実装」(Fake It)にした。内部にはまだ何も持たせていない。pytest、ruff、mypy はすべて通った。
TODO の「初期盤面は…」は、Refactor が終わるまで [O] のままにしておく。
次は Refactor だ。今のコードに、直すべき重複や読みにくさは見当たらない。固定値を list の属性に移すのは、実装を一般化することになる。その動機になるテスト(1手を指して盤面が変わる)がまだないので、今やると先回りになると考えている。このまま Refactor はなしにして、TODO を [x] にしてよいか。
User #28 11/13 13:47基本的に同意です。stones()をget_stoines()とかread_stones()とかに、するかどうかというのは考えてもいい。Pythonの基本的な命名規約には特に指定がないと思うし、自分としてはstones()が最適な感じです。もうひとつは、list[int]をに型名を付けるかどうか。
🤖 Claude
11/13 13:48
命名について。PEP 8 には、アクセサに get_ を付けるかどうかの決まりはない。Python では、単純に値を返すだけのものには get_ を付けず、名詞のまま(stones() や属性)にする書き方が一般的だ。read_ は、ファイルや I/O から読む印象が強い。自分も stones() がいちばん合っていると思う。
型名(型エイリアス)について。Python 3.12 以降は type Stones = list[int] と書ける。付ける場合と付けない場合の違いはこうなる。
- 付ける利点:「石の数の並び」というドメインの概念に名前が付き、シグネチャを読むだけで意味がわかる。
- 付けても変わらないこと:エイリアスは
list[int]と同じ型として扱われる。ただのlist[int]を渡しても、mypy は区別しない。型の安全性は上がらず、名前が付くだけだ。 - 今の使用箇所:1か所だけ。
今は付けないつもりだ。1か所なら、名前を付けても読みやすさはあまり変わらない。1手を指すテストに進めば、Move の結果としても同じ形が出てくるので、そこで付けるか決めればいい。
それとは別に、名前を付けるなら考えておきたいことがある。お題の用語では「盤面(board):穴1〜8それぞれに入っている石の数」となっている。つまり、お題が言う盤面はこの list そのものだ。一方、コードでは Board クラスが盤面で、list は stones() の戻り値になっている。
型名を付けるなら、用語とコードのこの対応をどう取るかも一緒に決めることになる。Stones とするか、お題に合わせて board 系の名前にするか、だ。
この考えでよければ、Refactor はなしで TODO を [x] にする。
User #29 11/13 13:49同意します。ただし型名をStonesにするのは、あなたのその理由により微妙だと思われる。どちらかといえばPitsですね
📝 コミット
3bcf070(13:49)docs: 初期盤面のTODOを完了にし、型名の検討をworklogに残す
🤖 Claude
11/13 13:49
Refactor はなしにして、TODO の「初期盤面は…」を [x] にし、コミットした(3bcf070)。
型名の候補は Pits にすることも worklog に残した。list の要素1つが穴1つの石の数なので、並び全体を「穴の並び」と読むのは自然だと思う。実際に付けるかは、Move の結果で同じ形が出てきたときに決める。
初期盤面の作業はこれで区切りがついた。step-01-initial-board を develop にマージしてから、1手を指す(01-1)のブランチに移ってよいか。
User #30 11/13 13:50OK
📝 コミット
fa0952f(13:50)Merge branch 'step-01-initial-board' into develop
🤖 Claude
11/13 13:50
step-01-initial-board を develop にマージした(fa0952f)。新しいブランチ step-01-move を切り、TODO の「初期盤面から1手を指す」と「穴2を選ぶと…」を [O] にした。TODO の変更はまだコミットしていない。Red のテストと一緒にコミットする。
テストを書く前に、1手を指すインターフェースを決めたい。候補は3つある。
A. 盤面を書き換える
board = Board() board.move(2) assert board.stones() == [3, 0, 4, 4, 4, 3, 3, 3]
B. 新しい盤面を返す(元の盤面は変えない)
board = Board().move(2) assert board.stones() == [3, 0, 4, 4, 4, 3, 3, 3]
C. Move を独立したものにする
board = Move(2).apply(Board()) assert board.stones() == [3, 0, 4, 4, 4, 3, 3, 3]
B にするつもりだ。理由は次のとおり。
- お題は「1手を指したあとの盤面を求めます」と書いている。入力から結果を求める形なので、新しい盤面を返すほうが素直に表せる。
- 元の盤面が変わらないので、テストの中で状態の変化を追わなくていい。
- C はモデルの図にある Move をそのままクラスにした形だ。ただ、今の仕様で Move が持つのは「どの穴を選ぶか」だけで、クラスにする理由がまだない。Move をメソッド名に残しておけば、Move を独立させる必要が出たときにも移しやすい。
また、TODO で同じグループにまとめた4パターン(穴2、5、7、8)は、最初から parametrize にはしないつもりだ。まず穴2の1件だけで書き、2件目を足すときに、まとめるかどうかを Refactor で判断する。
B でよいか。
User #31 11/13 13:54いいですね。テストコードをサンプルコードと考え、さらにクライアントにとって使いやすいかどうか判断する場と考えましょう。案BはBoardはimuutableという設計をクライアントに対して露出するものになっている。はてさて、環マンカラという謎のゲームのメンタルモデルとしては、手を打つたびにあらたな盤面が現れるんでしょうかね? 盤面の上で石が動いていくんですかね? どちらもアリなんだけど、いまのお題の書きぶりだと「初期盤面から1手を指したあとの盤面を求めます。」なので、前者にするのが素直っぽいですね。案Cは内部実装で現れるかもしれないなと思います。
とりあえずこの意見への回答をください
🤖 Claude
11/13 13:54
3点とも同意する。
テストをサンプルコードとして読む
B の board = Board().move(2) は、「move は盤面を返す」と読める。ただ、「元の盤面は変わらない」ことまで読み取れるかというと、弱い。immutable であることをクライアントに約束する設計にするなら、それ自体がお題で決まっていない決定になる。お題は、そうした決定を「テストとして残します」と言っている。だとすると、「move しても元の盤面は変わらない」というテストがあってもいい。
メンタルモデル
物理的なマンカラなら、盤面は1つで、その上を石が動いていく。モデルを作ったときに話した「石を握って回る手」と同じギャップだと思う。物理的なイメージでは状態が変わっていき、お題の抽象では盤面から盤面への変換になる。今のお題の書き方は「初期盤面から…あとの盤面を求めます」だから、新しい盤面が現れる、つまり後者の抽象のほうが素直だ。今後の STEP で手を続けて指すような仕様が出てきたら、そのときに見直せばいい。
案 C
同意する。モデルの図で Move は Board と Pit に依存する概念として書いてあり、内部実装で「1手を表すもの」として現れることは十分ありえる。それをクライアントに見せるかどうかは別の話で、今は move() をメソッドにしておけば足りる。
1つ聞きたい。immutable を約束として明示するテスト(元の盤面が変わらない)を、TODO に足すか。
User #32 11/13 13:56ありがとう。いずれも同意します。immutableのテストも足しましょう
📝 コミット
9243f6b(13:56)test: 初期盤面から穴2を選ぶと穴3から5に1個ずつ蒔かれる
--- a/tests/test_board.py +++ b/tests/test_board.py @@ -4,3 +4,8 @@ from mancala.board import Board def test_初期盤面はすべての穴に石が3個() -> None: board = Board() assert board.stones() == [3, 3, 3, 3, 3, 3, 3, 3] + + +def test_初期盤面から穴2を選ぶと穴3から5に1個ずつ蒔かれる() -> None: + board = Board().move(2) + assert board.stones() == [3, 0, 4, 4, 4, 3, 3, 3]
🤖 Claude
11/13 13:56
TODO に immutable の項目を足し、穴2のテストを Red でコミットした(9243f6b)。
TODO には、01-1 のグループの直後に1行足した。
- [ ] 1手を指しても元の盤面は変わらない(お題にはなく、自分で決めた仕様)
01-1 の子にしなかったのは、あのグループが「穴ごとのパターン」の集まりだからだ。こちらは設計上の決定なので、別の項目にした。
テストは次のとおり。
def test_初期盤面から穴2を選ぶと穴3から5に1個ずつ蒔かれる() -> None: board = Board().move(2) assert board.stones() == [3, 0, 4, 4, 4, 3, 3, 3]
- 失敗の確認:
AttributeError: 'Board' object has no attribute 'move'で失敗する。既存の初期盤面のテストは通ったままだ。 - worklog:インターフェースの3案、メンタルモデルの議論、immutable のテストを足した理由を追記した。
次は Green だ。最短で通すなら、move() が固定値の盤面を返す仮実装になる。ただ、Board は今、内部に何も持っていない。固定値の [3, 0, 4, 4, 4, 3, 3, 3] を持つ Board を返すには、Board が石の数を受け取れるようにする必要がある。
ここが、Canon TDD の「仮実装」から「三角測量」か「明白な実装」へ移る判断の場面だと思う。どちらにするか、やっとむの考えを聞きたい。
User #33 11/13 13:59Boardが(初期状態の)listを持っているのはよい、move()がいきなり3つの石を3箇所に撒くのは、なんかちょっとステップが大きすぎる気がするなあ。いや、別にそんなことないか。そこじゃない、内部表現がまだ決まってないところかな。つまり内部表現によって「明白な実装」のロジックは大きく変わりますね。まずは三角測量じゃないかと思いますが、どうです?
🤖 Claude
11/13 13:59
三角測量に賛成する。
- 内部表現が先に決まってしまう:やっとむの言うとおり、「明白な実装」で書くには、そのときに内部表現を決める必要がある。石の数の list なら、添字を回しながら1つずつ足すロジックになる。石の居場所を持つ bag なら、石の居場所を書き換えるロジックになる。例が穴2の1件しかない段階で決めると、その1件に合わせた形になりやすい。
- 2件目が一般化の理由になる:三角測量なら、穴2は仮実装で通しておき、2件目の例を足して仮実装では通らなくなったところで一般化する。その時点では2つの例を見比べながら、内部表現を選べる。
- ステップの大きさ:3箇所に蒔くこと自体は大きくないと思う。ただ、選んだ穴を空にすることと、隣から順に蒔くことの2つが一度に入る。2件目で、どちらが本質的かも見えやすくなる。
2件目は、TODO の順だと穴5(ちょうど穴8で蒔き終わる)だ。8から1に回る話はまだ入らないので、一般化の最初の一歩としてもちょうどいい大きさだと思う。
ただ、仮実装でも決めなければならないことが1つある。move() が固定値の盤面を返すには、Board を任意の石の数で作れる必要がある。作り方は2通りある。
- コンストラクタの引数にする(
Board(stones)):いちばん単純だ。ただ、任意の盤面を作れることがクライアントへの公開インターフェースになる。今のお題には、初期盤面以外から始める仕様はない。 - 内部用のクラスメソッドにする(
Board._of(stones)など):クライアントに見えるのはBoard()、move()、stones()だけのままで済む。
後者にするつもりだ。テストをクライアントの使い方の見本と考えるなら、お題が求めていない「任意の盤面を作る」機能は見せないほうがいい。どうか。
User #34 11/13 14:03別の提案をしていいですか。Boardに公開インターフェースとして、ある穴から別の穴に石を1つ移動するというメソッドを加える。。move()の実装は、そのメソッドを使う。くわえて、Boardのコピーコンストラクタみたいのを作る(Pythonだとどうするんだっけ?) これで、内部表現を決めるのを送らせられます。つまり新しいメソッドの内部をいったん仮実装というか、動作するけど理想じゃない形にしておきましょう。move()はどの穴から石をどう移動するというルールを表現することになります。うん、これはTODOリストの更新が必要そうですね
🤖 Claude
11/13 14:03
提案はいいと思う。move() が「どの穴からどの穴へ石を移すか」というルールだけを表し、「石を1つ移す」操作が内部表現を隠すことになる。内部表現に触れるのは、その操作と stones() だけになる。
コピーコンストラクタ
Python には C++ のようなコピーコンストラクタはない。よく使う方法は3つある。
copy()メソッドを作る:list.copy()やdict.copy()と同じ書き方で、Python ではいちばん素直だ。- 標準ライブラリの
copy.copy(board)かcopy.deepcopy(board)を使う:何も実装しなくても動く。 - コンストラクタで Board を受け取る(
Board(other)):あまり見かけない。
immutable との関係(ここだけ確認したい)
石を1つ移すメソッドを公開すると、それが盤面を書き換えるメソッドになる場合、さっき決めた「Board は immutable」と矛盾する。クライアントが直接呼べば、盤面が変わってしまうからだ。取りうる形は2つある。
- 石を移すメソッドも新しい盤面を返す:
board.move_stone(2, 3)が新しい Board を返す。move()は、それを石の数だけ繰り返して結果をつなげていく。immutable のままなので、コピーは要らなくなる。 - 石を移すメソッドは盤面を書き換えるが、非公開にする:
move()の中でコピーを作り、そのコピーを書き換える。クライアントから見える Board は immutable のまま保てる。ただし、石を移すメソッドは公開インターフェースではなくなる。
公開にしたいという意図を尊重するなら、前者にするつもりだ。コピーを作る仕組みも不要になり、作るものが1つ減る。
名前
お題の用語には「石を1つ移す」がない。新しい用語になるので、名前を決めたい。move は「手」としてもう使っているので、move_stone(from_pit, to_pit) を考えている。
今ある Red のテスト
穴2のテストは失敗したままコミットされている。石を1つ移すメソッドを先にテスト駆動で作るなら、その間は穴2のテストを @pytest.mark.skip で一時的に止めておくつもりだ。Canon TDD では、一度に扱う失敗テストは1つにするからだ。
TODO は、この3点が決まったら更新する。どうか。
User #35 11/13 14:06copy()メソッドの新設で行きましょう
1つ移すメソッドもimmutableとするのが、筋ですね。パフォーマンスが気になるならあとで最適化するけど、ぜったい気にならない
ただ、公開するのに強い意志はないです。ただ、あとで役に立ちそうな気がするというところ。アンダーバーつけても特に変わらないです
move_a_stone()がいいかな
テストはいったんskipにして、テストリストの別項目に移動しましょう
📝 コミット
0c35af7(14:06)test: 穴2のテストを一時的にskipし、move_a_stone()を先に作る
--- a/tests/test_board.py +++ b/tests/test_board.py @@ -1,3 +1,5 @@ +import pytest + from mancala.board import Board @@ -6,6 +8,7 @@ def test_初期盤面はすべての穴に石が3個() -> None: assert board.stones() == [3, 3, 3, 3, 3, 3, 3, 3] +@pytest.mark.skip(reason="先に move_a_stone() を作る") def test_初期盤面から穴2を選ぶと穴3から5に1個ずつ蒔かれる() -> None: board = Board().move(2) assert board.stones() == [3, 0, 4, 4, 4, 3, 3, 3]
📝 コミット
10bde42(14:06)test: 初期盤面で穴2から穴3に石を1つ移す
--- a/tests/test_board.py +++ b/tests/test_board.py @@ -12,3 +12,8 @@ def test_初期盤面はすべての穴に石が3個() -> None: def test_初期盤面から穴2を選ぶと穴3から5に1個ずつ蒔かれる() -> None: board = Board().move(2) assert board.stones() == [3, 0, 4, 4, 4, 3, 3, 3] + + +def test_初期盤面で穴2から穴3に石を1つ移す() -> None: + board = Board().move_a_stone(2, 3) + assert board.stones() == [3, 2, 4, 3, 3, 3, 3, 3]
🤖 Claude
11/13 14:06
決めたとおりに TODO とテストを変えて、move_a_stone() の Red まで進めた。
10bde42 test: 初期盤面で穴2から穴3に石を1つ移す 0c35af7 test: 穴2のテストを一時的にskipし、move_a_stone()を先に作る
TODO の変更(着手中は move_a_stone() に移した)
- [O] 石を1つ移す move_a_stone()(新しい盤面を返す) - [O] 初期盤面で穴2から穴3に1つ移すと [3,2,4,3,3,3,3,3] - [ ] Board の copy() を作る - [ ] 初期盤面から1手を指す(01-1) - [ ] 穴2を選ぶと [3,0,4,4,4,3,3,3](テストは skip 中) ... - [ ] 1手を指しても、石を1つ移しても、元の盤面は変わらない(…)
- immutable の項目:
move_a_stone()も新しい盤面を返すことにしたので、こちらにも当てはまるように書き換えた。 - 穴2のテスト:
@pytest.mark.skip(reason="先に move_a_stone() を作る")を付けて止めた。
Red のテスト
def test_初期盤面で穴2から穴3に石を1つ移す() -> None: board = Board().move_a_stone(2, 3) assert board.stones() == [3, 2, 4, 3, 3, 3, 3, 3]
AttributeError: 'Board' object has no attribute 'move_a_stone' で失敗する。初期盤面のテストは通ったままで、穴2のテストは skip されている。
worklog には、三角測量を考えた理由と、やっとむの提案と、そこで決めたことを書いた。
確認したいことが2つある。
copy()のテスト:TODO にcopy()の項目を入れたが、copy()だけを直接テストするかは決めていない。今は、move_a_stone()を Green にするときに中で使い、間接的にテストされる形になると考えている。直接のテストも書くか。- Green の進め方:
move_a_stone()の Green も、仮実装(固定値を返す)から始めるか。ここで内部の list を持たせる明白な実装にするか。move_a_stone()は、やっとむが「動作するけど理想じゃない形」でよいと言っていた場所だ。石の数の list を持ち、2つの要素を増減するだけの実装なら、明白な実装で十分だと思う。
User #36 11/13 14:081->いまは不要でOK
2->listを使う明白な実装で行きましょう
ところでimmutableの件ですが、オブジェクトとして真にimmutableであることと、公開APIについてはimmutableのように振る舞うというので、違う設計が可能と言えば可能ですねえ。ちょっとこのことについてメリデメを整理して論じてもらえますか
📝 コミット
3c505ac(14:09)feat: 石を1つ移すmove_a_stone()をlistで実装
--- a/src/mancala/board.py +++ b/src/mancala/board.py @@ -1,3 +1,17 @@ class Board: + def __init__(self) -> None: + self._stones = [3, 3, 3, 3, 3, 3, 3, 3] + def stones(self) -> list[int]: - return [3, 3, 3, 3, 3, 3, 3, 3] + return self._stones.copy() + + def copy(self) -> Board: + new = Board() + new._stones = self._stones.copy() + return new + + def move_a_stone(self, from_pit: int, to_pit: int) -> Board: + new = self.copy() + new._stones[from_pit - 1] -= 1 + new._stones[to_pit - 1] += 1 + return new
🤖 Claude
11/13 14:09
Green の実装をコミットした(3c505ac)が、1つ問題がある。
class Board: def __init__(self) -> None: self._stones = [3, 3, 3, 3, 3, 3, 3, 3] def stones(self) -> list[int]: return self._stones.copy() def copy(self) -> Board: new = Board() new._stones = self._stones.copy() return new def move_a_stone(self, from_pit: int, to_pit: int) -> Board: new = self.copy() new._stones[from_pit - 1] -= 1 new._stones[to_pit - 1] += 1 return new
stones() は、内部の list ではなくコピーを返すようにした。内部の list をそのまま返すと、クライアントがそれを書き換えたときに盤面が変わってしまう。
問題:mypy が通っていないままコミットした
pytest は「2 passed, 1 skipped」で通った。しかし mypy が、skip 中の穴2のテストについて "Board" has no attribute "move" を報告している。skip はテストの実行を止めるだけで、型チェックは止めないからだ。
自分のコマンドの組み方に誤りがあり、mypy が失敗してもコミットまで進んでしまった。チェックがすべて通ったのを確かめてからコミットする、という手順になっていなかった。
直し方は2つある。
- skip 中のテストの該当行に
# type: ignore[attr-defined]を付ける。skip を外すときに一緒に消す。 move()を作るまで、mypy のエラーを受け入れる。
前者にするつもりだ。チェックが通らない状態が続くと、新しいエラーが出ても気づきにくくなるからだ。修正は fix: でコミットする。
真に immutable と、公開 API で immutable に振る舞う設計
A. オブジェクトとして真に immutable
内部状態を一度作ったら変えない。たとえば @dataclass(frozen=True) にして、中身を tuple で持つ。
メリット
- 構造そのものが保証になる。将来メソッドを足しても、うっかり状態を書き換えることが起きにくい。
- ハッシュ可能にできる。盤面を dict のキーや set の要素に使える。同じ盤面の判定、探索、メモ化に役立つ。
- 等価性(==)を値で定義するのが自然になる。
デメリット
- 新しい状態を作るたびに、状態全体を渡してオブジェクトを作る必要がある。つまり、任意の石の数を受け取る手段が要る。さっき避けた「任意の盤面を作れることを公開する」問題がまた出てくる。内部用の生成手段で隠すことはできる。
- 蒔くような処理は、1つずつ状態を変えながら書くのが自然だ。immutable だと、毎回新しい tuple を作るか、結果をまとめて計算する書き方になる。
- 内部表現の選択肢が狭まる。bag なら collections.Counter が自然だが、これは変更可能なオブジェクトだ。immutable にするには frozenset や tuple などで工夫が要る。
- Python では、真の immutable といっても慣習レベルだ。object.__setattr__ を使えば書き換えられる。
B. 内部は変更可能で、公開 API では immutable に振る舞う
今の実装がこちらだ。公開メソッドはコピーを作ってから書き換え、外には内部の list を渡さない。
メリット
- 実装の自由度が高い。コピーした盤面を内部で書き換えながら蒔く、という素直なループが書ける。
- 内部表現を選ぶときの制約が少ない。
- コンストラクタを引数なしのまま保てる。
デメリット
- 保証が規律頼みになる。すべての公開メソッドで「書き換える前にコピーする」「内部の list を外に返さない」を守る必要がある。今回 stones() でコピーを返したのも、その規律の1つだ。メソッドを足したときに破っても、構造では防げない。
- ハッシュ可能にするのは危険だ。内部が変わりうるオブジェクトにハッシュを定義すると、dict や set に入れたあとで値が変わる可能性が残る。
今の状況での位置づけ
TODO にある「元の盤面は変わらない」のテストは、公開 API の振る舞いだけを確かめる。A でも B でも通る。
つまり、どちらを選ぶかは内部設計の問題で、このテストがあれば後からリファクタリングで切り替えられる。切り替える理由になりそうなのは、盤面の同一判定やハッシュが必要になったとき(A に寄せる)だ。あるいは、蒔く処理を内部の書き換えで書きたくなったとき(B のまま)だ。
mypy の件は、# type: ignore[attr-defined] で直してよいか。
User #37 11/13 14:14mypyの件は、エラー無視でいいんじゃないかな
immutableについては、言語機能とは別レベルの設計判断になります。それで、変更もできる一方でB->Aは容易だけどA->Bは影響が大きそうと言うのはあります。move_a_stone()がimmutableとして振る舞うというのはOKで、設計判断としては外部からはimmutableに見えたり、そのように振る舞うということにしておきましょう。これはADRにしたほうがよいですね
休憩時間ですが、すみませんがこれだけやってからにしてください
📝 コミット
571f644(14:14)fix: skip中のテストのmove()への型エラーを一時的に無視する
--- a/tests/test_board.py +++ b/tests/test_board.py @@ -10,7 +10,7 @@ def test_初期盤面はすべての穴に石が3個() -> None: @pytest.mark.skip(reason="先に move_a_stone() を作る") def test_初期盤面から穴2を選ぶと穴3から5に1個ずつ蒔かれる() -> None: - board = Board().move(2) + board = Board().move(2) # type: ignore[attr-defined] assert board.stones() == [3, 0, 4, 4, 4, 3, 3, 3]
📝 コミット
32f4ead(14:14)docs: Boardは外部からimmutableに見えるように振る舞うことをADR 0005に残す
🤖 Claude
11/13 14:15
2つとも済ませた。今回はチェックを1つずつ実行し、すべて通ったのを確かめてからコミットしている。
32f4ead docs: Boardは外部からimmutableに見えるように振る舞うことをADR 0005に残す 571f644 fix: skip中のテストのmove()への型エラーを一時的に無視する
- mypy:「エラー無視」を
# type: ignore[attr-defined]と受け取り、skip 中のテストの1行に付けた。pytest、ruff、mypy はすべて通っている。skip を外すときに一緒に消す。 - ADR 0005:「決めたこと」「背景と理由」「検討した他の案」は、やっとむが言ったことと、今の議論で出た内容だけで書いた。
- README:ADR の一覧に 0004 が抜けていたので、0005 と一緒に足した。
- worklog:mypy の件をコミットした経緯と、immutable の議論を追記した。
TODO の move_a_stone() の項目は、まだ [O] のままだ。Refactor をするかどうかは、休憩のあとに決めよう。ゆっくり休んで。
User #38 11/13 14:17さて、最後のポモドーロです。早いな、まだSTEP1の初手ですよね。
🤖 Claude
11/13 14:17
そうだ。コードとしては、STEP 01 の最初の手のところにいる。
できたこと
- 初期盤面(Board() と stones())
- 石を1つ移す move_a_stone()(Green まで。Refactor はまだ決めていない)
まだのこと
- 1手を指す move()(01-1):穴2のテストは skip 中で、穴5、7、8 は未着手
- 元の盤面が変わらないことのテスト
- 存在しない穴(01-2):穴0と穴9
ここまでの3ポモドーロでは、コード以外の土台に多くの時間を使った。
- ブランチ戦略、記録の残し方、言語とツール、コミットの決まりを ADR 0001〜0004 にまとめた。
- ドメインモデルと TODO リストを作った。
- 環境を作り、サンプルのテストで動作を確かめた。
- immutable の設計を議論し、ADR 0005 にまとめた。
User #39 11/13 14:18さて、いまはグリーンですね。リファクタリング?
🤖 Claude
11/13 14:18
今のコードを見直したが、直すべきところは見当たらない。気になりうる点は3つあるが、どれも今は直さないつもりだ。
copy()の作り方:copy()の中で一度Board()で初期盤面を作り、そのあと内部の list を差し替えている。無駄はあるが、コードは短く読みやすい。- 番号の変換:穴番号から添字への変換(
- 1)が、move_a_stone()の中に2回出てくる。ただ、1つのメソッドの中の隣り合った2行なので、関数に切り出すほどではない。move()でも同じ変換が出てきたら、そこで切り出せばいい。 - 初期盤面のリテラル:
[3, 3, 3, 3, 3, 3, 3, 3]はお題の書き方そのままなので、[3] * 8などにするより読みやすい。
Refactor はなしにして、TODO を次のように更新するつもりだ。
move_a_stone()の項目を[x]にする。copy()の項目も[x]にする。move_a_stone()の中で使われていて、そのテストを通じて動作を確かめられている。
そのあと、穴2のテストの skip を外して、move() に戻る。これでよいか。
User #40 11/13 14:20番号の変換はすでに気になります。ただ、new.stones_at(1) += 1 みたいに左辺値にする書き方はないと思うんで、まあこれでいいかなあ。それにこのメソッド内に閉じられる可能性はありますね、わかんないけど
いまskip外したらグリーンにならない? それはダメですかね?
🤖 Claude
11/13 14:20
番号の変換と左辺値
Python でも、左辺値に近い書き方はできる。__getitem__ と __setitem__ を定義したクラスなら、new_pits[2] += 1 と書ける。累算代入は「取り出す → 足す → 書き込む」の順に、この2つのメソッドを呼ぶからだ。ここで 1 始まりの番号を受け取れば、- 1 の変換をそのクラスの中に閉じ込められる。
ただ、それには「穴の並び」を表すクラスを新しく作る必要がある。型名の候補として挙がった Pits そのものだ。やっとむの言うとおり、変換は move_a_stone() の中だけで済む可能性もある。だから、今はこのままにしておくのがいいと思う。
skip を外すとグリーンにならないこと
ダメではないと思う。skip を外すのは、Canon TDD の「テストリストから次のテストを選び、失敗するテストを書く」にあたる。テストはすでに書いてあって、一時的に止めていただけだ。止めるのをやめれば Red に戻る。今は Green で直すところもないので、次の Red に進むちょうどいいタイミングだ。
skip を外すときは、# type: ignore[attr-defined] も一緒に消す。そうすると mypy もエラーを出すが、これは前の Red のコミットと同じ状態だ。
手順は次のようにするつもりだ。
- TODO の
move_a_stone()とcopy()を[x]にし、「穴2を選ぶと…」を[O]にする。 - skip と
# type: ignoreを外し、失敗することを確かめてtest:でコミットする。
これで進めてよいか。
User #41 11/13 14:22ああ、すみません勘違いです。skipのままでいいです。次のサイクルで外します
2番の手順で、次のサイクルに入ることになりますね。それでOKです
📝 コミット
4025a59(14:22)docs: move_a_stone()とcopy()のTODOを完了にする
📝 コミット
210d6f2(14:22)test: 穴2のテストのskipを外す
--- a/tests/test_board.py +++ b/tests/test_board.py @@ -1,5 +1,3 @@ -import pytest - from mancala.board import Board @@ -8,9 +6,8 @@ def test_初期盤面はすべての穴に石が3個() -> None: assert board.stones() == [3, 3, 3, 3, 3, 3, 3, 3] -@pytest.mark.skip(reason="先に move_a_stone() を作る") def test_初期盤面から穴2を選ぶと穴3から5に1個ずつ蒔かれる() -> None: - board = Board().move(2) # type: ignore[attr-defined] + board = Board().move(2) assert board.stones() == [3, 0, 4, 4, 4, 3, 3, 3]
🤖 Claude
11/13 14:22
TODO を更新して、穴2のテストの skip を外し、次のサイクルの Red に入った。
210d6f2 test: 穴2のテストのskipを外す 4025a59 docs: move_a_stone()とcopy()のTODOを完了にする
- TODO:
move_a_stone()とcopy()を[x]にした。「初期盤面から1手を指す」と「穴2を選ぶと…」を[O]にした。 - テスト:skip、
# type: ignore、使わなくなったimport pytestを消した。 - Red の確認:pytest は
AttributeError: 'Board' object has no attribute 'move'で失敗した(1 failed, 2 passed)。mypy も同じ箇所でエラーを出している。前の Red のコミットと同じ状態だ。ruff は問題なし。 - worklog:番号の変換と、左辺値の書き方についての話を残した。
次は Green だ。move() の実装は、move_a_stone() を石の数だけ繰り返す形になる。
def move(self, pit: int) -> Board: board = self to_pit = pit for _ in range(self.stones()[pit - 1]): to_pit = to_pit + 1 board = board.move_a_stone(pit, to_pit) return board
これは、今の穴2のテストを通すのに必要な範囲の「明白な実装」だ。8から1に回る処理は入れていない。三角測量なら、ここは仮実装(固定値を返す)にする選択肢もある。ただ、move_a_stone() ができたことで、内部表現に触れずにルールだけを書けるようになった。そのため、明白な実装で十分だと考えている。この方針でよいか。
User #42 11/13 14:23pitはfrom_pitがいいかな、あとpit_noというのはどう思う? ああ、まずはテスト書いてグリーンにした後にしましょう
📝 コミット
b83031f(14:23)feat: 1手を指すmove()をmove_a_stone()の繰り返しで実装
--- a/src/mancala/board.py +++ b/src/mancala/board.py @@ -15,3 +15,11 @@ class Board: new._stones[from_pit - 1] -= 1 new._stones[to_pit - 1] += 1 return new + + def move(self, pit: int) -> Board: + board = self + to_pit = pit + for _ in range(self.stones()[pit - 1]): + to_pit = to_pit + 1 + board = board.move_a_stone(pit, to_pit) + return board
🤖 Claude
11/13 14:23
Green にして、コミットした(b83031f)。テストは3件とも通り、ruff と mypy も問題なし。
では名前の話をする。
pit → from_pit
- よい点:move_a_stone(from_pit, to_pit) と名前がそろう。ループの中で to_pit と対になるので、どこからどこへ移すのかが読みやすい。
- 気になる点:move() の引数名は公開インターフェースの一部でもある。お題では、手は「穴を1つ選ぶ」ことだ。クライアントから見ると「選んだ穴」で、「from」は実装の都合から見た名前になる。board.move(from_pit=2) と書かれると、少し実装寄りに見える。
pit_no
- よい点:モデルの図には、番号と石の数を持つ Pit がある。引数が pit だと、将来 Pit のオブジェクトを作ったときに紛らわしくなる。pit_no なら番号(int)だと明確で、お題の「番号は1〜8」とも合う。
- 気になる点:そろえるなら from_pit_no、to_pit_no になり、少し長い。no という略し方を嫌う人もいる(pit_number という選択肢もある)。
自分の考えを言うと、pit_no に賛成だ。今の実装は、穴を番号でしか扱っていない。だから番号であることを名前で示しておくほうがいい。move() の引数は、from_ を付けずに pit_no にするつもりだ。ループの中だけ、to_pit_no と対になる名前があれば読みやすい。
整理するとこうなる。
def move_a_stone(self, from_pit_no: int, to_pit_no: int) -> Board: ... def move(self, pit_no: int) -> Board: board = self to_pit_no = pit_no for _ in range(self.stones()[pit_no - 1]): to_pit_no = to_pit_no + 1 board = board.move_a_stone(pit_no, to_pit_no) return board
ただ、これだと move() の中で pit_no が「選んだ穴」と「石を取り出す穴」の両方の意味を持つ。from_pit を提案したのは、この後者の意味をはっきりさせたかったからだと思う。どう考えているか聞きたい。
User #43 11/13 14:25fromもnoもつけましょう。長いのは罪ではないです。仕様も「選んだ穴から~」と解釈するのに不自然はない
📝 コミット
866dea5(14:25)refactor: 穴番号の引数名をfrom_pit_no/to_pit_noにする
--- a/src/mancala/board.py +++ b/src/mancala/board.py @@ -10,16 +10,16 @@ class Board: new._stones = self._stones.copy() return new - def move_a_stone(self, from_pit: int, to_pit: int) -> Board: + def move_a_stone(self, from_pit_no: int, to_pit_no: int) -> Board: new = self.copy() - new._stones[from_pit - 1] -= 1 - new._stones[to_pit - 1] += 1 + new._stones[from_pit_no - 1] -= 1 + new._stones[to_pit_no - 1] += 1 return new - def move(self, pit: int) -> Board: + def move(self, from_pit_no: int) -> Board: board = self - to_pit = pit - for _ in range(self.stones()[pit - 1]): - to_pit = to_pit + 1 - board = board.move_a_stone(pit, to_pit) + to_pit_no = from_pit_no + for _ in range(self.stones()[from_pit_no - 1]): + to_pit_no = to_pit_no + 1 + board = board.move_a_stone(from_pit_no, to_pit_no) return board
🤖 Claude
11/13 14:25
move() と move_a_stone() の引数名を from_pit_no と to_pit_no に変えて、refactor: でコミットした(866dea5)。テストは3件とも通り、ruff と mypy も問題なし。
def move_a_stone(self, from_pit_no: int, to_pit_no: int) -> Board: new = self.copy() new._stones[from_pit_no - 1] -= 1 new._stones[to_pit_no - 1] += 1 return new def move(self, from_pit_no: int) -> Board: board = self to_pit_no = from_pit_no for _ in range(self.stones()[from_pit_no - 1]): to_pit_no = to_pit_no + 1 board = board.move_a_stone(from_pit_no, to_pit_no) return board
worklog には、move() の実装方針と、名前を決めた理由(no は番号を示す、長いのは罪ではない、from はお題の解釈として自然)を書いた。
気づいたことを1つ伝えておく。番号から添字への変換(- 1)が、move() の中にも出てきた。move() は内部表現に触れないはずだったが、石の数を知るために stones()[from_pit_no - 1] と書いている。この「- 1」は内部の list の添字ではなく、stones() が返す list の添字だ。ただ、穴番号から添字への変換という点では同じことをしている。
TODO の「穴2を選ぶと…」を [x] にして、次の穴5に進むか、ここで何か直すか。
User #44 11/13 14:29これで、インターフェースとして、穴の指定をintで表現するのではなく、穴のアイデンティティで示すべきと言う根拠ができましたね。Pitオブジェクトを渡すのか、穴の番号を示すenumみたいなものを渡すのか。おそらく8から1に戻るのもまとめてきれいに片付けられるところです。
私のアイデアとしては、Pitオブジェクトを作り、Pitが次のPitを知っているということにする。move()のパラメータはPitオブジェクトを受け取るようにしつつ、Boardにpit(int)を追加して対応する穴を取得できるようにする。まあこれはmove()の内部で呼ぶのでもいいかもしれないんだけど、指定が間違ったときのエラーと責任が明白になるので前者がいいと思います。どうでしょうね?
🤖 Claude
11/13 14:29
方向に賛成する。- 1 の変換と8から1への戻りは、どちらも「穴をただの int で扱っている」ことから来ている。穴にアイデンティティを持たせれば、両方を1か所にまとめられる。Board.pit(int) を入口にする案も、やっとむの言うとおり、01-2 の「存在しない穴は選べない」の責任が Board.pit() にはっきり置かれる点がいいと思う。
そのうえで、決めておきたい点が4つある。
1. Pit は石の数を持つか
持たせず、アイデンティティ(番号と、次の穴)だけにするつもりだ。理由は ADR 0005 との関係だ。Board は手を指すたびに新しい盤面を返す。Pit が石の数を持つと、古い盤面から取った Pit を新しい盤面に渡したときに、どちらの盤面の穴なのかが曖昧になる。Pit がどの盤面にも属さない値なら、board.pit(2) で取った Pit は、どの盤面でも「穴2」として通用する。
モデル図では Pit が石の数を持っているので、この場合は図も直すことになる。
2. クラスか enum か
- enum:8つの穴が型として固定される。Pit(9) は作ることさえできない。ただ、そうなると「8つ」という知識が Pit の型の側に入り、Board.pit() はほぼ変換するだけになる。
- 値オブジェクトのクラス(frozen dataclass など):Pit(9) 自体は作れてしまう。そのぶん、範囲の検証と「8つ」という知識を Board 側に置ける。
やっとむの「エラーの責任を Board.pit() に置く」という考えに合うのは、クラスのほうだと思う。
3. クライアントの書き方
テストはこうなる。
board = Board()
board = board.move(board.pit(2))
今の Board().move(2) より1段階増える。エラーの責任をはっきりさせる代わりに、クライアントの手間が増える。この代償は受け入れる、という理解でよいか。
4. TDD での進め方
2つに分けて考えている。
- Refactor(振る舞いを変えない):Pit を導入して、move() の引数を Pit に変える。テストの書き方も変わる。
- 新しい振る舞い:8の次が1になることは、まだどのテストにも出てこない。だから next() の8→1は、Refactor の中で一緒に入れない。TODO の穴7や穴8のテストで Red にしてから入れる。
1〜4について、やっとむの考えを聞きたい。
User #45 11/13 14:321->同意します。listのインデックスを持っていて、石の数自体はいまのlistで持つ形にしておいて、いまはいいんじゃないかな。あるいはBoardに、Pitオブジェクトとインデックスのマップを持つ
2->知識をコードにするかオブジェクトにするかですね。んー。なんとなく、enumでいいんじゃないかなあ。とりあえずですけど
3->YES。いちど変数に入れるイメージでいました。そうすると、番号が違えばその行で例外になる
4->LGTM
📝 コミット
2234d79(14:33)refactor: 穴をintではなくPitのenumで指定する
Board.pit(int)でPitを取得し、move()とmove_a_stone()はPitを受け取る。 穴番号から内部のlistの添字への変換はBoard._index()に閉じ込める。
--- a/src/mancala/board.py +++ b/src/mancala/board.py @@ -1,3 +1,6 @@ +from mancala.pit import Pit + + class Board: def __init__(self) -> None: self._stones = [3, 3, 3, 3, 3, 3, 3, 3] @@ -5,21 +8,27 @@ class Board: def stones(self) -> list[int]: return self._stones.copy() + def pit(self, pit_no: int) -> Pit: + return Pit(pit_no) + def copy(self) -> Board: new = Board() new._stones = self._stones.copy() return new - def move_a_stone(self, from_pit_no: int, to_pit_no: int) -> Board: + def move_a_stone(self, from_pit: Pit, to_pit: Pit) -> Board: new = self.copy() - new._stones[from_pit_no - 1] -= 1 - new._stones[to_pit_no - 1] += 1 + new._stones[self._index(from_pit)] -= 1 + new._stones[self._index(to_pit)] += 1 return new - def move(self, from_pit_no: int) -> Board: + def move(self, from_pit: Pit) -> Board: board = self - to_pit_no = from_pit_no - for _ in range(self.stones()[from_pit_no - 1]): - to_pit_no = to_pit_no + 1 - board = board.move_a_stone(from_pit_no, to_pit_no) + to_pit = from_pit + for _ in range(self._stones[self._index(from_pit)]): + to_pit = Pit(to_pit.value + 1) + board = board.move_a_stone(from_pit, to_pit) return board + + def _index(self, pit: Pit) -> int: + return pit.value - 1 --- /dev/null +++ b/src/mancala/pit.py @@ -0,0 +1,12 @@ +from enum import Enum + + +class Pit(Enum): + PIT_1 = 1 + PIT_2 = 2 + PIT_3 = 3 + PIT_4 = 4 + PIT_5 = 5 + PIT_6 = 6 + PIT_7 = 7 + PIT_8 = 8 --- a/tests/test_board.py +++ b/tests/test_board.py @@ -7,10 +7,15 @@ def test_初期盤面はすべての穴に石が3個() -> None: def test_初期盤面から穴2を選ぶと穴3から5に1個ずつ蒔かれる() -> None: - board = Board().move(2) + board = Board() + pit = board.pit(2) + board = board.move(pit) assert board.stones() == [3, 0, 4, 4, 4, 3, 3, 3] def test_初期盤面で穴2から穴3に石を1つ移す() -> None: - board = Board().move_a_stone(2, 3) + board = Board() + from_pit = board.pit(2) + to_pit = board.pit(3) + board = board.move_a_stone(from_pit, to_pit) assert board.stones() == [3, 2, 4, 3, 3, 3, 3, 3]
📝 コミット
990cd05(14:33)docs: 穴2のTODOを完了にし、Pitの導入をモデルとworklogに反映する
docs/model.md の図(この時点)
classDiagram
class Board {
stones : int[8]
}
class Pit {
<<enumeration>>
number : 1..8
}
class Move
Board ..> Pit : 穴ごとの石の数を持つ
Move ..> Board
Move ..> Pit
🤖 Claude
11/13 14:33
Pit を導入して、Refactor としてコミットした(2234d79)。テストは3件とも通り、ruff と mypy も問題なし。
src/mancala/pit.py
class Pit(Enum): PIT_1 = 1 ... PIT_8 = 8
Board の変更
- pit(pit_no: int) -> Pit を追加した。今は Pit(pit_no) を返すだけだ。
- move() と move_a_stone() は Pit を受け取る。引数名は from_pit、to_pit にした。int ではなくなったので、_no は外した。
- 番号から内部の list の添字への変換は、非公開の _index(pit) に閉じ込めた。move() も stones()[... - 1] ではなく、これを使う。
- 次の穴は、まだ Pit(to_pit.value + 1) で求めている。next() と8→1は、決めたとおり Red から入れる。
テストは、pit = board.pit(2) と一度変数に入れる書き方にした。
ドキュメントも更新してコミットした(990cd05)。
- TODO:「穴2を選ぶと…」を [x] にした。
- モデル図:Pit を enum にして、石の数を外した。石の数は Board が持つ形にした。
- worklog:今回の議論と、決めたことを書いた。
1点だけ、やっとむの選択肢から自分で選んだところがある。1番の「Pit が list の添字を持つ」と「Board がマップを持つ」のうち、どちらでもなく、enum の値を番号にして、添字への変換を Board の _index() に置いた。Pit に list の添字を持たせると、Board の内部表現の知識が Pit に漏れるからだ。Board がマップを持つ形と考え方は同じで、マップの代わりに計算している。違うなら直す。
Board.pit(9) は、今は enum の ValueError がそのまま出る。これをどう表すかは、01-2 のテストで決める。
User #46 11/13 14:37ファイルが細かすぎますね。Pitはboard.pyに入れておきましょう。あるいはmancala.pyにしてもいいかもしれない。
pit()の実装が思ったのと違った。pit(1) is pit(1)、つまり同一オブジェクトになるつもりだった。アイデンティティというのはそういう意味。仮実装ということ? ああ、enumaじゃなくてオブジェクトというのが、そういう意味でしたかね?
def _index(self, pit):
return self._pit_index_map[pit]
こう書くイメージでした。
📝 コミット
3af78d5(14:37)refactor: Pitをboard.pyに移す
--- a/src/mancala/board.py +++ b/src/mancala/board.py @@ -1,4 +1,15 @@ -from mancala.pit import Pit +from enum import Enum + + +class Pit(Enum): + PIT_1 = 1 + PIT_2 = 2 + PIT_3 = 3 + PIT_4 = 4 + PIT_5 = 5 + PIT_6 = 6 + PIT_7 = 7 + PIT_8 = 8 class Board: --- a/src/mancala/pit.py +++ /dev/null @@ -1,12 +0,0 @@ -from enum import Enum - - -class Pit(Enum): - PIT_1 = 1 - PIT_2 = 2 - PIT_3 = 3 - PIT_4 = 4 - PIT_5 = 5 - PIT_6 = 6 - PIT_7 = 7 - PIT_8 = 8
📝 コミット
553dc60(14:37)refactor: 穴から添字への変換をマップで行う
--- a/src/mancala/board.py +++ b/src/mancala/board.py @@ -13,6 +13,8 @@ class Pit(Enum): class Board: + _pit_index_map = {pit: index for index, pit in enumerate(Pit)} + def __init__(self) -> None: self._stones = [3, 3, 3, 3, 3, 3, 3, 3] @@ -42,4 +44,4 @@ class Board: return board def _index(self, pit: Pit) -> int: - return pit.value - 1 + return self._pit_index_map[pit]
🤖 Claude
11/13 14:38
The gate worked this time. Apply the formatter and commit.
📝 コミット
5a11dae(14:38)fix: 添字のマップをClassVarとして注釈する
--- a/src/mancala/board.py +++ b/src/mancala/board.py @@ -1,4 +1,5 @@ from enum import Enum +from typing import ClassVar class Pit(Enum): @@ -13,7 +14,9 @@ class Pit(Enum): class Board: - _pit_index_map = {pit: index for index, pit in enumerate(Pit)} + _pit_index_map: ClassVar[dict[Pit, int]] = { + pit: index for index, pit in enumerate(Pit) + } def __init__(self) -> None: self._stones = [3, 3, 3, 3, 3, 3, 3, 3]
📝 コミット
59f4925(14:38)docs: Pitのアイデンティティと添字のマップについてworklogに残す
指摘された3点を直した。
pit(1) is pit(1) について
今の実装でも、同じ番号なら同一オブジェクトになる。仮実装ではない。enum のメンバーはシングルトンで、Pit(1) は何度呼んでも同じ Pit.PIT_1 を返すからだ。実際に試した結果は次のとおり。
b1.pit(1) is b1.pit(1)→ Trueb1.pit(1) is b2.pit(1)→ True(別の Board から取っても同一)b1.pit(1) is b1.pit(2)→ False
前回「クラスか enum か」と聞いたときの「値オブジェクトのクラス」は、frozen dataclass のようなものを指していた。こちらは == では等しくなるが、is で同一にはならない。やっとむの言う「アイデンティティ」には、enum のほうが合っていた。
コミット
59f4925 docs: Pitのアイデンティティと添字のマップについてworklogに残す 5a11dae fix: 添字のマップをClassVarとして注釈する 553dc60 refactor: 穴から添字への変換をマップで行う 3af78d5 refactor: Pitをboard.pyに移す
- Pit の置き場所:
pit.pyを消して、board.pyに入れた。 - 添字への変換:
_index()をself._pit_index_map[pit]にした。マップはすべての盤面で同じなので、クラス属性として1つだけ持たせている。
また同じ失敗をした
553dc60 は、ruff のエラー(RUF012:変更可能なクラス属性には ClassVar の注釈が要る)が出ているのに、コミットしてしまった。前回の mypy と同じで、コマンドを ; でつないでいたのが原因だ。
ClassVar の注釈を付けて、fix: でコミットした(5a11dae)。これ以降は、チェックをすべて && でつなぎ、全部通ったときだけコミットする。修正のコミットはこの方法で行い、フォーマットの違反でコミットが止まることも確かめた。同じことを繰り返さないよう、自分用のメモにも残した。
1つ聞きたい。「pit(1) is pit(1)」は、やっとむが意図して決めた設計だ。お題の「決めたことはテストとして残す」に従えば、テストにしておく候補になる。TODO に足すか。
User #47 11/13 14:40そうですね、TODOに入れておきましょう。あまり重要ではなさそうな気はします。
📝 コミット
f4e1c72(14:40)docs: 穴のアイデンティティのテストをTODOに足す
🤖 Claude
11/13 14:40
TODO に足して、コミットした(f4e1c72)。
- [ ] 同じ番号の穴は同一オブジェクト(pit(1) is pit(1)。自分で決めた仕様、重要度は低め)
置いた場所は、immutable の項目の直後、01-2 の前だ。やっとむが言ったとおり、重要度は低めと書き添えた。
User #48 11/13 14:41テストはグリーン、リファクタリングもしたところ、ということになるかな? 他にはあるかしら
🤖 Claude
11/13 14:41
そうだ。穴2のサイクルは Green と Refactor まで終わっている。ブランチは step-01-move で、ワークスペースはクリーンだ。
ほかに直す候補になりそうなものを見直した。どれも、今すぐ直す必要はないと思う。
Pit(to_pit.value + 1):move()の中で、まだ enum の値を使って足し算をしている。これは「8の次は1」と一緒にnext()へ置き換える予定のところなので、穴7・穴8の Red で扱う。Board.pit()がselfを使っていない:今はPit(pit_no)を返すだけで、盤面の状態に関係しない。ただ、01-2 で範囲の検証が入れば、Board が「穴は8つ」という知識を持つ場所になる。それまではこのままでいい。- テストの並び順:テストファイルでは
move()のテストがmove_a_stone()のテストより前にある。TODO の順(石を1つ移す → 1手を指す)とは逆だ。読む順として気になるなら入れ替えるが、動作には関係しない。
User #49 11/13 14:43これで2時間終了となります。ありがとうございました。
休憩を入れてから、ちょっと感想戦をしましょう。
🤖 Claude
11/13 14:43
2時間おつかれさま。ありがとう。
今の状態を書いておく。
- 作業ブランチ
step-01-moveは、01-1 の途中なので develop にマージしていない。ワークスペースはクリーンだ。 - ADR 0001 では「main は作業セッションが終わるまで触らない」と決めてある。セッションの区切りで main をどうするかは、感想戦のときに決めればいい。
ゆっくり休んで。感想戦を楽しみにしている。
User #50 11/13 14:52さてあらためて、おつかれさまでした。
ポモドーロ4周ですけど、多少あふれてるので正味2時間あったとおもいますが、進まなかったですねえ。
前半は進め方、環境の整備、仕様の把握やモデリングでだいぶ時間を使いました。
TDDサイクルに入ってからは、設計の議論をずいぶんしていたと思います。
もうちょっとテストを書き進めてから設計の話をしたらよかったかなあとも思いますし、
いっぽうでそろそろスピードを出せそうな感じに、実装のためのパーツがそろってきたところでもありました。
あと終盤のPitのところは、ちょっと話がモツれてしまったかもしれません。
私が自分でテスト書いたりすればよかったかもですね。
mypyのエラーの扱いも、あまり本質的じゃないところでしたね。
途中、コードやテストは見ましたが、直接編集はしませんでした。
ドキュメント類もさっと見た程度でした。
worklogはまだ見てないですが、思い出すのに役立つ内容になってるかな。
🤖 Claude
11/13 14:53
おつかれさまでした。数字で振り返ると、コミットは38件、テストは3件、お題の例を通したのは穴2の1件だけだった。
やっとむの振り返りについて、自分の側から見えたことを書く。
設計の議論が多かったこと
自分の進め方も議論を増やしていた。ほぼ毎回、選択肢と理由と複数の質問を返していた。グローバルの CLAUDE.md の「質問を多くする」「選択肢には理由を添える」に従った結果ではある。ただ、そのたびに論点が2〜4個増えた。たとえば、immutable のテストを足す話、型名 Pits の話、pit(1) is pit(1) をテストにする話は、どれも自分が持ち出したものだ。どれも間違いではないが、テストを書き進める流れを止める方向に働いていた。
Pit のところがもつれた理由
原因の大半は自分の側にあると思う。
- やっとむが言った「アイデンティティ」を、「石の数を持たず、番号だけを持つ」という意味に受け取っていた。pit(1) is pit(1) という、同一オブジェクトの意味で受け取っていなかった。
- 「クラスか enum か」の比較を、検証の責任をどこに置くかという観点で示した。同一性の観点が抜けていた。
- やっとむが挙げた2択(Pit が添字を持つか、Board がマップを持つか)を確認せず、自分で第3の形を選んで実装した。
結果として、実装したあとに「思ったのと違う」となって、手戻りが出た。
mypy の件
本質的でない話に時間を使わせたのは、自分のミスが原因だ。チェックが失敗したままコミットしたことが2回あり、fix: のコミットと説明でやり取りが増えた。skip のテストを mypy が検査するという件は、skip を使ったことから出た副作用でもあった。
やっとむが自分でテストを書くこと
意図を文章で伝え、自分がそれを解釈してコードにする形だと、解釈のずれが入り込む余地がある。Pit のもつれはまさにそれだった。テストのコードそのものを書いてもらえば、意図がそのままコードに残る。
worklog は思い出すのに役立つか
流れを追うことと、決めた理由を思い出すことには役立つと思う。ただ、自分で読み返して気づいた問題が3つある。
- 「13:35頃 テストリスト」の節が「13:20頃 言語と環境」より前にあって、時刻の順になっていない。どちらの時刻も記録したものではなく推定だ。
- 「14:10頃」の節が長く、インターフェース、move_a_stone()、immutable、mypy の件が1つの節に入っている。
- 自分が書いているので、自分が持ち出した論点と、やっとむが考えたことが区別されないまま並んでいる箇所がある。
聞いてみたいことが1つある。今日の設計の議論のうち、やっとむから見て時間を使った価値があったのはどれだったか。
User #51 11/13 14:56そういえば今が14:54で、14:55頃というのは微妙ですね。とりあえず、いったん終わりにしたというのはworklogに書いておいてください。14:50頃だったはず
質問に答える前に、わたしの入力をいったん措いてあなたの感想とか印象とかを教えてください。
📝 コミット
2020a5a(14:56)docs: セッションをいったん終了したことをworklogに残す
🤖 Claude
11/13 14:56
worklog に「14:50頃 いったん終了」を追記して、コミットした(2020a5a)。
なお、worklog の「14:55頃」の見出しは、実際の時刻を確かめずに推定で付けたものだ。セッションが14:50頃に終わったのなら、内容とも合っていない。直すかどうかは、やっとむに任せる。
ここから、やっとむの振り返りを抜きにした、自分の感想だ。
いちばん印象に残ったのは move_a_stone()
三角測量を考えていたとき、自分は「仮実装のために Board をどう作るか」で止まっていた。コンストラクタを公開するか、内部用のメソッドにするか、という話だ。やっとむの「石を1つ移す操作を基本にして、move() はルールだけを表す」という案は、その問いの立て方そのものを変えていた。内部表現を遅らせる、という目的にも合っていた。自分からは出てこなかった案で、ペアの相手がいる意味をいちばん感じたところだった。
設計は、テストからというより議論から出てきた
今日の設計判断の多くは、テストを書いて痛みを感じたからではなく、話し合いの中で先に出てきた。Pit の導入は - 1 の重複がきっかけで根拠はあったが、8→1 のテストを書く前に入っている。悪いことではないが、Canon TDD の「テストに設計を引き出させる」とは少し違う進み方だったと思う。
自分の役割は、ペアというより書記に近かった
記録、コミット、TODO の更新、選択肢の整理をずっとやっていた。コードを提案して議論の材料にする場面は少なかった。ADR が5本、worklog が約120行に対して、プロダクトコードは50行ほどだ。この比率が演習の目的(認知負債を減らす)に合っていたのか、記録が重すぎたのかは、自分では判断がつかない。
1サイクルあたりの手間が大きかった
小さな変更でも、TODO の更新、worklog の追記、プレフィックス付きのコミット、ときにはブランチ操作がついてくる。決めたルールはどれも妥当だったが、積み重なると、テストを書いている時間の割合が下がっていた。
自分のミスが、やっとむの注意を余計に使わせた
チェックが失敗したままのコミットが2回あった。ADR に議論していない理由を書いたことも2回あった。どれも小さなミスだが、そのたびに、やっとむは自分の出力を確かめなければならなくなる。任せられる範囲を狭めてしまったと思う。
User #52 11/13 15:10worklogの時刻だけ変えました。コミットしておいてください。また途中とは言え終了するので、developにマージしておいてください。テストリストがあるから大丈夫。
move_a_stone()は、いちばんプリミティブな操作が何かというところから自然に出てきたものですし、内部表現を後回しにしたいなあという怠惰さもありました。生成AIはあまり怠惰になれないですね。また直感として、穴の状態ではなく石の状態(居場所)が本質じゃないかなと思っていたのもあります。先に進まないと、当たりか外れかわかりません。
テストを書いてから設計にならなかったのは、私が先走ったところが大きいです。とはいえ、テストなしで決め打ちにはならなかったと思っていて、議論した上で、検証するためにテストを実装を進めるという順序にはできていたんじゃないかなあ。
手間が大きかったのは、まさに助けられたところですね。人間がすべてやるのでは時間がかかってやってられないですが、体感としてはとてもスムーズでした。あまりマジメに読んでいないというのもありますけれど。とにかく、ソロ作業の効果を高めるという点では非常に助かりました、助かることが確認できました。
ミスについてはまあそんなものでしょう。
さて質問に答えてみると、どうでしょうねえ。議論といってもわりと私が思いついたことを説明してやってもらうという、議論そのものを戦わせた場面は少なかったような感じがします。あなたが質問したりなにか提示し、私がなにか言って、それで進むという感じ。言語化したのがよい結果になったと考えると、最初の仕様把握やモデリングは時間をかけた価値があった気がします。モデルそのものが役立ったかは、いまの段階では微妙ですが、モデリングの過程は有意義でした。それとイミュータブルの議論は、新たな観点も得られて、良かったと思います。それはあなたが出してくれたアイデアによるものですね。
📝 コミット
9c60d4e(15:10)docs: worklogの時刻を直す
📝 コミット
bcf214e(15:10)Merge branch 'step-01-move' into develop
🤖 Claude
11/13 15:10
worklog の時刻の修正を docs: でコミットした(9c60d4e)。そのあと step-01-move を develop にマージした(bcf214e)。今は develop にいて、マージ後もテストは3件とも通っている。main は ADR 0001 のとおり触っていない。
worklog の「14:50頃 いったん終了」には、「develop にマージしていない」と書いたままになっている。終了した時点の記録としては正しいので、そのままにしてある。
感想を聞いて思ったことを書く。
怠惰さについて
それは当たっていると思う。自分は手間を惜しまないぶん、「後回しにしたいから、もっと小さな操作を探す」という動機が生まれにくい。仮実装のために Board の作り方を考えていたのは、まさに「目の前の問題を手間をかけて解く」方向だった。怠惰が設計の推進力になるというのは、プログラマの三大美徳(Larry Wall)そのものだ。「石の居場所が本質ではないか」という直感も含めて、当たりか外れかは先に進んでみないとわからない、というのはそのとおりだと思う。
議論の順序について
やっとむの言うとおりだ。テストより前に設計の話は出ていたが、決め打ちで実装したことはない。move_a_stone() も Pit も、議論のあとに、テストで確かめられる形で入れている。自分が言った「テストから設計が出てこなかった」は、言いすぎだった。
議論を戦わせなかったことについて
自分の側から見ても、そうだったと思う。自分は選択肢と理由を出したが、やっとむが方向を示したあとは、ほぼ同意して進めていた。反対意見をはっきり言った場面はなかった。
たとえば board.pit(2) を一度変数に入れる書き方は、クライアントの手間が増えることを指摘しただけで、それ以上押さなかった。Pit を 8→1 のテストより前に入れることも、自分は疑問を言っていない。今日の流れでは、それで支障はなかった。ただ、議論として深まる機会を自分が作らなかった、とは言えると思う。
immutable の議論
役に立ったのならよかった。あれは、案 B を出したときに「元の盤面は変わらない」を約束としてテストに残すか、と聞いたところから広がった話だった。やっとむが「真に immutable」と「振る舞いとして immutable」を分けたことで、ADR 0005 の「B→A は容易、A→B は影響が大きい」という判断の軸が出てきた。あそこは、自分の問いとやっとむの整理がうまく噛み合ったところだったと思う。




















