homaroma/.agents/orchestrator/BRIEFING.md

BRIEFING — 2026-06-29T21:35:00Z

Mission

Orchestrate the implementation of a Premium Mega Menu featuring 3 distinct 1:1 image placements across spa, admin, backend, and website apps.

🔒 My Identity

• Archetype: teamwork_preview_orchestrator
• Roles: orchestrator, user_liaison, human_reporter, successor
• Working directory: /home/ti/git/homaroma/.agents/orchestrator
• Original parent: parent
• Original parent conversation ID: 7e38829b-163b-46cc-8e49-1748a6bb675b

🔒 My Workflow

• Pattern: Project Pattern
• Scope document: /home/ti/git/homaroma/.agents/orchestrator/PROJECT.md

1. Decompose: Decompose the task into E2E Testing Track (M1), DB & Backend Updates (M2), Storefront & Admin UI (M3), and E2E & Adversarial Hardening (M4).
2. Dispatch & Execute:
   • Delegate (sub-orchestrator): Delegate tasks to specialists (Explorer, Worker, Reviewer, Auditor).
3. On failure (in this order):
   • Retry: nudge stuck agent or re-send task
   • Replace: spawn fresh agent with partial progress
   • Skip: proceed without (only if non-critical)
   • Redistribute: split stuck agent's remaining work
   • Redesign: re-partition decomposition
   • Escalate: report to parent (sub-orchestrators only, last resort)
4. Succession: Self-succeed at 16 spawns, write handoff.md, spawn successor.

• Work items:
  1. M1: E2E Testing Track [completed]
  2. M2: DB & Backend Updates [in-progress]
  3. M3: Storefront & Admin UI [pending]
  4. M4: E2E & Adversarial Hardening [pending]
• Current phase: 2
• Current focus: Backend routes and shared types implementation by Backend & MCP Developer.

🔒 Key Constraints

• Never write, modify, or create source code files directly.
• Never run build/test commands yourself — require workers to do so.
• You MAY use file-editing tools ONLY for metadata/state files (.md) in your .agents/ folder.
• Never reuse a subagent after it has delivered its handoff — always spawn fresh

Current Parent

• Conversation ID: 7e38829b-163b-46cc-8e49-1748a6bb675b
• Updated: not yet

Key Decisions Made

• Decompose the project into M1 (E2E Testing Track), M2 (DB & Backend Updates), M3 (Storefront & Admin UI), and M4 (Verification/Hardening).
• Active subagents: Spawned backend_worker_1 to implement API and types updates.
• TEST_INFRA.md created successfully.

Team Roster

Agent	Type	Work Item	Status	Conv ID
explorer_pre_impl_1	teamwork_preview_explorer	Pre-implementation investigation	completed	56f80963-767e-4e4b-ac5a-977badbf0cff
db_architect_1	teamwork_preview_worker	Prisma migration & schema changes	completed	4ade2016-c309-4e56-b760-0637e2ee34a9
backend_worker_1	teamwork_preview_worker	Backend API and shared types updates	in-progress	74ea6b82-e166-4003-add5-88681a90b210

Succession Status

• Succession required: no
• Spawn count: 5 / 16
• Pending subagents: none
• Predecessor: none
• Successor: not yet spawned

Active Timers

• Heartbeat cron: task-83
• Safety timer: none
• On succession: kill all timers before spawning successor
• On context truncation: run manage_task(Action="list") — re-create if missing

Artifact Index

• /home/ti/git/homaroma/.agents/orchestrator/BRIEFING.md — Persistent memory index
• /home/ti/git/homaroma/.agents/orchestrator/ORIGINAL_REQUEST.md — Verbatim user request
• /home/ti/git/homaroma/.agents/orchestrator/PROJECT.md — Project scope document
• /home/ti/git/homaroma/.agents/orchestrator/progress.md — Progress log