EDK · Architecture · Richard Pineda
← Back to home
erpp1712@gmail.com
Built by AI Solutions Architect Claude Code Python pytest
The architecture map

EDK · Enterprise Development Kit

The AI writes the software. EDK makes it trustworthy: tested, verified by an automated quality gate, approved by an AI Solutions Architect.

Claude Code plugin, called with /edk from any repo where an app is being built · 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.
 /edk from any app repo Four engineering layers, always in this order 1 Quality risks, standards, quality metrics 2 Process requirements, backlog, product roadmap 3 Methods design, SOLID design note, architecture blueprint 4 Construction tests first, then code, one increment per loop The AI Solutions Architect approves each layer before the next one starts The product repo where /edk is called
The app is built in its own repository. The architect calls EDK there as a plugin, with /edk. Nothing is ever written inside EDK itself.
Problems found in a product go back to EDK through its feedback file, docs/edk_feedback.md.
 PLATFORM SEPARATION HOW THE WORK IS FENCED, STAFFED AND REMEMBERED 6 hooks watch every action platform_separation no project writes inside EDK git_guard no destructive git on unsaved work impact_guard no code outside the impact map context_guard warns before the context runs out graph_freshness_guard stops the loop on a stale map sound_alert tells you when it needs you red = blocks the action (exit 2) · teal = informs only 11 specialists · 29 skills architecture backend frontend database data ai devops security qa code-review documentation Each step gets only the skills it needs Memory engine PROJECT_TRACKING.md the single source of truth · written at every transition docs/dashboard.md docs/lessons.md docs/decisions.md
The views are regenerated from the file, never edited by hand. Closed steps are archived, never deleted.
 WHO DECIDES THE CLOSE Quality gate: 20 automated checks quality_validator.py pytest_verde seguridad solid_design_note revision impacto_registrado arquitectura_imports migraciones_idempotentes no_hardcoding no_contaminacion diseno artefactos clarificacion auditoria modelo_datos roadmap_mvp blueprint_arquitectura stack_concreto tests_frontend_declarados ci_pipeline ci_corrida approved = every check passes. The gate decides, not the AI. Exit 0: loop closed
All checks pass and the architect approves. The step is archived and the result goes to the product repo.
 Exit 1: loop blocked
Back to the specialists with the failure as feedback. After 2 failures a stronger model takes over. At the cap, a report stops for the architect.
 Regression suite protects EDK itself · runs in CI 3,138
test functions in 167 files, run on Ubuntu and Windows on every pull request.
 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.
 /edk desde cualquier repo Cuatro capas de ingeniería, siempre en este orden 1 Calidad riesgos, estándares, métricas de calidad 2 Proceso requisitos, pendientes, hoja de ruta del producto 3 Métodos diseño, nota de diseño SOLID, plano de arquitectura 4 Construcción primero las pruebas, luego el código, un incremento por loop El arquitecto de soluciones de IA aprueba cada capa antes de que empiece la siguiente El repositorio del producto donde se llama a /edk
La app se construye en su propio repositorio. El arquitecto llama a EDK ahí, como plugin, con /edk. Nunca se escribe nada dentro del propio EDK.
Los problemas que aparecen en un producto vuelven a EDK por su archivo de retroalimentación, docs/edk_feedback.md.
 SEPARACIÓN DE PLATAFORMA CÓMO SE CERCA, SE ASIGNA Y SE RECUERDA EL TRABAJO 6 hooks vigilan cada acción platform_separation ningún proyecto escribe en EDK git_guard protege el trabajo sin guardar impact_guard nada fuera del mapa de impacto context_guard avisa antes de agotar el contexto graph_freshness_guard frena el loop si el mapa caducó sound_alert avisa cuando te necesita rojo = bloquea (exit 2) · turquesa = solo avisa 11 especialistas · 29 skills architecture backend frontend database data ai devops security qa code-review documentation Cada paso recibe solo las skills que necesita Motor de memoria PROJECT_TRACKING.md la única fuente de verdad · se escribe en cada transición docs/dashboard.md docs/lessons.md docs/decisions.md
Las vistas se regeneran desde el archivo, nunca se editan a mano. Los pasos cerrados se archivan, nunca se borran.
 QUIÉN DECIDE EL CIERRE Quality gate: 20 comprobaciones automáticas quality_validator.py pytest_verde seguridad solid_design_note revision impacto_registrado arquitectura_imports migraciones_idempotentes no_hardcoding no_contaminacion diseno artefactos clarificacion auditoria modelo_datos roadmap_mvp blueprint_arquitectura stack_concreto tests_frontend_declarados ci_pipeline ci_corrida aprobado = todas las comprobaciones pasan. Decide el gate, no la IA. Exit 0: loop cerrado
Todo aprueba y el arquitecto aprueba. El paso se archiva y el resultado pasa al repositorio del producto.
 Exit 1: loop bloqueado
Vuelve a los especialistas con el fallo como guía. Tras 2 fallos entra un modelo más potente. Al llegar al tope, un informe se detiene a esperar al arquitecto.
 Batería de regresión protege al propio EDK · corre en CI 3.138
funciones de prueba en 167 archivos, corren en Ubuntu y Windows en cada pull request.
 aprueba bloquea límite componente