Snowflake-Labs/blueprint-manager

Snowflake-Labs/blueprint-manager

Description: Build your Snowflake environment with confidence using expert-backed, guided blueprints. Interactive configuration workflows powered by Snowflake SME best practices.

Language: Jinja

License: NOASSERTION

Stars: 34

Forks: 14

Open issues: 0

Created: 2026-01-06T14:47:03Z

Pushed: 2026-05-29T16:48:04Z

Default branch: main

Fork: no

Archived: no

README:

Introduction

Blueprints

*Expert-backed guidance for Snowflake setup* Blueprints are step-by-step workflows built by Snowflake SMEs that guide you through environment configuration. Best practices are built into every blueprint—so you can configure with confidence that it follows proven patterns and will scale with your needs.

Blueprint Manager

*Self-service platform configuration, guided by experts* Blueprint Manager walks you through each decision, captures your answers, and generates the SQL and configuration tailored to your environment. No guesswork, no waiting for help—just clear direction to get productive faster.

Why Blueprints?

Expert-backed guidance so you can configure your environment knowing it follows best practices and will scale with your needs.

• Confidence - Expert-defined workflows ensure you're doing it right
• Best Practices - Start with an architecture that scales
• Speed - Get productive faster with guided setup
• Self-Service - Move at your own pace

How does it work?

Blueprints Blueprints are templates for best-practice Snowflake implementation and setup containing expert guidance, prescriptive configurations, validation rules, and generation logic. Blueprints will prompt you for business requirements via Cortex Code, then generate ready-to-execute SQL scripts to implement best-practice configurations, and provide curated documentation recording your decisions.

Cortex Code Skills Blueprints run inside Cortex Code via the $blueprint-builder skill and the $best-practices-skill. Skills are instructions that tell Cortex Code how to navigate and execute Blueprints, and guide the AI to the right best practices based on your inputs to ensure correct outputs for your specific requirements.

*Think of Blueprints as the "cookbook" containing all the implementation recipes and expertise, and Skills as the "index" that helps Cortex Code find and follow the right recipe for your needs.*

Blueprint Manager

This repository contains infrastructure-as-code templates and blueprints for setting up Snowflake blueprints.

Structure

• definitions/ - Question definitions for configuration
• blueprints/ - Available blueprint configurations
• scripts/ - Utility scripts for rendering templates
• projects/ - Project workspaces for organizing answers and outputs
• output/ - Generated infrastructure code and documentation

Setting Up Your Blueprint using Snowflake Cortex (Recommended)

The easiest way to configure your Snowflake Blueprint is using the Blueprint Builder skill with Snowflake Cortex. This provides a guided, interactive experience.

Getting Started

0. Pre-requisite: Cortex Code CLI

In order to get the guided Cortex Code experience you will first need to setup the command line interface on your machine. Those instructions can be found here: https://docs.snowflake.com/LIMITEDACCESS/cortex-code/cortex-code-overview.

1. Clone the repository:

git clone https://github.com/Snowflake-Labs/blueprint-manager.git
cd blueprint-manager

2. Start Cortex CLI:

cortex

3. Launch the Blueprint Builder:

/blueprints:build platform-foundation-setup

How it works:

1. Choose your approach:

• Option A: Provide a description of your organization (size, use case, security requirements, etc.) and Cortex will intelligently configure as many settings as possible
• Option B: Go through each question step-by-step with full guidance

2. Review the configuration — Cortex shows you:

• ✅ Questions it answered automatically (with reasoning)
• ❓ Questions that need your input (account names, emails, etc.)
• ⚠️ Questions that need more context from you

3. Generate SQL — once your answers are complete, Cortex runs the render script to produce ready-to-execute Snowflake SQL

Benefits:

• No need to understand the answer file format
• Intelligent defaults based on your organization profile
• Clear explanation of each configuration decision
• Validation and guidance throughout the process

Cortex Code Commands

The following commands are available when using Cortex Code in this repository:

Core Commands

| Command | Description | |---------|-------------| | /blueprints:list | List available blueprints with metadata | | /blueprints:describe | Show blueprint details including task/step tree | | /blueprints:build | Start the interactive blueprint building process | | /blueprints:validate --blueprint | Check answer file completeness | | /blueprints:render --blueprint | Generate SQL/Terraform/Documentation from answers |

Project Management

| Command | Description | |---------|-------------| | /blueprints:projects-list | List existing projects | | /blueprints:projects-create | Create a new project directory structure | | /blueprints:projects-describe | Show project status (answers, outputs, history) |

Answer File Operations

| Command | Description | |---------|-------------| | /blueprints:answers-init | Generate a skeleton answer file with all questions | | /blueprints:answers-validate | Check for missing/invalid values | | /blueprints:answers-diff | Compare two answer files |

Example Workflow

# 1. List available blueprints
/blueprints:list

# 2. Create a project for your work
/blueprints:projects-create my-company

# 3. Start building interactively
/blueprints:build platform-foundation-setup --project my-company

# 4. Or generate a skeleton and fill manually
/blueprints:answers-init platform-foundation-setup --project my-company

# 5. Validate your answers
/blueprints:validate answers.yaml --blueprint platform-foundation-setup

# 6. Generate SQL output
/blueprints:render answers.yaml --blueprint platform-foundation-setup --project my-company

Skills

This repository includes two Cortex Code skills that are automatically activated:

Blueprint Builder

Guides users through constructing answer files interactively. Triggered when you:

• Ask to set up or configure a blueprint
• Want to…