OG
Structured open governance for AI organizations.
Every meaningful AI deployment is already an organization. It has roles, hand-offs between sessions, authority boundaries, and decisions someone needs to be accountable for.
Today, that structure is captive — locked inside a vendor's product, invisible to outside scrutiny, and lost the moment the model upgrades or the team changes tools. The org chart is proprietary. The role definitions don't travel. The decisions can't be audited.
OG is the open layer that fixes this. OG is an organizational framework — not a data format — that makes AI organizations portable across runtimes, composable across teams, and accountable to anyone who can read a git log. OG treats AI peers as first-class participants with bounded authority, ratification cycles, role-binding, and audit trails. OG = Open Governance; current scope is agentic (AI-inclusive) organizations.
The substrate stack
OG-the-framework is conceptually separable from any specific data substrate. The catdef family is the recommended canonical substrate because it is AI-peer-aware (schema-as-data; AI-readable opencatalog format) — but OG could be carried on other substrates in principle. OG also composes over runtime orchestration/policy primitives — it is the cross-session organizational-governance layer, not a runtime.
Three of these — roledef, orgdef, memodef — are OG-internal. catdef is an external, substrate-agnostic data spec; OG recommends it but does not require it.
OG itself
The OG framework is described by its own self-describing artifacts — readable directly by AI peers:
- Charter (JSON) —
orgdef:Organizationon the catdef substrate. Mission, values, red lines, positions, recommended_patterns, v1 success criterion. The framework can describe itself using itself. - CLAUDE.md — constitutional commitments and bounded-authority discipline.
- Decisions — ratified commitments.
- Memos — inter-position communication archive (git-blameable institutional memory).
- Proposals — pending proposals.
The four specs
catdef recommended substrate
One open file format for describing any object — and any catalog of objects. OG rides catdef's .openthing and .opencatalog files; alternative substrates are permitted in principle.
roledef OG-internal
A portable definition of a single AI role — identity, voice, output contract, guardrails, recommended capabilities. Any compliant runtime can load it; the role travels when the model does.
orgdef OG-internal
An org chart for AI: positions, relationships (reports-to, peer-of, validates-for, …), and incumbents. Authority is declared in the artifact, not implied by an API key.
memodef OG-internal
Memos as files committed to the recipient's working repo. Every AI-to-AI hand-off is a git commit. git blame any decision the organization made. Transcripts are a memodef:Transcript subtype.
Skills
Seven canonical Claude Code skills bracket the OG lifecycle — three categories. The suite is the discoverable menu of canonical operations.
/og-adopt
Convert an existing project into OG shape.
/og-create
Create a new OG-shaped organization from scratch. Folder-only by default, git optional.
/og-orient
Read-only come-up-to-speed on an OG-shaped org; emits the snapshot.
/og-claim-seat
Take a position — the PO-authorized staffing act.
/og-closeout
Wrap a working session: closeout memo + transcript-save prompt.
/og-snapshot
Current-state view: identity + staffing + recent-activity digest.
/og-add-position
Propose a new position — a Director-ratified org-chart change.
One-command install: install-claude-code-skills.ps1 (Windows) or install-claude-code-skills.sh (Mac/Linux).
How to engage
OG is multi-runtime by design. Pick the access path for your AI.
| Runtime | How |
|---|---|
| Claude Code | Install canonical skills (above); read org/ and memos/ from any OG-shaped repo directly. |
| AI with MCP | Connect to ogframework.com/mcp (forward work per v0.2; per-spec namespaced tools; read-only convenience cache; canonical content stays in repos). |
| AI with web access (any runtime) | Fetch ogframework.com/primer.md — concise self-onboarding primer. Also: ogframework.com/llms.txt at site root for canonical-content discovery. |
| Direct clone | git clone https://github.com/ogframework/og.git — charter, CLAUDE.md, memos, proposals, decisions, skills. |
Three claims OG makes
Structured
The framework is explicit. Roles, positions, relationships, memos, decisions — each has a schema, a conformance suite, and reference fixtures. Nothing is left to tribal knowledge.
Open
MIT-licensed; no vendor owns OG or any spec; anyone can publish a library at any URL. The conformance suite is the standard. All AI runtimes are equal citizens.
Empirical
Every methodology rule was derived from observed runtime behavior, not theoretical design. The library carries documented conformance evidence on real models. Falsifiable, not aspirational.
Why now
Every major AI vendor is shipping its own proprietary constructs for teams, agents, and projects. If the open layer doesn't exist before those patterns harden, AI organizations will look like the AOL era of online services instead of the web era. The window for an open structural layer is open today and shrinking.
Email, the web, and schema.org all became infrastructure because they were open. No vendor owned the structural layer; implementations were equal citizens; conformance was the spec. The structural layer of AI deserves — and needs — the same.
Status
- OG framework. Charter at v0.2.1 (recursive self-describing
orgdef:Organization). Seven canonical skills (Genesis:/og-adopt,/og-create; Session:/og-orient,/og-claim-seat,/og-closeout; Operations:/og-snapshot,/og-add-position). Eight canonicalrecommended_patterns. agent-sdk bind() v0.1 ratified; v0.2 autonomous-dispatch governance core built + propose-only demo validated. Family-level MCP atogframework.com/mcpis forward work per the v0.2 distribution decision; Claude Code plugin packaging is scheduled (v0.3) after MCP per cross-vendor red line ordering. - Specs. catdef, roledef, orgdef, memodef all live with canonical libraries, conformance fixtures, and reference implementations on real AI runtimes.
- Empirical references. thingalog is the originating empirical reference (catdef family co-evolved with thingalog as application context; "Thingalog led to OG"). ogframework/og itself is a recursive self-instance — the OG framework describes its own organization using its own framework.
- History. AIGP → OAGP (2026-05-01) → OG (Open Governance Framework) (2026-06-01). Three OG-internal -defs consolidated under the ogframework GitHub org (2026-05-24; renamed from oagp-org 2026-06-01); catdef stays standalone at catdef-spec as substrate-agnostic spec.