Skip to content

hashgraph-online/awesome-codex-plugins / plugins/alpoxdev/hypercore/skills/hyper-architecture

hyper-architecture

Verified

[Hyper] Use this skill when the user asks for architecture, project setup, or performance work - building, auditing, restructuring, or reviewing project structure, routes, data or server boundaries, the lint/format/type tooling baseline (oxlint, Prettier, tsconfig, rustfmt, clippy), or build and runtime performance - in a Next.js App Router, TanStack Start, Vite with TanStack Router, Astro, Expo, Lynx (ReactLynx), Hono, Axum, Tauri v2, Electron, or Rust CLI, WASM, or MCP server project. It detects the stack from manifests and config files, routes each touched package of a monorepo separately, and applies the matching bundled stack guide, the shared setup baseline, and that stack's performance rules. Do not use it for stacks outside those eleven or for work that crosses no architecture, setup, or performance boundary, such as copy edits, a plain dependency bump, or one build failure.

FileKindSize
SKILL.ko.mdmarkdown19.9 KB
SKILL.mdskill md18.4 KB
assets/evals/astro-cases.jsonlother17.1 KB
assets/evals/axum-cases.jsonlother13.7 KB
assets/evals/electron-cases.jsonlother14.6 KB
assets/evals/expo-cases.jsonlother18.3 KB
assets/evals/hono-cases.jsonlother22.2 KB
assets/evals/hyper-architecture-cases.jsonlother26.0 KB
assets/evals/lynx-cases.jsonlother17.9 KB
assets/evals/nextjs-cases.jsonlother21.5 KB
assets/evals/rust-cases.jsonlother17.8 KB
assets/evals/tanstack-start-cases.jsonlother21.0 KB
assets/evals/tauri-cases.jsonlother18.6 KB
assets/evals/vite-cases.jsonlother18.6 KB
assets/templates/setup/repo/editorconfigother357 B
assets/templates/setup/repo/gitattributesother714 B
assets/templates/setup/repo/lefthook.ymlconfig843 B
assets/templates/setup/rust/clippy.tomlconfig110 B
assets/templates/setup/rust/rust-toolchain.tomlconfig86 B
assets/templates/setup/rust/rustfmt.tomlconfig200 B
assets/templates/setup/rust/workspace-lints.tomlconfig809 B
assets/templates/setup/typescript/oxlintrc.jsonconfig929 B
assets/templates/setup/typescript/oxlintrc.react.jsonconfig1.1 KB
assets/templates/setup/typescript/prettierignoreother316 B
assets/templates/setup/typescript/prettierrc.jsonconfig263 B
assets/templates/setup/typescript/tsconfig.base.jsonconfig551 B
references/official/astro/astro-2026-11-07.ko.mdmarkdown18.6 KB
references/official/astro/astro-2026-11-07.mdmarkdown17.0 KB
references/official/axum/axum-docs.ko.mdmarkdown5.7 KB
references/official/axum/axum-docs.mdmarkdown4.8 KB
references/official/axum/ecosystem-docs.ko.mdmarkdown3.8 KB
references/official/axum/ecosystem-docs.mdmarkdown3.5 KB
references/official/axum/sqlx-docs.ko.mdmarkdown5.5 KB
references/official/axum/sqlx-docs.mdmarkdown4.7 KB
references/official/axum/tower-docs.ko.mdmarkdown4.2 KB
references/official/axum/tower-docs.mdmarkdown3.7 KB
references/official/axum/utoipa-docs.ko.mdmarkdown4.1 KB
references/official/axum/utoipa-docs.mdmarkdown3.7 KB
references/official/electron/electron-2026-11-08.ko.mdmarkdown15.7 KB
references/official/electron/electron-2026-11-08.mdmarkdown14.1 KB
references/official/expo/expo-react-native-2026-11-04.ko.mdmarkdown23.0 KB
references/official/expo/expo-react-native-2026-11-04.mdmarkdown21.5 KB
references/official/hono/drizzle-docs.ko.mdmarkdown7.0 KB
references/official/hono/drizzle-docs.mdmarkdown6.6 KB
references/official/hono/hono-docs.ko.mdmarkdown15.8 KB
references/official/hono/hono-docs.mdmarkdown14.8 KB
references/official/lynx/lynx-2026-11-07.ko.mdmarkdown14.3 KB
references/official/lynx/lynx-2026-11-07.mdmarkdown14.0 KB
references/official/nextjs/current-docs-2026-11-04.ko.mdmarkdown13.1 KB
references/official/nextjs/current-docs-2026-11-04.mdmarkdown12.0 KB
references/official/nextjs/drizzle-docs.ko.mdmarkdown6.7 KB
references/official/nextjs/drizzle-docs.mdmarkdown6.3 KB
references/official/nextjs/nextjs-docs.ko.mdmarkdown13.6 KB
references/official/nextjs/nextjs-docs.mdmarkdown13.9 KB
references/official/rust/rust-crates-2026-11-07.ko.mdmarkdown22.6 KB
references/official/rust/rust-crates-2026-11-07.mdmarkdown22.0 KB
references/official/tanstack-start/current-docs-2026-11-04.ko.mdmarkdown16.0 KB
references/official/tanstack-start/current-docs-2026-11-04.mdmarkdown14.7 KB
references/official/tanstack-start/tanstack-router-2026-11-04.ko.mdmarkdown10.5 KB
references/official/tanstack-start/tanstack-router-2026-11-04.mdmarkdown9.6 KB
references/official/tanstack-start/tanstack-start-2026-11-04.ko.mdmarkdown25.8 KB
references/official/tanstack-start/tanstack-start-2026-11-04.mdmarkdown23.9 KB
references/official/tauri/tanstack-vite-react-2026-11-04.ko.mdmarkdown14.1 KB
references/official/tauri/tanstack-vite-react-2026-11-04.mdmarkdown13.1 KB
references/official/tauri/tauri-v2-2026-11-04.ko.mdmarkdown18.5 KB
references/official/tauri/tauri-v2-2026-11-04.mdmarkdown17.6 KB
references/official/tooling/tooling-2026-11-07.ko.mdmarkdown21.0 KB
references/official/tooling/tooling-2026-11-07.mdmarkdown20.5 KB
references/official/vite/current-docs-2026-11-04.ko.mdmarkdown11.2 KB
references/official/vite/current-docs-2026-11-04.mdmarkdown10.3 KB
rules/astro/actions-middleware-env.ko.mdmarkdown14.6 KB
rules/astro/actions-middleware-env.mdmarkdown12.9 KB
rules/astro/content.ko.mdmarkdown8.1 KB
rules/astro/content.mdmarkdown7.3 KB
rules/astro/performance.ko.mdmarkdown11.3 KB
rules/astro/performance.mdmarkdown10.0 KB
rules/astro/project-structure.ko.mdmarkdown11.2 KB
rules/astro/project-structure.mdmarkdown9.6 KB
rules/astro/rendering-and-islands.ko.mdmarkdown10.2 KB
rules/astro/rendering-and-islands.mdmarkdown8.7 KB
rules/astro/testing.ko.mdmarkdown10.4 KB
rules/astro/testing.mdmarkdown9.4 KB
rules/axum/conventions.ko.mdmarkdown5.3 KB
rules/axum/conventions.mdmarkdown4.8 KB
rules/axum/database.ko.mdmarkdown11.9 KB
rules/axum/database.mdmarkdown10.2 KB
rules/axum/errors.ko.mdmarkdown6.5 KB
rules/axum/errors.mdmarkdown6.0 KB
rules/axum/handlers.ko.mdmarkdown5.6 KB
rules/axum/handlers.mdmarkdown5.0 KB
rules/axum/middleware.ko.mdmarkdown5.4 KB
rules/axum/middleware.mdmarkdown4.9 KB
rules/axum/openapi.ko.mdmarkdown9.5 KB
rules/axum/openapi.mdmarkdown8.3 KB
rules/axum/performance.ko.mdmarkdown9.6 KB
rules/axum/performance.mdmarkdown8.6 KB
rules/axum/platform.ko.mdmarkdown6.9 KB
rules/axum/platform.mdmarkdown6.3 KB
rules/axum/project-structure.ko.mdmarkdown10.8 KB
rules/axum/project-structure.mdmarkdown9.9 KB
rules/axum/routes.ko.mdmarkdown7.3 KB
rules/axum/routes.mdmarkdown6.3 KB
rules/axum/testing.ko.mdmarkdown5.2 KB
rules/axum/testing.mdmarkdown4.6 KB
rules/axum/validation.ko.mdmarkdown4.8 KB
rules/axum/validation.mdmarkdown4.4 KB
rules/electron/packaging.ko.mdmarkdown7.9 KB
rules/electron/packaging.mdmarkdown7.0 KB
rules/electron/performance.ko.mdmarkdown5.8 KB
rules/electron/performance.mdmarkdown5.0 KB
rules/electron/processes-and-ipc.ko.mdmarkdown10.6 KB
rules/electron/processes-and-ipc.mdmarkdown9.7 KB
rules/electron/project-structure.ko.mdmarkdown8.8 KB
rules/electron/project-structure.mdmarkdown8.1 KB
rules/electron/renderer.ko.mdmarkdown10.8 KB
rules/electron/renderer.mdmarkdown9.8 KB
rules/electron/security.ko.mdmarkdown10.3 KB
rules/electron/security.mdmarkdown9.2 KB
rules/electron/testing.ko.mdmarkdown5.7 KB
rules/electron/testing.mdmarkdown5.0 KB
rules/expo/data-state-and-boundaries.ko.mdmarkdown4.7 KB
rules/expo/data-state-and-boundaries.mdmarkdown4.3 KB
rules/expo/native-platform-and-security.ko.mdmarkdown8.2 KB
rules/expo/native-platform-and-security.mdmarkdown7.5 KB
rules/expo/performance.ko.mdmarkdown11.2 KB
rules/expo/performance.mdmarkdown10.1 KB
rules/expo/project-structure.ko.mdmarkdown13.4 KB
rules/expo/project-structure.mdmarkdown13.2 KB
rules/expo/routing-and-navigation.ko.mdmarkdown8.6 KB
rules/expo/routing-and-navigation.mdmarkdown8.0 KB
rules/expo/testing-and-validation.ko.mdmarkdown5.1 KB
rules/expo/testing-and-validation.mdmarkdown4.8 KB
rules/hono/conventions.ko.mdmarkdown3.7 KB
rules/hono/conventions.mdmarkdown3.5 KB
rules/hono/database.ko.mdmarkdown11.7 KB
rules/hono/database.mdmarkdown10.8 KB
rules/hono/errors.ko.mdmarkdown3.9 KB
rules/hono/errors.mdmarkdown3.7 KB
rules/hono/handlers.ko.mdmarkdown2.5 KB
rules/hono/handlers.mdmarkdown2.2 KB
rules/hono/middleware.ko.mdmarkdown3.3 KB
rules/hono/middleware.mdmarkdown3.0 KB
rules/hono/openapi.ko.mdmarkdown11.7 KB
rules/hono/openapi.mdmarkdown10.9 KB
rules/hono/performance.ko.mdmarkdown8.9 KB
rules/hono/performance.mdmarkdown8.0 KB
rules/hono/platform.ko.mdmarkdown5.0 KB
rules/hono/platform.mdmarkdown4.7 KB
rules/hono/project-structure.ko.mdmarkdown10.4 KB
rules/hono/project-structure.mdmarkdown9.9 KB
rules/hono/routes.ko.mdmarkdown6.9 KB
rules/hono/routes.mdmarkdown6.6 KB
rules/hono/testing-rpc.ko.mdmarkdown5.6 KB
rules/hono/testing-rpc.mdmarkdown5.2 KB
rules/hono/validation.ko.mdmarkdown3.7 KB
rules/hono/validation.mdmarkdown3.5 KB
rules/lynx/native-and-platform.ko.mdmarkdown11.4 KB
rules/lynx/native-and-platform.mdmarkdown10.7 KB
rules/lynx/performance.ko.mdmarkdown11.6 KB
rules/lynx/performance.mdmarkdown10.6 KB
rules/lynx/project-structure.ko.mdmarkdown10.2 KB
rules/lynx/project-structure.mdmarkdown9.6 KB
rules/lynx/testing.ko.mdmarkdown7.0 KB
rules/lynx/testing.mdmarkdown6.4 KB
rules/lynx/threading.ko.mdmarkdown13.0 KB
rules/lynx/threading.mdmarkdown12.0 KB
rules/lynx/ui-and-data.ko.mdmarkdown11.8 KB
rules/lynx/ui-and-data.mdmarkdown10.8 KB
rules/nextjs/data-fetching.ko.mdmarkdown9.9 KB
rules/nextjs/data-fetching.mdmarkdown9.3 KB
rules/nextjs/db.ko.mdmarkdown8.1 KB
rules/nextjs/db.mdmarkdown7.3 KB
rules/nextjs/execution-model.ko.mdmarkdown5.0 KB
rules/nextjs/execution-model.mdmarkdown4.5 KB
rules/nextjs/hooks.ko.mdmarkdown5.8 KB
rules/nextjs/hooks.mdmarkdown5.3 KB
rules/nextjs/performance.ko.mdmarkdown12.5 KB
rules/nextjs/performance.mdmarkdown11.2 KB
rules/nextjs/platform.ko.mdmarkdown7.7 KB
rules/nextjs/platform.mdmarkdown7.0 KB
rules/nextjs/project-structure.ko.mdmarkdown9.4 KB
rules/nextjs/project-structure.mdmarkdown9.0 KB
rules/nextjs/route-handlers.ko.mdmarkdown4.7 KB
rules/nextjs/route-handlers.mdmarkdown4.3 KB
rules/nextjs/routes.ko.mdmarkdown5.0 KB
rules/nextjs/routes.mdmarkdown4.6 KB
rules/nextjs/server-actions.ko.mdmarkdown7.1 KB
rules/nextjs/server-actions.mdmarkdown6.4 KB
rules/nextjs/services.ko.mdmarkdown5.8 KB
rules/nextjs/services.mdmarkdown5.5 KB
rules/nextjs/validation.ko.mdmarkdown2.2 KB
rules/nextjs/validation.mdmarkdown2.3 KB
rules/rust/cli.ko.mdmarkdown13.6 KB
rules/rust/cli.mdmarkdown12.0 KB
rules/rust/crate-layout.ko.mdmarkdown11.4 KB
rules/rust/crate-layout.mdmarkdown10.1 KB
rules/rust/errors-and-logging.ko.mdmarkdown13.0 KB
rules/rust/errors-and-logging.mdmarkdown11.6 KB
rules/rust/mcp-server.ko.mdmarkdown15.2 KB
rules/rust/mcp-server.mdmarkdown13.8 KB

