intent-router

Featured

Converges an underspecified request into a typed IntentSpec before any planning, routing or acting starts. Use when the user asks to implement, add, change, refactor, fix, migrate, configure, handle, triage, sort out, look into or decide something and the request leaves decisions open (which objects, which approach, what happens on failure, which trade-off) — in a codebase, a ticket queue, a research brief or an ops runbook — or when the user says "clarify the intent", "what do you need from me", or invokes intent-router. Looks up answers in whatever sources it can reach (code, deps, version history, tests, CI, docs, or a ticket log, an order record, entitlements, the policy in force) before asking the human; asks only preference or irreversible questions, one at a time, with a recommended default; halts instead of guessing. Do not use for explaining existing state ("what does X do", "why is Y slow"), or for a task whose objects, approach and failure behaviour are already stated.

AI & Automation 111 stars 14 forks Updated 2 days ago MIT

Install

View on GitHub

Quality Score: 90/100

Stars 20%
68
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
50
License 10%
100
Description 5%
100

Skill Content

# Intent-Router A compiler does not guess the address of an undefined symbol. Do not guess the user's intent. This runs one layer *before* planning, routing or coding. It converges a request into an `IntentSpec` — a typed, machine-readable statement of what is actually being asked — and hands that off. It does not implement anything itself. ## 1. Purpose and when this fires Three passes, in compiler order: **Parse** the request into a draft spec, **Resolve** every open question by looking it up or asking, then **Typecheck and emit** — route, ask, or halt. Start when **both** hold: 1. The request is a *do-something* request: implement, add, change, refactor, fix, migrate, configure, handle, triage, sort out, look into, decide, write, set up, wire up, rename, remove, upgrade, optimise. 2. A quick scan finds **at least one decision-bearing unknown** — an answer that would change which files are touched, which approach is taken, how failures behave, or what counts as done. Do not start when: - the request asks you to explain existing state ("what does X do", "why is Y slow") rather than to find something out and produce a deliverable; - the silence check below passes — the request already states every decision-bearing item, so there is nothing to converge; - the request is trivially scoped and reversible (fix a typo, bump a patch version). **The silence check.** Run it once, against the request text alone, before probing anything. The request is fully specif...

Details

Author
angel291592
Repository
angel291592/Intent-Router
Created
4 days ago
Last Updated
2 days ago
Language
Python
License
MIT

Similar Skills

Semantically similar based on skill content — not just same category