Skip to content

Timeline and Dependencies ​

This document maps dependencies between epics and tasks across all Agent Architecture projects. Use this to identify the critical path, parallel work opportunities, and blocking relationships.



Epic-to-Epic Dependencies ​

Critical Path (must be built in order) ​

Session State Management
        │
        ▼
Tool Cascade (Internal Context Loading)
        │
        ▼
LLM Orchestration Loop
        │
        ▼
Queue Implementation
        │
        ▼
Worker Process Lifecycle
        │
        ▼
Agent Abstraction Layer
        │
        ▼
Dining Research Agent (Vertical 1)
        │
        ▼
Additional Verticals (Experiences, Transportation, Flights, DMC)

Dependency Matrix ​

EpicDepends OnBlocked ByEnables
Orchestrator Core Engine
Session State Management——Tool Cascade, LLM Loop
Tool CascadeSession State Management—LLM Loop
LLM Orchestration LoopSession State Management, Tool Cascade—Queue Implementation (dispatch side)
Job Queue Infrastructure
Queue Implementation——Worker Process Lifecycle, Agent Abstraction
Queue MonitoringQueue Implementation—Scaling (autoscaling signal)
Research Agent Framework
Worker Process LifecycleQueue Implementation—Agent Abstraction, all vertical agents
Agent Abstraction LayerWorker Process Lifecycle—Dining Agent, all vertical agents
Dining Research AgentWorker Process Lifecycle, Agent Abstraction—Additional Verticals
Experiences Research AgentWorker Process Lifecycle, Agent Abstraction——
Transportation Research AgentWorker Process Lifecycle, Agent Abstraction——
Flights Research AgentWorker Process Lifecycle, Agent Abstraction——
DMC Research AgentWorker Process Lifecycle, Agent Abstraction——
Scaling and Reliability
Orchestrator ScalingSession State Management—Production readiness
Agent AutoscalingQueue Monitoring, Worker Process Lifecycle—Production readiness
Failure Mode HandlingQueue Implementation, Worker Process Lifecycle—Production readiness
Observability and Operations
Distributed TracingSession State Management, Worker Process Lifecycle—Metrics and Alerting
Metrics and AlertingDistributed Tracing, Queue Monitoring—Cost Telemetry
Cost TelemetryMetrics and Alerting——

Task-Level Dependencies Within Epics ​

Session State Management ​

TaskDepends OnNotes
Design session state schema—Start here
Implement in-memory working copySchema design
Define Postgres schemaSchema designParallel with in-memory
Set up Redis session storeSchema designParallel with Postgres
Implement session write-throughIn-memory copy, Redis, PostgresAll three must exist
Build session reconstructionWrite-through
Implement sticky routingReconstruction
Build session migrationSticky routing
Add session metricsAll aboveLast task

Tool Cascade ​

TaskDepends OnNotes
Define tool interface contract—Start here
Implement Tier 1 toolsContractParallel with Tier 2/3
Implement Tier 2 toolsContractParallel with Tier 1/3
Implement Tier 3 toolsContractParallel with Tier 1/2
Build cascade orchestratorAll tiersMust have all three tiers
Implement brief generationCascade orchestrator
Add cachingAll tiersCan parallel with cascade
Build cascade error handlingCascade orchestrator
Add cascade metricsAll aboveLast task

LLM Orchestration Loop ​

TaskDepends OnNotes
Define decompose prompt—Start here
Implement decompose stepPrompt
Build dispatch logicDecompose step
Implement parallel dispatchDispatch logic
Build synthesis stepDispatch logicCan parallel with dispatch
Implement re-planningSynthesis step
Implement per-job timeoutDispatch logic
Build partial result supportTimeout, Synthesis
Implement streaming responseSynthesis step
Build conversation history integrationDecompose step
Add LLM metricsAll aboveLast task

Queue Implementation ​

