RafaelFerSilva/refinement-agent-skills

Configurar espacio de trabajo

Escribe la configuración a nivel de espacio de trabajo que asumen /refine-story, /qa-plan, /requirements-discovery y /meeting-minutes. Esta es una habilidad guiada por conversación, no un script automatizado: explora, presenta hallazgos, confirma, y solo entonces escribe archivos.

Pasos

1. Explorar. Inspecciona los archivos existentes antes de hacer suposiciones: AGENTS.md y CLAUDE.md en la raíz, CONTEXT.md, docs/agents/refinement.md y docs/agents/issue-tracker.md (resultados anteriores de esta habilidad), .scratch/, y señales de código fuente: package.json, pyproject.toml, src/, go.mod, o cualquier cosa que un equipo compile o ejecute. Si docs/agents/issue-tracker.md ya existe de otra convención, consérvalo: verifica solo que especifique dónde publicar. Si CLAUDE.md es meramente un puente con @AGENTS.md, el archivo de instrucciones principal es AGENTS.md. Completado cuando: sabes si el espacio de trabajo ya está configurado, el modo probable, el idioma probable (en-US o pt-BR), si existe un glosario, si existe el rastreador, y qué archivo de instrucciones editar.

2. Preguntar, una sección a la vez, liderando con la respuesta recomendada.

   Modo. Recomienda basado en los hallazgos: si hay código presente, com-codigo (con código); si está ausente, sem-codigo (sin código). Explica en una línea: con código, el agente inspecciona el código fuente antes de preguntar; sin código, el PO es la fuente de hechos y las preguntas de arquitectura se convierten en cuestionarios para el equipo.

   Idioma. Recomienda basado en archivos existentes o en-US por defecto: en-US o pt-BR. Explica en una línea: define el idioma del examen, rondas de preguntas, narrativas, criterios Gherkin y veredictos.

   Elementos de trabajo. ¿Las Historias de Usuario se originan en un rastreador externo? Si es así, ¿cuál es la URL base y la convención de campo (por ejemplo Azure: <ID> para elementos de trabajo de Azure DevOps)? Cada HU se origina allí y cada artefacto lleva esta línea de ID.

   Glosario de producto. ¿Ya existe CONTEXT.md? Si no, no se necesita acción ahora: el primer examen que resuelva un término del dominio lo creará. Indica esto claramente.

   Completado cuando: modo, idioma, convención de elemento de trabajo y URL base están confirmados.

3. Confirmar y escribir. Presenta el borrador de docs/agents/refinement.md basado en refinement.md, docs/agents/issue-tracker.md basado en issue-tracker.md (solo cuando no exista ya), y el bloque ## Refinement para el archivo de instrucciones del agente. Permite ajustes. Luego escribe los archivos. Para el archivo de instrucciones: si CLAUDE.md existe e importa AGENTS.md (@AGENTS.md), edita AGENTS.md; de lo contrario edita CLAUDE.md si existe; de lo contrario AGENTS.md si existe; si ninguno existe, pregunta cuál crear. Si el bloque ## Refinement ya existe, actualízalo en su lugar sin modificar el resto del archivo.

   El bloque:

   ## Refinement
   
   Flujos de trabajo de refinamiento socrático: ejecuta `/which-flow` para seleccionar un flujo. El modo y las convenciones están en `docs/agents/refinement.md`; las convenciones del rastreador en `docs/agents/issue-tracker.md`. Los artefactos se almacenan en `.scratch/<slug>/` con `Status:` y el ID del elemento de trabajo.
   

   Completado cuando: refinement.md, el archivo del rastreador (nuevo o conservado) y el bloque de instrucciones existen con contenido confirmado.

4. Concluir. Confirma que el espacio de trabajo está configurado, enumera los flujos que leen docs/agents/refinement.md, y nota que los archivos se pueden editar manualmente más tarde; volver a ejecutar esta habilidad solo es necesario para cambiar modos, idiomas o convenciones del rastreador.