synthesize

Generate formal runbooks from planning briefs using canonical vocabulary IDs.

6|1|Updated Mar 14, 2026
One-click install
npx skills add https://github.com/micherra/canon --skill synthesize-micherra
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: synthesize
Source: https://github.com/micherra/canon/tree/main/skills/canon/skills/synthesize
Command: npx skills add https://github.com/micherra/canon --skill synthesize-micherra

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill automates the generation of formal runbooks from planning briefs by weaving canonical step IDs into structured, validated plans and ensuring tail requirements and per-step constraints.

Core Features & Use Cases

  • Generates runbooks using only vocabulary IDs from references/runbook-vocabulary.md.
  • Validates step definitions, ensures mandatory tail, and produces per-step artifacts and HITL signals.
  • Supports optional resources (scripts/references/assets) and contract pairings for complex releases.
  • Use Case: When you need a repeatable, auditable runbook for a new feature or migration, this skill provides a production-grade skeleton that can be iterated with HITL.

Quick Start

Provide a planning brief and let this Skill synthesize a compliant runbook using canonical vocabulary.

Frequently Asked Questions about synthesize

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate runbook generation from a planning brief?

Runbook generation from a planning brief is automated by synthesizing formal, validated step sequences using a canonical vocabulary. The process enforces frontmatter constraints, mandatory tail requirements, and per-step artifacts to produce a production-grade, auditable plan.

What is a canonical vocabulary runbook for engineering orchestration?

A canonical vocabulary runbook for engineering orchestration is a structured plan that uses only predefined step IDs from a validated reference file. It ensures traceable, compliant step sequences required for complex tasks like feature work or migrations.

How do I validate step IDs in a synthesized runbook?

Validating step IDs in a synthesized runbook involves checking each step definition against a dedicated reference vocabulary file. This ensures all steps, frontmatter fields, and tail requirements conform to canonical constraints before execution.

Can I include custom scripts and assets in an automated runbook?

You can include custom scripts, references, and assets in an automated runbook by directing the skill to attach optional resources. This supports contract pairings and complex release artifacts alongside the validated step sequences.

Does automated runbook synthesis support human-in-the-loop validation?

Automated runbook synthesis supports human-in-the-loop validation by producing per-step HITL signals within the generated plan. This allows teams to iterate on the production-grade skeleton while maintaining formal validation and traceability.

What are the limitations of using a canonical vocabulary for runbook synthesis?

The limitation of using a canonical vocabulary for runbook synthesis is that all step IDs must strictly match the predefined reference file. Runbooks requiring steps outside this validated vocabulary will fail validation constraints and cannot be generated.