rules/hono/openapi.ko.md

View on GitHub
# OpenAPI와 Swagger

> 생성된 API 문서를 typed contract boundary로 취급

---

## Stable package 기준

2026-11-04 확인 기준 `@hono/zod-openapi` 1.6.3은 Hono `>=4.10.0`과 Zod `^4.0.0`만 요구하고, `@hono/swagger-ui` 0.6.2는 Hono `>=4`를 요구합니다. Third-party `hono-openapi` 1.5.0은 Hono `^4.11.2`와 Standard Schema ecosystem peer를 요구합니다. 경로 선택 전 lockfile과 peer compatibility를 확인합니다.

- Zod 4 route-first API에는 `@hono/zod-openapi`를 우선합니다. `@hono/zod-validator`와 달리 Zod 3를 받지 않습니다.
- 기존 `hono-openapi` surface를 incidental하게 migration하지 않고 보존합니다. 이 package는 official HonoJS package가 아닙니다. 1.3.2부터 `validator()` route에 400 validation 응답이 자동으로 붙으므로 같은 응답을 두 번 문서화하지 않습니다.
- Undocumented plain `Hono` child를 섞고 `OpenAPIHono`가 metadata를 발견할 것이라 기대하지 않습니다.
- 실제 success/error status를 모두 schema화합니다. Central error envelope를 runtime 및 RPC global response type과 동기화합니다.
- Deterministic check에서 document를 생성하고 reference와 unique `operationId`를 검증하며 committed artifact라면 diff를 확인합니다.
- Spec/UI 노출을 별도로 gate합니다. UI를 숨겨도 public JSON spec이 private이 되지 않으며 Swagger UI는 spec을 생성하지 않습니다.
## 핵심 규칙

