Repository navigation
First release of roninforge-hono, the 19th plugin in the RoninForge Cursor portfolio.
What's inside
- 10 rules with proper Cursor globs:
hono-anti-patterns(59 BAD/CORRECT entries: Express leakage, v3-era removed APIs, RPC inference, Workers, security, routing, runtime, smaller issues)hono-core(alwaysApply: app init, Context API, request accessors, middleware, built-in middleware list, cookie helpers, runtime detection)hono-routing-and-rpc(chained routes load-bearing for RPC, sub-app composition,import typerule, IDE-slowdown mitigations)hono-validators(zod-validator placement, zod-openapi peer pin gotcha, Standard Schema, decision tree)hono-cloudflare-workers(wrangler.jsonc canonical shape, compatibility flag matrix, asset binding, D1 + Drizzle, Durable Objects)hono-security(secureHeaders, csrf, bodyLimit + CVE pin, cookies, JWT, auth library guidance)hono-error-handling(HTTPException, app.onError, typed RPC errors, Sentry via @sentry/hono)hono-jsx(server JSX, jsx-renderer, dom JSX, HonoX islands, htmx, SSR security pin)hono-testing(app.request universal, testClient typed, @cloudflare/vitest-pool-workers)hono-deployment(per-runtime adapters, build pipelines, pin floors)
- 5 skills:
/hono-new-route,/hono-rpc-setup,/hono-cloudflare-workers-setup,/hono-migrate-to-v4,/hono-validate - 1 reviewer subagent (
hono-reviewer) with CRITICAL/ERROR/WARN/NIT severity grouping and 13 per-file checks - 2 fixture projects demonstrating both the gold-standard pattern (correct-sample) and the v3-era hangover (anti-pattern-sample with 26 tracked violations)
- POSIX
validate-plugin.sh+ GitHub Actions CI
Pin floors documented
hono >= 4.9.7mandatory (CVE-2025-59139 / GHSA-92vj-g62v-jqhh bodyLimit bypass fix)hono >= 4.12.16for additional bodyLimit hardening against chunked / unknown-length requestshono >= 4.12.18if rendering JSX SSR (tag / attribute / CSS injection hardening)- Default pin:
^4.12.19(latest stable; covers all of the above) @hono/node-server >= 2.0.0requires Node 20+@hono/zod-openapi >= 1.0.0peers onzod ^4.0.0only (will not work with zod 3.x)
Why this plugin
Hono's maintainers filed Issue #3906 ("llm.txt file") and Issue #4812 ("Official AI Agent Skill for Hono") explicitly because "LLMs have basically no knowledge of how the latest Hono works." Pre-2025 training data is v3-era. Existing community rules don't cover the v3 -> v4 removed APIs, the Express middleware leakage class, or the security defaults.
Every entry sourced to a Hono GitHub issue, MIGRATION.md entry, CVE advisory, or maintainer statement.
Important: no Hono v5 exists. Latest stable is v4.12.19. Any "v5" in generated code is hallucination.
Install
git clone https://github.com/RoninForge/roninforge-hono.git
cp -rn roninforge-hono/rules/* your-project/.cursor/rules/
cp -rn roninforge-hono/skills/* your-project/.cursor/skills/
cp -rn roninforge-hono/agents/* your-project/.cursor/agents/