Reference · 6 stages · SDLC mapping Referencia · 6 etapas · mapeo al SDLC

The Forge Cycle El Ciclo de La Fragua

Software development follows the same arc as steel: raw material becomes a working artifact through heating, shaping, quenching, and tempering. Each metallurgical stage maps to a software lifecycle stage — and GS has a defined obligation at every gate. El desarrollo de software sigue el mismo arco que el acero: la materia prima se convierte en un artefacto funcional a través del calentamiento, el moldeado, el temple y el revenido. Cada etapa metalúrgica mapea a una etapa del ciclo de vida del software — y GS tiene una obligación definida en cada gate.

The Six Stages Las Seis Etapas

From raw material to production artifact — each stage name links to its recipe De materia prima a artefacto de producción — cada nombre de etapa enlaza a su receta
StageEtapa In the forgeEn la fragua SDLCSDLC GS doesGS hace
01 Calentamiento HeatingCalentamiento Steel heated to 1000 °C+ — rigid metal goes plastic, workable, ready to receive form.Acero calentado a más de 1000 °C — el metal rígido se vuelve plástico, maleable, listo para recibir forma. Problem understandingEntendimiento del problema AI activated; reads requirements and the existing codebase before generating anything.IA activada; lee requerimientos y la base de código existente antes de generar cualquier cosa.
02 Moldeado MoldingMoldeado Hot metal shaped by hammer or press into the mold — form is imposed while malleable.El metal caliente es moldeado por martillo o prensa — la forma se impone mientras está maleable. Spec + designSpec + diseño The spec is the mold. AI stamps from it. Code derives. The mold determines all future shape.La spec es el molde. La IA estampa desde ella. El código deriva. El molde determina toda forma futura.
03 Temple QuenchingTemple Rapid plunge into water or oil — shape locks, martensite forms, steel hardens instantly.Inmersión rápida en agua o aceite — la forma se fija, se forma martensita, el acero se endurece al instante. CI / commitCI / commit Cascade gates lock the shape: mutation testing + coverage + commit discipline fire on every commit.Los gates de cascada bloquean la forma: mutation testing + cobertura + disciplina de commits se activan en cada commit.
04 ⭐ Revenido TemperingRevenido Reheated to 150–700 °C, cooled slowly — relieves brittleness, tunes the hardness/toughness balance.Recalentado a 150–700 °C, enfriado lentamente — alivia la fragilidad, ajusta el equilibrio dureza/tenacidad. MaintainabilityMantenibilidad Structural disciplines always-on: SOLID, hexagonal, layered, TDD, ADRs. The same bridge that serves human readers serves the AI reader.Disciplinas estructurales siempre activas: SOLID, hexagonal, capas, TDD, ADRs. El mismo puente que sirve al lector humano sirve al lector IA.
05 Endurecido HardeningEndurecimiento Case hardening or nitriding — surface resists wear and load; core stays tough.Endurecimiento superficial o nitrurado — la superficie resiste el desgaste y la carga; el núcleo permanece tenaz. CD / stagingCD / staging NFR enforcement + chaos testing + circuit-breaker patterns on every pre-production build.Aplicación de NFRs + chaos testing + patrones circuit-breaker en cada build pre-producción.
06 Recocido AnnealingRecocido Slow furnace cool — relieves internal stress, restores ductility, readies the piece for re-shaping.Enfriamiento lento en horno — alivia el estrés interno, restaura la ductilidad, prepara la pieza para ser re-moldeada. Brownfield / migrationBrownfield / migración Spec re-analyzed → refined → fed back into Calentamiento. The cycle restarts with updated intent.Spec re-analizada → refinada → realimentada a Calentamiento. El ciclo reinicia con intención actualizada.
Cross-cutting: The test pyramid fires at every gate — it is not its own stage. Inspección (human judgment) is the mandatory gate at critical points: spec sign-off, staging promotion, release. Transversal: La pirámide de pruebas se activa en cada gate — no es su propia etapa. Inspección (juicio humano) es el gate obligatorio en puntos críticos: aprobación de spec, promoción a staging, release.

Why Structural Disciplines Help the AI Por Qué las Disciplinas Estructurales Ayudan a la IA

Mechanical advantages — not aesthetic ones Ventajas mecánicas — no estéticas

