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/nextjs/server-actions.ko.md

View on GitHub
# Server Actions

> `use server` 기반 mutation, validation, dispatch 순서, freshness, security 규칙입니다.

---

## Core Rule

모든 Server Action을 reachable POST entry point처럼 취급합니다.

App Router에서 앱 UI에서 시작된 mutation의 기본 surface는 Server Actions입니다.

즉:

- 입력 검증
- 호출자 인증
- resource access 권한 확인
- UI에 필요한 최소 반환값만 제공
- 영향을 받은 데이터를 의도적으로 refresh 또는 revalidate

page-level UI gating만 신뢰하지 않습니다.

## Placement

- 재사용 가능한 actions, 특히 Client Components로 import되는 actions는 top-level `'use server'` 전용 파일을 사용합니다.
- 특정 route에 강하게 묶여 있고 closure가 의도적이면 Server Component 내부 inline action도 허용됩니다.
- 반복되는 DB/auth logic은 server-only DAL 또는 helper로 이동합니다.
- internal app UI에서 시작된 쓰기이고 HTTP-native contract가 필요 없다면 `route.ts`보다 Server Action을 우선합니다.

## Sequential Dispatch

Next.js는 client마다 Server Action을 한 번에 하나씩 dispatch합니다. 두 번째 action은 첫 번째가 끝나기를 기다리고 세 번째는 두 번째를 기다립니다. 재렌더된 server tree가 그 결과를 낳은 action 결과와 일치하게 유지하기 위해서입니다.

- client에서 `Promise.all`로 Server Actions를 병렬 실행하려 하지 않습니다. client가 어차피 줄을 세웁니다.
- 독립적인 작업을 겹쳐야 하면 하나의 Server Action 안에서 처리하거나, Server Component에서 병렬 fetch하거나, mutation이 아닌 요청에 Route Handler를 씁니다.
- 이것은 client dispatcher의 성질입니다. server는 action을 대기열에 넣지 않고 도착하는 대로 각각의 요청에서 실행합니다.

## Single-Response Data and UI

즉시 재검증을 일으키는 action은 mutation과 재렌더를 한 HTTP 요청 안에서 끝냅니다. 응답에는 action의 반환값과 현재 route의 새 RSC payload가 함께 담깁니다.

action이 다음을 하면 같은 응답에 재렌더가 포함됩니다:

- `updateTag` 또는 `revalidatePath` 호출
- `refresh` 호출
- `cookies()`를 통한 cookie 변경
- `redirect` 호출

stale-while-revalidate 프로필의 `revalidateTag`는 예외입니다. tag를 background refresh 대상으로 표시할 뿐 재렌더를 포함하지 않으므로 페이지는 이후 읽기에서 변경을 반영합니다. 위 어느 것도 하지 않는 action은 반환값만 담습니다.

## Forms and Client Calls

- Forms는 `action` attribute로 Server Actions를 호출하고 `FormData`를 받을 수 있습니다.
- authoritative checks에는 server-side validation을 사용합니다. client validation은 UX 보조일 뿐입니다.
- UI에 필요할 때만 좁은 Client Component wrapper에서 `useActionState`, pending state, optimistic updates, transitions를 사용합니다.
- dispatch가 client마다 순차이므로 여러 단계 UI는 호출을 경쟁시키지 말고 명시적 순서나 하나의 복합 action으로 설계합니다.

## Freshness APIs

- read-your-own-writes cache expiration에는 Server Actions 안에서 `updateTag`를 사용합니다. Server Action 전용입니다.
- stale-while-revalidate 동작이 허용되면 `revalidateTag(tag, 'max')`를 사용합니다. Route Handlers에서는 동작하지만 Client Components와 Proxy에서는 안 됩니다.
- path-based invalidation에는 `revalidatePath`를 사용합니다.
- tag invalidation 없이 current client router를 refresh해야 하면 Server Action 안에서 `next/cache`의 `refresh`를 사용합니다. Server Action 전용입니다.
- 필요한 invalidation은 `redirect()` 전에 호출합니다.

