← docsFull-Lifecycle

/plan-to-blueprint

Turn a one-off plan into a reusable executable contract.

Takes an implementation plan and generates a skill contract from it. The plan describes what to do; the blueprint defines how the agent does it repeatably. This is where one-off work becomes institutional memory.

Category

Full-Lifecycle

Execution

Plan → SKILL.md + template.json

Goal

Transform an approved plan into a reusable workflow contract that any agent can execute deterministically.

Scope

Applies to

  • +Plans that describe repeatable procedures
  • +Workflows that will be invoked more than once

Does not cover

  • −One-off tasks
  • −Plans that are too vague to proceduralize

Triggers

"Turn this plan into a skill""Create blueprint from plan"Phase 5 of radioactive

Inputs

  • →Approved task.md or plan document
  • →Project slug
  • →Existing project skills (to avoid duplication)

Invariants

  • 01Generated contract must have all 8 sections
  • 02Must wire into project routing matrix
  • 03Must not duplicate existing workflow

Procedure

  1. Step 1Read the plan and extract the procedure
  2. Step 2Check existing skills for overlap
  3. Step 3Draft contract: Goal, Scope, Triggers, Inputs, Invariants, Procedure, Outputs, Review gate
  4. Step 4Generate template.json manifest
  5. Step 5Wire into routing matrix and SKILL.md

Outputs

  • ▸skills/<project>/workflows/<feature>/SKILL.md
  • ▸template.json (optional)
  • ▸Updated routing matrix

Review Gate

  • [ ]Contract has all 8 sections
  • [ ]No duplication with existing workflows
  • [ ]Routing matrix updated
  • [ ]template.json commands match workflow folders