Files

Steve Yegge 584608a14e feat: add llms.txt standard support for AI agent discoverability (#784 )

Cherry-picked website/, scripts/generate-llms-full.sh, and deploy-docs.yml
from joyshmitz's PR. Fixed workflow to trigger on main branch instead of
docs/docusaurus-site.

Features:
- Docusaurus documentation site with llms.txt support
- Environment-variable driven config (defaults to steveyegge org)
- Automated llms-full.txt generation from docs
- GitHub Pages deployment workflow

Co-authored-by: joyshmitz <joyshmitz@users.noreply.github.com>

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

Executed-By: beads/crew/dave
Rig: beads
Role: crew

2025-12-30 18:27:50 -08:00

2.2 KiB

Raw Blame History

id, title, sidebar_position

id	title	sidebar_position
routing	Routing	2

Multi-Repo Routing

Automatic issue routing across repositories.

Overview

Routing enables:

Issues created in one repo routed to another
Pattern-based routing rules
Fallback to default repository

Configuration

Create .beads/routes.jsonl:

{"pattern": "frontend/**", "target": "frontend-repo", "priority": 10}
{"pattern": "backend/**", "target": "backend-repo", "priority": 10}
{"pattern": "docs/**", "target": "docs-repo", "priority": 5}
{"pattern": "*", "target": "main-repo", "priority": 0}

Route Fields

Field	Description
`pattern`	Glob pattern to match
`target`	Target repository
`priority`	Higher = checked first

Pattern Matching

Patterns match against:

Issue title
Labels
Explicit path prefix

Examples:

{"pattern": "frontend/*", "target": "frontend"}
{"pattern": "*api*", "target": "backend"}
{"pattern": "label:docs", "target": "docs-repo"}

Commands

# Show routing table
bd routes list
bd routes list --json

# Test routing
bd routes test "Fix frontend button"
bd routes test --label frontend

# Add route
bd routes add "frontend/**" --target frontend-repo --priority 10

# Remove route
bd routes remove "frontend/**"

Auto-Routing

When creating issues, beads checks routes:

bd create "Fix frontend button alignment" -t bug
# Auto-routed to frontend-repo based on title match

Override with explicit target:

bd create "Fix button" --repo backend-repo

Cross-Repo Dependencies

Track dependencies across repos:

# In frontend-repo
bd dep add bd-42 external:backend-repo/bd-100

# View cross-repo deps
bd dep tree bd-42 --cross-repo

Hydration

Pull related issues from other repos:

# Hydrate issues from related repos
bd hydrate

# Preview hydration
bd hydrate --dry-run

# Hydrate specific repo
bd hydrate --from backend-repo

Best Practices

Use specific patterns - Avoid overly broad matches
Set priorities - Ensure specific patterns match first
Default fallback - Always have a * pattern with lowest priority
Test routes - Use bd routes test before committing

2.2 KiB Raw Blame History