Agent skill

rfc-writer

Stars 0
Forks 0

Install this agent skill to your Project

npx add-skill https://github.com/ardelperal/skills/tree/main/skills/rfc-writer

SKILL.md

Skill: rfc-writer

Propósito

Generar un RFC (Request for Change) para decisiones de arquitectura grandes que preceden al flujo SDD. Un RFC es obligatorio cuando el cambio afecta a contratos de interfaz entre módulos, modifica el modelo de datos, o impacta en más de un PRD. Sin RFC aprobado, no se inicia el SDD.

Cuándo activar este skill

  • El usuario describe un cambio de arquitectura significativo
  • El cambio afecta a múltiples módulos o capas (Model, Service, Repository, ViewModel)
  • El cambio requiere modificar tablas en ERD/Estructura_Datos.md
  • El cambio impacta en uno o más PRDs existentes
  • Hay incertidumbre sobre qué alternativa técnica elegir

Cuándo NO activar este skill

  • El cambio es una historia de usuario sin impacto en contratos → usar sdd-protocol directamente
  • El cambio es un bugfix acotado a un solo módulo → usar sdd-protocol directamente
  • El cambio ya tiene RFC aprobado → pasar a sdd-protocol

Pasos

Paso 0 — Contexto Engram

Ejecutar mem_search "[módulo o área afectada]" antes de redactar. Si hay decisiones previas relacionadas, incorporarlas en la sección de Alternativas.

Paso 1 — Recopilar información

Preguntar al usuario si no está claro:

  • ¿Qué problema concreto resuelve este cambio?
  • ¿Qué módulos y PRDs están afectados?
  • ¿Hay restricciones conocidas (rendimiento, compatibilidad, deuda técnica)?

Paso 2 — Redactar el RFC

Usar la plantilla docs/templates/rfc_template.md. Numeración: RFC-NNN (correlativo al último RFC en docs/rfcs/).

Paso 3 — STOP: presentar y esperar aprobación

Presentar el RFC completo al usuario. No iniciar el SDD hasta recibir aprobación explícita (APROBADO).

Paso 4 — Guardar en Engram

mem_save title="RFC-NNN: [título]" type="architecture"

Paso 5 — Tras aprobación

  • Guardar el RFC en docs/rfcs/RFC-NNN_[titulo-kebab].md
  • Actualizar AGENTS.md si el RFC introduce nuevas reglas críticas
  • Iniciar sdd-protocol con referencia al RFC aprobado

Expand your agent's capabilities with these related and highly-rated skills.

ardelperal/skills

sdd-protocol

Activar cuando el usuario describe una historia de usuario, bug o mejora, o cuando dice "modo SDD", "nueva spec", "quiero implementar", "crea una spec", o cuando envía el trigger de cierre "VALIDADO EN ACCESS: Spec-XXX". Este skill orquesta el flujo completo: análisis → spec → implementación → cierre. NO activar para preguntas genéricas sobre VBA o Access que no sean cambios concretos al proyecto activo.

0 0
Explore
ardelperal/skills

diario-sesion

Registra una entrada en el Diario de Sesiones al cerrar una sesión de trabajo. Activar cuando el usuario diga "CIERRE DE SESIÓN", "cerrar sesión", "fin de sesión", o cuando el protocolo SDD llegue a la Fase 4 de cierre tras "VALIDADO EN ACCESS: Spec-XXX". NO activar para consultas informales ni durante el desarrollo activo.

0 0
Explore
ardelperal/skills

access-vba-sync

0 0
Explore
ardelperal/skills

git-release-manager

0 0
Explore
ardelperal/skills

spec-writer

Genera Specs técnicas a partir de historias de usuario para proyectos VBA/Access. Usar cuando el usuario describa un cambio, reporte un bug, pida una mejora, o diga "quiero que...", "necesito que...", "hay un problema con...", "arregla...", "añade...", "genera un spec", "crea una spec", "especifica esto". Este skill se activa en la Fase 1 del sdd-protocol. NO activar de forma independiente si sdd-protocol está activo — sdd-protocol lo orquesta.

0 0
Explore
ardelperal/skills

hotfix

Gestión de hotfixes y bugfixes en proyectos VBA/Access. Usar cuando el usuario reporte: "hay un bug", "error", "no funciona", "fix", "hotfix", "corregir", "arreglar", "problema con", "falla". NO usar para nuevas funcionalidades (usar sdd-protocol). NO usar para refactors que afecten múltiples módulos.

0 0
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results