편집 문법의 하이라키와 기본 Profile 계약을 구체화한다

.github/workflows/ci.yml

@@ -1,68 +1,14 @@
 name: CI
 
 on:
-  pull_request:
-  push:
-    branches: [main]
   workflow_dispatch:
 
 permissions:
   contents: read
 
 jobs:
-  plan:
-    name: Plan
-    runs-on: ubuntu-latest
-    outputs:
-      full: ${{ steps.plan.outputs.full }}
-      package_required: ${{ steps.plan.outputs.package_required }}
-      package_workspaces: ${{ steps.plan.outputs.package_workspaces }}
-      browser_specs: ${{ steps.plan.outputs.browser_specs }}
-      docs: ${{ steps.plan.outputs.docs }}
-      site: ${{ steps.plan.outputs.site }}
-      standards: ${{ steps.plan.outputs.standards }}
-      external_kit: ${{ steps.plan.outputs.external_kit }}
-      reason: ${{ steps.plan.outputs.reason }}
-    steps:
-      - uses: actions/checkout@v6
-        with:
-          fetch-depth: 0
-      - uses: actions/setup-node@v6
-        with:
-          node-version: "22"
-      - name: Select verification scope
-        id: plan
-        env:
-          EVENT_NAME: ${{ github.event_name }}
-          BASE_SHA: ${{ github.event.pull_request.base.sha }}
-          HEAD_SHA: ${{ github.event.pull_request.head.sha }}
-        run: |
-          if [ "$EVENT_NAME" = "pull_request" ]; then
-            node scripts/ci-plan.mjs --base "$BASE_SHA" --head "$HEAD_SHA" >> "$GITHUB_OUTPUT"
-          else
-            node scripts/ci-plan.mjs --full >> "$GITHUB_OUTPUT"
-          fi
-      - name: Summarize verification scope
-        env:
-          PLAN_REASON: ${{ steps.plan.outputs.reason }}
-          PACKAGE_WORKSPACES: ${{ steps.plan.outputs.package_workspaces }}
-          BROWSER_SPECS: ${{ steps.plan.outputs.browser_specs }}
-          EXTERNAL_KIT: ${{ steps.plan.outputs.external_kit }}
-        run: |
-          {
-            echo "## CI 검증 계획"
-            echo "- 판단: $PLAN_REASON"
-            echo "- 패키지: $PACKAGE_WORKSPACES"
-            echo "- 브라우저: $BROWSER_SPECS"
-            echo "- 외부 kit: $EXTERNAL_KIT"
-          } >> "$GITHUB_STEP_SUMMARY"
-      - name: Verify workspace contract and planner
-        run: npm run workspace:check && npm run ci:plan:test
-
   package:
     name: Package
-    needs: plan
-    if: needs.plan.outputs.package_required == 'true'
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v6
@@ -71,31 +17,15 @@ jobs:
           node-version: "22"
       - name: Install dependencies
         run: npm ci --no-audit --no-fund
+      - name: Verify planner commands
+        run: npm run ci:plan:test
       - name: Verify full release graph
-        if: needs.plan.outputs.full == 'true'
         env:
           npm_config_cache: ${{ runner.temp }}/npm-cache
         run: npm run release:check
-      - name: Verify affected libraries
-        if: needs.plan.outputs.full != 'true' && needs.plan.outputs.package_workspaces != '[]'
-        env:
-          AFFECTED_WORKSPACES: ${{ needs.plan.outputs.package_workspaces }}
-        run: >-
-          node --input-type=module --eval
-          'import { spawnSync } from "node:child_process";
-          const workspaces = JSON.parse(process.env.AFFECTED_WORKSPACES);
-          const result = spawnSync("node", ["scripts/workspace-tasks.mjs", "verify", ...workspaces], { stdio: "inherit" });
-          process.exit(result.status ?? 1);'
-      - name: Verify standards
-        if: needs.plan.outputs.full != 'true' && needs.plan.outputs.standards == 'true'
-        run: npm run standard:check
-      - name: Verify documentation
-        if: needs.plan.outputs.full != 'true' && needs.plan.outputs.docs == 'true'
-        run: npm run docs:evaluate
 
   playground-site:
     name: Site
