Agents Builders

New app onboarding SOP

Archived
new-app-onboarding-sop

Created

Jun 23, 03:06

Started

Jun 23, 03:07

Completed

Jun 23, 04:08

DevOps handoff

Type

Chore

Shape

Worktree Slug

new-app-onboarding-sop

Repositories

mcritchie-studio

Release Train

Branch

feat/new-app-onboarding-sop

Local URL

QA URL

Production URL

docs devops process

Acceptance Criteria

  • New-app onboarding SOP added with tier-decision table
  • Cycle docs gain standalone client app lane
  • Worktrees doc gains multi-agent merge-safety patterns
  • Registry gains promotion lifecycle and Rolio emoji
  • Build rules split into evergreen and standalone

Expected Test Plan

No expected checks recorded.

Checks Run

  • [manual] all relative doc links resolve (modules/system/sibling NEW_APP_SETUP)
  • [manual] bin/dor-check → n/a (docs chore), ready to advance

Agent Context

Codify the devops nuances surfaced building Rolio (a standalone client app). Add app TIERS to the cycle: managed satellite vs standalone/client app (PR->main not release, no studio-engine, lite DoR, client handoff). New SOP doc system/new-app-onboarding-sop.md (tier-decision table + phased checklist). Edits: devops-cycle-design.md (new standalone SOP section + shapes-are-deployment-agnostic note), worktrees.md (multi-agent merge-safety: manual git worktree add, new-files-first, single render-line partial edits, additive routes, one migration owner, sequential merge+full-suite gate), app-registry.md (unmanaged-candidate->promote lifecycle + Rolio 📇 emoji). Build rules SPLIT into Evergreen(all apps) vs Standalone-specific. KEY: robust error/API-failure logging is EVERGREEN (rescue_and_log principle); only the studio-engine ErrorLog helper is managed-specific - standalone apps log with plain Rails/Sentry, they do NOT skip logging. External integrations mock-first behind swappable adapters. Author via cycle: worktree, PR into release.

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.

  1. Shipped Archived
    Model
    Duration
    Tokens
    Cost
    Completed Jun 23, 17:13 · 4 days ago

Conversation

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

Handoff 4 days ago

Docs-only chore. 6 files: NEW new-app-onboarding-sop.md (tier table + phased checklist + evergreen/standalone build-conventions split); EDITs to devops-cycle-design.md (Standalone/Client App SOP; shapes deployment-agnostic), worktrees.md (Multi-Agent Safety & Merge Patterns), app-registry.md (candidate→satellite lifecycle + Rolio 📇), index.md Start Here + ECOSYSTEM.md (discoverability + Rolio 📇). PR #107 base=release. bin/dor-check → n/a (docs chore). All relative links verified resolving. Review focus: tier names used verbatim; rescue_and_log principle framed as non-optional-for-standalone.

Sealed-bid sizing

Edit →

Alex (PM)

Avi (PO)

Dev

Actual