TaskDepends OnNotes
Set up Redis instance—Start here
Define job payload schema—Parallel with Redis setup
Implement job enqueue functionRedis, Schema
Build per-agent queuesEnqueue function
Implement result storageRedis
Build pub/sub notificationsResult storage
Implement Orchestrator subscriberPub/sub
Build dead-letter queueEnqueue function
Implement job retry logicDead-letter queue
Add job TTLEnqueue function
Build queue cleanupTTL
Implement Redis connection poolingRedis
Add Redis health checkConnection pooling

Worker Process Lifecycle ​

TaskDepends OnNotes
Define job payload schemaQueue Implementation schemaReuse or extend
Implement Redis connection poolQueue Implementation Redis
Implement blocking popConnection pool
Build job deserializationBlocking pop
Build job execution pipelineDeserialization
Implement result write-backExecution pipeline
Build pub/sub notificationWrite-back
Implement ack flowWrite-back
Implement nack flowWrite-back
Add visibility timeoutAck/nack
Implement graceful shutdownAll above
Build health check endpointConnection pool
Build readiness check endpointAll dependencies

Agent Abstraction Layer ​

TaskDepends OnNotes
Define input contractWorker Process Lifecycle schema
Define output contractWorker Process Lifecycle schema
Build worker process pool managerWorker Process Lifecycle
Implement agent registrationPool manager
Implement per-agent LLM configRegistration
Implement per-agent tool configRegistration
Build agent discoveryRegistration
Add agent health monitoringPool manager
Build agent versioningRegistration
Implement agent isolationPool manager

Dining Research Agent ​

TaskDepends OnNotes
Set up Dining Agent containerAgent Abstraction
Integrate OpenTable APIContainerParallel with other APIs
Integrate Resy APIContainerParallel with other APIs
Integrate Yelp APIContainerParallel with other APIs
Integrate Tock APIContainerParallel with other APIs
Build source aggregationAll API integrations
Implement deduplicationSource aggregation
Define RestaurantOption schema—Can start early
Build dining system promptSchema
Implement latency budgetSource aggregation
Build caching layerSource aggregation
Implement rate limitingAll API integrations
Add source health monitoringAll API integrations
Build output validationSchema, Execution pipeline

Parallel Work Opportunities ​

Wave 1 (can start immediately) ​

  • Session State Management (Orchestrator)
  • Queue Implementation (Job Queue)
  • Agent Abstraction Layer design (Research Agents)

Wave 2 (after Wave 1 foundations) ​

  • Tool Cascade (needs Session State)
  • Worker Process Lifecycle (needs Queue)
  • Distributed Tracing (needs Session State + Worker)

Wave 3 (after Wave 2) ​

  • LLM Orchestration Loop (needs Tool Cascade + Session State)
  • Dining Research Agent (needs Worker + Abstraction)
  • Queue Monitoring (needs Queue Implementation)
  • Metrics and Alerting (needs Tracing + Queue Monitoring)

Wave 4 (after Wave 3) ​

  • Additional Vertical Agents (needs Worker + Abstraction)
  • Orchestrator Scaling (needs Session State)
  • Agent Autoscaling (needs Queue Monitoring + Worker)
  • Failure Mode Handling (needs Queue + Worker)
  • Cost Telemetry (needs Metrics)

Critical Path Summary ​

The minimum viable path to a working Dining Agent:

1. Session State Management (Orchestrator)
2. Tool Cascade (Orchestrator)
3. Queue Implementation (Job Queue)
4. Worker Process Lifecycle (Research Agents)
5. Agent Abstraction Layer (Research Agents)
6. Dining Research Agent (Research Agents)
7. LLM Orchestration Loop (Orchestrator) — can parallel with 4-6
8. Basic Metrics (Observability) — can parallel with 4-6

Estimated critical path: ~6-8 weeks if fully staffed and unblocked.


Risk Areas ​

RiskImpactMitigation
Redis setup blocks everythingHighStart Redis infrastructure immediately
Session State schema changes cascadeHighFinalize schema early, get sign-off
Partner API integration delaysMediumStart with one API (OpenTable), add others incrementally
LLM prompt iteration takes longer than expectedMediumStart decompose/synthesize prompts early, iterate
Tool Cascade complexity underestimatedMediumBuild tier by tier, test each independently

Marchay Platform Documentation