diff --git a/ROUTING-EXAMPLES.md b/ROUTING-EXAMPLES.md new file mode 100644 index 0000000..efe6600 --- /dev/null +++ b/ROUTING-EXAMPLES.md @@ -0,0 +1,84 @@ +# 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