jonnifyagile agents
jonnify / Agile Agent Workflow / A4 · Spec / A4.2 / A4.2.3 · The course itself

A4.2 · The triad · dive 3

The course itself

The triad is not only the shape of a Portal rung's spec. It is the shape of this chapter's own spec — a4.md, a4.stories.md, a4.llms.md.

Chapter A4 — the spec layer you are reading — is itself specified by three files, answering the same three questions one level up. The course is a worked example of the artifact it teaches. Select a question on the right to see both instances at once: the Portal rung file and the chapter file.

One question · both triads at once

a Portal rung this course f6.1.md the spec a4.md the chapter spec f6.1.stories.md the stories a4.stories.md the chapter stories f6.1.llms.md the agent brief a4.llms.md the chapter brief same question, same file role · a rung on the left, a chapter on the right
What & why & done → the .md file. On a Portal rung: f6.1.md (the spec). On this course: a4.md (the chapter spec). Same question, same file role, two levels — a rung and a chapter.

Two levels, one shape

The questions do not change with the subject. A specification of anything buildable and acceptable answers what & why & done, who wants what, and how to build — whether the subject is one rung of the Portal's engine or one chapter of a course. So chapter A4 is specified the same way a rung is: three files, the same three questions.

a4.md is the chapter contract: its Goal ("After A4, the reader can write a spec for a rung and the stories that accept it"), its Rationale (5W), Scope, Deliverables (the landing plus modules A4.1–A4.7), Invariants, and Definition of Done — the same six sections A4.3 teaches. a4.stories.md is the chapter's user's side: Connextra stories for three roles — the learner, the developer, and the Claude Author — with Given/When/Then, at chapter, module, and dive levels. a4.llms.md is the chapter's agent brief: the references, the module structure, the no-invent grounding, and the gate command an Author runs to verify each page.

a4.md
The chapter spec — what & why & done. Goal, Rationale (5W), Scope, Deliverables (the landing + A4.1…A4.7), Invariants, Definition of Done.
a4.stories.md
The chapter stories — who wants what. Connextra stories for the learner, the developer, and the Claude Author; Given/When/Then; at chapter, module, and dive levels.
a4.llms.md
The chapter agent brief — how to build it, with proof gates. References, the module structure, the no-invent grounding, the ten-gate command an Author self-verifies with.

A rung's triad and a chapter's triad are the same shape because the three questions are subject-independent. The next section checks the chapter holds itself to the rule.

Does the chapter close?

A4's Definition of Done says the chapter is done when its own triad reads as a spec that passes the traceability rule — the same closure A4.6 teaches. So the chapter is held to the artifact it teaches: each of its three files must answer its question. Step the three a4.* files and the readout reports whether the question is answered, and the running count toward a closed triad.

All three are present and each answers its question, so the chapter's triad is closed: three of three. The course does not exempt itself from the rule it argues for — it is specified by the triad it teaches.

Step the chapter's own triad · is it closed?

a4.md present · what & why & done a4.stories.md present · who wants what a4.llms.md present · how to build three files present · three questions answered · the triad is closed
a4.md answers what & why & done (Goal, Rationale, Scope, Deliverables, Invariants, Definition of Done) — present. The chapter's triad: 3 of 3 questions answered. The course is specified by the artifact it teaches.

The chapter does not exempt itself: a4.md, a4.stories.md, a4.llms.md answer all three questions, so its own triad closes — three of three.

The two triads, side by side

On the Portal, the rung F6.1 is specified by f6.1.*; in this course, the chapter A4 is specified by a4.*. Lined up, the two triads are the same three rows — the question is the constant, the file role is the constant, only the subject changes. A rung on one line, a chapter on the next.

The fragment below lines up both triads. It is markdown specification text, not code: the question as a comment, the two files as the matched pair. Reading down the comments reads the triad; reading across reads the two levels.

# The triad, at two levels — a Portal rung and this course's chapter. (markdown, not code)
# what & why & done   f6.1.md          ↔  a4.md          # Goal · Rationale · Scope · Deliverables · Invariants · DoD
# who wants what        f6.1.stories.md  ↔  a4.stories.md  # Connextra · Given/When/Then · Coverage
# how to build, gated   f6.1.llms.md     ↔  a4.llms.md     # References · Requirements · the prompt

# The questions are subject-independent: a rung and a chapter are specified by the same triad.

The principle

The triad specifies anything buildable and acceptable, at any level: the three questions are subject-independent, so a chapter is specified the same way a rung is.

On the Portal

The rung F6.1 is specified by f6.1.* and the chapter A4 by a4.* — the same three-file triad; the course is a worked example of its own lesson.

The same three questions specify a Portal rung and this chapter — a4.md, a4.stories.md, a4.llms.md are the triad, one level up.

Recap — the triad, applied to itself

Chapter A4 is specified by a4.md, a4.stories.md, and a4.llms.md — the same three files, answering the same three questions, that specify a Portal rung. The questions are subject-independent, so a rung and a chapter take the same shape, and the chapter's own triad closes: three of three. The triad is the unit of a specification, whatever the subject. With the triad in hand, A4.3 opens the first file and reads it section by section.

Next in A4.2: return to the A4.2 module hub, then to A4.3 · Anatomy of a spec — the six sections of the .md file, read on the real f6.1.md.

References

The sources behind a specification as a subject-independent triad, and where it connects in the course.

Sources

Related in this course