Skip to main content

Standard Operating Procedures

Benchmarked against: Anthropic — (No direct equivalent — SuperPortia operations feature) Storage: Cloud UB + .claude/rules/ + .claude/skills/ Scope: Recurring procedures that all agents must follow

SOPs are the step-by-step playbooks for recurring operations. They ensure consistency across agents and sessions.


SOP index

Session management

SOPTriggerLocationDescription
Session StartEvery new sessionAIP Section 1 + hooksHeartbeat, mailbox, ask Captain
Compaction RecoveryAfter context compactioncompaction-recovery-protocol.mdRead summary, confirm context, resume
Session HandoffSession endingAIP Section 5bSave todos to Cloud UB
Pre-ExitSession endingAIP Section 5Confirm ingestions, report summary

Decision making

SOPTriggerLocationDescription
Pre-Flight CheckBefore non-trivial tasksCloud UB: ub-a0914abf17a73D scoring: Blast Radius x Knowledge Freshness x Reversibility
66s ReviewMajor decisions, specsSkill: /66s-reviewSix Hats + Six Shoes systematic analysis
HITL DecisionCaptain approval neededConstitution Section 11Q / Options / Recommendation / Captain reply
Pre-Decision SearchBefore important decisionsAIP Section 2Search UB for precedents

Knowledge management

SOPTriggerLocationDescription
Search-First FlowNeed informationConstitution Section 6UB first → delegate search → ingest → use
Correction CaptureCaptain corrects agentAIP Section 3Dual ingest: Memory MCP + UB
DiscoveryLearn new factAIP Section 4Decide: personal vs team → appropriate store
Research-Before-PlanTechnical planningAIP Section 6Classify knowledge → verify perishable → then plan

Work orders

SOPTriggerLocationDescription
WO CreationNew task neededWO System docsTitle convention, valid assignees, required fields
WO CompletionWork doneWO System docsSummary + actual hours → submit for review
WO BlockingImpediment foundWO System docsStatus update with mandatory notes

SOP design principles

PrincipleApplication
TriggerableEvery SOP has a clear trigger condition
CheckableSteps can be verified for completion
SearchableStored in UB or docs (not just memory)
EnforceableHooks/gates enforce critical SOPs
LeanMinimum steps needed

SOP vs rule vs skill

TypeLoadingWhereExample
RuleAlways.claude/rules/Cost awareness
SkillOn /command.claude/skills/66s Review
SOPReferencedCloud UB + docsPre-Flight Check
GuideOn demandDocs siteFleet Setup

Creating a new SOP

  1. Identify the trigger — What event starts this procedure?
  2. List the steps — What must be done, in order?
  3. Define verification — How do you know it's done correctly?
  4. Choose storage — UB entry, rule file, skill file, or docs page?
  5. Add enforcement — Can a hook or gate enforce it?
  6. Ingest to UB — So all agents can find it

PageRelationship
Resources OverviewResource categories
Session Start GuideSession start SOP details
WO Lifecycle GuideWO SOPs details
Skills OverviewSkills that implement SOPs