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 |