Back to Docs

Reference Architectures

10 real-world architectures where architect fits in production systems. Each one includes a flow diagram, YAML configuration, implementation commands, and the architect features used.

๐Ÿ”„

Self-Healing CI/CD Pipeline

CI/CD

Tests fail in CI โ†’ architect automatically fixes them with Ralph Loop โ†’ creates a PR with the fix.

loopguardrailsreportsbudget
๐Ÿ›ก๏ธ

PR Quality Gate + Auto-Remediation

Development

Linters and SAST detect findings in a PR โ†’ architect applies the fixes โ†’ pushes to the same PR.

runguardrailshookscode_rules
๐Ÿ”’

Security Vulnerability Remediation Pipeline

Security

Scanner detects CVEs โ†’ 4-step pipeline analyzes, fixes, re-scans, and documents for compliance.

pipelineloopguardrailsreports
๐Ÿ›

QA Bug Triage โ†’ Auto-Fix

QA

Bug reported in Jira โ†’ architect reads the ticket via MCP โ†’ attempts fix with Ralph Loop โ†’ creates PR or escalates.

MCPlooprunguardrails
๐Ÿญ

Codebase Migration Factory

Development

200 React class files โ†’ hooks. Parallel workers migrate each file in isolated worktrees.

parallelpipeline.architect.mdguardrails
โ˜๏ธ

Infrastructure as Code with Guardrails

DevOps

Generates Terraform with infrastructure guardrails. Dry-run, validate, tfsec scan, and automatic documentation.

pipelinedry-runguardrailscode_rules
๐Ÿšจ

AIOps Incident Code Remediation

AIOps / SRE

Alert โ†’ AIOps diagnoses root cause โ†’ architect applies code hotfix โ†’ PR with OTel trace.

MCPrunguardrailsreports
๐Ÿงช

ML Experiment Accelerator

MLOps

Experimental notebook โ†’ 5-step pipeline generates production code with tests and MLflow config.

pipelinesub-agents.architect.mdguardrails
๐Ÿ“–

Documentation-as-Code Pipeline

Development

Code merged โ†’ architect reads git diff โ†’ Writer generates docs โ†’ Reviewer verifies โ†’ docs PR.

pipelinesub-agents.architect.mdcontext-git-diff
๐Ÿ“ฆ

Monorepo Dependency Updater

DevOps

React 18โ†’19 across 12 packages. Parallel workers update each package with Ralph Loop.

parallelloopguardrailsreports