feat(phase-1): 정적 페이지를 Astro로 옮기고 Pages를 Actions로 고정한다

.cursor/agents/planner.md

@@ -1,8 +1,9 @@
 ---
 name: planner
 description: >-
-  Phase planner. Use before implementation to refine PLAN.md, and after
-  PR-DRAFT to review the still-draft PR against SPEC and code-style. No product code.
+  Phase planner. Use before implementation to refine PLAN.md. After
+  PR-DRAFT, review is the verifier (GPT 5.6 Sol), not this agent.
+  No product code. May edit PLAN.md and LOG.md only.
   Use proactively when a phase PLAN needs executable steps.
   May edit PLAN.md and LOG.md only — never product code.
 model: inherit
@@ -14,7 +15,7 @@ When invoked:
 
 1. Read `.tasks/ROADMAP.md`, the current phase `SPEC.md` + `PLAN.md`, `AGENTS.md`, `docs/conventions/code-style.md`, and `docs/conventions/prs.md`.
 2. If asked to refine the plan (Part A): map every SPEC goal to a PLAN step; write executable files/commands/acceptance checks back to `PLAN.md` only. Reply `PLAN-READY <phase> <open questions|none>`.
-3. If asked to review (Part B): review the **draft**. Do not ask for ready first. Do not trust the PR body. Check correctness, style §1–7, StyleX/Astro contracts, real gate output, leak-guard, and `docs/conventions/prs.md`. Reply `REVIEW <APPROVE|CHANGES> <phase> <PR#>`. Do not run `gh pr ready`.
+3. If asked to review (Part B): only when the leader explicitly asks. Default review is verifier on GPT 5.6 Sol. Do not run `gh pr ready`.
 4. Append the report to `.tasks/phase-N-*/LOG.md`.
 
 No product code. No SPEC edits (propose via leader). Korean PLAN prose; English LLM docs.

.cursor/agents/verifier.md

@@ -4,7 +4,7 @@ description: >-
   Skeptical gate checker. Use after implementer claims PR-DRAFT (while the
   PR is still draft). Confirm commands actually ran, SPEC goals exist in the
   diff, and nothing was marked done without evidence. Do not mark the PR ready.
-model: inherit
+model: gpt-5.6-sol-medium
 readonly: true
 ---
 

.github/workflows/deploy.yml

@@ -1,41 +1,30 @@
-# refs. https://github.com/bmvantunes/youtube-2020-august-github-pages-github-actions
-name: Node.js CI
+name: Deploy to GitHub Pages
 
 on:
   push:
-    branches: [master]
-  pull_request:
-    branches: [master]
+    branches: [main]
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
 
 jobs:
   build:
     runs-on: ubuntu-latest
-
-    strategy:
-      matrix:
-        node-version: [14.x]
-
     steps:
-      - uses: actions/checkout@v2
-
-      - name: Use Node.js ${{ matrix.node-version }}
-        uses: actions/setup-node@v2
+      - uses: actions/checkout@v7
+      - uses: withastro/action@v6
         with:
-          node-version: ${{ matrix.node-version }}
-          cache: 'yarn'
-
-      - name: Install Packages
-        run: yarn install --frozen-lockfile
-
-      - name: Build 🔧
-        run: yarn build
+          node-version: 22
 
-      - run: yarn run export
-
-      - run: touch ./out/.nojekyll
-
-      - name: Deploy
-        uses: JamesIves/github-pages-deploy-action@4.1.4
-        with:
-          branch: gh-pages # The branch the action should deploy to.
-          folder: out
+  deploy:
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    steps:
+      - id: deployment
+        uses: actions/deploy-pages@v5

.gitignore

@@ -8,10 +8,15 @@
 # testing
 /coverage
 
-# next.js
+# next.js (legacy-next/)
 /.next/
 /out/
 
+# astro
+/dist/
+/.astro/
+/storybook-static/
+
 # production
 /build
 

.husky/pre-commit

@@ -1,5 +1,5 @@
 #!/bin/sh
 . "$(dirname "$0")/_/husky.sh"
 
