実例
リソース
もっと読みたい人向け — SDD / IDD とこの空間のツールに関する一次情報と、本サイトで使う用語集。
intent-cli ── オープンソースのツール
コード・ドキュメント・コミュニティ
- GitHub の intent-cli
ループを動かす決定論的な CLI。Apache-2.0。npm の導入経路は npm i -g intent-system で、.NET SDK なしで intent-cli コマンドを使えます。npx はグローバルに導入せず実行できます。
- ドキュメント (英 / 日)
インストール、プロジェクト開始、Intent Storming、各ループ、復旧、コマンドリファレンス。
- J-Tech JAPAN OSS Discord
コミュニティでの質問・議論 ── 無償です。
SDD とツールの参考情報
SDD の全体像
- Understanding Spec-Driven-Development: Kiro, spec-kit, and TesslBirgitta Böckeler · martinfowler.com
SDD 3 段階モデルの原典。
- spec-driven.mdGitHub Spec-Kit
IDD を SDD の上流として位置づける。
- Tessl Framework documentationTessl
最も大胆な spec-as-source 実装。
- Augment Intent — overviewAugment Code
Spec を基準にした規律と、エージェントの並列実行を組み合わせた macOS アプリ。
私たちの記事
Intent System ホストから
Intent-System が現在どう動いているかを書いた長文。公開リンクはホスト側で公開でき次第。それまではタイトルが内容の見出しになります。
- インテントシステム — 3 スレッドのタイマーループという代替手段 (③ 実装ループ編)
現在も対応しているタイマーループという代替手段の詳細記事。3 つの独立スレッドと、Approve で ③ に戻るループ構造を解説。
- インテントシステム — 概念編 (①)
AI 活用チーム向けに、Intent と intent ツリーが何であるかを言語化。
IDD の参考情報
IDD の出自 (各流派)
- What is Intent-Driven Developmentvisrow · Medium
- Intent-Driven Development: Build-First Documentationvisrow · Keyhole Software
- Intent Driven Development is our Current Futurem8a-io · dev.to
- r/IntentDrivenDev — original threadReddit
用語集
本サイトで使う用語
- Intent
- システムが「なぜ」「何を達成するか」を、顧客向けの言葉で表現したもの。
- Intent Tree
- Purpose / User Context / Means の下に意図を階層・関係づけて整理した構造。
- Intent Storming
- プロダクトオーナーとして技術と意図をまとめ、Intent ツリーの種をまくプロセス。ブレインストーミングや Event Storming と同じ姿勢で行うが、手元に残るのは Intent ツリー。チームのワークショップ(プロダクトオーナー + エンジニア、UI が論点ならデザイナーも)としても、一人でも行える ── 一人がプロダクトオーナーを務め、intent-cli に導かれた AI が論点ごとに背景・選択肢・利点欠点・推奨を提示しながら聞き取りを行う。
- Intent-as-source
- Intent ツリーを正本とし、仕様とコードを下流の派生物として扱う立場。
- Intent Compass
- 能力ある AI にスライス単位で渡す、方向性と決定権限のパケット。
- Slice
- Intent ツリーから切り出された、実装可能な単位の作業。
- Design loop
- 設計スレッドの内側で回る循環: パケットを書く → マージを待つ → 稼働中のアプリを操作する (Computer Use か Playwright CLI) → 出力を意図と照合する → 次のパケット (調整 / バグ修正 / 新しいスライス) を出す。これが Intent-System を雰囲気コーディングに陥らせない仕組み ── 人間が書いた意図が、実際に作られたものの上に画面レベルの証拠と共に重ねられる。
- Packet
- Issue より一段抽象度が高い作業単位。果たすべき意図への参照と、実装が満たすべき検証観点を明示的に持つ。設計スレッドで LLM が生成する。設計スレッドはパケットを Issue に昇格させる前に、マージ済みアプリを実際に動かして画面レベルの観察をパケットに折り込む。
- herdr-only orchestration
- リリース済み intent-cli v0.22.0 における、同じ環境に集まるチーム向けの推奨されるプレビュー外のセッショントランスポート。承認後に herdr を実行するのはコーディングエージェントまたは運用担当者で、intent-cli は案内を出し、構成を記録・検証する。分散チームや既存の agmsg チームでは agmsg + herdr も利用できる。
- agmsg
- 分散チームやすでに agmsg を使っているチームで herdr と組み合わせる、対応する信号トランスポート。普遍的な主トランスポートではなく、同じ環境に集まるチームでは herdr-only が推奨される。
- file-backed delivery
- delivery_method: file-backed で宣言する配信。永続的で参照可能なタスク封筒を保存し、1 行のポインターを届ける。宣言しなければ、配信は本文埋め込みのまま。
- named branch lane
- パケットの振り分けに使う registry/default または明示選択されたレーン。branch_lane と routing_snapshot として記録する。これはリリース済みの preview-through-1.x 機能であり、1.0 互換性保証ではない。intent-cli はレーンを提案・記録するが、ブランチの作成や管理はしない。
- Git-backed claim
- claim acquire と claim verify により .intent-cli/claims/ に記録する複数人での所有権。これはリリース済みの preview-through-1.x 機能であり、1.0 互換性保証ではない。不変な通常の `push` に成功した人だけが担当宣言を所有するため、ひな形作成の前に担当宣言を行う。
- prompt class and scope
- リテラルなプロンプト分類と対象を絞った承認ポリシー。answerable_by、上書きできないリスク下限、実行中の対話に対する比較交換(compare-and-swap)を含む。これはリリース済みの preview-through-1.x 機能であり、1.0 互換性保証ではない。未知または一致しないプロンプトはエスカレーションする。
- team_mode=authoring-only
- コードを書かずに意図を整理して Issue を公開できる、リリース済み preview-through-1.x の authoring-only 機能。エージェントが意図を聞き取り、パケットを作成する。実装は別のチーム・人・ベンダーが担える。配信構成や配信担当席はなく、既定値は delivery mode。ここでの配信監督は対象外で、1.0 互換性保証ではない。
- /loop 5m
- 対応する 3 スレッドのタイマーループという代替手段で使えるスケジューラーの選択肢の 1 つ。主となる 4 役割のオーケストレーションモデルではない。
- Closeout
- マージされた変更を正本として Intent ツリーに書き戻す手順。