# angel291592/intent-router architecture

> Architecture diagram of the GitHub repository angel291592/intent-router, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-04). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/angel291592/intent-router
- Repository: https://github.com/angel291592/intent-router

## Overview

Intent-Router is a prompt-based skill that turns an unclear request into a typed IntentSpec, then checks completed work against that specification. Its principal workflow probes repository or task evidence, asks only about unresolved decisions, halts when the request is contradictory or underspecified, and emits a persistent artifact for a downstream agent or planner. The README also documents resuming from that artifact and recording delivery checks. Source excerpts are limited to the evaluation runner, so runtime relationships below rely on README statements; unsampled skill internals are not inferred.

Main entry points: [`skills/intent-router/SKILL.md`](https://github.com/angel291592/intent-router/blob/main/skills/intent-router/SKILL.md) (Resolve unknowns), [`skills/intent-router/references/probe-surfaces.md`](https://github.com/angel291592/intent-router/blob/main/skills/intent-router/references/probe-surfaces.md) (Probe guidance), [`skills/intent-router/references/ask-protocol.md`](https://github.com/angel291592/intent-router/blob/main/skills/intent-router/references/ask-protocol.md) (Ask protocol), [`skills/intent-router/schema/intentspec.schema.json`](https://github.com/angel291592/intent-router/blob/main/skills/intent-router/schema/intentspec.schema.json) (IntentSpec schema)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_intent["Intent resolution"]
  node_skill["Intent skill<br/>[SKILL.md]"]
  node_parse["Parse request<br/>[SKILL.md]"]
  node_typecheck["Typecheck intent<br/>[SKILL.md]"]
  node_halt["Halt defects<br/>[SKILL.md]"]
end

subgraph group_evidence["Evidence and decisions"]
  node_probe["Probe context<br/>[SKILL.md]"]
  node_probe_refs["Probe guidance<br/>[probe-surfaces.md]"]
  node_resolve["Resolve unknowns<br/>[SKILL.md]"]
  node_ask_protocol["Ask protocol<br/>[ask-protocol.md]"]
end

subgraph group_artifact["Spec and delivery"]
  node_schema["IntentSpec schema"]
  node_emit["Emit IntentSpec<br/>[SKILL.md]"]
  node_artifact_file["Saved spec"]
  node_delivery["Check delivery<br/>[SKILL.md]"]
end

node_user(("Requester"))
node_agent(("Planner or agent"))

node_user -->|"submits request"| node_skill
node_skill -->|"parses request"| node_parse
node_parse -->|"probes context"| node_probe
node_probe -->|"uses guidance"| node_probe_refs
node_probe -->|"resolves fields"| node_resolve
node_resolve -->|"asks unresolved"| node_ask_protocol
node_resolve -->|"halts defects"| node_halt
node_resolve -->|"settles intent"| node_typecheck
node_typecheck -->|"types against"| node_schema
node_typecheck -->|"emits spec"| node_emit
node_emit -->|"saves spec"| node_artifact_file
node_artifact_file -->|"hands off"| node_agent
node_artifact_file -->|"resumes before probing"| node_probe
node_agent -->|"returns completed work"| node_delivery
node_delivery -->|"records check"| node_artifact_file

click node_skill "https://github.com/angel291592/intent-router/blob/main/skills/intent-router/SKILL.md"
click node_parse "https://github.com/angel291592/intent-router/blob/main/skills/intent-router/SKILL.md"
click node_typecheck "https://github.com/angel291592/intent-router/blob/main/skills/intent-router/SKILL.md"
click node_probe "https://github.com/angel291592/intent-router/blob/main/skills/intent-router/SKILL.md"
click node_probe_refs "https://github.com/angel291592/intent-router/blob/main/skills/intent-router/references/probe-surfaces.md"
click node_resolve "https://github.com/angel291592/intent-router/blob/main/skills/intent-router/SKILL.md"
click node_ask_protocol "https://github.com/angel291592/intent-router/blob/main/skills/intent-router/references/ask-protocol.md"
click node_halt "https://github.com/angel291592/intent-router/blob/main/skills/intent-router/SKILL.md"
click node_schema "https://github.com/angel291592/intent-router/blob/main/skills/intent-router/schema/intentspec.schema.json"
click node_emit "https://github.com/angel291592/intent-router/blob/main/skills/intent-router/SKILL.md"
click node_delivery "https://github.com/angel291592/intent-router/blob/main/skills/intent-router/SKILL.md"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_skill,node_parse,node_typecheck,node_halt toneBlue
class node_probe,node_probe_refs,node_resolve,node_ask_protocol toneAmber
class node_schema,node_emit,node_artifact_file,node_delivery,node_user toneMint
class node_agent toneIndigo
```

## Components

### Intent resolution

- [Intent skill](https://github.com/angel291592/intent-router/blob/main/skills/intent-router/SKILL.md): `skills/intent-router/SKILL.md`
- [Parse request](https://github.com/angel291592/intent-router/blob/main/skills/intent-router/SKILL.md): `skills/intent-router/SKILL.md`
- [Typecheck intent](https://github.com/angel291592/intent-router/blob/main/skills/intent-router/SKILL.md): `skills/intent-router/SKILL.md`
- [Halt defects](https://github.com/angel291592/intent-router/blob/main/skills/intent-router/SKILL.md): `skills/intent-router/SKILL.md`

### Evidence and decisions

- [Probe context](https://github.com/angel291592/intent-router/blob/main/skills/intent-router/SKILL.md): `skills/intent-router/SKILL.md`
- [Probe guidance](https://github.com/angel291592/intent-router/blob/main/skills/intent-router/references/probe-surfaces.md): `skills/intent-router/references/probe-surfaces.md`
- [Resolve unknowns](https://github.com/angel291592/intent-router/blob/main/skills/intent-router/SKILL.md): `skills/intent-router/SKILL.md`
- [Ask protocol](https://github.com/angel291592/intent-router/blob/main/skills/intent-router/references/ask-protocol.md): `skills/intent-router/references/ask-protocol.md`

### Spec and delivery

- [IntentSpec schema](https://github.com/angel291592/intent-router/blob/main/skills/intent-router/schema/intentspec.schema.json): `skills/intent-router/schema/intentspec.schema.json`
- [Emit IntentSpec](https://github.com/angel291592/intent-router/blob/main/skills/intent-router/SKILL.md): `skills/intent-router/SKILL.md`
- **Saved spec**
- [Check delivery](https://github.com/angel291592/intent-router/blob/main/skills/intent-router/SKILL.md): `skills/intent-router/SKILL.md`

### Other components

- **Requester**
- **Planner or agent**

## Connections

- Requester → Intent skill: submits request (evidence: `README.md`)
- Intent skill → Parse request: parses request (evidence: `README.md`)
- Parse request → Probe context: probes context (evidence: `README.md`)
- Probe context → Probe guidance: uses guidance (evidence: `README.md`)
- Probe context → Resolve unknowns: resolves fields (evidence: `README.md`)
- Resolve unknowns → Ask protocol: asks unresolved (evidence: `README.md`)
- Resolve unknowns → Halt defects: halts defects (evidence: `README.md`)
- Resolve unknowns → Typecheck intent: settles intent (evidence: `README.md`)
- Typecheck intent → IntentSpec schema: types against (evidence: `README.md`)
- Typecheck intent → Emit IntentSpec: emits spec (evidence: `README.md`)
- Emit IntentSpec → Saved spec: saves spec (evidence: `README.md`)
- Saved spec → Planner or agent: hands off (evidence: `README.md`)
- Saved spec → Probe context: resumes before probing (evidence: `README.md`)
- Planner or agent → Check delivery: returns completed work (evidence: `README.md`)
- Check delivery → Saved spec: records check (evidence: `README.md`)
