Skip to content

docs: link agent routing references #51

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
easel wants to merge 2 commits into
base: main
Choose a base branch
from
Open

docs: link agent routing references #51

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
eaec6bc
docs: link agent routing references
easel Apr 22, 2026
528ab7c
docs: link agent routing references
easel Apr 22, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 8 additions & 0 deletions AGENTS.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,5 +1,13 @@
# DDx Agent Instructions

## Agent Routing Reference

DDx agent routing rules live in ddx-agent and should be linked, not duplicated:

- Profile catalog: https://github.com/DocumentDrivenDX/agent/blob/master/docs/routing/profiles.md
- Override precedence: https://github.com/DocumentDrivenDX/agent/blob/master/docs/routing/override-precedence.md
- Best-provider contract: https://github.com/DocumentDrivenDX/agent/blob/master/docs/routing/best-provider.md

This repository uses DDx's built-in bead tracker for durable work management.

## Bead Policy
Expand Down
10 changes: 9 additions & 1 deletion CLAUDE.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -6,6 +6,14 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co

DDx (Document-Driven Development eXperience) is the shared infrastructure platform for document-driven development. It provides the tools that developers and workflow systems (like HELIX) use to manage the documents AI agents consume to build software.

## Agent Routing Reference

DDx agent routing behavior is documented in ddx-agent and should be linked, not duplicated:

- Profile catalog: https://github.com/DocumentDrivenDX/agent/blob/master/docs/routing/profiles.md
- Override precedence: https://github.com/DocumentDrivenDX/agent/blob/master/docs/routing/override-precedence.md
- Best-provider contract: https://github.com/DocumentDrivenDX/agent/blob/master/docs/routing/best-provider.md

DDx is one layer in a three-project stack:
- **DDx** (this repo) — platform services: document library, bead tracker, agent service, personas, templates, git sync
- **HELIX** (`~/Projects/helix`) — workflow methodology: phases, gates, supervisory dispatch, bounded actions
Expand Down Expand Up @@ -222,4 +230,4 @@ Personas enable consistent, high-quality AI interactions across team members and
Do what has been asked; nothing more, nothing less.
NEVER create files unless they're absolutely necessary for achieving your goal.
ALWAYS prefer editing an existing file to creating a new one.
NEVER proactively create documentation files (*.md) or README files unless the task explicitly requires creating or editing documentation.
NEVER proactively create documentation files (*.md) or README files unless the task explicitly requires creating or editing documentation.
Loading