mcpField
R
router-first-architecture

router-first-architecture

github.com/parcadeiAgent workflows3.9k468 installsUpdated 39w ago
Repository

About router-first-architecture

An agent architecture skill that routes requests through domain routers before individual tools, for workflows that centralize intent mapping and tool selection.

Key features

  1. 01Route through domain routers first
  2. 02Use confidence to determine fallbacks
  3. 03Co-activate domain skills with routers
  4. 04Separate trigger and routing layers

Use cases

  1. 01Map math intents to CLI commands
  2. 02Avoid direct script calls when a router exists

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/parcadei/continuous-claude-v3 --skill router-first-architecture

After installing, type/router-first-architecturein Claude Code to confirm it loaded.

Details

From the project README

Router-First Architecture

Route through domain routers before using individual tools. Routers abstract tool selection.

Pattern

Domain routers (like math-router) provide deterministic mapping from user intent to exact CLI commands. Always use the router first; only bypass for edge cases.

DO

  • Call math-router route "<intent>" before any math operation
  • Let domain skills co-activate with their router (via coActivate in skill-rules.json)
  • Trust the router's confidence score; only fall back if command: null
  • Keep trigger keywords/patterns in skill-rules.json broader than routing patterns

DON'T

  • Call individual scripts directly when a router exists
  • Duplicate routing logic in individual skills
  • Let domain skills bypass their router

Co-Activation Pattern

Domain skills should co-activate with their router:

{
  "math/abstract-algebra/groups": {
    "coActivate": ["math-router"],
    "coActivateMode": "always"
  }
}

This ensures the router is always available when domain knowledge is activated.

Two-Layer Architecture

  1. Skill-rules trigger layer: Nudges Claude to use the router (keywords, intent patterns)
  2. Router routing layer: Deterministic mapping to scripts via regex patterns

Keep the trigger layer broader than routing - the router should handle "not found" gracefully.

Source Sessions

  • 2bbc8d6e: "Trigger layer was narrower than routing layer" - expanded triggers
  • This session: Wired 8 domain math skills to co-activate with math-router

Comments

Markdown supported