hallazgo
Skill2 starsChanged 4 months agoApache-2.0View on GitHub
Ciclo completo de un hallazgo G## — registrarlo como fichero nuevo en docs/findings/, verificar que no sea ya expresable, decidir con opciones, aplicar la resolución a TODOS los documentos, auditar coherencia y disparadores P##, y ADR si procede. Úsala cuando la API no baste para algo, cuando un contrato presuponga API inexistente, o cuando una ronda/juicio destape una grieta real.
1 other project uses a version of this.
Adopted by
Most recently taken up by
- TheVeller/claude-skillstheir own version, first seen Nov 2, 2026
Other versions1 project uses a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 1
- TheVeller/claude-skills★ 4same name
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
The file
Files
Ciclo de un hallazgo G##
Una grieta que la v1 necesita cerrada se resuelve una a una y no está hecha hasta ser coherente en todos los documentos. El código es el último eslabón de la cadena, no el primero: si el hallazgo nació implementando, la implementación espera a que los documentos cierren.
Pasos
- Registrar. Crea
docs/findings/gNN-<slug>.mdcon el siguiente número G## libre (el índice dedocs/findings/README.mdlo dice; ojo a los huecos reservados que anota). El fichero lleva frontmatter de tipo hallazgo (type: hallazgo,id: GNN,status: abierto,origin: <de dónde salió>) y el formato de siempre: H1# GNN · <título corto> — <docs afectados>, y los bloques Problema (la grieta, con la frase textual de la espec que se queda corta), Impacto (a quién afecta y con qué urgencia) y Opciones ((a), (b), (c)... cada una con su porqué). Añade su fila a la tabla índice dedocs/findings/README.mdy actualiza el contador de la cabecera (N registradas, N resueltas, N abiertas). - ¿Ya es expresable? Antes de inventar API, lanza el agente
verificadorcon el hallazgo: su mandato es demostrar que el escenario ya se compone con la API existente (el precedente: el semáforo connu.task.future). Si vuelve FALSO POSITIVO con la composición como evidencia, el G## se cierra como demostrado-expresable: se documenta la composición en la resolución y no se toca la API. Este paso mata la mayoría de hallazgos baratos. - Decidir. Presenta las opciones al usuario con tu recomendación
motivada (qué rompe menos, qué compone mejor, qué precedente sienta). Si la
resolución añade o toca
api.md, lanza antesjuez-filosofiacon la propuesta: una OBJECIÓN bloqueante vuelve al usuario. Toda adición a la API exige bump denu.version.apiy crece solo por adición. - Aplicar a TODOS los documentos. Busca con Grep cada contrato y
pseudocódigo que presuponía la semántica vieja (
agente.md,providers.md,sesiones.md,chat.md,guia-plugins.md,pseudocodigo.md,arquitectura.md,modelo-ejecucion.md... el corpus completo) y actualízalos. Deja el rastro: cada cambio cita el G## que lo motiva. - Auditar. Lanza
auditor-docscon la descripción del cambio. Corrige cada incoherencia que reporte y presta atención a su barrido de disparadores P##: si un disparador dedocs/postponed/suena, díselo al usuario (reabrir un P## es decisión suya). - ADR si procede. Si la decisión es arquitectónica (cambia una regla del
juego, no solo una firma), crea
docs/decisions/adr/adr-NNN-<slug>.mdcon frontmatter de tipo adr (id: ADR-NNN,status: aceptada,date) y el formato contexto → decisión → consecuencias, y añade su fila al índice dedocs/decisions/adr/README.md. Las entradas nunca se reescriben: si reemplaza a una vieja, la nueva declarasupersedes: [ADR-VVV]y en la vieja se edita SOLO el frontmatter (status: reemplazada,superseded_by: [ADR-NNN]) y su línea**Estado:**— el cuerpo queda como registro histórico. - Cerrar. El fichero del hallazgo pasa a resuelto: el título gana
— **RESUELTO**, el bloque Resolución va al principio (aplicada en<docs afectados>, con enlaces) y el frontmatter se rellena (status: resuelto,resolution: <una frase>,affected: [...],adr: ADR-NNNsi lo hubo,date). Actualiza su fila y el contador endocs/findings/README.md. Commit en español:Resuelve G##: <la decisión en una frase>. - Si había implementación en pausa (el hallazgo nació en una
/sesion): ahora sí, vuelve a ella e implementa la resolución. El test que blinde el G## debe nombrarlo en comentario.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
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.

