# Routing Examples

Use these examples to validate that the suite routes clearly from `AGENTS.md` to the right hub files and specialized skills.

In deployments with a filled-in [DEPLOYMENT-PROFILE.md](./DEPLOYMENT-PROFILE.md), the agent should read that file after `AGENTS.md` and before opening hubs or skills.

## Representative Prompts

### Fix a failing backend test and explain the root cause

- Start at [AGENTS.md](./AGENTS.md)
- Read [DEPLOYMENT-PROFILE.md](./DEPLOYMENT-PROFILE.md) if it is filled in
- Open [Debugging Hub](./hubs/debugging.md)
- Use [Bug Triage](./skills/debugging/bug-triage.md)
- Use [Debugging Workflow](./skills/debugging/debugging-workflow.md)
- Add [API and Backend Work](./skills/software/api-backend.md)
- Add [Test Strategy](./skills/software/test-strategy.md)

### Build a new UI settings page with good UX and copy

- Start at [AGENTS.md](./AGENTS.md)
- Read [DEPLOYMENT-PROFILE.md](./DEPLOYMENT-PROFILE.md) if it is filled in
- Open [Software Development Hub](./hubs/software-development.md)
- Use [Feature Implementation](./skills/software/feature-implementation.md)
- Use [Frontend UI Implementation](./skills/software/frontend-ui-implementation.md)
- Add [UI/UX Hub](./hubs/ui-ux.md)
- Use [UX Review](./skills/ui-ux/ux-review.md)
- Add [Product Copy](./skills/marketing/product-copy.md)

### Write release notes and update onboarding docs for this feature

- Start at [AGENTS.md](./AGENTS.md)
- Read [DEPLOYMENT-PROFILE.md](./DEPLOYMENT-PROFILE.md) if it is filled in
- Open [Documentation Hub](./hubs/documentation.md)
- Use [Release and Change Summary](./skills/software/release-change-summary.md)
- Use [Onboarding Documentation](./skills/documentation/onboarding-docs.md)
- Add [Technical Documentation](./skills/documentation/technical-docs.md) if setup or behavior changed

### Brainstorm three product directions and turn the best one into a scoped implementation plan

- Start at [AGENTS.md](./AGENTS.md)
- Read [DEPLOYMENT-PROFILE.md](./DEPLOYMENT-PROFILE.md) if it is filled in
- Open [Brainstorming Hub](./hubs/brainstorming.md)
- Use [Ideation](./skills/brainstorming/ideation.md)
- Use [Structured Brainstorming](./skills/brainstorming/structured-brainstorming.md)
- Add [Repository Exploration](./skills/software/repo-exploration.md) if the plan must align to an existing codebase
- Add [Feature Implementation](./skills/software/feature-implementation.md) for implementation-ready shaping

### Review this PR for bugs, regressions, and missing tests

- Start at [AGENTS.md](./AGENTS.md)
- Read [DEPLOYMENT-PROFILE.md](./DEPLOYMENT-PROFILE.md) if it is filled in
- Open [Software Development Hub](./hubs/software-development.md)
- Use [Code Review](./skills/software/code-review.md)
- Add [Test Strategy](./skills/software/test-strategy.md)

### Draft launch messaging for a developer tool feature

- Start at [AGENTS.md](./AGENTS.md)
- Read [DEPLOYMENT-PROFILE.md](./DEPLOYMENT-PROFILE.md) if it is filled in
- Open [Marketing Hub](./hubs/marketing.md)
- Use [Messaging and Positioning](./skills/marketing/messaging-positioning.md)
- Use [Marketing Content](./skills/marketing/marketing-content.md)
- Add [Technical Documentation](./skills/documentation/technical-docs.md) if claims need implementation-grounded detail

### Plan a risky framework upgrade without derailing feature delivery

- Start at [AGENTS.md](./AGENTS.md)
- Read [DEPLOYMENT-PROFILE.md](./DEPLOYMENT-PROFILE.md) if it is filled in
- Open [Software Development Hub](./hubs/software-development.md)
- Use [Dependency Lifecycle Management](./skills/software/dependency-lifecycle.md)
- Add [Test Strategy](./skills/software/test-strategy.md)
- Add [Maintenance and Technical Debt Planning](./skills/software/maintenance-technical-debt.md)
- Add [Release and Change Summary](./skills/software/release-change-summary.md) if rollout communication matters

### Respond to a live production issue and leave the system easier to diagnose next time

- Start at [AGENTS.md](./AGENTS.md)
- Read [DEPLOYMENT-PROFILE.md](./DEPLOYMENT-PROFILE.md) if it is filled in
- Open [Debugging Hub](./hubs/debugging.md)
- Use [Incident Response and Stabilization](./skills/debugging/incident-response-stabilization.md)
- Use [Debugging Workflow](./skills/debugging/debugging-workflow.md)
- Add [Observability and Operability](./skills/software/observability-operability.md)
- Add [Bug Triage](./skills/debugging/bug-triage.md) if reproduction or impact framing is still loose