Hono API가 OpenAPI/Swagger docs를 발행한다면, route 변경은 같은 변경 안에서 generated contract도 갱신해야 합니다. Contract는 runtime route가 실제로 지원하는 request, response, status code, security, example과 일치해야 합니다.

Database row는 자동으로 public API DTO가 아닙니다. Persistence 변경이 문서화된 response에 영향을 주면 publish 또는 codegen 전에 ORM row를 public response schema로 매핑합니다.

## 승인된 생성 경로

| Repo 형태 | 우선 경로 |
|------|------|
| Zod-first routes | `@hono/zod-openapi`의 `OpenAPIHono`, `createRoute()`, `app.openapi()`, `app.doc()` |
| Mixed validator 또는 Standard Schema repos | `hono-openapi`의 `describeRoute()`, `resolver()`, `validator()`, `openAPIRouteHandler()` |
| UI only | Generated spec endpoint에 연결한 `@hono/swagger-ui` |

사용자가 명시적으로 migration을 요청하지 않았다면 앱 전체의 generator를 바꾸지 않습니다.

## 폴더 구조

```text
src/
├── app.ts
├── openapi/
│   ├── components.ts
│   ├── errors.ts
│   └── registry.ts
└── routes/
    └── users/
        ├── index.ts
        ├── routes.ts
        ├── schemas.ts
        └── handlers.ts
```

