Agent Blueprint

Get the business profile for the organization. Returns company details, industry, strategic initiatives, technology profile, and AI readiness score.

Create or upsert a structured business profile for an existing organization. Use this first in the headless workflow: existing PAT + existing org -> create_business_profile -> generate_use_cases or trigger_full_pipeline.

Generate AI use cases from the current business profile and readiness assessment for an existing organization. Returns normalized use case data with IDs you can pass to generate_blueprint.

Start blueprint generation for a chosen use case. This returns an auditId immediately; poll with get_generation_status until the blueprint is ready, then call download_blueprint.

Start the full pipeline for an existing business profile. This runs use cases through implementation plan generation asynchronously and returns a jobId; poll with get_generation_status.

Poll either blueprint generation or full-pipeline generation status. Pass exactly one of auditId or jobId. When the run finishes with a blueprintId, call download_blueprint.

List all blueprints for the organization. Returns summaries with id, title, platform, agent count, and lifecycle status.

Get a blueprint summary by ID. Returns title, executive summary, agentic pattern, platform, agent names/roles, and phase overview. For full details, use download_blueprint.

Get a business case summary for a blueprint. Returns executive summary, headline ROI numbers, pilot economics, and recommendation. For full financial analysis, use download_blueprint.

Get an implementation plan summary for a blueprint. Returns project overview, epic names with phases and story counts, and timeline. For full stories and dependencies, use download_blueprint.

Get the use case analysis linked to a blueprint. Returns business challenge, success metrics, ROI estimate, and strategic alignment.

Get the compiled implementation spec for a blueprint. Returns metadata about the spec package including agent count, platform, and what artifacts are included.

Download a blueprint as an Agent Skills directory. Returns a JSON manifest with all files (SKILL.md, reference docs, scripts) that can be written to disk for any coding agent to consume. Use this instead of reading full blueprint/business-case/plan data via individual tools.

Sync implementation state back to Agent Blueprint. Reports which agents have been implemented, their status, platform artifacts, and any deviations from the spec. Each sync creates a versioned snapshot enabling progress tracking over time.

Report actual performance metrics for a blueprint. The system auto-resolves predicted targets from the blueprint and returns deviation analysis. Supports multiple metrics in one call. Use this after implementing agents to track whether they hit their success criteria.

Get implementation progress and performance metrics for a blueprint. Returns predicted targets, latest actual measurements with deviation analysis, and implementation state (if synced via sync_implementation_state). Use this to check how an implementation is tracking against the plan.

Update blueprint sections with actual implementation data. Sends full top-level sections that are shallow-merged into the existing blueprint. Creates a version snapshot before mutation and propagates staleness to business case and implementation plan. Use this when the implementation diverges from the original recommendation.

Update business case sections. Shallow-merges provided sections into the existing business case data. Propagates staleness to implementation plan. After updating, consider calling recalculate_financials to refresh ROI projections.

Update implementation plan sections. Shallow-merges provided sections into the existing plan. This is a terminal artifact with no downstream staleness propagation.

Update use case fields for a blueprint. Updates the use case linked to the specified blueprint. Propagates staleness to the blueprint.

Update business profile fields. Updates company details, technology profile, strategic initiatives, etc. Propagates staleness to use cases. Also syncs company name to the organization record.

Recalculate business case financials from current blueprint and profile data. Use this after updating the blueprint to refresh ROI projections, labor savings, and payback period. Clears staleness on the business case.

Get strategic recommendations for a blueprint based on implementation state, performance metrics, and AI landscape changes. Returns prioritized, actionable recommendations. Requires implementation state to be synced first via sync_implementation_state. Use ?force=true to regenerate.