Skip to content

day-one-review: Cold First-Time-User Launch Audit & Remediation

Use day-one-review when auditing a repository from the perspective of a cold Day-1 developer installing and using it publicly tomorrow, then remediating confirmed findings and running cumulative follow-up reviews without digression.

Execution defaults vs. explicit /swarm opt-in

  • Default (no /swarm): Runs via direct invoke_subagent or single-agent execution to stay focused and avoid /swarm board overhead.
  • Explicit /swarm opt-in: Only when the user explicitly asks for /swarm, pair with swarm-governance using a flat /swarm compiled via squad_planner (agy-squad plan --topology flat --read-only), split into category-scoped read-only specialists tailored to the target repository plus one flat Integrity Auditor (audit-<id>) (structurally matching flat self-diagnosis, generalized for any target repository).

Exact 4-stage workflow

  1. Stage 1: Cadence intake & scratch/ audit anchor: Before launching r1, ask the user strictly which review cadence they want without asking for or injecting bug hypotheses:
  2. Single-round cold audit (r1 only): read-only report and ship verdict, then stop.
  3. Multi-round (r1 -> remediate -> r2 cumulative): iterate until the target ship verdict passes.
  4. Full public-launch gate (r1 -> remediate -> r2 -> unanchored live raw-final): adds a fresh unanchored consumer live trial before merge or tag. Anchor all review files under scratch/day-one-review/ (or a user-designated path), confirm .gitignore and release-tarball exclusion so audit artifacts never ship accidentally (use docs/reviews/ only if explicitly requested), and pin branch, HEAD SHA, dirty delta, and runtime environment.
  5. Stage 2: Raw, unguided initial review (r1) with live consumer install: Enforces a strict Anti-Anchoring Rule (putting [agy-transcript-access: deny] on line 1 of r1 and raw-final subagent prompts whenever Agy-Context-Saver is installed). On r1, do not read prior review ledgers (docs/reviews/*), internal planning docs (docs/plans/*), git log, PR self-claims, or maintainer hypotheses before packing the release artifact, installing it into a disposable consumer project (normal + --ignore-scripts where applicable), compiling public types strictly (skipLibCheck: false for TypeScript SDKs), and walking the target repository live from the outside in:
  6. First 60 seconds (README, diagrams/jargon, Quickstart, package/site metadata)
  7. Clean install, setup, upgrade, and rollback (fresh host, --ignore-scripts, off-PATH, cross-OS, strict public typecheck)
  8. Everyday usage inside an unrelated user project (zero checkout assumptions, live CLI/SDK/MCP dogfooding, error clarity, friction)
  9. Security and trust boundaries (4.11 SEC: execution surface, downloads/checksums, permissions, secret hygiene, linear-time regex / ReDoS, least-privilege CI workflow permissions: / concurrency:, uninstall cleanliness)
  10. Packaging, CI, and release pipeline (tarball allowlist, exact artifact publish, multi-OS CI) Write scratch/day-one-review/day-one-review-r1.md conforming to Standard v1.5.0 Sections 1-8 (ARCH..DEP, SEC), the Cold Day-1 User-Journey Trace Matrix, and the explicit 4-tier Ship Verdict:
  11. SHIP NOW: 0 open P0/P1/P2/P3 actionable in-repo defects (only tracked Section 8 residuals, upstream deferrals, or informational notes remain, if any).
  12. SHIP WITH MINOR POLISH: 0 P0/P1/SEC blockers and at most <= 2 small, localized P2/P3 polish items with zero broken consumer install, compile, SDK, or core-command contracts.
  13. FIX BEFORE RELEASE: 0 P0/P1/SEC blockers, but >= 3 open P2/P3 items or any P2 breaking consumer compilation, installation, or core documented workflows (under Stage 3, all concrete in-repo P0-P3 defects are fixed automatically to reach SHIP NOW).
  14. HOLD BEFORE PUBLIC RELEASE: Any open P0/P1 blocker, any unresolved SEC vulnerability, or any unreviewed material category.
  15. Stage 3: Auto-fix P0-P3, ask only on Section 8 residuals & selective resume: Keep code edits separate from review passes and checkpoint clean git state. In a Day-1 launch review, P3 findings are concrete user-facing in-repo defects and are remediated automatically alongside P0-P2, no questions asked. Reserve Section 8 (Post-Remediation Residuals & Deferred Dispositions) as the decision gate where the agent asks the user before acting or deferring: external/upstream dependencies, intentional behavior/contract trade-offs that could break existing suites or users, policy-gated files (such as benchmark definitions), and subjective suggestions.
  16. CPU/daemon serialization rule: Default Stage 3 remediation to a single coding subagent whenever the target repository uses native indexers, local daemons, or database locks (reserving parallel coding subagents for lightweight, independent modules).
  17. Pre-push checks: Run tests, strict consumer typecheck, preflight, packaging, docs/lint, and CodeQL-class SEC checks (linear-time regex / ReDoS and least-privilege CI workflow permissions: / concurrency:).
  18. Interruption rule: If remediation is interrupted (rate limit, timeout, disconnect, pause), inspect manage_subagents(Action='list') and resume ONLY the interrupted subagent(s). Never send unsolicited messages to healthy running workers and never spawn duplicate replacement subagents over existing work. Only if a subagent permanently died mid-edit, run a read-only recovery audit first (git diff + worker transcript including tool calls) before finishing only the unremediated remainder.
  19. Stage 4: Cumulative follow-up reviews (r2, r3, ...) & unanchored live raw-final: Follow-up reviews build directly on r1 inside the same audit directory (day-one-review-r2.md linking Prior review: day-one-review-r1.md), carrying forward every prior finding ID with updated canonical statuses, re-verifying fixes across primary and affected categories, and tracking Section 8 residuals. Under the full public-launch gate (or when requested), run one fresh unanchored live consumer trial (day-one-review-raw-final.md with [agy-transcript-access: deny]) before merging or tagging.