# Org Registrar

> org-registrar — Grafo organizacional (SE-365)

- Skill: `gonzalezpazmonica/org-registrar` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx get-skill add gonzalezpazmonica/org-registrar`
- Raw SKILL.md: https://api.skillmd.com/api/skills/gonzalezpazmonica/org-registrar/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/org-registrar

---


# org-registrar — Grafo organizacional (SE-365)

> Company as Code: entidades organizacionales como código versionable, consultable
> y gobernado por CRITERIO.md. CRIT-001: todo local.

## Cuándo usar

- Consultar "¿qué proyectos usan este recurso?" / "¿qué políticas aplican a esta unidad?"
- Validar una entidad o relación nueva contra el esquema y CRITERIO.md
- Proponer una entidad nueva (escritura mediada: prepara el diff, no lo aplica)

## Comandos

```bash
# validar una entidad
bash scripts/org-registrar.sh validate --file company/policies/policy-x.md

# indexar el grafo de un directorio
bash scripts/org-registrar.sh index --dir company --json

# consultar dependencias de un recurso
bash scripts/org-registrar.sh query --graph graph.json --what uses_resource --id resource-x

# preparar propuesta (no aplica — requiere confirmación humana)
bash scripts/org-registrar.sh propose --file entity.md --out proposals/
```

## Estructura del grafo

```
org/company/roles|units|people|policies/<slug>.md
org/projects/<slug>.md
org/resources/infra|tools|knowledge/<slug>.md
```

> Árbol dedicado bajo `org/`, separado de `projects/` de pm-workspace (protegido por
> `protect-project-privacy`).

## Reglas de gobernanza

1. **Lectura libre** para agentes; **escritura mediada** por humano (se delega la
   ejecución, nunca el criterio).
2. **Vocabulario de relaciones cerrado** (sección 6 del spec SE-365): relación no
   listada → rechazo.
3. **Políticas solo `origin: owner`** (`source: human`); agentes pueden proponer
   (marcan `proposed`).
4. **Recursos**: `sensitivity` nunca `secret` — credenciales nunca viven en el vault.
5. **CRITERIO.md valida, no almacena** — las entidades viven en su propio árbol.
6. Cada escritura emite receipt en el audit ledger (SE-355) con `enforced`.

## Referencias

- Spec: `docs/specs/SE-365-company-as-code.spec.md`
- Dependencias: SE-352 (origin), SE-355 (audit), SE-363 (records), SE-362 (risk)