-    needs: plan
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v6
@@ -107,22 +37,12 @@ jobs:
       - name: Install Rich Text browser engines
         run: npx playwright install --with-deps firefox webkit
       - name: Verify site
-        if: needs.plan.outputs.site == 'true'
         run: npm run typecheck -w @interactive-os/json-document-site && npm test -w @interactive-os/json-document-site && npm run site:verify:pages
       - name: Verify browser behavior
-        env:
-          BROWSER_SPECS: ${{ needs.plan.outputs.browser_specs }}
-        run: >-
-          node --input-type=module --eval
-          'import { spawnSync } from "node:child_process";
-          const specs = JSON.parse(process.env.BROWSER_SPECS);
-          const result = spawnSync("npm", ["run", "browser:test", "--", ...specs], { stdio: "inherit" });
-          process.exit(result.status ?? 1);'
+        run: npm run browser:test
 
   external-kit:
     name: External kit
-    needs: plan
-    if: needs.plan.outputs.external_kit == 'true'
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v6

.github/workflows/collaboration-soak.yml

@@ -2,8 +2,6 @@ name: Collaboration Soak
 
 on:
   workflow_dispatch:
-  schedule:
-    - cron: "0 19 * * 1"
 
 permissions:
   contents: read

AGENTS.md

@@ -1,5 +1,21 @@
 # Repository agent instructions
 
+## Local verification and remote workflows
+
+This is a solo-maintained project. Agents own change-scoped local verification
+before handoff: run the relevant tests, type checks, builds, and browser flows.
+Report the commands, results, and any unexecuted or failing checks separately.
+An absent remote check must not be reported as a pass.
+
+Pull requests do not automatically run full CI. Main pushes run the Pages
+build/deploy workflow; release tags retain package verification on a clean
+runner. Full CI and the extended collaboration soak are manual workflows.
+Do not wait for automatic PR checks or routinely dispatch manual CI to recreate
+the removed gate. Use remote full verification when deliberately requested.
+
+Keep product tests and verification commands available. The local workflow and
+manual commands are documented in the root README's development section.
+
 ## Canonical module principle
 
 This repository follows **the same role, the same responsibility, the same

README.md

@@ -124,3 +124,35 @@ npm test -w @interactive-os/json-document
 npm run typecheck -w @interactive-os/json-document
 npm run build -w @interactive-os/json-document
 ```
+
+### 검증 운영
+
+1인 개발과 agent의 로컬 검증을 기본으로 합니다. 개발·PR에서는 변경 범위에 맞는
+테스트·타입·빌드·브라우저 검증을 수행하고, 실행 명령과 결과를 인계합니다.
+실행하지 못한 검사와 실패한 검사는 통과와 구분합니다. 자동 CI가 없다는 사실을
+검증 완료로 간주하지 않습니다.
+
+| 시점 | 원격 실행 |
+| --- | --- |
+| PR 생성·갱신 | 자동 전체 CI 없음 |
+| main push | Pages 빌드·배포와 live 확인 |
+| 릴리스 tag | 깨끗한 runner에서 기존 패키지 검증 후 publish |
+| 필요 시 | 전체 CI와 장시간 collaboration soak 수동 실행 |
+
+전체 검증이 필요하면 기존 명령을 사용합니다. 제품 테스트와 검사 CLI는 유지하며,
+변경 영향도 선택기 CLI는 자동 CI의 gate로 사용하지 않습니다.
+
+```sh
+npm run verify
+npm run release:check
+npm run external-kit:verify
+npm run test:collaboration:soak
+```
+
+원격의 깨끗한 환경에서 확인하려면 GitHub Actions의 해당 workflow에서
+`Run workflow`를 선택하거나 아래 명령으로 명시적으로 실행합니다.
+
+```sh
+gh workflow run ci.yml --ref main
+gh workflow run collaboration-soak.yml --ref main
+```