Skip to content
mif-docs

Skill reference: doc-set-planner

Skill reference: doc-set-planner

Section titled “Skill reference: doc-set-planner”

The doc-set-planner skill is the suite’s orchestrator: it does not author a single genre, it decomposes a broad subject into a coordinated SET of MIF documents, fans out to the member genre skills, and reconciles the cross-document relationship graph. This reference describes what it produces, how, when, and from what sources.

PropertyValue
AuthorsA coordinated, cross-linked set of MIF documents
Purpose groupOrchestrator
MIF conceptTypeorchestrator
Target MIF level3
Primary sourceMIF specification

What this document type is

Section titled “What this document type is”

A single genre skill answers a single-document request. Many real requests — “document the auth system”, “produce the full spec set for feature X” — span several documents that must agree with one another. doc-set-planner is the skill for that altitude: it plans the set, decides which genres compose it, delegates each member to its genre skill, and then proves the members are wired together into one MIF relationship graph rather than a pile of disconnected files.

It works from one of four recipes, each a named decomposition of a subject into a coherent set.

RecipeProduces
diataxisThe four Diátaxis quadrants — tutorial, how-to, reference, explanation
ai-specAn AI-ready spec — feature spec plus an AI-architecture doc and EARS criteria
kiroThe AWS Kiro three-document set — requirements.md, design.md, tasks.md
architectureAn architecture set — arc42 and/or C4 with an ADR decision log

Singleton genres — an ADR, a changelog, an SRE runbook, a playbook, a Rust RFC, a Python PEP, a Google design doc — stand alone and are invoked directly, not through the planner.

How the skill produces one

Section titled “How the skill produces one”

doc-set-planner carries the recipes and the reconciliation procedure as durable instructions, and runs a three-phase flow.

  • Fan-out. The planner selects a recipe, expands it into the list of member documents, and delegates each to its genre skill — for example dispatching the diataxis recipe to the four quadrant skills. Each member is authored over the shared mif-frontmatter floor, with criteria shaped by ears-acceptance-criteria where the genre uses them.
  • Reconcile. Once the members exist, the planner resolves the cross-document relationships[] graph — declaring how each document references, supports, or derives from the others — so the set reads as one connected body of knowledge.
  • Link-completeness. A planner-check gate asserts the graph is complete: every intended relationship is present and every target resolves, with no dangling references. Each member is then proven conformant by mif-validate.

When it is beneficial

Section titled “When it is beneficial”

Reach for doc-set-planner when a request is plural — when the deliverable is a set whose documents must cross-reference and not contradict each other. The value is coordination: the planner guarantees coverage of the recipe’s quadrants and a complete, validated relationship graph, which hand-assembling separate documents rarely achieves.

Do not use it for a single artifact: a lone decision belongs to the adr skill, a lone procedure to a runbook, a lone release record to a changelog. Invoking the orchestrator for one document adds planning overhead with no set to coordinate. Match the altitude of the skill to the altitude of the request.

Example

Section titled “Example”

A request to “document the auth system” runs the architecture recipe: the planner fans out an arc42 document and a C4 model, delegates the key decisions to ADRs, reconciles their relationships[] so the C4 components reference the arc42 building blocks and the ADRs, and runs planner-check to confirm the graph is complete before the set is published.

Provenance & citations

Section titled “Provenance & citations”