## Hard Rules

| 확인 | 규칙 |
|---|---|
| Action이 `FormData`, params, headers, search params를 직접 신뢰 | 차단 |
| Action이 page-level auth redirect/gating에만 의존 | 차단 |
| Action이 raw DB records 또는 internal objects 반환 | 차단 |
| Action이 form/event/transition path가 아니라 render 중 mutation | 차단 |
| Action이 반복 domain authorization logic을 매번 inline 수행 | 경고. DAL로 이동 |
| 필요한 `updateTag`, `revalidatePath`, `revalidateTag` 전에 `redirect()` 사용 | 차단 |
| client code가 `Promise.all`로 Server Actions를 병렬화하고 동시 실행을 기대 | 차단 |
| `revalidateTag(tag, 'max')`가 응답에서 현재 route를 다시 렌더링한다고 가정 | 차단 |
| Server Action 밖에서 `updateTag` 또는 `refresh` 호출 | 차단 |

## DAL Guidance

권장 분리:

- Action: input edge, auth re-check, mutation orchestration, freshness, redirect
- DAL/server-only module: DB access, authorization logic, DTO shaping, sensitive business rules/nextjs

## Security Notes

- auth는 action에 넘겨진 trusted client token이 아니라 cookies 또는 headers에서 읽습니다.
- Server Action return values는 client로 serialize되어 돌아가므로 최소화합니다.
- client 입력은 참조와 변경 내용으로 좁힙니다. schema validation은 형태를 볼 뿐 소유권을 보지 않으므로 세션 기준으로 row를 다시 읽습니다.
- 비용이 큰 actions에는 rate limiting과 abuse controls를 고려합니다.
- Next.js는 `Origin`과 `Host` 또는 `X-Forwarded-Host` 비교, 기본 1MB body 제한, 암호화된 action ID, closure 변수 암호화를 적용합니다.
- proxy나 CDN host에는 `experimental.serverActions.allowedOrigins`를 설정합니다. `*`는 한 라벨, `**`는 한 개 이상 라벨과 맞고 포트는 그대로 적어야 합니다.

## Deployment

- action ID는 source가 그대로여도 최대 14일마다 회전합니다. 이전 build의 client는 더 이상 없는 ID를 호출해 "Failed to find Server Action"을 볼 수 있습니다.
- 인스턴스 사이에서 `NEXT_SERVER_ACTIONS_ENCRYPTION_KEY`를 고정해 action 참조가 어디서나 복호화되게 합니다.
- 사용자가 mutation 중일 수 있으면 급격한 전환보다 rolling deployment를 쓰고, 실패는 단단한 오류가 아니라 재시도 경로로 노출합니다.

## Review Checklist

- input validation 존재
- auth/authz가 action 내부 또는 delegated server-only layer에서 재확인됨
- return values 최소화
- client 호출부가 병렬 dispatch를 가정하지 않음
- 필요할 때 redirect 전 freshness 수행
- 같은 응답 재렌더를 기대하는지에 맞게 freshness 방식을 골랐음
- multi-instance 또는 proxy 배포에서 암호화 키와 origin 설정이 의도적임
- 반복 domain logic이 여러 actions에 중복되지 않음

## Sources

> 확인 2026-11-04. `https://nextjs.org/docs/app/guides/server-actions`, `https://nextjs.org/docs/app/api-reference/config/next-config-js/serverActions`, `https://nextjs.org/docs/app/api-reference/functions/updateTag`, `https://nextjs.org/docs/app/api-reference/functions/revalidateTag`, `https://nextjs.org/docs/app/api-reference/functions/refresh`, `https://nextjs.org/docs/app/guides/data-security`를 확인했습니다. 날짜가 붙은 스냅숏은 `references/official/nextjs/current-docs-2026-11-04.md`입니다.
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: 470kUpdated 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: 470kUpdated Claude CodeCodexVerifiedInstall
rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics.Stars: 470kUpdated 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