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

私のハーネスエンジニアリング

H.Matsutani
November 15, 2026

 私のハーネスエンジニアリング

第31回 redmine.tokyo 講演
https://redmine.tokyo/projects/shinared/wiki/%E7%AC%AC31%E5%9B%9E%E5%8B%89%E5%BC%B7%E4%BC%9A
2026/10/31(土)
Pleasanter Lounge
場所:東京都中野区中野2-30-5 中野アーバンビル7F (JR中野駅 徒歩3分)

概要
AI駆動で開発するときの、私のハーネスの工夫を紹介します
正解の提示ではなく**私の現在地**。ルールやスキル自体も継続的に改良しており、今後も変わっていきます
現時点の「私の工夫」が、皆様のご参考になれば幸いです

H.Matsutani

November 15, 2026

Transcript

30 slides
  1. 2

  2. 3

  3. S T EP 0 〜6 × 工夫1 〜3 私のハーネスエンジニアリング CLAUDE.md

    全体像 Claude Codeが毎回読み込む指示書。プロジェクトのルールや守るべき制約を書いておく。 12
  4. STEP2〜6:設計からドキュメント反映へ STEP2 設計 STEP3 テストRED STEP4 実装 STEP5 テストGREEN STEP6

    ドキュメント反映 各STEPで、必ず人がレビューする STEP2でブランチ作成 → 各STEPレビュー後にコミット → STEP6(最終チェック)後にAIがPR作成 → マージは必ず人間が実行 体験談:STEP3でAIがImportErrorによる失敗を誤って「RED確認」と報告 → 指摘後、スタブ実装に修正し意味のあるRED確認に訂正(opbaseコミット d0f8b59) 16
  5. フェーズ表:STEP0〜6 STEP やること 工夫のポイント Redmineの「アイデア」トラッカーで集約。 AIを増幅器として使う 0. 壁打ち アイデア出し 1.

    要件定義 要件を文書化 2. 設計 設計ドキュメント作成 要件の網羅性をチェック 3. テストRED 先にテストを書き失敗確認 アサーションで失敗することを確認 4. 実装 テストを通す実装 要件トレーサビリティで実装漏れをチェック 5. テストGREEN 全テスト合格を確認 手動確認が必要なシナリオもチェック 6. ドキュメント反映 README等を機能に整合 最終チェック。承認後AIがPR作成、マージは人間 要件タグを付番し、以降のSTEPで追跡 14
  6. 各STEPで、要件タグごとのトレーサビリティをチェック 要件タグ 設計参照 テスト参照 実装参照 ステータス REQ-F001 ✓ ✓ ✓

    ✓ (空欄) テスト済 REQ-F003 ✓ (空欄) (空欄) REQ-F002 ✓ 未カバーの観点あり ← 漏れ! テスト未特定 ← 漏 れ! 全部は読めないので、判断材料になる表をAIに作らせている 18
  7. 要件マトリックスを網羅したテストを書いているか確認 観点:正常系∕異常系∕境界値∕権限違い 要件タグ 観点 観点の内容 テスト項目 実施者 実施結果 REQ-F001 正常系

    要件どおりの入力で正しく動作する 暗号化→復号の往復テスト 自動 — REQ-F001 異常系 不正な入力やデータ改ざんを検知する 改ざん・不正値での例外テスト 自動 — REQ-F001 境界値 空値・最大長など境界条件で破綻しない 空文字・上限長でのテスト 自動 — REQ-F001 権限違い 権限の無い利用者からの操作を拒否する 権限なしユーザーでの手動確認 手動 未実施 20
  8. A I にR e d m i n e を使わせる工夫

    〜 Redmineスキルの概要 〜 起票 チケット参照 ステータス変更 コメント追記 22
  9. A I にR e d m i n e を使わせる工夫

    〜 リンク記法の工夫 〜 1 裸の「#N」参照(Redmineチケットへのリンク)は前後にスペースを入れて確実にリンクさせる 2 GitHubのPR・Issue(#N)はリンク記法で書き、Redmineのチケット参照と区別する 3 違反があれば、投稿前に自動チェックする仕組みを用意 23
  10. 今後の方向性 「ハーネスエンジニアリングとは」の3要素を、現状と次の一手で棚卸しする 制約 評価の仕組み 実行環境 (ツール等) STEP0〜6の制約が、かなり効いている → さらにブラッシュアップしていく 要件マトリックス・テストマトリックスは効いている

    定量的なメトリクスを強化したい Redmine以外はあまり使えていない → 静的品質チェック(SonarQube等) を検討したい AIコーディングも、今後どんどん変わっていくとおもいます。新しいことにどんどん取り組んでいきます。 28
  11. 自己紹介 (個人事業主) フューチャーマインテクノロジーズ まつたに ひでひさ • 本業:通信ソフトウェア業界のSE(開発17年・運用14年) • 2020年〜:Redmine Japan

    運営スタッフ • • 2014年〜:Redmine.tokyoスタッフ 2026年:Futuremine Technologies 開業 お問合せ、お仕事のご相談 おまちしております 31

More Decks by H.Matsutani

Other Decks in Technology