DecisionOps Documentation
Reference

Glossary

A structured record of an important choice, including its scope, status, content, and history.

Decision

A structured record of an important choice, including its scope, status, content, and history.

Decision Version

The append-only record of how a decision changed over time.

Decision Revision

A field-level change summary tied to create, update, approve, supersede, or import activity.

Organization

The top-level workspace boundary in DecisionOps.

Project

A grouping of repositories inside one organization.

Repository Scope

A decision scope that applies only to one repository.

Organization Scope

A decision scope that applies across the workspace unless a more specific decision replaces or narrows it.

Constraint

A reusable rule or operating boundary that influences whether a decision draft is acceptable.

Rule

An organization-level governance rule that can synchronize policy posture across repositories.

Drift

Signals that show the organization is moving away from the expected decision or policy posture over time.

Override

A temporary exception that bypasses repository gate enforcement for a limited period.

API Key

A long-lived organization credential created by an admin for automation or service use.

OAuth Access Token

A short-lived bearer token issued by DecisionOps after client-credentials exchange or interactive authorization.

MCP

The Model Context Protocol surface used by supported IDEs and coding agents to search, draft, validate, and publish decisions.

Interactive OAuth Handoff

The first-run browser consent flow triggered when an IDE MCP client asks DecisionOps for access.

FAQ

Usually yes, at least once. Most users first sign in, finish onboarding, and open `/integrations/agents` to get the right organization, project, repository, and platform details. After that, the IDE path becomes the faster day-to-day workflow.

Asset Capture Checklist

| Asset ID | Page Or Flow | Target File | Notes | | --- | --- | --- | --- | | `web-login` | Login page | `docs/assets/screenshots/web-login.png` | Show GitHub and email sign-in choices | | `web-start` | `/start` welcome screen | `docs/assets/screenshots/web-start.png` | Include the three activation choices | | `web-onboarding-setup` | `/onboarding/setup` | `docs/assets/screenshots/web-onboarding-setup.png` | Show workspace and project selection | | `web-decisions-list` | `/decisions` | `docs/assets/screenshots/web-decisions-list.png` | Include status, scope, and filters | | `web-decision-detail` | `/decisions/:decisionId` | `docs/assets/screenshots/web-decision-detail.png` | Show history and suggestion areas | | `web-decision-edit` | `/decisions/:decisionId/edit` | `docs/assets/screenshots/web-decision-edit.png` | Capture editor structure after copy stabilizes | | `web-organization` | `/organization` | `docs/assets/screenshots/web-organization.png` | Show overview cards and navigation | | `web-projects-repos` | `/organization/projects` | `docs/assets/screenshots/web-projects-repos.png` | Include project and repo assignment UI | | `web-members` | `/organization/members` | `docs/assets/screenshots/web-members.png` | Show role labels and invite status | | `web-api-keys` | `/organization/api-keys` | `docs/assets/screenshots/web-api-keys.png` | Avoid showing full token values | | `web-github` | `/integrations/github` | `docs/assets/screenshots/web-github.png` | Show install or connected state | | `web-agents` | `/integrations/agents` | `docs/assets/screenshots/web-agents.png` | Include platform selector and connected clients | | `web-monitoring` | `/monitoring` | `docs/assets/screenshots/web-monitoring.png` | Show alerts and coverage | | `web-rules` | `/rules` | `docs/assets/screenshots/web-rules.png` | Show rule list and config panel | | `web-overrides` | `/pr-gatekeeper/overrides` | `docs/assets/screenshots/web-overrides.png` | If route remains user-visible in docs scope |

On this page