Files
ui-tracker/ROUTING-EXAMPLES.md

85 lines
4.4 KiB
Markdown
Raw Permalink Normal View History

2026-03-27 22:34:12 -05:00
# 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