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

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

Sponsored · Your Podcast. Everywhere. Effortlessly. Share. Educate. Inspire. Entertain. You do you. We'll handle the rest.

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

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、機械的ゲートの 三点セット • 繰り返す修正は文書化し、ハーネスへ戻す