-npx pretty-quick --staged
-npx lint-staged
+bunx oxfmt --check .
+bunx oxlint .

.oxfmtrc.json

@@ -0,0 +1,18 @@
+{
+  "$schema": "./node_modules/oxfmt/configuration_schema.json",
+  "printWidth": 100,
+  "ignorePatterns": [
+    ".yarn/**",
+    ".agents/skills/**",
+    "node_modules/**",
+    "dist/**",
+    "out/**",
+    ".next/**",
+    ".astro/**",
+    "storybook-static/**",
+    "legacy-next/**",
+    "coverage/**",
+    "bun.lock",
+    "yarn.lock"
+  ]
+}

.oxlintrc.json

@@ -0,0 +1,18 @@
+{
+  "$schema": "./node_modules/oxlint/configuration_schema.json",
+  "categories": {
+    "correctness": "error"
+  },
+  "ignorePatterns": [
+    ".yarn/**",
+    ".agents/skills/**",
+    "node_modules/**",
+    "dist/**",
+    "out/**",
+    ".next/**",
+    ".astro/**",
+    "storybook-static/**",
+    "legacy-next/**",
+    "coverage/**"
+  ]
+}

.storybook/main.ts

@@ -0,0 +1,22 @@
+import type { StorybookConfig } from "@storybook-astro/framework";
+import stylex from "@stylexjs/unplugin";
+
+const config: StorybookConfig = {
+  stories: ["../src/**/*.stories.@(ts|tsx)"],
+  framework: {
+    name: "@storybook-astro/framework",
+    options: {},
+  },
+  async viteFinal(config) {
+    config.plugins = config.plugins ?? [];
+    config.plugins.unshift(
+      stylex.vite({
+        useCSSLayers: true,
+        runtimeInjection: false,
+      }),
+    );
+    return config;
+  },
+};
+
+export default config;

.storybook/preview.ts

@@ -0,0 +1,16 @@
+import type { Preview } from "@storybook-astro/framework";
+
+import "../src/styles/global.css";
+
+const preview: Preview = {
+  parameters: {
+    controls: {
+      matchers: {
+        color: /(background|color)$/i,
+        date: /Date$/i,
+      },
+    },
+  },
+};
+
+export default preview;

.tasks/ROADMAP.md

@@ -7,13 +7,13 @@
 
 ## Phase 개요
 
