Decision Records Overview
Get oriented in the decision list, choose the right next action, and understand how records are surfaced in the dashboard.
The decisions hub at /decisions is the main landing area after onboarding. It is the place where you browse current records, filter by scope or status, open detail views, and decide whether you need to create, edit, approve, or supersede something.
What You See On The Page
The list is table-first. Each row tells you what the decision is, where it applies, what state it is in, and when it was updated. Depending on available data and permissions, you may also see signals that summarize governance context such as rule conformance, PR posture, and drift-related health.
The hub is most useful when you treat it as a starting point rather than a final view. Use it to narrow the list down, then open a decision detail page when you need the full document, revision history, or suggestions.
Common Ways To Use It
Use the hub to answer questions like:
- What decisions apply to this repository right now?
- Which records are still proposed and need review?
- Which accepted decisions are due for follow-up?
- What changed most recently in the workspace?
Related Tasks
If you are creating something new, continue to create-a-decision.md. If you are reviewing an existing record, continue to review-edit-and-publish-decisions.md. If you need to understand why a record looks the way it does, use decision-history-and-suggestions.md.