Cómo trabajo con IA

Mi flujo de trabajo con Claude Code.

Las skills, agentes e instrucciones que uso como Software Engineer profesional. Se llama Craft y es un plugin que puedes instalarte.

Ver el código de Craft en GitHub
Craft v4.10.0 6 nov. 2026 MIT
$claude plugin install craft --marketplace juanwmedia/craft
Para que se actualice solo, activa autoUpdate. Cómo
Tres principios

Lo que nunca cambia.

  1. 01

    Tú decides lo que el agente no puede inferir: el dominio, la arquitectura, la estructura de lo que se construye.

  2. 02

    El código es barato una vez que la incertidumbre ha desaparecido. Las decisiones quedan escritas y el agente construye solo.

  3. 03

    Cada paso se revisa en un contexto fresco: los documentos contra el código antes de que los veas, el código contra los documentos cuando está construido.

El loop

Cinco pasos. Dos son humanos.

Tú decides lo que el agente no puede inferir. Después, el loop corre solo y cada paso se revisa en un contexto fresco. Haz clic a la derecha o a la izquierda del escenario, o usa las flechas.

Una idea. Tú y Claude Code, y nada decidido todavía.

El loop empieza en lo que el agente no puede inferir: el dominio, la arquitectura, la estructura.

Shape: qué construimos y por qué.

Te entrevista hasta que nada bloqueante queda abierto. Lo que el código responde, lo lee en el código.

Un agente nuevo audita el borrador.

Evaluate, en un contexto fresco, comprueba cada afirmación contra el código. Evaluator-optimizer: se corrige y se vuelve a auditar.

Plan: slices que nunca comparten archivo.

Cada slice con su comprobación. Aquí termina tu tiempo dentro del loop.

Implement: un agente por slice, en paralelo.

Si una comprobación falla, otro agente fresco lo intenta. Nadie te pregunta.

Review: otro contexto fresco, contra los documentos.

Lo que no se confirma se arregla y se vuelve a revisar.

Try: en vivo, con la evidencia registrada.

Lo que falla vuelve a plan.

Close: los documentos vuelven a decir la verdad.

Reconcilia lo construido con la propuesta de origen. Un solo sí: commit, push y pull request.

Tú
shape
plan
implement
try
close
Fases humanas
← → o clic
Las skills

Nueve skills (cinco son el loop principal) y cuatro agentes.

El loop 5

/craft: shape

Tú: Qué construimos y por qué. Agente: Te entrevista hasta que nada bloqueante queda abierto; lo que el código responde, lo lee en el código.

/craft: plan

Tú: Que las slices son las correctas. Agente: Parte el trabajo en slices que nunca tocan el mismo archivo, cada una con su comprobación.

/craft: implement

Tú: Nada: aquí se acabó tu tiempo en el loop. Agente: Construye las slices en paralelo, un agente por slice, pasa cada comprobación y revisa el cambio entero.

/craft: try

Tú: Qué prueba vale. Agente: Prueba en vivo lo construido, de extremo a extremo y en un navegador si corresponde, y deja la evidencia registrada.

/craft: close

Tú: Un solo sí. Agente: Reconcilia la documentación con lo construido, y entonces commit, push y pull request.

Cuando te pierdes 1

/craft: wtf

Tú: Que no lo has entendido. Agente: Repite la última respuesta hasta que aterriza, sin mover el trabajo.

Por encima del loop 3

/craft: detached

Tú: Si trabaja sin ti. Agente: Cada pregunta que una fase te haría va a act-as-me, y detached.md la guarda para la mañana.

/craft: status

Tú: Qué trabajo retomar. Agente: Dice dónde está cada trabajo abierto, de dónde viene y cuál es el siguiente paso.

/craft: bar

Tú: Verla u ocultarla. Agente: Muestra la línea sobre el prompt con el trabajo, la fase, las slices y el agente en marcha.

Los agentes 4

build

