【社内勉強会】新年度からコーディングエージェントを使いこなす - 構造と制約で引き出すClaude Codeの実践知

Slide 1

Slide 1 text

新年度から新年度からコーディングエージェントをコーディングエージェントを使いこなす使いこなす構造と制約で引き出すClaude Code の実践知構造と制約で引き出すClaude Code の実践知 2026/03/23 3-SHAKE 社内勉強会 @nwiizo

Slide 65

Slide 65 text

ハーネスエンジニアリングとは何か coding agent = AI model(s) + harness 。エージェントの品質はモデルの賢さではなく、周囲の制約（ハーネス）の質で決まる。 Mitchell Hashimoto が「エージェントがミスをするたびに、二度とそのミスを起こせない仕組みを作る」と定義した。Can Boluk のベンチマークでは、同じモデルでもハーネスの違いで22 ポイント性能が変わる一方、モデルを交換しても1 ポイント程度しか変わらなかった。投資すべきはモデルではなくハーネス。 3 つの柱コンテキストエンジニアリング — エージェントが参照する情報の質を管理する。CLAUDE.md は索引、rules で制約、ADR で判断履歴。Slack やドキュメントはエージェントに見えない。リポジトリに書かれたものだけが真実構造的制約 — linter 、型システム、アーキテクチャルールで「そもそも間違ったコードが書けない」状態を作る。エラーメッセージに修正手順を埋め込めば、エージェントが自己修正できる自動ゴミ収集 — エージェント生成コードは人間と異なる形で劣化する（重複、未使用コード、型の劣化）。定期的に品質スキャンし、リファクタリングPR を自動生成するなぜハーネスがモデルより重要なのかモデルの性能は開発者がコントロールできない。次のバージョンが出れば変わるし、プロバイダの判断で挙動が変わることもある。一方、ハーネスは開発者が完全にコントロールできる。 linter のルール、テストの網羅性、型の厳密さはすべて自分たちで設計できる。さらに、ハーネスは複利で効く。一度追加したlinter ルールは、以後のすべてのコード生成に適用される。テストは書いた瞬間から永続的に品質を検証し続ける。モデルの改善は一時的だが、ハーネスの改善は蓄積する。 65

Slide 1

Slide 1 text

Slide 2

Slide 2 text

Slide 3

Slide 3 text

Slide 4

Slide 4 text

Slide 5

Slide 5 text

Slide 6

Slide 6 text

Slide 7

Slide 7 text

Slide 8

Slide 8 text

Slide 9

Slide 9 text

Slide 10

Slide 10 text

Slide 11

Slide 11 text

Slide 12

Slide 12 text

Slide 13

Slide 13 text

Slide 14

Slide 14 text

Slide 15

Slide 15 text

Slide 16

Slide 16 text

Slide 17

Slide 17 text

Slide 18

Slide 18 text

Slide 19

Slide 19 text

Slide 20

Slide 20 text

Slide 21

Slide 21 text

Slide 22

Slide 22 text

Slide 23

Slide 23 text

Slide 24

Slide 24 text

Slide 25

Slide 25 text

Slide 26

Slide 26 text

Slide 27

Slide 27 text

Slide 28

Slide 28 text

Slide 29

Slide 29 text

Slide 30

Slide 30 text

Slide 31

Slide 31 text

Slide 32

Slide 32 text

Slide 33

Slide 33 text

Slide 34

Slide 34 text

Slide 35

Slide 35 text

Slide 36

Slide 36 text

Slide 37

Slide 37 text

Slide 38

Slide 38 text

Slide 39

Slide 39 text

Slide 40

Slide 40 text