System Design

Component Architecture

Primary Runtime Objects

Object	Created in	Purpose
CHANGE_TEXT	Input section	The natural-language database change request
change_json	Stage 1	Structured interpretation of the request
rag_vector_store_id	Optional PDF RAG section	Hosted vector store ID for uploaded PDF context
rag_file_search_results	Stage 2	Summary of File Search results returned to the Impact Agent
impact_json	Stage 2	Impacted objects, risks, and assumptions
plan_json	Stage 3	Rollout plan, checks, and rollback guidance
sql_text	Stage 4	Draft SQL script
validation	Stage 5	Deterministic SQL sanity-check result
bundle	Final Bundle section	Consolidated workflow output
out_path	Save Artifact section	Saved JSON artifact path
promptfoo_config	Promptfoo section	Generated eval configuration

Important Boundary

SchemaFlow generates draft implementation artifacts. It does not execute SQL against a database, apply migrations, open pull requests, or modify production systems.