Agents Builders

Docs reference SOP vocabulary

Shipped
docs-reference-sop-vocabulary

Created

Jun 26, 22:28

Started

Jun 27, 00:08

Completed

Jun 27, 01:22

DevOps handoff

Type

Chore

Shape

ui-only

Worktree Slug

docs-reference-sop-vocabulary

Repositories

mcritchie-studio

Release Train

Branch

feat/docs-reference-sop-vocabulary

QA URL

Production URL

docs

Acceptance Criteria

  • devops-cycle-design links to the SOP infographic
  • Stages guide links to the SOP infographic
  • Docs note vocabulary YAML as single source
  • Vocabulary Main Branch step drops resolved divergence

Expected Test Plan

  • [component] GET /stages/sop 200; exactly one data-sop-diverges marker on Review's Release Branch
  • [unit] Devops::Vocabulary: Main Branch step drops :diverges; Release Branch keeps it (one diverging step total)

Checks Run

  • [component] GET /stages/sop 200; exactly one data-sop-diverges marker (Review's Release Branch)
  • [unit] Devops::Vocabulary: Main Branch step has no :diverges; Release Branch still does (one diverging step total)
  • [full-suite@116f2b3720656412a241ee000ea04cc5b7afa8cb] bin/rails test green
  • [rubocop@116f2b3720656412a241ee000ea04cc5b7afa8cb] bin/rubocop clean

Agent Context

Part of the single-source-of-truth goal (2026-06-26). (1) Point devops-cycle-design.md §1.2 + the /stages stage guide at /stages/sop, and name config/devops_vocabulary.yml (read by Devops::Vocabulary) as the single source of truth — link to the live page, don't restate the per-step content. (2) ALSO fold in the resolved Main Branch fix that MISSED PR #250's merge: in the Steffon/Assemble lane's 'Main Branch' step, delete the diverges line and reword expectation to 'Merge-forward guard: if main moved ahead, merge main into release so release always keeps main as an ancestor (stays shippable). Main itself does NOT move here — it advances only at ship, when release fast-forwards into main.' and gate to 'release stays ahead of main'. The fix exists as dangling commit 338ab6d on feat/devops-sop-infographic (one commit ahead of release) — cherry-pick or re-apply it. After: /stages/sop shows ONE ⚠ (Release Branch only). Depends on devops-sop-infographic already shipped.

Stage Timeline

Who handled each stage, the time it took (measured), and the model / tokens / cost reported (best-effort) — plus who's on it right now. means the agent didn't report that metric.

Sizing Avi · PO SMALL Dev SMALL Actual XL ≠ forecast
  1. Created Designed
    Model
    Duration
    Tokens
    Cost
    Completed Jun 26, 22:28 · about 13 hours ago
    api
  2. Designed Building
    5
    580465d6-dd71-4c43-9029-41842241971c
    Model
    claude-opus-4-8
    Duration
    about 2 hours
    Tokens
    61,020,267
    Cost
    ~$48.97
    Started Jun 26, 22:28
    Completed Jun 27, 00:08 · about 11 hours ago
    cli
  3. Building Submitted
    5
    580465d6-dd71-4c43-9029-41842241971c
    Model
    claude-opus-4-8
    Duration
    12 minutes
    Tokens
    6,689,655
    Cost
    ~$5.51
    Started Jun 27, 00:08
    Completed Jun 27, 00:20 · about 11 hours ago
    cli
  4. Submitted Reviewed
    A Alex
    Alex primary
    S Shannon
    Shannon light
    Model
    gpt-5.5
    Duration
    7 minutes
    Tokens
    Cost
    Started Jun 27, 00:20
    Completed Jun 27, 00:27 · about 11 hours ago
    cli
  5. Reviewed Assembled
    S Steffon
    Steffon
    Model
    gpt-5.5
    Duration
    7 minutes
    Tokens
    Cost
    Started Jun 27, 00:27
    Completed Jun 27, 00:34 · about 11 hours ago
  6. Assembled Shipped
    A Avi
    Avi
    Model
    gpt-5.5
    Duration
    about 1 hour
    Tokens
    Cost
    Started Jun 27, 00:34
    Completed Jun 27, 01:22 · about 10 hours ago

Conversation

QA review feedback, agent handoffs, and follow-up notes for this task.

No task feedback has been recorded yet.

Sealed-bid sizing

Edit →

Alex (PM)

Avi (PO)

SMALL

Dev

SMALL

Actual

XL