- Shared components, security schemes, examples, error envelopes는 두 개 이상 feature가 재사용할 때 `src/openapi/`에 둡니다.
- Feature operation metadata는 설명하는 feature route 근처에 둡니다.
- Canonical spec은 app boundary에서 조합하고, generated fragment를 손으로 복붙하지 않습니다.
- `/doc` 또는 `/openapi.json` 같은 안정적인 spec path를 사용합니다.
- Swagger UI는 `/ui`, `/docs`, admin route 같은 별도 path에서 제공합니다.

## Operation Metadata Checklist

문서화된 모든 operation은 아래를 정의해야 합니다:

- 안정적인 `operationId`
- 일관된 `tags`
- Path params, query params, headers, request body schemas
- Status별 JSON schema가 있는 success responses
- 필요한 경우 400, 401, 403, 404, 409, 422, 500 같은 expected error responses
- Reusable `components.securitySchemes`를 통한 auth requirements
- Schema와 일치하는 request/response examples
- Public으로 노출하면 안 되는 endpoint의 deprecation 또는 hide metadata

## Contract Drift Rules

| Drift | 규칙 |
|------|------|
| Handler가 OpenAPI에 없는 validated data를 읽음 | 차단. Request schema를 추가하거나 route 문서화를 중단합니다. |
| OpenAPI가 handler가 반환하지 않는 response status를 나열함 | 경고. Codegen/client publish 전에 handler 또는 docs를 고칩니다. |
| Handler는 status-specific payload를 반환하지만 docs는 generic response만 보여줌 | 경고. 명시적 response schema를 추가합니다. |
| OpenAPI response schema가 internal/sensitive field를 포함한 raw ORM row를 노출함 | 차단. DTO mapping을 추가하고 public response contract를 문서화합니다. |
| Shared auth middleware가 있는데 OpenAPI에 security requirements가 없음 | Public/partner-facing docs에서는 차단. |
| Swagger UI가 실수로 public 노출됨 | 차단. Auth/admin/dev gating을 추가하거나 public-docs 결정을 문서화합니다. |
| Generated spec lint 실패 또는 깨진 `$ref`가 있음 | Publish 전에 차단. |
| 문서화된 JSON·form body에 `415`가 없는데 client가 선언되지 않은 `Content-Type`을 보낼 수 있음 | 경고. 415 결과를 문서화하거나 허용 media type을 좁힙니다. |
| Body를 optional로 선언했는데 handler가 모든 field 존재를 가정함 | 차단. `body.required: true`로 바꾸거나 body 없는 경우를 명시적으로 검증합니다. |