-| Phase | 이름 | 목표 | 종료 게이트(지표) | 문서 |
-|---|---|---|---|---|
-| 0 | Foundation: 브랜치·툴체인·지식기반 | `main` 전환, Node 22 + **bun** 고정 (yarn classic 잔재 제거), Astro Docs MCP + Astro 스킬 1개 + StyleX ESLint 룰 확정, StyleX 스파이크(o) | `main`이 default, `bun run dev`+StyleX 샘플 빌드 그린, 스킬 목록 `SPEC`에 핀 | [SPEC](phase-0-foundation/SPEC.md) · [PLAN](phase-0-foundation/PLAN.md) |
-| 1 | Scaffold + Design System + Home/Tags 껍데기 + 배포 | Astro v7 스캐폴드(static), StyleX 토큰/프리미티브, Home·Tags 라우트, GH Pages Actions 배포 | `main` 푸시→Pages 자동배포, Lighthouse perf≥90·a11y≥95, 스타일런타임 주입 0 | [SPEC](phase-1-scaffold-design-system/SPEC.md) · [PLAN](phase-1-scaffold-design-system/PLAN.md) |
-| 2 | Content Routes + MDX 마이그레이션 | `articles`(가변 테마) + `til`(통일) + `tags/[tag]`, Content Collections(Zod), 기존 6개 + `llm-wiki-template/wiki` 선별 이식 | 기존글 100% 렌더(깨진 링크 0), 스키마 위반 0, articles≥2 colorway 데모 | [SPEC](phase-2-content-routes/SPEC.md) · [PLAN](phase-2-content-routes/PLAN.md) |
-| 3 | Wiki Quiz (flash cards) | 랜덤 객관식/주관식, 덱·세션·채점·localStorage 진척, island로 SSG 무해화 | 퀴즈 20문항 시드, 키보드 조작·채점 단위테스트 그린 | [SPEC](phase-3-wiki-quiz/SPEC.md) · [PLAN](phase-3-wiki-quiz/PLAN.md) |
-| 4 | Hardening + 운영 | Pagefind 검색, SEO/RSS/OG/sitemap, 404, CI 가드(lint·link·schema·공개안전), 구 `gh-pages` 정리 | 검색 Top-3 적중 수동체크, CI 그린, 구배포 경로 제거 | [SPEC](phase-4-hardening-ops/SPEC.md) · [PLAN](phase-4-hardening-ops/PLAN.md) |
+| Phase | 이름                                               | 목표                                                                                                                                      | 종료 게이트(지표)                                                            | 문서                                                                                            |
+| ----- | -------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------- |
+| 0     | Foundation: 브랜치·툴체인·지식기반                 | `main` 전환, Node 22 + **bun** 고정 (yarn classic 잔재 제거), Astro Docs MCP + Astro 스킬 1개 + StyleX ESLint 룰 확정, StyleX 스파이크(o) | `main`이 default, `bun run dev`+StyleX 샘플 빌드 그린, 스킬 목록 `SPEC`에 핀 | [SPEC](phase-0-foundation/SPEC.md) · [PLAN](phase-0-foundation/PLAN.md)                         |
+| 1     | Scaffold + Design System + Home/Tags 껍데기 + 배포 | Astro v7 스캐폴드(static), StyleX 토큰/프리미티브, Home·Tags 라우트, GH Pages Actions 배포                                                | `main` 푸시→Pages 자동배포, Lighthouse perf≥90·a11y≥95, 스타일런타임 주입 0  | [SPEC](phase-1-scaffold-design-system/SPEC.md) · [PLAN](phase-1-scaffold-design-system/PLAN.md) |
+| 2     | Content Routes + MDX 마이그레이션                  | `articles`(가변 테마) + `til`(통일) + `tags/[tag]`, Content Collections(Zod), 기존 6개 + `llm-wiki-template/wiki` 선별 이식               | 기존글 100% 렌더(깨진 링크 0), 스키마 위반 0, articles≥2 colorway 데모       | [SPEC](phase-2-content-routes/SPEC.md) · [PLAN](phase-2-content-routes/PLAN.md)                 |
+| 3     | Wiki Quiz (flash cards)                            | 랜덤 객관식/주관식, 덱·세션·채점·localStorage 진척, island로 SSG 무해화                                                                   | 퀴즈 20문항 시드, 키보드 조작·채점 단위테스트 그린                           | [SPEC](phase-3-wiki-quiz/SPEC.md) · [PLAN](phase-3-wiki-quiz/PLAN.md)                           |
+| 4     | Hardening + 운영                                   | Pagefind 검색, SEO/RSS/OG/sitemap, 404, CI 가드(lint·link·schema·공개안전), 구 `gh-pages` 정리                                            | 검색 Top-3 적중 수동체크, CI 그린, 구배포 경로 제거                          | [SPEC](phase-4-hardening-ops/SPEC.md) · [PLAN](phase-4-hardening-ops/PLAN.md)                   |
 
 의존성: 0 → 1 → 2 → 3 → 4 순차. 3·4는 2 승인 후 병렬 검토 가능.
 
@@ -46,8 +46,8 @@
   - Cursor (Cline 한도 소진 시 기본): [harness/cursor.md](playbook/harness/cursor.md) — 부모 Grok 4.6 (orchestrator+leader), planner·verifier 서브에이전트, Composer 2.5 implementer는 worktree. 정의: `.cursor/agents/`.
   - Cline + Herdr: [harness/cline-herdr.md](playbook/harness/cline-herdr.md) — pane 3개, muse-spark / glm-5.3-flash (2026-09-10 실측).
   - Claude Code / Codex: 스텁. 첫 실사용 때 `_template.md`로 승격.
