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
# 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 deprojects/de pm-workspace (protegido porprotect-project-privacy).
Reglas de gobernanza
- Lectura libre para agentes; escritura mediada por humano (se delega la ejecución, nunca el criterio).
- Vocabulario de relaciones cerrado (sección 6 del spec SE-365): relación no listada → rechazo.
- Políticas solo
origin: owner(source: human); agentes pueden proponer (marcanproposed). - Recursos:
sensitivitynuncasecret— credenciales nunca viven en el vault. - CRITERIO.md valida, no almacena — las entidades viven en su propio árbol.
- 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)