blueprint-engine

id	blueprint-engine
name	blueprint-engine
type	skill
version	1.0.0
created	20/03/2026
modified	20/03/2026
status	active
description	Hybrid DAG execution primitive combining deterministic and agentic nodes with hard iteration caps
context	fork

Blueprint Engine — Hybrid DAG Primitive

Inspired by Stripe Minions: deterministic scaffolding + bounded agentic intelligence. Hard caps are non-advisory — they are enforced by iteration-counter.py.

Node Types

Deterministic Nodes (No LLM — Always Idempotent)

Commands executed directly with no iteration cost:

• git-branch — git checkout -b minion/{task-id}
• git-commit — git add -A && git commit -m "minion: {message}"
• git-push — git push -u origin HEAD
• create-pr — gh pr create --title "minion: {task}" --body "{template}" --label "minion-generated"
• lint — pnpm turbo run lint
• type-check — pnpm turbo run type-check
• test — pnpm turbo run test
• circular-deps-check — pnpm turbo run lint (includes circular dep detection)
• system-supervisor-quick-audit — read .claude/memory/current-state.md + grep for violations (deterministic)
• execution-guardian-check — evaluate risk level from task keywords (deterministic mapping)

Agentic Nodes (LLM Reasoning — Hard Caps Apply)

• implement — Implement the requested feature. Cap: 1 pass only
• reproduce-bug — Write a failing test that reproduces the bug. Cap: 1 pass only
• implement-fix — Fix the reproduced bug. Cap: 1 pass only
• implement-migration — Execute a database or code migration. Cap: 1 pass only
• implement-refactor — Refactor per system supervisor audit findings. Cap: 1 pass only
• fix-ci — Fix CI/test failures. Cap: 2 rounds maximum
• fix-lint — Fix non-auto-fixable lint errors. Cap: 1 round maximum

Hard Iteration Caps (Non-Advisory)