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.
references/official/astro/astro-2026-11-07.ko.md
View on GitHub# Astro 공식 근거 스냅숏 — 2026-11-07
설치된 Astro 버전, 설정 키, 호환성 파괴 변경, 런타임 하한이 변경을 좌우할 때 읽습니다. 이 스냅숏은 이 패키지가 의존하는 공식 주장과 각 항목을 확인한 날짜를 기록합니다.
- last_verified_at: 2026-11-07
- `status`: `docs.astro.build`의 가이드와 레퍼런스 페이지, Astro 7.0·6.0 릴리스 포스트, `astro`와 `@astrojs/*` npm 레지스트리 기록, Astro CHANGELOG, `astro check` CLI 소스로 확인
- `baseline`: `astro` 7.4.7(2026-11-05 배포), Node `>=22.23.4`, Vite `^8.3.5`, `@astrojs/node` 11.1.11, `@astrojs/vercel` 11.0.20, `@astrojs/cloudflare` 14.4.6, `@astrojs/netlify` 8.2.12, `@astrojs/react` 7.1.4, `@astrojs/mdx` 8.1.3, `@astrojs/check` 0.9.12, `prettier-plugin-astro` 1.1.2
- `refresh_when`: 설치된 `astro`가 7.4.x와 크게 다르거나, 어댑터·Node 하한·Markdown 처리기·렌더링 모델이 바뀔 때
- `authority`: 근거일 뿐입니다. 사용자와 프로젝트 지시, 설치된 프로젝트 자체의 동작이 여전히 권위를 갖습니다.
## Contents
- Versions and release model
- Node and toolchain floors
- Breaking changes v5 → v6 → v7
- Config keys used by this package
- Rendering and routing facts
- Content, Actions, and environment facts
- Tooling facts
- Unverified items
- Sources
## Versions and release model
2026-11-07에 npm 레지스트리 메타데이터와 아래 인용한 릴리스 노트로 확인했습니다. 자동 업그레이드 대상이 아니라 근거 스냅숏입니다.
| Package | Stable | 확인된 호환성 |
|---|---:|---|
| `astro` | 7.4.7 | Node `>=22.23.4`, npm `>=9.6.5`, pnpm `>=7.1.0`, `vite ^8.3.5` 의존 |
| `@astrojs/node` | 11.1.11 | peer `astro ^7.2.1` |
| `@astrojs/vercel` | 11.0.20 | peer `astro ^7.0.0` |
| `@astrojs/cloudflare` | 14.4.6 | peer `astro ^7.4.0`, `wrangler ^4.125.0` |
| `@astrojs/netlify` | 8.2.12 | peer `astro ^7.0.0` |
| `@astrojs/react` | 7.1.4 | peer `react ^17.0.2 \|\| ^18 \|\| ^19`, `oxc-transform-react ^0.145.0` |
| `@astrojs/mdx` | 8.1.3 | peer `astro ^7.2.10`, `@astrojs/markdown-remark ^7.3.0` |
| `@astrojs/check` | 0.9.12 | peer `typescript ^5.0.0 \|\| ^6.0.0` |
| `prettier-plugin-astro` | 1.1.2 | peer `prettier ^3.5.3`, `@astrojs/compiler-rs` 의존 |
릴리스 계보:
| 버전 | 날짜 | 메모 |
|---|---|---|
| 7.0.0 | 2026-06-22 | Rust 컴파일러가 유일한 `.astro` 컴파일러가 되고 Sätteri가 기본 Markdown 처리기가 됨 |
| 7.2.0 | 2026-08 | `session: false`, `experimental.incrementalBuild` |
| 7.4.0 | 2026-10-15 | 7.4 마이너 계보 시작 |
| 7.4.5 | 2026-11 | 2026년 10월 Node 보안 릴리스를 반영해 Node 하한을 22.23.4로 올림 |
| 7.4.7 | 2026-11-05 | 확인 시점의 최신 안정 패치 |
| 6.0.0 | 2026-03-10 | Node 22 최소, Vite 7, Zod 4, 레거시 콘텐츠 컬렉션 제거 |
- `astro` 7.4.7은 선택 의존성 `sharp ^0.35.4`와 선택 peer `@astrojs/markdown-remark ^7.3.0`을 나열합니다. 후자는 unified Markdown 파이프라인에만 필요합니다.
- Node 지원 정책은 최신 Maintenance LTS와 현재 Active LTS입니다. Maintenance LTS의 최소 패치를 마이너 릴리스에서 올릴 수 있고, 보안 수정은 패치에 들어갈 수 있습니다(L-39).
## Node and toolchain floors
- Node `>=22.23.4`. 설치 페이지는 v23 같은 홀수 버전을 지원하지 않는다고 덧붙입니다(L-04).
- Node 18과 20 지원은 6.0에서 제거됐고, 당시 최소값은 22.12.0이었습니다(L-02).
- Rolldown 번들러를 쓰는 Vite 8이 7.0에서 Vite 7을 대체했습니다(L-01, L-41, L-49).
- TypeScript는 Astro가 직접 고정하지 않지만, `astro check`는 `@astrojs/check`와 TypeScript `^5 || ^6`을 요구하고 7.0을 거부합니다(L-51, L-52).
## Breaking changes v5 → v6 → v7
### 5.0
- `output: 'hybrid'`가 제거되고 `'static'`이 hybrid 동작을 흡수해, 정적 사이트도 개별 라우트를 서버 렌더링으로 선택할 수 있게 됐습니다(L-03).
### 6.0
- Node 22 최소, Vite 7, Shiki 4, Vite Environment API 재편(L-02).
- Zod 4: `z.string().email()`이 `z.email()`이 되고, `{ message }`가 `{ error }`가 되며, 기본값이 출력 타입과 맞아야 하고, `.prefault()`가 파싱된 기본값을 제공합니다(L-02).
- 레거시 콘텐츠 컬렉션이 제거되어 콘텐츠 계층이 필수가 됐습니다. `src/content/config.ts`는 더 이상 유효한 위치가 아닙니다.
- `<ViewTransitions />`, `Astro.glob()`, `astro:schema`, `astro:content`의 `z` 재export가 제거됐습니다.
- `getStaticPaths()` 안의 `Astro`가 폐기됐습니다. `Astro.site` 대신 `import.meta.env.SITE`를 씁니다.
### 7.0
- Rust `.astro` 컴파일러가 기본이자 유일한 컴파일러입니다. 닫히지 않은 태그는 오류가 되고 잘못된 HTML 중첩은 더 이상 자동 교정되지 않습니다(L-01, L-41).
- 기본 `compressHTML`이 `true`에서 `'jsx'`로 바뀌어 인라인 요소 사이 공백이 JSX 방식으로 제거됩니다. `compressHTML: true`나 명시적 `{" "}`로 되돌립니다.
- Sätteri(네이티브)가 기본 Markdown 처리기이고 `@astrojs/markdown-remark`는 더 이상 기본 설치되지 않습니다. remark와 rehype 플러그인을 유지하려면 `markdown.processor: unified()`를 설정하고 `@astrojs/markdown-remark`를 설치합니다.
- 실험 플래그 `logger`, `queuedRendering`, `rustCompiler`, `advancedRouting`, `cache`/`routeRules`가 안정화되어 최상위로 이동했습니다. `experimental` 안에 남겨 두면 유효하지 않습니다.
- `src/fetch.ts`가 고급 라우팅용 예약 파일 이름이 됐습니다. `fetchFile`이 이름을 바꾸거나 비활성화합니다(L-01, L-06, L-17).
- `@astrojs/db`가 제거됐습니다. `node:sqlite`, Drizzle, 플랫폼 데이터베이스를 씁니다.
- `astro:transitions` 내부가 제거됐습니다. `TRANSITION_*` 상수, `isTransitionBefore*Event`, `createAnimationScope`입니다.
- `getContainerRenderer()`가 통합 패키지 루트에서 `@astrojs/react/container-renderer`로 이동했습니다(preact, solid-js, svelte, vue, mdx도 같습니다).
## Config keys used by this package
| 키 | 허용 값 | 메모 |
|---|---|---|
| `site` | 절대 URL | `import.meta.env.SITE`와 canonical에 쓰임 |
| `output` | `'static'` \| `'server'` | 기본은 `'static'`이고 `'server'`는 기본 렌더링 동작만 바꿈 |
| `trailingSlash` | `'always'` \| `'never'` \| `'ignore'` | 확장자 URL 라우팅 매칭에 영향 |
| `adapter` | 어댑터 인스턴스 | 온디맨드 라우트, 서버 아일랜드, 라이브 컬렉션에 필요 |
| `integrations` | 배열 | 프레임워크와 기능 통합 |
| `prefetch` | 불리언 또는 객체 | `prefetchAll`, `defaultStrategy` |
| `build.format` | `'file'` \| `'directory'` | 출력 형태 |
| `build.inlineStylesheets` | `'always'` \| `'auto'` \| `'never'` | `'auto'`는 Vite의 4kB `assetsInlineLimit` 아래를 인라인 |
| `build.concurrency` | 숫자, 기본 1 | 문서가 기본값 변경을 경고 |
| `image.layout` | `'constrained'` \| `'full-width'` \| `'fixed'` \| `'none'` | 반응형 이미지 기본값 |
| `image.responsiveStyles` | 불리언 | 반응형 스타일 규칙 출력 |
| `image.breakpoints` | 문자열 배열 | 생성 브레이크포인트 덮어쓰기 |
| `image.domains` | 문자열 배열 | 원격 이미지 허용 목록 |
| `image.remotePatterns` | 패턴 배열 | 원격 이미지 패턴 허용 목록 |
| `image.service` | 객체 | 기본은 `astro/assets/services/sharp`이고 7.4는 `build`와 `runtime` 서비스를 분리 허용 |
| `fonts` | 배열 | `provider`, `name`, `cssVariable`, `weights`, `styles`, `subsets`, `fallbacks`, `formats` |
| `env.schema` | `envField` 레코드 | `context`, `access`, `optional`, `default` |
| `env.validateSecrets` | 불리언 | dev와 빌드 시작 시점에 비밀 값 검증 |
| `security.checkOrigin` | 불리언, 기본 `true` | 안전하지 않은 메서드의 CSRF 방어 |
| `security.allowedDomains` | 패턴 배열 | `X-Forwarded-Host` 검증 |
| `security.csp` | 불리언 또는 객체, 기본 `false` | 해시를 담은 페이지별 CSP meta |
| `security.actionBodySizeLimit` | 바이트, 기본 1MB | Action 요청 상한 |
| `security.serverIslandBodySizeLimit` | 바이트, 기본 1MB | 서버 아일랜드 요청 상한 |
| `cache` | `{ provider }` | `Astro.cache`가 동작하려면 필요 |
| `routeRules` | 라우트 패턴에서 캐시 옵션으로 가는 레코드 | 선언적 캐시 기본값 |
| `redirects` | 경로에서 대상이나 객체로 가는 레코드 | 정적 빌드는 meta refresh를 출력 |
| `fetchFile` | `null` \| 문자열 | `src/fetch.ts`의 이름 변경이나 비활성화 |
| `markdown.processor` | `unified()` | 7.x에서 remark/rehype 파이프라인 복원 |
| `compressHTML` | 불리언 \| `'jsx'` | 7.0부터 기본 `'jsx'` |
## Rendering and routing facts
- `output`은 `'static'` 또는 `'server'`뿐이고, `'server'`는 "does not bring any additional functionality. It only switches the default rendering behavior."입니다(L-17, L-09).
- 라우트별 `export const prerender = false`(정적 모드) 또는 `= true`(서버 모드)는 정적으로 분석 가능해야 합니다.
- 온디맨드 라우트에는 어댑터가 필요하고, `server:defer` 서버 아일랜드와 라이브 컬렉션도 마찬가지입니다.
- 온디맨드 라우트의 HTML은 기본적으로 스트리밍되며 응답 헤더는 페이지 수준에서만 수정할 수 있습니다.
- 파일 기반 라우팅은 `.astro`, `.md`, `.mdx` 페이지와 `.js`/`.ts` 엔드포인트를 포함합니다. `[param]`은 한 세그먼트, `[...rest]`는 나머지 경로를 매칭합니다(L-06, L-05).
- 라우트 우선순위: 예약 라우트, 세그먼트가 많은 쪽, 정적 우선 동적, 명명 파라미터 우선 rest, 프리렌더 동적 우선 온디맨드 동적, 엔드포인트 우선 페이지, 파일 라우트 우선 리다이렉트.
- 예약 라우트 접두사: `_astro/`, `_server_islands/`, `_actions/`.
- `src/pages/404.astro`는 `404.html`을 만들고, `src/pages/500.astro`는 온디맨드 전용이며 `error` prop을 받습니다(L-37).
- `Astro.rewrite()`는 브라우저 URL을 유지하고 미들웨어를 포함한 전체 렌더 단계를 다시 돕니다.
- 기본 `src/fetch.ts` 파이프라인 순서는 트레일링 슬래시 정규화, 리다이렉트, 세션, 액션, 사용자 미들웨어, 페이지 렌더링, i18n, 캐싱입니다.
## Content, Actions, and environment facts
- `src/content.config.ts`가 `collections`를 export하고, 각 항목은 필수 `loader`(`glob()` 또는 `file()`)와 선택적 Zod `schema`를 가집니다. `z`는 `astro/zod`에서 옵니다(L-10).
- `deferRender: true`(7.1)는 빌드 메모리를 줄이려고 Markdown 렌더링을 미룹니다.
- `getCollection()` 순서는 비결정적이므로 명시적으로 정렬합니다.
- 라이브 컬렉션은 `src/live.config.ts`, `defineLiveCollection()`, 커스텀 로더, 어댑터를 씁니다.
- Actions는 `src/actions/index.ts`에 있고 `/_actions/<name>`으로 공개되며 서버 출력을 요구합니다(L-11, L-12, L-57).
- 미들웨어는 명명된 `onRequest`를 export하고 `sequence()`로 조합하며 타입이 붙은 `context.locals`로 상태를 공유합니다(L-13).
- 세션(5.7+)에는 드라이버가 필요합니다. Node, Cloudflare, Netlify 어댑터는 기본 드라이버를 제공하고 Vercel은 제공하지 않습니다. `session: false`(7.2+)는 세션을 제거합니다(L-14, L-50).
- `env.schema`는 `envField.string|number|boolean|enum`을 쓰고, 클라이언트 문맥의 비밀 값은 설계상 불가능합니다(L-15).
- `security.checkOrigin`은 기본값이 `true`이고 안전하지 않은 메서드에 대해 `Sec-Fetch-Site`를 `Origin` 대체와 함께 확인합니다(L-17).
## Tooling facts
- `astro dev`와 `astro build`는 타입 검사를 하지 않고 `astro check`가 하며 오류 시 종료 코드 1을 냅니다(L-26, L-28).
- `astro check`는 `@astrojs/check`와 `typescript`가 필요하고 TypeScript 7.0을 폐기 예고와 함께 거부합니다(L-51).
- `astro sync`는 `astro:content`, `astro:env`, `astro:actions`용 `.astro/types.d.ts`를 생성합니다.
- Prettier는 `prettier-plugin-astro`와 `*.astro` parser override로 `.astro`를 포맷합니다(L-40).
- Oxlint는 `.astro` 파일의 `<script>` 블록만 lint하고 템플릿 lint가 없습니다(L-43, L-44).
- Oxfmt는 Prettier 기반 경로로 `.astro`에 도달하며 `@astrojs/compiler-rs`와 `astro` 옵션이 필요합니다(L-45, L-46).
- Vitest 통합은 `astro/config`의 `getViteConfig()`를 쓰고, 컴포넌트 테스트는 `experimental_AstroContainer`를 씁니다(L-25, L-27).
## Unverified items
작성 시점에 공식 페이지나 패키지 타입으로 확인되지 않은 항목입니다. 미확인으로 표시하거나 빼야 하며, 규칙으로 단정하지 않습니다.
- 라이브 로더 캐시 힌트에 쓰는 `Astro.cache.set(entry)`의 정확한 타입 형태. 7.0 포스트는 그 형태를 보여 주지만 캐싱 가이드는 명시적 옵션 객체만 문서화합니다.
- `security.csp`가 어떤 어댑터에서든 실제 HTTP 헤더를 낼 수 있는지. 문서화된 것은 `<meta>` 방식뿐입니다.
- 라이브 로더 API의 전체 시그니처(`loadCollection`/`loadEntry` 반환 타입과 오류 봉투). 산문만 있습니다.
- `compressHTML: 'jsx'`가 `.mdx` 출력의 공백을 `.astro`와 다르게 바꾸는지.
- `@astrojs/ts-content-mapper`의 성숙도. 0.2.0 실험이고 `astro check` 폐기는 버전 없이 예고됐습니다.
- `image.layout`이 `public/` 파일에 적용되는지. 문서는 그 이미지가 절대 최적화되지 않는다고 하지만 설정 상호작용은 밝히지 않습니다.
- `astro check`가 폐기 예고 뒤에도 타입 게이트로 남는다는 주장.
## Sources
> Checked 2026-11-07. 아래 모든 페이지, 릴리스 포스트, 레지스트리 기록, 소스 파일은 이 스냅숏을 위해 2026-11-07에 읽었습니다.
- <https://docs.astro.build/en/guides/upgrade-to/v7/>
- <https://docs.astro.build/en/guides/upgrade-to/v6/>
- <https://docs.astro.build/en/guides/upgrade-to/v5/>
- <https://docs.astro.build/en/install-and-setup/>
- <https://docs.astro.build/en/basics/project-structure/>
- <https://docs.astro.build/en/basics/astro-pages/>
- <https://docs.astro.build/en/guides/routing/>
- <https://docs.astro.build/en/reference/routing-reference/>
- <https://docs.astro.build/en/guides/endpoints/>
- <https://docs.astro.build/en/guides/on-demand-rendering/>
- <https://docs.astro.build/en/guides/content-collections/>
- <https://docs.astro.build/en/reference/modules/astro-content/>
- <https://docs.astro.build/en/guides/actions/>
- <https://docs.astro.build/en/reference/modules/astro-actions/>
- <https://docs.astro.build/en/reference/errors/actions-without-server-output-error/>
- <https://docs.astro.build/en/guides/middleware/>
- <https://docs.astro.build/en/guides/sessions/>
- <https://docs.astro.build/en/guides/environment-variables/>
- <https://docs.astro.build/en/reference/modules/astro-env/>
- <https://docs.astro.build/en/reference/configuration-reference/>
- <https://docs.astro.build/en/guides/server-islands/>
- <https://docs.astro.build/en/guides/framework-components/>
- <https://docs.astro.build/en/reference/directives-reference/>
- <https://docs.astro.build/en/guides/images/>
- <https://docs.astro.build/en/reference/modules/astro-assets/>
- <https://docs.astro.build/en/guides/styling/>
- <https://docs.astro.build/en/guides/prefetch/>
- <https://docs.astro.build/en/guides/view-transitions/>
- <https://docs.astro.build/en/guides/fonts/>
- <https://docs.astro.build/en/guides/testing/>
- <https://docs.astro.build/en/guides/typescript/>
- <https://docs.astro.build/en/reference/container-reference/>
- <https://docs.astro.build/en/reference/cli-reference/>
- <https://docs.astro.build/en/guides/client-side-scripts/>
- <https://docs.astro.build/en/guides/caching/>
- <https://docs.astro.build/en/reference/cache-provider-reference/>
- <https://docs.astro.build/en/reference/modules/astro-fetch/>
- <https://docs.astro.build/en/reference/modules/astro-hono/>
- <https://docs.astro.build/en/reference/experimental-flags/parallel-prerender/>
- <https://docs.astro.build/en/reference/experimental-flags/incremental-build/>
- <https://docs.astro.build/en/reference/experimental-flags/client-prerender/>
- <https://docs.astro.build/en/guides/integrations-guide/node/>
- <https://docs.astro.build/en/guides/integrations-guide/vercel/>
- <https://docs.astro.build/en/guides/integrations-guide/cloudflare/>
- <https://docs.astro.build/en/guides/integrations-guide/netlify/>
- <https://docs.astro.build/en/editor-setup/>
- <https://docs.astro.build/en/upgrade-astro/>
- <https://astro.build/blog/astro-7/>
- <https://astro.build/blog/astro-6/>
- <https://registry.npmjs.org/astro>
- <https://registry.npmjs.org/@astrojs/node>
- <https://registry.npmjs.org/@astrojs/vercel>
- <https://registry.npmjs.org/@astrojs/cloudflare>
- <https://registry.npmjs.org/@astrojs/netlify>
- <https://registry.npmjs.org/@astrojs/react>
- <https://registry.npmjs.org/@astrojs/mdx>
- <https://registry.npmjs.org/@astrojs/check>
- <https://registry.npmjs.org/prettier-plugin-astro>
- <https://raw.githubusercontent.com/withastro/astro/main/packages/astro/CHANGELOG.md>
- <https://raw.githubusercontent.com/withastro/astro/main/packages/astro/src/cli/check/index.ts>
- <https://raw.githubusercontent.com/withastro/astro/main/packages/language-tools/ts-content-mapper/README.md>
- <https://oxc.rs/docs/guide/usage/linter/config-file-reference.html>
- <https://oxc.rs/compatibility.html>
- <https://oxc.rs/docs/guide/usage/formatter/language-support>
- <https://oxc.rs/docs/guide/usage/formatter/config-file-reference>
| Claim | Source |
|---|---|
| 스냅숏 표의 패키지 버전, 엔진 범위, peer 범위, 의존성 고정 | 위에 나열한 `registry.npmjs.org` 기록 |
| 릴리스 계보 날짜와 7.4.5의 Node 하한 상향 | `https://raw.githubusercontent.com/withastro/astro/main/packages/astro/CHANGELOG.md`와 `https://astro.build/blog/astro-7/` |
| 5.0, 6.0, 7.0의 호환성 파괴 변경 | 위에 나열한 업그레이드 가이드 세 개와 릴리스 포스트 두 개 |
| 설정 키와 허용 값 | `https://docs.astro.build/en/reference/configuration-reference/` |
| 렌더링, 라우팅, 콘텐츠, Actions, 미들웨어, 세션, env 동작 | 위에 나열한 해당 가이드와 레퍼런스 페이지 |
| `astro check`, `astro sync`, Prettier, oxlint, Oxfmt의 도구 동작 | 위에 나열한 CLI 레퍼런스, 에디터 설정 페이지, oxc 페이지, `astro check` 소스 |
| 이 패키지가 라우팅에 쓰는 Astro 대상, 어댑터, 버전 하한 | 같은 페이지와 레지스트리 기록 |
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| 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: 471k | Updated | Claude CodeCodex | Verified | Install |
| 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: 471k | Updated | Claude CodeCodex | Verified | Install |
| rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics. | Stars: 471k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |