blueprint layer 1

Schema, templates, and generation CLI for AI workflow definitions. Produces entity models, workflow specs, and foundation scaffolds from structured markdown definitions.

Parsing a Blueprint Definition

Parse a structured markdown definition into a validated artifact object.

markdown 
// Parse a Blueprint_Definition from markdown
import { parseGeneratedMarkdown } from "blueprint/schema/markdown";

const definition = `---
name: customer-intake-review
version: "1.0"
kind: workflow
---

## Scenario
A support agent reviews a new customer intake form
and routes it to the appropriate team.

## Actors
- Support Agent
- Routing Engine
- Team Lead

## Workflow
1. Agent receives intake form notification
2. Agent reviews form completeness
3. Routing Engine scores urgency
4. Agent assigns to team queue

## Friction Points
- Incomplete forms cause routing delays
- No visibility into queue depth
`;

const result = parseGeneratedMarkdown(definition);
console.log(result);
output 
{
  ok: true,
  artifact: {
    name: "customer-intake-review",
    version: "1.0",
    kind: "workflow",
    scenario: "A support agent reviews a new customer intake form...",
    actors: ["Support Agent", "Routing Engine", "Team Lead"],
    workflowSteps: [
      "Agent receives intake form notification",
      "Agent reviews form completeness",
      "Routing Engine scores urgency",
      "Agent assigns to team queue"
    ],
    frictionPoints: [
      "Incomplete forms cause routing delays",
      "No visibility into queue depth"
    ]
  },
  issues: []
}

Artifact Generation

Generate a workflow document and entity model from a parsed definition.

typescript 
// Generate workflow + entity model from a definition
import { generateArtifacts } from "blueprint/cli/generate";

const definition = {
  name: "customer-intake-review",
  version: "1.0",
  kind: "workflow",
  actors: ["Support Agent", "Routing Engine", "Team Lead"],
  workflowSteps: ["Receive", "Review", "Score", "Assign"],
  frictionPoints: ["Incomplete forms", "No queue visibility"],
};

const artifacts = generateArtifacts(definition);
console.log(Object.keys(artifacts));
console.log(artifacts.workflow.slice(0, 120));
output 
["workflow", "entityModel", "implementationPlan", "skeletonMetadata"]

# Workflow: customer-intake-review

## Overview
Generated workflow for customer-intake-review v1.0.

## Actors
- Support Agent
- Routing Engine
- Team Lead

## Steps
1. Receive — intake form notification arrives
2. Review — agent checks form completeness
3. Score — routing engine assigns urgency
4. Assign — routed to appropriate team queue