-  흐름: leader 추적 → planner가 PLAN 정제 → developer 구현 + **draft** PR → planner/verifier 리뷰 → ready 전환 → 사람 머지.
-  **미사용:** Paseo, opencode-go 모델.
+    흐름: leader 추적 → planner가 PLAN 정제 → developer 구현 + **draft** PR → verifier 리뷰 (Cursor: GPT 5.6 Sol medium) → ready 전환 → **사람 머지**.
+    **미사용:** Paseo, opencode-go 모델.
 
 ## 승인 플로우
 

.tasks/phase-0-foundation/PLAN.md

@@ -1,6 +1,7 @@
 # Phase 0 PLAN — Foundation
 
 ## 순서
+
 1. `git branch -m master main && git push -u origin main` → GitHub Settings → Default branch=`main` →
    로컬 `git symbolic-ref refs/remotes/origin/HEAD refs/remotes/origin/main`, `master` 삭제.
    - Pages 설정이 `gh-pages` 브랜치를 바라보므로 전환 중 배포 영향 없음. README에 "개편 중" 배너는 선택.
@@ -10,15 +11,15 @@
    - Node 22.23.2 병행 유지 (Astro 요구 ≥22.12). `bun run dev` 기본 동작=Node로 Astro 실행.
 3. 지식기반:
    a. Astro Docs MCP — same URL `https://mcp.docs.astro.build/mcp`, **per harness**:
-      Cursor: `.cursor/mcp.json` (already in repo). Cline: Cline MCP HTTP config.
-      Claude: `claude mcp add --transport http astro-docs https://mcp.docs.astro.build/mcp` (re-verify when promoting that stub).
-      Do not copy one product’s JSON into another.
+   Cursor: `.cursor/mcp.json` (already in repo). Cline: Cline MCP HTTP config.
+   Claude: `claude mcp add --transport http astro-docs https://mcp.docs.astro.build/mcp` (re-verify when promoting that stub).
+   Do not copy one product’s JSON into another.
    b. 스킬 평가: `spillwavesolutions/publishing-astro-websites-agentic-skill` clone → SKILL.md 품질 체크
-      (Collections/MDX/SSG 커버 여부) → 통과 시 `.agents/skills/astro-publish/` 미러 + 커밋해시 기록, 탈락 시 `incluud/astro-agent-skills`로 교체.
+   (Collections/MDX/SSG 커버 여부) → 통과 시 `.agents/skills/astro-publish/` 미러 + 커밋해시 기록, 탈락 시 `incluud/astro-agent-skills`로 교체.
    c. `AGENTS.md` 작성 (영어, 최소 유지 — 상세는 링크):
-      MCP 우선조회·`bun astro add` 사용·`getStaticProps/next/link` 금지·StyleX ESLint 준수 +
-      코드 스타일 링크 (`docs/conventions/code-style.md` — 사람·에이전트 공용).
-      `CLAUDE.md`는 symlink (`ln -s AGENTS.md CLAUDE.md`).
+   MCP 우선조회·`bun astro add` 사용·`getStaticProps/next/link` 금지·StyleX ESLint 준수 +
+   코드 스타일 링크 (`docs/conventions/code-style.md` — 사람·에이전트 공용).
+   `CLAUDE.md`는 symlink (`ln -s AGENTS.md CLAUDE.md`).
    d. CI 선행 구축은 Phase 4 PLAN §0 참조 (`feat/ci-gates` → `main` 직행이 스택 최하단).
 4. StyleX 스파이크 (임시 디렉토리, 본 repo 미오염):
    `bun create astro spike -- --template minimal` → `bun add -d @stylexjs/stylex @stylexjs/unplugin @stylexjs/eslint-plugin` →
@@ -27,9 +28,11 @@
    - 보너스: `bun add sharp` 후 이미지 최적화 빌드 실증 (실패 시 SPEC §7 폴백 기록).
 
 ## 검증
+
 - `git branch -a` / GitHub API default branch 확인.
 - 스파이크 `bun run build` 그린 + 생성 CSS 샘플.
 
 ## 승인 요청
+
 - [x] pm = bun@1.4.2 확정? (유지 희망 시 코멘트) — 2026-09-09 진행으로 채택
 - [x] 스킬 1순위 채택 동의? — `.agents/skills/astro-publish/` @ `5889789e`