SOP Template

This is the master SOP template. Copy this file when creating a new SOP. The frontmatter is enforced at build time by src/content/config.ts.

---
title: <SOP Title>

# --- Core (seed-compatible) ---
status: worked            # one of: worked | draft | stub | needs-linear | needs-org-doc
applies_to:               # universal | go2 | vega | site:<slug> | deployment:<slug> | project:<slug>
  - go2
owner: TBD                # skild handle or TBD
last_source_check: YYYY-MM-DD

# --- RBAC (V1 — metadata only; V2 enforced at hub / hosting layer) ---
audience:                 # one or more
  - operator
visibility: internal_general  # internal_general | restricted_ops | engineering_only | manager_only | admin_only | customer_facing

# --- Lifecycle ---
approval_status: draft    # draft | needs_review | reviewed | approved | deprecated
reviewer: TBD
reviewed_date: TBD
approver: TBD
approved_date: TBD
# superseded_by: <slug>   # only if approval_status == deprecated

# --- Cross-links ---
related_dashboards: []
related_issue_forms: []
related_data_sources: []
related_kpis: []
related_apps: []
related_training: []
escalation_path: []

# --- Known gaps + source-grounding ---
known_gaps: []
source_files: []          # paths into raw-index/sources/ or external pointers
---

Body sections

Required, in order:

Scope

One sentence. Who and what this SOP covers.

Purpose

One sentence. Why this SOP exists.

Required inputs / tools

Hardware:
Software:
Permissions:
Documents / channels:

Procedure

Before

During

After

Quality checks

What confirms this was done correctly?

Common failure modes

Issue	Likely cause	Action

Escalation

Who to notify, when, and what information to include.

Source notes

[SOURCE: <doc title or link>]
[INFERRED: <pattern>]
[RECOMMENDATION — not in sources]
[CONFLICT: <doc A> says X; <doc B> says Y]
[ASSUMPTION: <explicit assumption>]

Parent SOP (if this is a site or deployment override):
Sibling SOPs in this branch:
Related dashboards, training, apps:

Source-grounding rules

Every claim must be labeled:

[SOURCE: ...] — directly stated in a cited source.
[INFERRED: ...] — drawn from repeated patterns; not stated outright.
[RECOMMENDATION — not in sources] — best practice; not current SOP.
[CONFLICT: ...] — unresolved conflict; never silently resolved.
[ASSUMPTION: ...] — explicit assumption being made.

See ../source-control/ for governance.