Skip to content

feat(skills): auditar-proyecto — sincronizar milestones ↔ project board #263

Description

@complexluise

Contexto

Hallazgo de la metacognición 2026-06-30 (cierre del ciclo de encuadre 0.12.0): el PO pidió
"disciplina con projects" y la skill flujo no tenía herramienta para responder. Tuve que
improvisar Fase 1 de higiene (gh issue edit --milestone + gh project item-add uno por uno)
y обнаружил drift entre el milestone 0.12.0 (7 issues) y el project board bib2graph — roadmap
(no todos los issues del milestone estaban en el project).

Motivación

El flujo SKILL.md tiene la tabla de géneros (Issues + Project + Milestones = "trabajo/estado")
pero ningún comando mantiene esa tupla sincronizada. Resultado: drift silencioso que el PO
descubre cuando va a usar el project board para ver "en qué vamos a trabajar".

Propuesta

Skill nueva auditar-proyecto (o sincronizar-proyecto) que:

  • Lista milestones abiertos + cuenta issues por milestone.
  • Lista items del project board + agrupa por Status.
  • Detecta drift en 3 dimensiones:
    • Issues con milestone X pero NO en el project → candidatos a agregar.
    • Items en el project sin milestone → candidatos a asignar o declarar backlog.
    • Items Done que siguen abiertos → candidatos a cerrar.
  • Ofrece acciones bulk (agregar al project, asignar milestone, cerrar inválidos), siempre
    con confirmación del PO antes de mutar.

DoD

  • Skill auditar-proyecto.md en .claude/skills/ (o donde el PO decida).
  • Procedimiento cubre las 3 dimensiones de drift (milestone↔project, project sin
    milestone, Done sin cerrar).
  • Política de confirmación explícita: nada se muta sin OK del PO.
  • Ejemplos con datos reales del repo (drift observado en 0.12.0 antes del fix).

Out of scope

  • No es un dashboard visual (eso es GitHub Projects UI).
  • No automatiza el merge de PRs.
  • No reemplaza a abrir-issue (sigue siendo el comando para issues nuevos).

Origen

Metacognición 2026-06-30 de la sesión de encuadre 0.12.0 (Nota 29). Categoría: mejora de
proceso / skill faltante. Candidato a entrar en 0.12.0 si el PO prioriza, o a backlog
de proceso.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions