agentleFS
ad1codead1code/sdd-harness/skills/handoff/SKILL.md

handoff

Skill4 starsChanged 22 days agoMITView on GitHub

Cierra una tarea dejando el relevo escrito en el repo, para que otra sesión, otro equipo u otro agente continúe sin releer el historial. Usar cuando el usuario pida cerrar, pausar o dejar handoff, y al terminar una tarea antes del commit final.

  • Reads credentials

191 other projects use a version of this.

Adopted by

Most recently taken up by

Used with

Projects with it also use decision-mapping, setup-ts-deep-modules and 10 more.

Other files people use alongside this one.

Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
  • FabienDehopreSkill

    decision-mapping

    Turn a loose idea into a sequenced map of investigation tickets, then drive them to resolution one at a time.

    Also in 8 projects that use this

  • liufeng1976Skill

    setup-ts-deep-modules

    Wire dependency-cruiser into a TypeScript repo so each package is a deep module — implementation hidden in subfolders, reachable only through its entry-point files. User-invoked.

    Also in 42 projects that use this

  • AWSSkill

    to-questionnaire

    Turn a decision you can't fully answer into a questionnaire for someone else to fill in.

    Also in 93 projects that use this

  • GoogleSkill

    ask-matt

    Ask which skill or flow fits your situation. A router over the skills in this repo.

    Also in 87 projects that use this

  • RoentekSkill

    loop-me

    Grill me about specs for the workflows I want to build, within this workspace.

    Also in 51 projects that use this

  • LesaniSkill

    writing-beats

    Shape an article as a journey of beats, choose-your-own-adventure style. The user picks a starting beat from the raw material, you write only that beat, then offer options for where to pivot next, beat by beat, until the article reaches a natural end. Use when the user has raw material and wants to assemble it as a narrative rather than an argument.

    Also in 54 projects that use this

The file

Files
SKILL.md

El relevo viaja por Git con el código, en el mismo commit. Nada lo escribe solo: se hace al cerrar la tarea.

Dos ficheros

HANDOFF.md (raíz del repo, o docs/HANDOFF.md si ya vive ahí). Se reescribe entero en cada cierre: es el estado, no un historial.

# Handoff — <proyecto>
fecha: AAAA-MM-DD · agente: <herramienta y modelo> · rama: <rama> · commit: <hash corto>

## Estado actual          hecho y verificado (con la evidencia) / a medias / propuesto sin ejecutar
## Decisiones tomadas      qué se decidió y por qué, incluidas las alternativas descartadas
## Archivos tocados
## Para arrancar en otro equipo   qué no viaja por Git y cómo se reconstruye (.env desde .env.example, datos, modelos, servicios)
## Bloqueos o riesgos
## Siguiente paso          uno, ejecutable hoy

docs/ERRORES.md. Solo se añade, nunca se reescribe. Una entrada por error real del desarrollo que costó tiempo:

## AAAA-MM-DD · <síntoma en una línea>
- Dónde: fichero, comando o servicio
- Causa: la real, no la primera sospecha
- Intentos que no funcionaron: para que nadie los repita
- Solución: qué se hizo, con el commit
- Cómo evitarlo: la comprobación o regla que lo habría parado

Reglas

  • Concreto: "se cambió X en Y para resolver Z", no "varios cambios".
  • Distingue lo verificado de lo propuesto. Si no se comprobó, se dice.
  • Un bloqueo dice qué está parado, por qué y qué hace falta para desbloquearlo.
  • Sin secretos ni tokens: nombres de variables, nunca valores. Rutas relativas al repo.
  • Si un documento que hace falta para continuar está en .gitignore, se avisa al usuario en el cierre: o viaja, o se anota en "Para arrancar en otro equipo".
  • El cierre va en el mismo commit que el trabajo. El push sigue la regla 10 de AGENTS.md; a main o a producción, solo con el sí del usuario.

Quien retoma lee HANDOFF.md y docs/ERRORES.md, y comprueba el estado real antes de fiarse.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

Reviews can't be read right now.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.