## Request Body Contract

`@hono/zod-openapi` 1.6.x는 JSON과 form media type만 검증합니다. 두 동작을 계약에 반영해야 합니다.

- Request body의 `Content-Type`이 route에 선언한 media type과 하나도 맞지 않으면 `415 Unsupported Media Type`으로 거부합니다. 이전 version은 빈 객체를 검증했기 때문에 잘못된 header를 보낸 client가 handler까지 도달했습니다.
- `request.body.required` 기본값은 `false`입니다. Body 없는 요청이 handler에 도달하고 `c.req.valid('json')`은 `{}`입니다. Body가 필수라면 `required: true`로 두며, 그때 body가 없으면 `400`으로 실패합니다.

`createRoute({ request: { body: { content: { ... } } } })`에 허용하는 media type을 모두 선언하고, client가 의존한다면 두 결과를 operation response 목록에도 반영합니다.

## Large-App Pattern

`@hono/zod-openapi`에서는 feature-local route definition과 app-level registration을 선호합니다. `openapiRoutes()`는 `route`와 `handler`를 짝지은 `defineOpenAPIRoute()` 결과를 받으며, `createRoute()` 객체만으로는 이 방식으로 등록할 수 없습니다.

```ts
// routes/users/routes.ts
import { createRoute, defineOpenAPIRoute } from '@hono/zod-openapi'

export const listUsersRoute = defineOpenAPIRoute({
  route: createRoute({
    method: 'get',
    path: '/',
    operationId: 'listUsers',
    tags: ['Users'],
    responses: {
      200: {
        description: 'Users returned',
        content: {
          'application/json': {
            schema: usersResponseSchema,
          },
        },
      },
    },
  }),
  handler: async (c) => {
    return c.json({ users: await listUsers() }, 200)
  },
})

export const userRoutes = [listUsersRoute] as const
```