SOLID, hexagonal architecture, TDD, ADRs, intentional naming — these were invented to make intent legible to the next human reader. A stateless AI reader has the same problem as that human: it arrives knowing nothing about what you meant. The disciplines reduce the token cost of understanding code, eliminate the need to read implementations when contracts suffice, and make the AI's first search deterministic. SOLID, arquitectura hexagonal, TDD, ADRs, naming intencional — estas prácticas fueron inventadas para hacer legible la intención al siguiente lector humano. Un lector IA sin estado tiene el mismo problema que ese humano: llega sin saber nada sobre lo que quisiste decir. Las disciplinas reducen el costo en tokens de entender el código, eliminan la necesidad de leer implementaciones cuando los contratos son suficientes, y hacen que la primera búsqueda de la IA sea determinista.

DisciplineDisciplina Mechanical AI advantageVentaja mecánica para el lector IA
SOLID — interfaces + DISOLID — interfaces + DI The AI reads the contract (N lines), not the implementation (N×10). Hallucinations about private state = impossible.El AI lee el contrato (N líneas), no la implementación (N×10). Alucinaciones sobre estado privado = imposibles.
Single ResponsibilityResponsabilidad Única The AI acts on the class without exploring the call graph. The class is its own complete spec.El AI actúa sobre la clase sin explorar el call graph. La clase es su propia spec completa.
Hexagonal + consistent structureHexagonal + estructura consistente controllers/ always has controllers. The first search hits. No discovery traversals.controllers/ siempre tiene controllers. La primera búsqueda acierta. Sin traversals de descubrimiento.
DDD — ubiquitous languageDDD — lenguaje ubicuo Names in code map to the AI's training data on the same domain. Higher generation quality.Nombres en código mapean al training data del AI sobre el mismo dominio. Calidad de generación más alta.
Conventional CommitsConventional Commits The git log is queryable by type and scope. Cascade triggers fire from parseable types.El git log es consultable por tipo y scope. Cascade triggers se activan desde tipos parseables.
TDD — tests as specTDD — tests como spec Each test is a behavior statement the AI reads before the implementation. The harness verifies output against intent, not just syntax.Cada test es una declaración de comportamiento que el AI lee antes de la implementación. El harness verifica el output contra la intención, no solo la sintaxis.
ADRs The AI reads the why behind decisions. It cannot "optimize" intentional tradeoffs that merely look suboptimal.El AI lee el por qué de las decisiones. No puede "optimizar" tradeoffs intencionales que parecen subóptimos.
Doc-first cascadeCascada doc-first The AI receives intent before implementation. Generating from spec is execution; generating from code without spec is reverse engineering.El AI recibe la intención antes que la implementación. Generar desde spec es ejecución; desde código sin spec es ingeniería inversa.
Intentional namingNaming intencional calcularCostoMensual(userId: UserId, period: BillingPeriod): Result<Money, Error> — domain, operation, inputs, output, error contract, all in the signature. Zero implementation reads.calcularCostoMensual(userId: UserId, period: BillingPeriod): Result<Money, Error> — dominio, operación, inputs, output, contrato de error, todo en la firma. Cero lectura de implementación.
The key insight: These disciplines existed for 30 years and were never fully adopted — because humans couldn't sustain them under pressure. The AI reader that benefits from them is also the executor that enforces them. The adoption friction disappeared. The benefit doubled. La idea clave: Estas disciplinas existieron 30 años y nunca se adoptaron completamente — porque los humanos no podían sostenerlas bajo presión. El lector IA que se beneficia de ellas es también el ejecutor que las hace cumplir. La fricción de adopción desapareció. El beneficio se duplicó.
Reference Referencia
7 Disease Cards → 7 Tarjetas de Enfermedad →
What score 0 looks like for each property — and the cure. Cómo se ve el puntaje 0 en cada propiedad — y la cura.
Workshop · 30 min Taller · 30 min
Run the Audit → Corre la Auditoría →
Score your codebase on all seven GS properties. No tools required. Puntúa tu base de código en las siete propiedades GS. Sin herramientas.
Foundation · 90 min Fundación · 90 min
Generate Your Specification → Genera tu Especificación →
Full sentinel tree: SPEC.md, constitutions, STATUS.md, ADR-000. Árbol sentinel completo: SPEC.md, constituciones, STATUS.md, ADR-000.
Recipes Recetas
Recipe Cards → Tarjetas de Receta →
Focused recipes for specific situations and use cases. Recetas enfocadas para situaciones y casos de uso específicos.