Workflow to App

blueprintfoundation

Blueprint CLI generating a Foundation starter from a sample definition.

Step 1 — Blueprint Definition File

A structured markdown Blueprint_Definition describes the workflow entities, steps, and schema references.

yaml

# Blueprint_Definition: knowledge-base-qa
version: 1.0.0
type: workflow

metadata:
  name: Knowledge Base Q&A
  description: >
    RAG pipeline that answers user questions from an ingested corpus.
  author: dblxl-team

entities:
  - name: Question
    fields:
      - { name: text, type: string, required: true }
      - { name: userId, type: string, required: true }

  - name: Answer
    fields:
      - { name: text, type: string }
      - { name: confidence, type: number }
      - { name: citations, type: Citation[] }

workflow:
  steps:
    - id: retrieve
      uses: atlas/retrieval
      input: question.text
      params: { topK: 3 }

    - id: complete
      uses: foundation/ai
      input: { question: question.text, context: retrieve.chunks }

    - id: validate
      uses: protocol/validator
      input: complete.output
      schema: QAAnswerSchema

output

Blueprint_Definition parsed successfully.
Entities: Question, Answer
Workflow steps: retrieve → complete → validate
Ready to generate Foundation scaffold.

Step 2 — CLI Dry Run

The Blueprint CLI parses the definition and lists the files it would generate — without writing anything to disk.

bash

# Terminal — Blueprint CLI dry run
$ blueprint generate \
    --definition src/definitions/knowledge-base-qa.md \
    --output ./generated \
    --dry-run

Blueprint CLI v0.4.1
Reading definition: src/definitions/knowledge-base-qa.md
Validating schema... OK
Resolving templates...

output

[dry-run] Would generate 8 files:

  generated/
  ├── src/
  │   ├── entities/
  │   │   ├── Question.ts
  │   │   └── Answer.ts
  │   ├── workflows/
  │   │   └── knowledge-base-qa.ts
  │   ├── schemas/
  │   │   └── QAAnswerSchema.ts
  │   └── pages/
  │       └── qa.astro
  ├── tests/
  │   └── knowledge-base-qa.test.ts
  ├── package.json
  └── tsconfig.json

No files written (--dry-run). Run without --dry-run to generate.

Step 3 — Generated Foundation Scaffold

Running without --dry-run writes the full Foundation scaffold: entities, workflow, schema, page, tests, and config.

bash

# Generated Foundation scaffold (after removing --dry-run)
$ blueprint generate \
    --definition src/definitions/knowledge-base-qa.md \
    --output ./generated

Blueprint CLI v0.4.1
Generating scaffold...

output

✔  generated/src/entities/Question.ts
✔  generated/src/entities/Answer.ts
✔  generated/src/workflows/knowledge-base-qa.ts
✔  generated/src/schemas/QAAnswerSchema.ts
✔  generated/src/pages/qa.astro
✔  generated/tests/knowledge-base-qa.test.ts
✔  generated/package.json
✔  generated/tsconfig.json

8 files written to ./generated
Foundation scaffold ready. Run `pnpm install && pnpm dev` to start.