Development record
session
A session is the unit of work for the /abcd:intent grill sub-verb, which is a design
target, not shipped: abcd intent registers no grill sub-verb, so nothing that ships today runs
a session in this sense. The glossary README's grill section records the design.
Two things ship instead. One is the planning interview: the /abcd:intent plugin page runs it
with the person present, and the interview sub-verb runs it in a plain Terminal. Both forms ask
one thing at a time. The other is the record-grill leg of /abcd:ideate's admission gauntlet,
which reads the record and asks no one anything. Neither writes a PRD. In the design, a session
begins when the human runs the command and ends when the PRD is written. Within a session, the oracle asks
Socratic questions (up to 12 total, 3 per round), the human answers, the oracle sharpens terms
and captures glossary updates inline, then silently synthesises a PRD.
This term is bounded to the interview context. Do not import it into HTTP/auth contexts or use it generically — the abcd interview session is a distinct concept with its own lifecycle.
When to use
Use "session" when describing the lifecycle of a single designed /abcd:intent grill invocation. A
session is atomic — it either completes (PRD written) or is abandoned (no PRD artifact).
When NOT to use
Never use "user session", "login session", "auth session", or "HTTP session" to mean this concept. Those terms carry authentication and web-protocol connotations that are orthogonal to the grill interview. Within abcd documentation, unqualified "session" in the interview context means the designed grill exchange, never one of the interviews that ship.
Lifecycle
| Phase | Condition |
|---|---|
| Starts when | /abcd:intent grill <target> is invoked by the human (design target) |
| Ends when | PRD synthesis completes and prd.md is written to disk (design target) |
Examples
- "In the design, a session takes Carol through three rounds of Socratic questioning for an intent."
- "A session that is abandoned before PRD synthesis produces no artefact."
Related terms
- record families — the one page that maps the record families and how they relate
- embark — the opening move that initiates a session
- intent — the primary target of a grill session
Frontmatter
| term | session |
|---|---|
| bounded_context | interview |
| status | stable |
| aliases | grill session, interview session |
| definition | One complete interactive exchange between a human and the abcd grill sub-verb, a design target that does not ship, spanning all rounds of Socratic questioning through PRD synthesis for a single intent or brief section. |
.abcd/development/brief/glossary/interview/session.md
open on GitHub ↗ · commit history ↗