Tú: Nada. Lo lanza implement, uno por slice. Agente: Construye su slice en un contexto fresco, cambia solo los archivos que la slice lista, pasa su comprobación y reporta.

evaluate

Tú: Nada. Lo lanzan shape, plan y close. Agente: Audita un documento en un contexto fresco y devuelve cada afirmación que el código no respalda, con archivo y línea. El patrón evaluator-optimizer: el borrador se corrige y se vuelve a auditar.

review

Tú: Nada. Lo lanza implement. Agente: Intenta refutar el cambio contra los documentos y las convenciones del repo, y devuelve confirmado, refutado o incierto, con evidencia.

act-as-me

Tú: Si le dejas responder por ti. Agente: En modo desatendido contesta lo que una fase te preguntaría, como un senior pragmático: mira el código primero, responde con su porqué, o dice que no puede decidir.

Changelog

Las últimas versiones.

v4.10.0 6 nov. 2026

The craft bar leaves this plugin and becomes craft-bar, installed from the same marketplace with /plugin install craft-bar@craft. The Claude plugin directory accepts mods only from Verified organizations, so craft ships no mod and the directory can list it. Updating craft alone removes the bar until craft-bar is installed; /craft:bar is now /craft-bar:bar.

v4.9.1 23 oct. 2026
  • The craft bar shows the work, the phase and detached for a phase the model starts with the Skill tool, the same as for one you type. Before, a phase started that way (a routine asking in words, a session moving on to the next phase) showed only craft.
  • /craft:detached answers one line, whether the mode is on or off in this repository, without the line about routines.
  • The bar draws above the prompt in the terminal and in the desktop app. The web (claude.ai/code) does not draw it.
v4.9.0 23 oct. 2026

Detached mode: craft carries a piece of work with nobody at the keyboard.

  • /craft:detached on turns it on and /craft:detached off ends it. A routine starts with /craft:detached on as its first message, or asks for the mode in words, since both /craft:detached and /craft:bar can now be called by the model.
  • While it is on, every question a phase would put to you (shape, plan, implement, try and close, approvals and confirmations included) goes to the new agent craft:act-as-me, which runs on Fable 5.1 in a fresh context and answers as an extremely pragmatic senior software engineer who takes nothing for granted. It checks the code first, answers with one option, given or its own, and why, and says Cannot decide with what is missing instead of inventing. When it cannot decide, or does not start, the phase stops and names the question.
  • The mode is the flag craft.detached in the repository's local git config: per repository, outside the tree, never committed.
  • Each answer is appended to detached.md in the work's folder with its phase, the question, the answer and why, in order. It is the file to read in the morning, next to the pull request.
  • Close commits, pushes and opens the pull request when craft:act-as-me says yes. The yes is logged in detached.md before the commit, so the commit carries it, and close says who gave it. You review the pull request.
  • The craft bar shows detached after the phase while the mode is on, and ends with an x that hides it, the same as /craft:bar off.
  • Four evals grade the detached path of shape, plan, try and close on the trace and the files: no AskUserQuestion call, craft:act-as-me started for the questions, the entry in detached.md.
  • Without the flag the human answers every question, as before. Every rule now asks as references/ask.md says, instead of naming the human or AskUserQuestion itself.
Historial completo en GitHub ↗
Guía gratuita

Los 51 imprescindibles, en una guía.

Una página por tip. Cinco capítulos. Lo que de verdad uso a diario en producción. Sin teoría, sin humo.

  • I. Empieza bien 10 tips
  • II. Conciencia 3 tips
  • III. Maestría 22 tips
  • IV. Autonomía 10 tips
  • V. Comparativa 6 tips
¿Eres desarrollador/a Web profesional?

Recibirás la guía por email · Te unes a la newsletter Gravitas · Cancela cuando quieras

de 51
#

Wmedia · 51 Tips
Guía gratuita · 51 tips · 5 capítulos

Los 51 imprescindibles, en una guía.

¿Eres desarrollador/a Web profesional? · Cancela cuando quieras