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/astro/rendering-and-islands.md

View on GitHub
# Rendering and Islands

> Astro is static by default; make a route on demand only when it needs request data, and ship framework JavaScript only where a `client:*` directive and a reason exist.

Rules here are labelled `official` when an opened page in the dated snapshot states them, and `hypercore-default` when this package chose the default.

## 1. The rendering model

`official` — `output` accepts only `'static'` or `'server'`, and `'static'` is the default. `'server'` "does not bring any additional functionality. It only switches the default rendering behavior." (L-17, L-09)

| Setting | Meaning |
|---|---|
| `output: 'static'` (default) | Every route renders at build time unless it opts out |
| `output: 'server'` | Every route renders on demand unless it opts in |
| `export const prerender = false` | This route renders on demand, under `'static'` |
| `export const prerender = true` | This route renders at build time, under `'server'` |

Rules:

- `official` — `prerender` must be statically analyzable. A value computed at runtime is not supported.
- `official` — Any on-demand route needs an adapter. So do `server:defer` server islands and live collections.
- `official` — Static sites can opt individual routes into server rendering since 5.0 removed `output: 'hybrid'`; `'static'` absorbed that behavior (L-03).
- `hypercore-default` — Start from `'static'` and add `prerender = false` to the routes that need it. Switch the site to `'server'` only when most routes are dynamic, and say so in the change description.

## 2. Adapters

`official` — The official adapters are Node, Netlify, Vercel, and Cloudflare (L-09, L-54).

```js
import node from '@astrojs/node';

export default defineConfig({
  adapter: node({ mode: 'standalone' }),
});
```

- `official` — `@astrojs/node` takes `mode: 'standalone' | 'middleware'`, plus `staticHeaders`, `bodySizeLimit`, and `experimentalDisableStreaming`.
- `official` — HTML streams by default on on-demand routes.
- `official` — Response headers can only be modified at page level (`Astro.response.headers`, `Astro.redirect`); a child component cannot set them.
- `hypercore-default` — Detect the adapter before recommending any server feature, and name the adapter in the report. A recommendation that assumes an adapter the project does not have is wrong.

## 3. Server islands

`official` — `<Component server:defer />` splits a component into its own `/_server_islands/...` route, fetched by an injected script (L-18).

```astro
---
import Avatar from '../components/avatar.astro';
---

<Avatar server:defer>
  <p slot="fallback">Loading…</p>
</Avatar>
```

Rules:

- `official` — Props must be serializable. Functions and circular references cannot cross the boundary.
- `official` — Props travel as an encrypted query string and fall back to POST above roughly 2048 bytes, which breaks caching.
- `official` — Props are encrypted with a per-build key. Use `astro create-key` and `ASTRO_KEY` for rolling or multi-region deployments.
- `official` — `slot="fallback"` supplies the placeholder markup rendered into the static page.
- `hypercore-default` — Prefer a server island over converting a whole page to on-demand rendering when only one fragment needs cookies or personalization.

## 4. Client islands

`official` — Framework components render to static HTML by default; a `client:*` directive hydrates them (L-19, L-58).

| Directive | When the component hydrates | Use for |
|---|---|---|
| `client:load` | Immediately on page load | Interaction needed on first paint |
| `client:idle` | When the browser is idle | Secondary controls below the fold |
| `client:visible` | When the component enters the viewport | Content far down the page |
| `client:media={QUERY}` | When a media query matches | Mobile-only or desktop-only widgets |
| `client:only={FRAMEWORK}` | Client only, never server-rendered | Components that cannot render on the server |

Rules:

- `official` — Only `client:only` skips server rendering, and it requires the framework name.
- `official` — Props passed to a hydrated component have the same serializability limits as server islands; functions cannot cross.
- `official` — Only `.astro` files can mix frameworks. A React component cannot render a Svelte component.
- `hypercore-default` — Use the narrowest directive that satisfies the interaction. `client:visible` or `client:idle` for below-the-fold islands; `client:load` only when first paint needs the interaction; `client:only` only when the component genuinely cannot render on the server.
- `hypercore-default` — Every added directive needs a stated reason in the change. An island directive is a performance decision, not a default.