```ts
// app.ts
const app = new OpenAPIHono()

app.openapiRoutes([...userRoutes, ...billingRoutes] as const)
app.doc('/doc', { openapi: '3.0.0', info: { title: 'API', version: '1.0.0' } })
app.get('/ui', swaggerUI({ url: '/doc' }))
```

RPC app이 수십 개 route를 넘어가면 작은 `OpenAPIHono` instance로 나누고 `.route()`로 mount합니다. `.openapi()` chain이 길어지면 link마다 schema type이 누적되어 하나의 큰 app이 `hc` type 검사를 느리게 만듭니다. Routing과 OpenAPI output은 그대로이고 누적되는 type 연산만 줄어듭니다.

```ts
const users = new OpenAPIHono().openapi(getUserRoute, getUserHandler)
const posts = new OpenAPIHono().openapi(getPostRoute, getPostHandler)

export const appRoutes = new OpenAPIHono().route('/', users).route('/', posts)
```

`get()`, `post()`, `use()`는 `OpenAPIHono`가 아니라 `Hono` 타입을 반환하므로, 이들을 섞은 chain은 `.openapi()`를 잃습니다. 결과를 `$()`로 감싸거나 `HonoToOpenAPIHono`로 타입을 변환합니다.

```ts
import { $, OpenAPIHono } from '@hono/zod-openapi'

const app = $(new OpenAPIHono().use(requestIdMiddleware))
app.openapi(route, handler)
```

`hono-openapi`에서는 route-local `describeRoute()` metadata와 단일 app-level `openAPIRouteHandler()` endpoint를 선호합니다.

## Version and Package Caveats

