working-methods
La metodología deja de depender de que el agente se acuerde: las fases son código, no prosa, los gates devuelven un código de salida, y a ti solo te interrumpe dos veces, no todo el rato. The methodology stops depending on the agent remembering it: phases are code, not prose, gates return exit codes, and you're interrupted exactly twice, not constantly.
Qué haceWhat it does
Una metodología que el modelo puede saltarse es una sugerencia. working-methods es la capa de enforcement de la Forja dentro de Claude Code: /forge-run secuencia las 12 fases mediante forge.js, una máquina de estados sin dependencias que rechaza ejecuciones fuera de orden. Un hook delega en ella antes de cada gh pr create — y es fail-closed de verdad: si no puede leer el manifest, se niega a dar el visto bueno en vez de dejar pasar por duda.A methodology the model can skip is a suggestion. working-methods is the enforcement layer of Forge inside Claude Code: /forge-run sequences the 12 phases through forge.js, a zero-dependency state machine that rejects out-of-order runs. A hook defers to it before every gh pr create — and it's genuinely fail-closed: if it can't read the manifest, it refuses to vouch instead of letting it through on doubt.
Además incluye /grill —3-4 lentes read-only adversariales sobre cualquier documento, más una 4ª lente de completitud— y /handoff, el relevo de sesión que se ejecuta solo cuando no hay nadie delante.It also ships /grill — 3-4 read-only adversarial lenses on any document, plus a 4th completeness lens — and /handoff, the session relay that runs itself when nobody is around.
/install-family una vez, luego /forge-run añade claves de idempotencia al endpoint de cobro de pagos. Las 12 fases corren bajo docs/forge/<slug>/; intentar gh pr create antes de que existan spec.md, acceptance-matrix.md, ambas actas de grill y el plan se bloquea./install-family once, then /forge-run add idempotency keys to the payments charge endpoint. The 12 phases run under docs/forge/<slug>/; trying gh pr create before spec.md, acceptance-matrix.md, both grill verdicts and the plan exist gets blocked.
Cómo funciona, en diagramasHow it works, in diagrams
Diagramas interactivos hechos con Archify, sacados del propio repo: recorre los caminos, haz zoom o ábrelos a pantalla completa.Interactive diagrams built with Archify, taken from the repo itself: trace the paths, zoom in, or open them full screen.
Por qué importaWhy it matters
Fail-closed de verdad.Genuinely fail-closed. Bloquea también cuando no puede verificar el estado — la duda nunca se convierte en un visto bueno.It blocks even when it can't verify state — doubt never turns into a green light.
Las fases son código, no memoria.Phases are code, not memory. El orden vive en
forge.js, no en la esperanza de que el agente se acuerde.The order lives inforge.js, not in the hope that the agent remembers.Interrumpe dos veces, no siempre.Interrupts twice, not constantly. Cada checkpoint es un multi-select con la recomendación ya marcada.Each checkpoint is a multi-select with the recommendation already marked.
Cómo se usaHow it's used
/forge-run <tu tarea> dentro de Claude Code para el ciclo completo. /grill <documento> para auditar algo suelto. /handoff para el relevo de sesión./forge-run <your task> inside Claude Code for the full cycle. /grill <document> to audit something standalone. /handoff for the session relay.
Compone conComposes with
Requiere forge-methodology para el loop neutral y sus agentes; invoca design-review en la fase de verify sobre diffs de UI.Requires forge-methodology for the neutral loop and its agents; invokes design-review in the verify phase on UI diffs.
Preguntas frecuentesFrequently asked questions
¿Qué hace working-methods?What does working-methods do?
/forge-run secuencia las 12 fases de Forge dentro de Claude Code con una máquina de estados sin dependencias y un hook fail-closed antes de cada PR./forge-run sequences Forge's 12 phases inside Claude Code with a zero-dependency state machine and a fail-closed hook before every PR.
¿En qué se diferencia de forge-methodology?How is it different from forge-methodology?
forge-methodology define el loop neutral; working-methods lo aplica dentro de Claude Code con un hook más estricto — bloquea incluso cuando no puede verificar el estado.forge-methodology defines the neutral loop; working-methods enforces it inside Claude Code with a stricter hook — it blocks even when it can't verify state.
¿Cómo se usa?How is it used?
Con /forge-run <tarea>. También trae /grill y /handoff, usables sueltos.With /forge-run <task>. It also ships /grill and /handoff, usable standalone.
¿Es gratis y de código abierto?Is it free and open source?
Sí — licencia MIT, publicado en GitHub.Yes — MIT license, published on GitHub.
Un comando, doce fases.One command, twelve phases.
$ /plugin marketplace add davidgarciagordo/claude-plugins$ /plugin install working-methods@davidgarciagordo-plugins
