Skip to content

docs: add 8.2 routing DSL coverage to AI guidelines template - #87

Merged
lmajano merged 1 commit into
developmentfrom
claude/coldbox-8.2-release-oxp2q0
Sep 12, 2026
Merged

docs: add 8.2 routing DSL coverage to AI guidelines template#87
lmajano merged 1 commit into
developmentfrom
claude/coldbox-8.2-release-oxp2q0

Conversation

@lmajano

@lmajano lmajano commented Sep 12, 2026

Copy link
Copy Markdown
Member

Description

The AI coding-agent guidelines template (templates/ai/guidelines/core/coldbox.md) that ships with coldbox ai scaffolding still only documented the pre-8.x routing surface (route()/resources()/group()). This adds a new Routing subsection covering the ColdBox 8.1/8.2 additions: route middleware, middleware groups, route-level caching (.withCache()), Server-Sent Events, and AI/AI Gateway routing (toAi(), toMCP(), toAiGateway()).

No route-generator command exists in this repo today, so nothing was broken by 8.2 — this is purely filling a documentation gap so AI agents scaffolding ColdBox 8.2 apps have accurate routing examples to draw from.

Issues

Found during a ColdBox 8.2 release-readiness audit; no separate CLI issue was filed since this is docs-template-only.

Type of change

  • Bug Fix
  • Improvement
  • New Feature
  • Breaking change (fix or feature that would cause existing functionality to not work as expected)
  • This change requires a documentation update

Checklist

  • My code follows the style guidelines of this project
  • I have commented my code, particularly in hard-to-understand areas
  • I have made corresponding changes to the documentation
  • I have added tests that prove my fix is effective or that my feature works
  • New and existing unit tests pass locally with my changes

🤖 Generated with Claude Code

https://claude.ai/code/session_01D7vyEDCVLA9nFp6NrsajWL


Generated by Claude Code

Route middleware, middleware groups, route-level caching, SSE routes,
and AI gateway routing were all missing from the Routing section, which
still only documented the pre-8.x route()/resources()/group() surface.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01D7vyEDCVLA9nFp6NrsajWL
@lmajano
lmajano merged commit f00807d into development Sep 12, 2026
5 checks passed
@lmajano
lmajano deleted the claude/coldbox-8.2-release-oxp2q0 branch September 12, 2026 16:55
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants