Upgrade to Pro — share decks privately, control downloads, hide ads and more …

ルールを書いて終わらせないハーネスエンジニアリング

 ルールを書いて終わらせないハーネスエンジニアリング

Avatar for Yuji Yamaguchi

Yuji Yamaguchi

July 18, 2026

More Decks by Yuji Yamaguchi

Other Decks in Programming

Transcript

  1. • 業務 ◦ プロダクトエンジニア・エンジニア採用・技術広報 • 経歴 ◦ 1987/12 埼玉県本庄市生まれ ◦

    2011/04 ソフトバンクモバイル株式会社 ◦ 2016/01 株式会社サイバーエージェント ◦ 2016/10 株式会社リクルートライフスタイル ◦ 2021/09 株式会社ラクス ◦ 2022/08 株式会社HRBrain ◦ 2025/07 Dress Code株式会社 • プライベート ◦ マンガ・アニメ・ゲーム・映画 ◦ 三児の父(中3, 中1, 年中) 自己紹介 山口 祐司 ぷーじ(@yug1224) 3
  2. CONFIDENTIAL | © Dress Code Inc . All rights reserved.

    14.1億円  資金調達を実施 Pre Seed&Seed Round 200+社 が利用中  Number of companies Number of countries 5カ国 で事業を展開  会社概要 Company Name / 会社名 Dress Code 株式会社 2024年9月 正式創業:2025年4月 47名 東京都中央区築地2-1-4 銀座PREX East 8F CEO / 代表取締役 Date of establishment / 設立年月 Location / 所在地 江尻 祐樹 Member / メンバー数 5
  3. 私のハーネスエンジニアリングとは 9 • エージェント単体ではなく、その外側の仕組み を整えること • 事前の guides(ルール、スキル、権限)で進路 を示す •

    事後の sensors(フック、lint、CI)と検証 ループで逸脱を戻す • モデル本体はベンダー任せ、こちらが触れるの は外側だけ
  4. dotfiles: ポータブルな個人ハーネス • Cursor と Claude Code で、共通の shared/ai/ を原本にする

    • AGENTS.md、rules、commands、 agents、hooks をツール非依存で管理する • 各ツール側は薄いラッパー(設定と frontmatter)だけにする • Shell は guard、RTK、allowlist の3層で、破壊 的操作は guard で止める • 調査は CodeGraph(MCP)を優先し、grep の 前に構造を掴む • 公開範囲は Public と Local、共通知は shared、 会社固有や個人は .local.md 11
  5. Dress Code: チームの共有ハーネス 12 • AGENTS.md を正にし、ルールとスキルの索引 を置く • 常時適用ルールで最低限の品質を固定する

    ◦ coding、architecture • Skill は画面パターン、ドメイン、OpenSpec な ど用途ごとに分ける • FE と BE で、Cursor と Claude の設定をミラー 同期する • 専門判断は Subagentに任せる ◦ アーキテクト、ドメインエキスパート
  6. ルールだけでは足りない 13 • ルールを書いただけでは、エージェントはたまに 破る • lefthook、oxlint、CI は sensors、機械的にゲー トする

    • 危険なシェル操作は guard-shell で deny または ask にする • 繰り返す手直しは Skill や Rule に昇格させる (失敗を環境へ戻す) • プロンプトはヒント、最終防衛線はフックと CI
  7. まとめ 14 • モデルより先に、ハーネスへ投資する • 骨格は Fowler(guides × sensors)、 育て方は

    Hashimoto 寄り • 持ち運べる層(AGENTS.md、MCP、CI)を 厚くし、ツール固有は薄くする • チームでは索引、Skill、機械的ゲートの 三点セット • 繰り返す修正は文書化し、ハーネスへ戻す