Resources
Where to read more — primary references on SDD, IDD, and the tools in this space, plus a glossary of terms used on this site.
Get the code, the docs, and the community
- intent-cli on GitHub
The deterministic CLI that runs the loop. Apache-2.0. The npm path is npm i -g intent-system; it provides the intent-cli command without a .NET SDK. npx runs it without a global install.
- Documentation (EN / JP)
Install, project start, Intent Storming, the loops, recovery, and the command reference.
- J-Tech Japan OSS Discord
Community questions and discussion — free.
SDD landscape
- Understanding Spec-Driven-Development: Kiro, spec-kit, and TesslBirgitta Böckeler · martinfowler.com
Origin of the SDD three-level model.
- spec-driven.mdGitHub Spec-Kit
Frames IDD as the upstream of SDD.
- Tessl Framework documentationTessl
The boldest spec-as-source implementation.
- Augment Intent — overviewAugment Code
macOS app that pairs Spec-anchored discipline with parallel agent execution.
From the Intent System host
Long-form writeups on how Intent-System runs today. Public links coming as soon as the host publishes them — until then, the titles describe what each piece covers.
- Intent System — driving implementation and review autonomously with three threads (③ Implementation loop)
A historical deep dive into the still-supported timer-loop alternative: three independent threads and the Approve edge that rewinds the loop to ③.
- Intent System — concept (①)
What Intent and the intent tree are, framed for AI-assisted teams.
IDD origins (the schools)
- 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
Terms used on this site
- Intent
- The why and what-to-achieve of a system, expressed in customer-facing language.
- Intent Tree
- Hierarchical / relational organization of intents under Purpose / User Context / Means.
- Intent Storming
- The process of structuring technology and intent as the product owner, seeding the intent tree. Same posture as Brainstorming or Event Storming, except the artifact you walk away with is an intent tree. It runs as a group workshop (product owner + engineers, designers if the surface matters) or solo — one person acting as product owner while the AI, guided by intent-cli, interviews them with background / options / pros-cons / recommendation for each open decision.
- Intent-as-source
- Stance that the intent tree is the source of truth, with spec and code as downstream artifacts.
- Intent Compass
- Direction-and-decision-rights packet given to a capable AI for a slice of work.
- Slice
- An issue-ready unit of work cut from the intent tree.
- Design loop
- The cycle inside the design thread: write packet → wait for the merge → drive the running app (Computer Use or Playwright CLI) → judge the result against intent → emit the next packet (adjustment, bug-fix, or new slice). This is what keeps Intent-System from drifting into vibe coding — human-authored intent is added on top of what was actually built, with screen-level evidence attached.
- Packet
- A work unit one level above an Issue. Carries explicit references to the intent it serves and the verification points the implementation must satisfy. Packets are generated by the LLM in the design thread; the design thread also runs the merged app and folds screen-level observations back in before promoting a packet to an Issue.
- herdr-only orchestration
- The preferred, non-preview session transport for collocated teams in released intent-cli v0.22.0. The coding agent or operator runs herdr after approval; intent-cli emits guidance and records or validates the topology. agmsg plus herdr remains supported for distributed or existing-agmsg teams.
- agmsg
- A supported signal transport used with herdr for distributed teams or teams with agmsg already in place. It is not a universal or primary transport; herdr-only is preferred for collocated teams.
- file-backed delivery
- Delivery declared with delivery_method: file-backed. It persists a durable, addressable task envelope and delivers a one-line pointer; without the declaration, delivery remains inline.
- named branch lane
- A registered/default or explicitly selected lane for packet routing, recorded as branch_lane with a routing_snapshot. This is a released preview-through-1.x capability, not a 1.0 compatibility guarantee. intent-cli proposes and records the lane; it does not create or manage branches.
- Git-backed claim
- Multi-user ownership recorded under .intent-cli/claims/ through claim acquire and claim verify. This is a released preview-through-1.x capability, not a 1.0 compatibility guarantee. Only the successful immutable plain push owns the claim; claim before scaffold.
- prompt class and scope
- A literal prompt class plus scoped approval policy, including answerable_by, a hard non-overridable risk floor, and live-dialog compare-and-swap. This is a released preview-through-1.x capability, not a 1.0 compatibility guarantee. Unknown or unmatched prompts escalate.
- team_mode=authoring-only
- A released preview-through-1.x authoring capability and front door for interviewing and shaping intent, authoring packets, and publishing issues. It has no delivery topology or seats; delivery mode remains the default and delivery supervision is not applicable here. It is not a 1.0 compatibility guarantee.
- /loop 5m
- One scheduler choice for the supported three-thread timer-loop alternative. It is not the primary four-role orchestration model.
- Closeout
- Step that writes a merged change back to the intent tree as canonical.