ACE · Richard Pineda
← Back to home
[email protected]
Built by AI Solutions Architect Claude Code Terraform Python GitHub Actions
The architecture map

ACE · AI Cloud Engineering

ACE: the tool that does cloud infrastructure engineering with AI.

The AI writes the infrastructure code. ACE decides what is safe to apply, and it never applies anything itself.

Claude Code plugin, called with /ace from the repo that holds the Terraform · every piece below is a real component · click any piece for the details

Click or tap any piece to see what it does, in plain words. The pulses show how the work moves.

WHO DIRECTS, AND IN WHAT ORDER AI Solutions Architect directs and approves
Gives the goal in one sentence, approves each layer and approves the final result.
 /ace from any infra repo Four engineering layers, always in this order 1 Quality standards and quality criteria 2 Process requirements, infrastructure roadmap 3 Design stack, blueprint, module design note 4 Construction one loop per increment, checklist first The AI Solutions Architect approves each layer before the next one starts The infrastructure repo where /ace is called
The Terraform lives in its own repository. The architect calls ACE there as a plugin, with /ace. Nothing is ever written inside ACE itself.
Findings from a project go back to ACE through its feedback file, docs/ace_feedback.md.
 PLATFORM SEPARATION HOW THE WORK IS FENCED, STAFFED AND REMEMBERED 13 hooks watch every action · 12 block approval_gate never runs apply or destroy state_guard no state surgery by hand secrets_guard no credentials or state in git project_boundary no writes into another repo context_guard warns before the context runs out + 8 more blocking hooks · red = blocks (exit 2) 11 specialists · 17 skills cloud-architect terraform brownfield security finops network platform-ops iac-review compliance verification documentation Each step gets only the skills it needs Memory engine PROJECT_TRACKING.md one row per loop · written at every transition .ace/runs/ plans and evidence, outside git docs/ace_feedback.md findings back to ACE
The tracking keeps only a digest of each plan: its hash, counts per action, risk class and top findings.
 WHO DECIDES WHAT MAY BE APPLIED Risk class, read from the real plan r0_read no changes r1_additive only creates r2_mutation updates r3_destructive deletes, no data r4_irreversible deletes data or keys The class can only go up. Lowering it needs a waiver with an expiry date. Quality gate: 32 automated checks terraform_valid lint iac_security tagging_complete naming_compliant no_secrets policies_compliant pinned_versions no_unapproved_destruction cost_estimated + 22 more · tflint, checkov, trivy, conftest, infracost approved = every check passes. The gate decides, not the AI. Exit 0: approved
Every check passes on the real plan. The loop closes and the change can go to a pull request.
 Exit 1: rejected
Back to the specialists with the failure as feedback. Retries are capped by risk class: 3, 5 or 8. At the cap, a report stops for the architect.
 FROM APPROVED CODE TO REAL INFRASTRUCTURE Gate green
all checks pass on the real plan
 Pull request
the plan is commented on it
 Human approval
required by risk class
 Merge
to the main branch
 CI applies
from the merged commit, with OIDC
 ACE NEVER RUNS APPLY Drift and import
Drift: a scheduled plan flags manual changes.
Import: done only at an empty plan.
 Regression suite 2,614
test functions in 132 files
 passes blocks limit component
QUIÉN DIRIGE Y EN QUÉ ORDEN Arquitecto de soluciones de IA dirige y aprueba
Da el objetivo en una frase, aprueba cada capa y aprueba el resultado final.
 /ace desde cualquier repo de infra Cuatro capas de ingeniería, siempre en este orden 1 Calidad estándares y criterios de calidad 2 Proceso requisitos, hoja de ruta de infraestructura 3 Diseño stack, plano, nota de diseño de módulos 4 Construcción un loop por incremento, primero la lista de verificación El arquitecto de soluciones de IA aprueba cada capa antes de que empiece la siguiente El repositorio de infraestructura donde se llama a /ace
El Terraform vive en su propio repositorio. El arquitecto llama a ACE ahí, como plugin, con /ace. Nunca se escribe nada dentro del propio ACE.
Los hallazgos de un proyecto vuelven a ACE por su archivo de retroalimentación, docs/ace_feedback.md.
 SEPARACIÓN DE PLATAFORMA CÓMO SE CERCA, SE ASIGNA Y SE RECUERDA EL TRABAJO 13 hooks vigilan cada acción · 12 bloquean approval_gate nunca ejecuta apply ni destroy state_guard sin cirugía manual del state secrets_guard sin credenciales ni state en git project_boundary sin escribir en otro repo context_guard avisa antes de agotar el contexto + 8 hooks más que bloquean · rojo = bloquea (exit 2) 11 especialistas · 17 skills cloud-architect terraform brownfield security finops network platform-ops iac-review compliance verification documentation Cada paso recibe solo las skills que necesita Motor de memoria PROJECT_TRACKING.md una fila por loop · se escribe en cada transición .ace/runs/ planes y evidencia, fuera de git docs/ace_feedback.md hallazgos de vuelta a ACE
El seguimiento guarda solo un resumen de cada plan: su hash, conteos por acción, clase de riesgo y hallazgos principales.
 QUIÉN DECIDE QUÉ SE PUEDE APLICAR Clase de riesgo, leída del plan real r0_read sin cambios r1_additive solo crea r2_mutation actualiza r3_destructive borra, sin datos r4_irreversible borra datos o llaves La clase solo sube. Bajarla exige un waiver con vencimiento. Quality gate: 32 comprobaciones automáticas terraform_valid lint iac_security tagging_complete naming_compliant no_secrets policies_compliant pinned_versions no_unapproved_destruction cost_estimated + 22 más · tflint, checkov, trivy, conftest, infracost aprobado = todas las comprobaciones pasan. Decide el gate, no la IA. Exit 0: aprobado
Todo aprueba sobre el plan real. El loop se cierra y el cambio puede ir a un pull request.
 Exit 1: rechazado
Vuelve a los especialistas con el fallo como guía. Los reintentos tienen tope según la clase de riesgo: 3, 5 u 8. Al llegar al tope, un informe se detiene a esperar al arquitecto.
 DEL CÓDIGO APROBADO A LA INFRAESTRUCTURA REAL Gate en verde
todo aprueba sobre el plan real
 Pull request
el plan queda comentado en él
 Aprobación humana
exigida según la clase de riesgo
 Merge
a la rama principal
 El CI aplica
desde el commit fusionado, con OIDC
 ACE NUNCA EJECUTA APPLY Drift e import
Drift: un plan programado detecta cambios manuales.
Import: termina solo con un plan vacío.
 Batería de regresión 2.614
funciones de prueba en 132 archivos
 aprueba bloquea límite componente