- `@hono/zod-openapi`의 일반 예시는 `app.doc()`와 OpenAPI 3.0을 보여주지만, 3.1 output이 필요하면 `app.doc31()` / `getOpenAPI31Document()` 지원 여부를 확인합니다. `getOpenAPI31Document()`는 두 번째 인자로 `unionPreferredType: 'oneOf'` 같은 generator option을 받습니다.
- `@hono/zod-openapi`는 Zod `^4.0.0`만 peer로 받습니다. Zod 3을 쓰는 저장소는 `hono-openapi`를 유지하거나 Zod를 먼저 올립니다. 두 validator는 Zod major를 공유하지 않습니다.
- `@hono/swagger-ui`는 spec을 생성하지 않고 UI를 제공합니다. `url`은 단일 spec, `urls`는 여러 spec에 사용합니다. 0.6.2는 page에 삽입하는 title과 string option을 escape합니다.
- `persistAuthorization`, `remoteAssets.baseUrl`, UI `version`, custom HTML은 deployment/UI knobs이며 spec contract knobs가 아닙니다.
- Plain `Hono` sub-app을 `OpenAPIHono` 아래에 섞으면 OpenAPI metadata가 spec에 합쳐지지 않을 수 있습니다.
- Nested OpenAPI sub-app을 mount할 때 parent `.route()` path parameter는 Hono `:param` syntax를 사용합니다.
- Header schema key는 Hono validator와 OpenAPI generator 모두에서 lowercase로 맞춥니다.
- `createRoute({ method: 'query' })`는 1.6.0부터 쓸 수 있습니다. Publish 전에 generated document 소비자가 QUERY operation을 받아들이는지 확인합니다.

## 리뷰 체크리스트

- 하나의 generator strategy를 일관되게 사용함
- Spec endpoint와 Swagger UI endpoint가 분리되어 있고 의도적임
- Route validators와 documented schemas가 source 또는 synchronization rule을 공유함
- JSON·form body가 media type을 선언하고, client가 trigger할 수 있는 곳에 415를 문서화함
- `body.required`가 handler의 가정과 일치함
- Plain `Hono`를 반환하는 middleware chain은 `.openapi()` 전에 `$()`나 `HonoToOpenAPIHono`로 감쌈
- Database row shape가 publication 전에 public DTO schema로 매핑됨
- Reusable schemas, errors, security schemes, parameters, examples가 `components`를 사용함
- Operation ID가 안정적이고 unique함
- Error responses가 중앙 error handling과 일치함
- RPC `AppType`/typed client shape와 generated OpenAPI shape가 충돌하지 않음
- 단일 chain이 type 검사를 느리게 만들면 큰 RPC surface를 mount한 `OpenAPIHono` instance로 나눔
- Publish 전에 CI 또는 local verification이 generated spec을 lint, bundle, validate함

## Sources

> Checked 2026-11-04.

| 주장 | 출처 |
|---|---|
| `@hono/zod-openapi` 1.6.3, `@hono/swagger-ui` 0.6.2, `hono-openapi` 1.5.0 version과 peer 범위 | [npm registry: `@hono/zod-openapi`](https://registry.npmjs.org/@hono/zod-openapi), [npm registry: `@hono/swagger-ui`](https://registry.npmjs.org/@hono/swagger-ui), [npm registry: hono-openapi](https://registry.npmjs.org/hono-openapi) |
| 선언되지 않은 media type의 415, `body.required` 기본값, `$()` / `HonoToOpenAPIHono`, `defineOpenAPIRoute` / `openapiRoutes`, mount instance type 성능, 3.1 generator option | [`@hono/zod-openapi` README](https://github.com/honojs/middleware/tree/main/packages/zod-openapi) |
| `createRoute()`의 QUERY 지원, 1.6.3의 415 수정, 1.6.1·1.6.2의 type 비용 감소 | [`@hono/zod-openapi` releases](https://github.com/honojs/middleware/releases) |
| `hono-openapi` 400 자동 포함과 header `resolver()` 지원 | [`hono-openapi` releases](https://github.com/rhinobase/hono-openapi/releases) |
| 0.6.2의 Swagger UI escaping | [`@hono/swagger-ui` releases](https://github.com/honojs/middleware/releases) |
rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit.Stars: 469kUpdated Claude CodeCodexVerifiedInstall
rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure.Stars: 469kUpdated Claude CodeCodexVerifiedInstall
rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics.Stars: 469kUpdated Claude CodeCodexVerifiedInstall
ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first.Stars: 194kUpdated Claude CodeCodexVerifiedInstall