workspace-integrity

# Skill: Workspace Integrity

> Auditores de integridad documento-realidad.
> Ref: SE-043/046/047/048/052/057.

## Cuando usar

- Pre-push (manual check de drift antes de `git push`)
- Al cierre de cada Era (ejecutados en batches 13, 22, 23)
- Mensualmente sobre workspace sano
- Tras refactor que toca muchos ficheros

## Inventario

| Script | Spec | Detecta |
|---|---|---|
| `claude-md-drift-check.sh` | SE-043 | Counters en CLAUDE.md vs filesystem (agents/commands/skills/hooks) |
| `baseline-tighten.sh` | SE-046 | Baseline metrics stale tras cambios estructurales |
| `agents-catalog-sync.sh` | SE-047 | Drift entre `docs/rules/domain/agents-catalog.md` y `.claude/agents/` |
| `rule-orphan-detector.sh` | SE-048 | Reglas en `docs/rules/domain/` sin referencias cruzadas |
| `rule-manifest-integrity.sh` | SE-057 | `docs/rules/INDEX.md` vs ficheros reales |
| `agent-size-audit.sh` + `agent-size-remediation-plan.sh` | SE-052 | Agents > umbral lineas; plan de split |
| `rule-usage-analyzer.sh` | — | Estadisticas de uso de reglas domain |

## Invocacion

```bash
# Individual checks
bash scripts/claude-md-drift-check.sh
bash scripts/rule-manifest-integrity.sh
bash scripts/agents-catalog-sync.sh --json
bash scripts/rule-orphan-detector.sh --json
bash scripts/agent-size-audit.sh

# Ejecucion uniforme (patron de aggregator)
for script in claude-md-drift-check rule-manifest-integrity agents-catalog-sync rule-orphan-detector; do
  echo "=== $script ==="
  bash scripts/$script.sh --json 2>&1 | head -3
done
```

## Exit codes esperados

- `0` — PASS (sin drift)
- `1` — DRIFT o FINDING (WARN o ERROR)
- `2` — usage error

## Integracion con CI

Cada script emite JSON parseable. CI puede:
- Bloquear merge si `claude-md-drift-check.sh` falla (ya activo vía `readiness-check.sh`)
- Notificar (no bloquear) si `rule-orphan-detector` encuentra >N orphans
- Reporting mensual via `agent-size-audit` con plan de remediation

## No hacen

- No modifican ficheros (solo audit)
- No auto-fixer (SE-062 Era 184 scope)
- No corren tests (eso es `readiness-check.sh`)
- No push ni merge (gate via `push-pr.sh`)

## Decision tree

```
¿CI falla por counter drift?
  → SE-062.1 counter sync (usar claude-md-drift-check.sh)
¿Spec ID duplicado?
  → Revisar docs/propuestas, resolve per SE-044
¿Rule orphan?
  → Remover rule o anadir referencia
¿Agent oversized?
  → agent-size-remediation-plan.sh genera split plan
```

## Referencias

- SE-043 drift check: `scripts/claude-md-drift-check.sh`
- SE-046 baseline: `scripts/baseline-tighten.sh`
- SE-047 catalog sync: `scripts/agents-catalog-sync.sh`
- SE-048 orphan: `scripts/rule-orphan-detector.sh`
- SE-052 agent size: `scripts/agent-size-audit.sh`
- SE-057 manifest: `scripts/rule-manifest-integrity.sh`
- Era 182 audit closure: batch 13 (PR #654)
- Era 184 Consolidation: `docs/propuestas/SE-062-era184-consolidation-hygiene.md`