# Context Dome

> Context Dome

- Skill: `gonzalezpazmonica/context-dome` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx get-skill add gonzalezpazmonica/context-dome`
- Raw SKILL.md: https://api.skillmd.com/api/skills/gonzalezpazmonica/context-dome/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: gonzalezpazmonica (https://skillmd.com/u/gonzalezpazmonica)
- Updated: 2026-09-21
- Page: https://skillmd.com/skills/gonzalezpazmonica/context-dome

---


# Context Dome

## Descripcion

Una cupula de contexto es un artefacto de documentacion que captura el
conocimiento tacito de un modulo: lo que no esta en el codigo pero
que cualquier dev necesita para trabajar con el.

Se genera automaticamente a partir del historial git y la estructura
del proyecto, y se almacena como `CONTEXT_DOME.md` en el directorio
del modulo.

## Ruta critica

- Script:    `scripts/context-dome-generate.sh`
- Hook scan: `.claude/hooks/bus-factor-warn.sh`
- DOMAIN:    `.claude/skills/context-dome/DOMAIN.md`

## Uso

```bash
# Generar cupulas para modulos con riesgo HIGH o superior
bash scripts/context-dome-generate.sh --project <path> --min-risk HIGH

# Solo un modulo especifico
bash scripts/context-dome-generate.sh --project <path> --module src/payments

# Preview sin escribir
bash scripts/context-dome-generate.sh --project <path> --dry-run
```

## Estructura del CONTEXT_DOME.md generado

```markdown
---
module: <nombre>
bus_factor: <N>
risk_level: CRITICAL|HIGH|MEDIUM|LOW
knowledge_owners: [<dev1>, ...]
generated_at: <ISO8601>
spec: SE-252
runbook_confidence: low|medium|high
---

# Context Dome -- <nombre>
## Proposito
## Decisiones no obvias
## Dependencias criticas
## Runbook minimo
## Knowledge owners actuales
## Plan de distribucion sugerido
## Historial de cambios relevantes
```

## Fuentes de datos

| Seccion | Fuentes |
|---------|---------|
| Proposito | CONTEXT.md, README.md, comentarios cabecera |
| Decisiones | git log --grep (why:, because, NOTE:, HACK:, SE-, SPEC-) |
| Dependencias | imports por extension (.py, .ts, .go, .cs) |
| Runbook | Makefile, package.json scripts, README ## Usage, Dockerfile CMD |
| Owners | JSON del bus-factor-scan |
| Historial | git log --no-merges excluyendo chore/format/typo |

## runbook_confidence

| Nivel | Condicion | Accion |
|-------|-----------|--------|
| low | Sin fuentes detectadas | Documentar manualmente |
| medium | 1 fuente encontrada | Revisar y completar |
| high | 2+ fuentes encontradas | Verificar actualizacion |

