Agents Builders

Sweep remaining doc stragglers

Archived
sweep-remaining-doc-stragglers

Created

Jul 04, 08:34

Started

Jul 04, 18:01

Completed

Jul 04, 19:54

DevOps handoff

Type

Chore

Shape

ui-only

Worktree Slug

sweep-remaining-doc-stragglers

Repositories

mcritchie-studio

Release Slug

Branch

feat/sweep-remaining-doc-stragglers

QA URL

Production URL

devops

Acceptance Criteria

  • heartbeats cheat sheet drops release merge step
  • Avi Slow Fast rows marked retired aliases
  • deployment.md names production-deploy as sanctioned prompt
  • mission.md added to REVIEW_DOCS tripwire

Expected Test Plan

  • component

Checks Run

  • [component] bin/rails test test/docs/ — 13 runs, 154 assertions, green (incl. mission.md now in REVIEW_DOCS)
  • [full-suite@8c486900f659dba8552ead2032630bdec127b572] bin/rails test green
  • [rubocop@8c486900f659dba8552ead2032630bdec127b572] bin/rubocop clean

Agent Context

Bundle of pre-existing stragglers from the PR #367 review (Shannon primary + Alex light, task activity-761). (1) MOST READER-DANGEROUS: docs/agents/modules/heartbeats.md:75 — the Avi cheat-sheet row still ends review with 'bin/task move <task> reviewed + bin/release merge <task>', contradicting the review-only contract stated at ~line 208 of the SAME doc; a conductor following the cheat sheet would merge after review. (2) docs/agents/modules/parallel-agent-devops.md:274-296 — Avi Heartbeat Slow/Fast presented as current with no retired/alias marker (behavioral claims are accurate; just mark as aliases per the qa-release SKILL framing). (3) docs/agents/modules/deployment.md ~164 — add production-deploy to the pre-approved production prompts list (currently only full-cycle + Deploy with Task; hedged wording so non-blocking, but completeness). (4) Add system/mission.md to REVIEW_DOCS in test/docs/review_lane_docs_test.rb so mission.md regressions trip (gap: it has no positive pin — exactly why PR #367 had to be a manual sweep). Optional style nits from the same review: pr-review-sop.md ~37 double possessive; deployment.md ~164 singular verb. Match the #362/#365/#367 vocabulary; leave alias-keyed runbooks and dated history.

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
    F Fearow
    Fearow
    Model
    Duration
    Tokens
    Cost
    Completed Jul 04, 08:34 · 4 days ago
    api
  2. Designed Building
    F Fearow
    Fearow
    Model
    claude-fable-5
    Duration
    about 9 hours
    Tokens
    29,695,709
    Cost
    ~$59.78
    Started Jul 04, 08:34
    Completed Jul 04, 18:01 · 4 days ago
    cli
  3. Building Submitted
    F Fearow
    Fearow
    Model
    claude-fable-5
    Duration
    14 minutes
    Tokens
    93,433
    Cost
    Started Jul 04, 18:01
    Completed Jul 04, 18:15 · 4 days ago
    cli
  4. Submitted Reviewed Review Activity
    S Shannon
    Shannon primary
    J Jasper
    Jasper light
    Model
    claude-fable-5
    Duration
    8 minutes
    Tokens
    4,099,972
    Cost
    ~$4.85
    Started Jul 04, 18:15
    Completed Jul 04, 18:24 · 4 days ago
    cli
  5. Reviewed Assembled
    S Steffon
    Steffon
    Model
    claude-fable-5
    Duration
    about 1 hour
    Tokens
    5,340,122
    Cost
    ~$5.99
    Started Jul 04, 18:24
    Completed Jul 04, 19:13 · 4 days ago
  6. Assembled Shipped
    A Avi
    Avi
    Model
    claude-fable-5
    Duration
    41 minutes
    Tokens
    Cost
    Started Jul 04, 19:13
    Completed Jul 04, 19:54 · 4 days ago
  7. Shipped Archived
    Model
    Duration
    about 6 hours
    Tokens
    Cost
    Started Jul 04, 19:54
    Completed Jul 05, 02:21 · 3 days ago

Conversation

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

Comment 4 days ago

Scope update from the PR #367 delta review (Shannon): the #364 restructure appears to have RESOLVED item 1 (heartbeats.md Avi cheat-sheet merge-after-review row — the region is now recovery/History framing at heartbeats.md:243/:264). Builder should verify and drop item 1 if confirmed; items 2 (parallel-agent-devops.md Slow/Fast alias markers) and 3 (deployment.md production-deploy one-liner) and 4 (mission.md REVIEW_DOCS tripwire) remain open.

Handoff 4 days ago

PR #376 open into release. Items 1+2 already resolved on release (#364/#373) — dropped with evidence in PR body; item 3 (deployment.md production-deploy prompt) + item 4 (mission.md REVIEW_DOCS pin) + pr-review-sop possessive nit fixed. Full suite 2727 runs green, rubocop clean, dor-check pass. Preview :3013/docs/modules/deployment.

Comment shannon 4 days ago

Review (Shannon PRIMARY + Jasper LIGHT): all-clear. One non-blocking follow-up from the light's empirical check: the new REVIEW_DOCS comment says mission.md's framing 'can't drift back', but a literal revert to pre-#367 mission.md passes the scan (old phrasing 'runs the merge' / 'Two approvals merge the PR into release' matches none of the three regexes). Tripwire is real for fresh one-hand 'reviews+merges' phrasings (injection fails correctly, zero false-positive exposure). Future sweep: soften that comment or add a positive pin for system/mission.md (assert_match /review-only/i + /sweep/i).

Sealed-bid sizing

Edit →

Alex (PM)

Avi (PO)

SMALL

Dev

SMALL

Actual

XL