## 5. Framework integrations

`official` — Framework support arrives through integrations: `@astrojs/react`, `@astrojs/preact`, `@astrojs/svelte`, `@astrojs/vue`, `@astrojs/solid-js`, and `@astrojs/alpinejs` (L-19).

- `official` — Install the integration and the framework's own package; the integration does not bundle the framework runtime.
- `hypercore-default` — Prefer `.astro` components for static markup. Add a framework integration only where its component model earns the runtime.
- `hypercore-default` — When a project has several framework integrations, check whether one would do before adding another. Each adds its own hydration runtime.

## 6. Client-side scripts

`official` — An Astro `<script>` is bundled, TypeScript-compiled, deduplicated per page, given `type="module"`, and inlined when small (L-29, L-58).

| Attribute | Effect |
|---|---|
| default | Bundled, deduplicated, processed |
| `is:inline` | Left as written, not bundled |
| `define:vars` | Implies `is:inline`, so the script is not bundled and runs per instance |

Rules:

- `official` — `define:vars` implies `is:inline`; do not expect bundling or deduplication from it.
- `hypercore-default` — Prefer a bundled `<script>` over `is:inline` unless the script must run before the bundle loads or needs no processing.

## 7. What not to do

- Do not add Actions, sessions, server islands, live collections, or route caching to a project with no adapter.
- Do not switch the whole site to `output: 'server'` to make one route dynamic.
- Do not set response headers inside a child component.
- Do not pass a function, a class instance, or a circular structure to a hydrated or server island.
- Do not expect `client:*` to render the component on the server; only the absence of the directive does that.

## Checklist

- [ ] `output` and the adapter are recorded, and every touched route has an explicit `prerender` decision.
- [ ] `prerender` values are statically analyzable.
- [ ] Any on-demand route, server island, or live collection has an adapter behind it.
- [ ] Each `client:*` directive is the narrowest one that satisfies the interaction, with a stated reason.
- [ ] No non-serializable prop crosses a hydration or server-island boundary.
- [ ] Server island props stay small enough to avoid the POST fallback where caching matters.
- [ ] Response headers are set at page level.
- [ ] Framework components only mix inside `.astro` files.

## Sources

> Checked 2026-11-07. Facts come from the Astro research lane, which opened these pages on 2026-11-07; lane source ids are kept in parentheses.

| Claim | Source |
|---|---|
| `output` accepts only `'static'` and `'server'`; `'server'` only switches the default (L-17, L-09) | https://docs.astro.build/en/reference/configuration-reference/ |
| `prerender` opt-in and opt-out must be statically analyzable (L-09, L-07) | https://docs.astro.build/en/guides/on-demand-rendering/ |
| `output: 'hybrid'` removed in 5.0 and `'static'` absorbed it (L-03) | https://docs.astro.build/en/guides/upgrade-to/v5/ |
| Adapter requirement for on-demand routes, server islands, and live collections (L-09, L-18, L-10) | https://docs.astro.build/en/guides/on-demand-rendering/ |
| Official adapters and the Node adapter's options (L-09, L-54) | https://docs.astro.build/en/guides/integrations-guide/node/ |
| HTML streaming default and page-level-only response headers (L-09) | https://docs.astro.build/en/guides/on-demand-rendering/ |
| Server islands, `server:defer`, fallback slot, encrypted props, 2048-byte POST fallback (L-18) | https://docs.astro.build/en/guides/server-islands/ |
| Server island prop encryption key and `astro create-key` (L-18, L-28) | https://docs.astro.build/en/reference/cli-reference/ |
| `client:*` directives, static-by-default rendering, serializable props, `.astro`-only mixing (L-19, L-58) | https://docs.astro.build/en/reference/directives-reference/ |
| Framework integrations and their packages (L-19) | https://docs.astro.build/en/guides/framework-components/ |
| Bundled scripts, `is:inline`, `define:vars` implying inline (L-29, L-58) | https://docs.astro.build/en/guides/client-side-scripts/ |
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