RFC-0002: Intent Graphs

Parent-child hierarchies and dependency DAGs for complex workflows.

Abstract

This RFC defines Intent Graphs: hierarchical parent-child relationships and dependency DAGs for coordinating complex multi-agent workflows.

Hierarchical Structure

Intents can be organized in parent-child hierarchies using the parent_intent_id field:

{
  "id": "uuid",
  "title": "Research subsection A",
  "parent_intent_id": "parent-uuid",
  "status": "active"
}

Dependencies

Intents can declare dependencies using the depends_on field:

{
  "id": "uuid",
  "title": "Synthesize findings",
  "depends_on": ["research-uuid-1", "research-uuid-2"],
  "status": "blocked"
}

Dependency Resolution

• An intent with unresolved dependencies starts in blocked status
• When all dependencies complete, the intent transitions to active
• Circular dependencies are rejected at creation time

Graph Operations

• GET /api/v1/intents/:id/children - List child intents
• GET /api/v1/intents/:id/dependencies - List dependency graph