create-anpunkit 2.2.0 → 2.3.0

package/template/.claude/anpunkit-manifest.json

@@ -1,17 +1,17 @@
 {
-  "version": "2.2.0",
+  "version": "2.3.0",
   "files": [
     {
       "path": "AGENTS.md",
-      "sha256": "0e4bdc92e8e33355fdfca8d7c3f644bd5f6b91d8b11b1837c65241c25a8dd695"
+      "sha256": "eb9e76938dd765cdc761cb53d9030f03d67edf04f1228bdb8fed4332273a29ee"
     },
     {
       "path": "CLAUDE.md",
-      "sha256": "132e64b4a9a5a178deb4db810324f79338c2af65d598fd5e26f183225c2a4d98"
+      "sha256": "2dbf55cd7a8ad2279eab8ac2e3637855f25e5c96b77fe48bd4d5cfe3e36508ca"
     },
     {
       "path": "README.md",
-      "sha256": "ca353eea88978b65dab78355ec304de0b8fb5d8ecb54d4316ee493de4459f002"
+      "sha256": "b0ac71a37d69f8c2a77db182e4930bfa7984e8d0f5685b18820d06eed83c9cb5"
     },
     {
       "path": ".gitattributes",
@@ -19,47 +19,55 @@
     },
     {
       "path": "setup.sh",
-      "sha256": "77e994cbd6db69dde57fbdd8ce1460bc61cd24ad338e816303f7243165001e32"
+      "sha256": "d19382499232221b2b180b684f1935f0fe7eda3d2078dd37ffe65c8aaeedaed1"
+    },
+    {
+      "path": ".claude/ref/compression.md",
+      "sha256": "baa49f9d97af1a168a5f74317732d13a9ce5085cebbbbf3c824f19886de483dd"
+    },
+    {
+      "path": "knowledge/webapp.md",
+      "sha256": "21898ae582abac519f9af0f054fa14c03d6648ff2c877609523f6a590eca6259"
+    },
+    {
+      "path": "knowledge/azure.md",
+      "sha256": "f94e06ed2c6879014868550810c73b5b9520db7e8c8727744714d9e12539c056"
     },
     {
       "path": ".claude/agents/debugger.md",
-      "sha256": "4ddc97252275db82356489061b87b71ac39bd9e4cc7a47d0501132c7c7024a52"
+      "sha256": "843b6a96921d3e0957f507cba77e0b25125b946bfe2b3d20439e9627b49f3e6b"
     },
     {
       "path": ".claude/agents/e2e-runner.md",
-      "sha256": "c454ad3217d6adc21e0e6cda5746e3094ea299cd7e71f761e1f417a7d6a2391e"
+      "sha256": "b5712614f0f8e09bd1884250258231bd69f019ed15018566fe06b67d092e7d18"
     },
     {
       "path": ".claude/agents/implementer.md",
-      "sha256": "e6598fdb77657616f821695323653cfdded44db85a428597d1c8074a56bbf816"
+      "sha256": "1a1d7cff9f64d519742932e36a0b89ee951d07a493493c37f27d1df00cd9e41f"
     },
     {
       "path": ".claude/agents/infra-provisioner.md",
-      "sha256": "52a54a2aaaf7e53d28e261f5e01f2693fd0a4883fd93f844a112a742a91f9149"
+      "sha256": "6f7cba54296c2f46bc382a59007cfe7943fd2f0a713b4af541316247ad00099d"
     },
     {
       "path": ".claude/agents/spec-author.md",
-      "sha256": "3e352514bfd5eb32f966cfa12014d706d17b3a12ad2155e2f826243c03fb7d0c"
+      "sha256": "d2f795b1555bf740af058282705079725ea68eb4293da25b964e11e65343e5d7"
     },
     {
       "path": ".claude/agents/planner.md",
-      "sha256": "a1a2b86aa5a88d8b9fee9af3a8d10c7f1f09e5a2fb32f831dce38b010c507771"
+      "sha256": "7c497def29d093de877747cba350981bc804f477e4e3d48c2173e58a5366b1b4"
     },
     {
       "path": ".claude/agents/researcher.md",
-      "sha256": "aa54503f8c9998d3aa97aa322c0ba47d23cae8aea6236530ddc2dfc44e7c4658"
+      "sha256": "e21a126a37f1054640f4ccd16d8f7719178570a4fa4c29a9e5a472b879589352"
     },
     {
       "path": ".claude/agents/synthesizer.md",
-      "sha256": "d17de592a3c83f2439ff9be68337d04c9d4933aa2193c68372005a85a2fdec95"
+      "sha256": "3d61df0c762eaf6e0d46722bfaab8a67666d06e05d8cc0f1afed03139071ad13"
     },
     {
       "path": ".claude/agents/test-author.md",
-      "sha256": "adc53adb326424dcb215a5f074c7df3dfcb6644f2c63ce1e9ed68d2810dc8398"
-    },
-    {
-      "path": ".claude/hooks/cursor-session-start.sh",
-      "sha256": "e08bcd14fbcfe1831b64e7d8f181b57b02c561cd8d0de6eb16fe06db259be6af"
+      "sha256": "2cd74c971a9f04656535e44ab6d981911f447457a19d9a6e5c23b9146478071d"
     },
     {
       "path": ".claude/hooks/pre-compact.sh",
@@ -67,167 +75,99 @@
     },
     {
       "path": ".claude/hooks/session-start.sh",
-      "sha256": "9cfce17a40cebf3bc518f37b33b4fad2c47f43b5913fec03b98e96e1d232bc94"
+      "sha256": "a47fc68a4f4a92cd093de2d49301e16fc499e358cbdc2c4cc364aed5f012cb97"
     },
     {
       "path": ".claude/hooks/subagent-stop.sh",
       "sha256": "fd4b48484db0511e6b78ff659213ebb826e3082e37c98d67dbcb09f159c3e318"
     },
-    {
-      "path": ".claude/skills/caveman/SKILL.md",
-      "sha256": "62c1522b986679f75e574d7f04c939405df6fc200723d67a255b36d960d9880c"
-    },
     {
       "path": ".claude/skills/grill-me/SKILL.md",
       "sha256": "1cf60d6ce350314e794033ae0773303b54fd1557c3f7ffecfc64dd788fdd4edc"
     },
     {
       "path": ".claude/skills/karpathy-guidelines/SKILL.md",
-      "sha256": "5423139b03a976713348ed4badd5de65e64fbf04d997e7b692917b1d0baddc3b"
+      "sha256": "bb48ebcc401b9893dc7fad38b1a98960f5fdd0673456328bb11a1968e246f6dd"
     },
     {
       "path": "commands.src/infra.md",
-      "sha256": "fe0e6ba6cf0c2fc3826ab67cd882752e9450677b1ffef440388349f0ba3c4fb6"
+      "sha256": "06cd17689be763718ad2ebeded8a86c4d784c4e4ccf959828853f35b7c480d15"
     },
     {
       "path": "commands.src/log-decision.md",
-      "sha256": "90c1bd5d6e625730e0b735eefc521239a8e1f547e8f1a0e8d2b8d96ca95612ed"
+      "sha256": "b8964c64ed6d576573f34e8a2f050d880c4d60ccc7f63f0bf8b29e31be418063"
     },
     {
       "path": "commands.src/log-issue.md",
-      "sha256": "359967180b5dde14f36cfabda0b0a2bc8bbb17580da557805879ab4e50eabeca"
+      "sha256": "ba448c1b93b496e60ac59e14c126c014daf53e02ed60556d4e9eff2e0700d382"
     },
     {
       "path": "commands.src/overview.md",
-      "sha256": "85a300dcdd94d95c87c25c84d06619a38b5b3679631f68b511da11d7010e5cb8"
+      "sha256": "3c36baa2711d6a1c8fe181f5081f9e04b1eaa974006f16f71a3901edbcddfca3"
     },
     {
       "path": "commands.src/phase.md",
-      "sha256": "60a0e6442c2a3945afc4aec991cd44d48705eb8c142f3c2284db7095bb5441d9"
+      "sha256": "21b417f32008e76fd9d3039bd71e6eb2556f5e4a5e214b05a1cded57a14193e1"
     },
     {
       "path": "commands.src/quick.md",
-      "sha256": "6517eefcc1c6458d441ebea1db736d7070abf6531a7e96c55ae00b90a0763313"
+      "sha256": "7d7ae50905dac714dfaf491b038c97c809e38fda49a783f0745aaa4c15cc485b"
     },
     {
       "path": "commands.src/replan.md",
-      "sha256": "57597623a2118e5867963aa61a04cff7808eb5ce8e2aed5bebb5247cff6be8ad"
+      "sha256": "e27e6057039138cb81d0a3041d652580f2eba99ace8b17f68ccbe89abcef303a"
     },
     {
       "path": "commands.src/store-wisdom.md",
-      "sha256": "960bf4e281d30a451298b5a34c4052cc65be5bc0e9f4a7a91140c7915a2dd362"
+      "sha256": "f6427b6ad2ea671d7d6ab1c24cea4e6495e0fa14d4266d2f1c4863ed92b03e58"
     },
     {
       "path": "commands.src/synthesize.md",
-      "sha256": "db4a19ff627eb22fbc1f78d1e8e2c98d73ab05fdd780afe0ca62b7ce9885c21c"
+      "sha256": "41218772abe8c2d756b0851cdb14efaa59208dd5905119da374a436a608b4e8a"
     },
     {
       "path": "commands.src/unstuck.md",
-      "sha256": "a675a648af299074240d3b7b4aa7ca39d41fdfc44520352c67f0895d5c5c1102"
+      "sha256": "72f093e0578b19745940741fc7062845196fe70110b6987af66fa44cfae5b154"
     },
     {
       "path": ".claude/commands/infra.md",
-      "sha256": "fe0e6ba6cf0c2fc3826ab67cd882752e9450677b1ffef440388349f0ba3c4fb6"
+      "sha256": "06cd17689be763718ad2ebeded8a86c4d784c4e4ccf959828853f35b7c480d15"
     },
     {
       "path": ".claude/commands/log-decision.md",
-      "sha256": "90c1bd5d6e625730e0b735eefc521239a8e1f547e8f1a0e8d2b8d96ca95612ed"
+      "sha256": "b8964c64ed6d576573f34e8a2f050d880c4d60ccc7f63f0bf8b29e31be418063"
     },
     {
       "path": ".claude/commands/log-issue.md",
-      "sha256": "359967180b5dde14f36cfabda0b0a2bc8bbb17580da557805879ab4e50eabeca"
+      "sha256": "ba448c1b93b496e60ac59e14c126c014daf53e02ed60556d4e9eff2e0700d382"
     },
     {
       "path": ".claude/commands/overview.md",
-      "sha256": "85a300dcdd94d95c87c25c84d06619a38b5b3679631f68b511da11d7010e5cb8"
+      "sha256": "3c36baa2711d6a1c8fe181f5081f9e04b1eaa974006f16f71a3901edbcddfca3"
     },
     {
       "path": ".claude/commands/phase.md",
-      "sha256": "60a0e6442c2a3945afc4aec991cd44d48705eb8c142f3c2284db7095bb5441d9"
+      "sha256": "21b417f32008e76fd9d3039bd71e6eb2556f5e4a5e214b05a1cded57a14193e1"
     },
     {
       "path": ".claude/commands/quick.md",
-      "sha256": "6517eefcc1c6458d441ebea1db736d7070abf6531a7e96c55ae00b90a0763313"
+      "sha256": "7d7ae50905dac714dfaf491b038c97c809e38fda49a783f0745aaa4c15cc485b"
     },
     {
       "path": ".claude/commands/replan.md",
-      "sha256": "57597623a2118e5867963aa61a04cff7808eb5ce8e2aed5bebb5247cff6be8ad"
+      "sha256": "e27e6057039138cb81d0a3041d652580f2eba99ace8b17f68ccbe89abcef303a"
     },
     {
       "path": ".claude/commands/store-wisdom.md",
-      "sha256": "960bf4e281d30a451298b5a34c4052cc65be5bc0e9f4a7a91140c7915a2dd362"
+      "sha256": "f6427b6ad2ea671d7d6ab1c24cea4e6495e0fa14d4266d2f1c4863ed92b03e58"
     },
     {
       "path": ".claude/commands/synthesize.md",
-      "sha256": "db4a19ff627eb22fbc1f78d1e8e2c98d73ab05fdd780afe0ca62b7ce9885c21c"
+      "sha256": "41218772abe8c2d756b0851cdb14efaa59208dd5905119da374a436a608b4e8a"
     },
     {
       "path": ".claude/commands/unstuck.md",
-      "sha256": "a675a648af299074240d3b7b4aa7ca39d41fdfc44520352c67f0895d5c5c1102"
-    },
-    {
-      "path": ".cursor/commands/infra.md",
-      "sha256": "d6f7a7ee93f76a4d68aeb74c1f43aa76b969043ac59fbc22b02675e05a6dfee5"
-    },
-    {
-      "path": ".cursor/commands/log-decision.md",
-      "sha256": "3a4ea21091306d2cf1d24595318c4a0bb15e9fd4283d5fb96fc26f2749f26f73"
-    },
-    {
-      "path": ".cursor/commands/log-issue.md",
-      "sha256": "abf7199d735f7c994c628711e5aabd661a0656f13ac5723f0a8ffc2f048ad027"
-    },
-    {
-      "path": ".cursor/commands/overview.md",
-      "sha256": "9ee65f44d44362aaa37e5df7ed95eb7d386cec6e2045a2f87a81b80da343ac00"
-    },
-    {
-      "path": ".cursor/commands/phase.md",
-      "sha256": "5a2bac0d8dc36892256e49ddfd6bccac36e1d71dbc4cc0602ac337e398a0733e"
-    },
-    {
-      "path": ".cursor/commands/quick.md",
-      "sha256": "771060033625e721b6a96f774aee4131e65ac2b0c481180004dfa8b8cef5d563"
-    },
-    {
-      "path": ".cursor/commands/replan.md",
-      "sha256": "3ad268b74c0218ae3530e3e7b86b75d9fd26bd98a79a74760efe767a63c251a2"
-    },
-    {
-      "path": ".cursor/commands/store-wisdom.md",
-      "sha256": "95d553ed835888c36b5ff188844e76c3d8c3695654904ab1284766574938c26c"
-    },
-    {
-      "path": ".cursor/commands/synthesize.md",
-      "sha256": "128067091a83934b7cc0c071713c7936cb4905cbcdd57831cecaac5301a20950"
-    },
-    {
-      "path": ".cursor/commands/unstuck.md",
-      "sha256": "d076cc6307af467f79ea41a934c1e14f2a08b01db93e80e912ab77ebd464f7be"
-    },
-    {
-      "path": ".cursor/rules/anpunkit.md",
-      "sha256": "f7ebf7b8a7d8cb6ad7cef55e06f7d36477cf0859b6f974dbb07059e81838a939"
-    },
-    {
-      "path": "playwright.config.ts",
-      "sha256": "32091109fa51b085ddf562d2896de9b25b69fb6302461bb06212078892cb994a"
-    },
-    {
-      "path": "e2e/global-setup.ts",
-      "sha256": "f9fd377d45bad7925e7645b94f5a839ee5a781f51b5ad9f1b3a8011d527f3317"
-    },
-    {
-      "path": "docker-compose.test.yml",
-      "sha256": "03d3d89354769abcfb2abb42540b4fd9d2bfcc382f62815822db9c910c01d9f7"
-    },
-    {
-      "path": "scripts/e2e-stack.sh",
-      "sha256": "98a6ab95e19e3b560887f6c7e935a1947fe59d5cf881f0da8286db66580a7ce4"
-    },
-    {
-      "path": "scripts/auth-setup.sh",
-      "sha256": "bb30646047a83bf857bf0ffc8cef0560f2ddf012d48a19185407f10740d8fa43"
+      "sha256": "72f093e0578b19745940741fc7062845196fe70110b6987af66fa44cfae5b154"
     },
     {
       "path": "scripts/regression.sh",
@@ -251,15 +191,15 @@
     },
     {
       "path": "create-anpunkit/package.json",
-      "sha256": "e283531b788e94cf9ca604a119e9d581e9cede3e1276770087f2c4874927e567"
+      "sha256": "f8b2c8d09f9a32f98bdcac68056adc696a84ab41c2d2497ba5e63f98a1dccb76"
     },
     {
       "path": "create-anpunkit/bin/cli.js",
-      "sha256": "f96460757110e6a0f81cef750c5b39442ea5589f53ae83b69951555632cce7ec"
+      "sha256": "b726046c637e1383bdf5aadf31d027fdab436f8ba7620d8812a25d87a8dc4d92"
     },
     {
       "path": "create-anpunkit/build.sh",
-      "sha256": "3a5062e46ba09ff23736de08545cefd1c0f30b216c3820bd2ada22e3d0db5b79"
+      "sha256": "77f9b11ed5012429fa71fa7a0249e3825d3eb39a426629d3a1e014b8571ab9f9"
     },
     {
       "path": "create-anpunkit/README.md",
@@ -268,9 +208,8 @@
   ],
   "hybrid": [
     ".claude/settings.json",
-    ".cursor/hooks.json",
     ".gitignore",
     "docs/DESIGN_LOG.md"
   ],
-  "generated_from": "commands.src/ -> .claude/commands/ + .cursor/commands/"
+  "generated_from": "commands.src/ -> .claude/commands/"
 }

package/template/.claude/commands/infra.md

@@ -3,16 +3,20 @@ description: Provision or verify Azure infrastructure. Generates Bicep, shows wh
 argument-hint: [provision | verify | update <what changed> | regenerate-env | auth-proof]
 ---
 
-Caveman ULTRA mode. You are the ORCHESTRATOR.
+compression: user (.claude/ref/compression.md). You are the ORCHESTRATOR.
 
 Action: $ARGUMENTS (default: "provision" if INFRA.md missing, "verify" if present)
 
+Only meaningful when docs/OVERVIEW.md has `infra_needed: true`. If
+`infra_needed: false`, tell me this project has no infra phase and STOP.
+
 ---
 
 ## PRE-FLIGHT
 
-1. Check `az account show` — if it fails, STOP.
-   Tell me: "Run `scripts/auth-setup.sh` first."
+1. Confirm cloud CLI auth per the project's knowledge doc (Azure:
+   `knowledge/azure.md` ritual — `bash scripts/auth-setup.sh`; materialize it if
+   absent). If it fails, STOP and tell me the exact command to run.
 
 2. Determine mode from $ARGUMENTS or default logic.
 

package/template/.claude/commands/log-decision.md

@@ -3,7 +3,7 @@ description: Record an architectural decision in docs/DESIGN_LOG.md. Use only wh
 argument-hint: [what changed]
 ---
 
-Caveman ULTRA mode.
+compression: user (.claude/ref/compression.md).
 
 Append an architectural decision to docs/DESIGN_LOG.md. Change: $ARGUMENTS
 

package/template/.claude/commands/log-issue.md

@@ -3,7 +3,7 @@ description: Log an error to docs/ISSUES.md with root cause + solution, in the c
 argument-hint: [short error description]
 ---
 
-Caveman ULTRA mode.
+compression: user (.claude/ref/compression.md).
 
 Append an entry to docs/ISSUES.md. Error: $ARGUMENTS
 

package/template/.claude/commands/overview.md

@@ -2,7 +2,7 @@
 description: Bootstrap a new project. Runs design-research, research review, double grill (incl. data/state flow), datasource-understanding baseline, and planning. Run once per project.
 ---
 
-Caveman ULTRA mode.
+compression: user (.claude/ref/compression.md).
 
 Recommended: run from plan mode (Shift+Tab). Planning agents are read-only by
 tool grant; plan mode adds a read-only gate on the main session too. Optional.
@@ -16,11 +16,17 @@ Goal: stand up a fresh project workspace with a well-grounded plan.
 ### Round 1 — Initial grill
 
 1. Run the `grill-me` skill to interrogate me. Goal: understand initial scope.
-   Cover: project purpose, success criteria, external services, Azure services
-   needed (type + sizing), region, deployment target (Azure or local for E2E),
-   known constraints, unknowns. ALSO establish:
+   Cover: project purpose, success criteria, external services, cloud/infra
+   services needed (type + sizing, if any), region, known constraints, unknowns.
+   ALSO establish:
+   - **project_type**: web app / desktop app / script / library / other. This
+     drives the deterministic flag derivation (step 6) and knowledge-doc
+     selection.
    - **has_frontend**: is there a browser-facing UI? If yes, what is the frontend
      root path (e.g. `src/web/`, `app/`)? This drives the mandatory-E2E path match.
+   - **deploy meaning**: what does "done and shipped" mean for this project —
+     cloud deploy (where?), package publish (which registry?), verified
+     install/run instructions, or none (why)? This sets `deploy_kind`.
    Do not stop early. Do not write OVERVIEW.md yet.
 
 Store the round-1 answers as working context — do NOT write OVERVIEW.md yet.
@@ -86,11 +92,23 @@ Store the round-1 answers as working context — do NOT write OVERVIEW.md yet.
    - Project purpose and success criteria
    - Scope and constraints (informed by research findings)
    - External services with confirmed capabilities/limits
-   - "Azure services" section: every service with expected SKU
-   - Deployment target (azure-deployed or local-docker for E2E)
+   - Cloud/infra services section: every service with expected SKU (if any)
    - `has_frontend: true|false` and, if true, the frontend root path
    - Known risks / open questions (if any remain)
 
+   PROJECT FLAGS (hard rule 10 — declared once here, recorded verbatim, never
+   re-derived later):
+   - `project_type: web app|desktop app|script|library|other` (declared in round 1)
+   - `infra_needed: true|false` — derived: application types (web app, desktop
+     app, service) → true; script / library → false. Overridable here with a
+     stated reason.
+   - `e2e_kind: browser|cli|http|library-api` — derived: has_frontend → browser;
+     backend/API service → http; script → cli; library → library-api.
+   - `deploy_kind: cloud-deploy|package-publish|install-run-verified|none(<reason>)`
+     (from the round-1 "deploy meaning" answer).
+   - `knowledge_docs:` — derived list: web app or has_frontend → `knowledge/webapp.md`;
+     Azure services declared OR Azure cloud-deploy → `knowledge/azure.md`; else empty.
+
    OVERVIEW.md is written HERE — after the re-grill, not before.
 
 7. Write docs/DATAFLOW.md — a state-transition table per key object, driven by the
@@ -112,8 +130,10 @@ Store the round-1 answers as working context — do NOT write OVERVIEW.md yet.
 
 8. Hand OVERVIEW.md + DATAFLOW.md + design-research findings to the `planner`
    subagent. PLAN.md MUST:
-   - Start with Phase 0 (infra setup) as the first entry (always).
-   - End with a final code phase that contains the deploy task block.
+   - Start with Phase 0 (infra setup) as the first entry IFF `infra_needed: true`;
+     when `infra_needed: false` there is no Phase 0 — Phase 1 is the first entry.
+   - End with a final code phase whose deploy task completes `deploy_kind`
+     (cloud deploy / package publish / verified install-run / none-with-reason).
    - For any phase whose `changes` touch the frontend root: include ≥1
      UI-existence acceptance criterion naming the specific user-visible
      interactive element the phase introduces (not "page renders 200").
@@ -138,15 +158,18 @@ Store the round-1 answers as working context — do NOT write OVERVIEW.md yet.
 
 phase: 0 (pending)
 completed: project bootstrapped — design research, research review, double grill (incl. data/state flow) done
-next: run /infra to provision Azure infrastructure
+next: <if infra_needed: "run /infra to provision infrastructure (Phase 0)"; else "run /phase 1">
 blocker: none
 
 ```
+   When `infra_needed: false`, set `phase: 1 (pending)` and the next line to
+   "run /phase 1".
 10. Create docs/ISSUES.md with header `# Issues` and `## Archived` section.
 
 11. Create empty docs/HISTORY.md.
 
-12. Create docs/INFRA.md from the template (populated by /infra).
+12. Create docs/INFRA.md from the template (populated by /infra). Skip when
+    `infra_needed: false`.
 
 13. Create docs/ENDPOINTS.md:
  ```
@@ -162,5 +185,7 @@ case NAMES (no values). I confirm the case-name set is COMPLETE here — these n
 are the up-front behavioral contract; values get filled + reviewed per phase at
 `/phase` SPEC REVIEW.
 
-Remind me: "Run `/infra` next to provision the Azure environment (Phase 0) and
-run the one-time AUTH PROOF before starting Phase 1."
+Remind me of the next step per `infra_needed`:
+- `infra_needed: true` → "Run `/infra` next to provision the environment (Phase 0)
+  and run the one-time AUTH PROOF before starting Phase 1."
+- `infra_needed: false` → "No infra phase — run `/phase 1` to start."

package/template/.claude/commands/phase.md

@@ -3,7 +3,7 @@ description: Run one phase end-to-end. TDD phases run SPEC fill -> SPEC REVIEW -
 argument-hint: [phase number]
 ---
 
-Caveman ULTRA mode. You are the ORCHESTRATOR. Route work to subagents —
+compression: user (.claude/ref/compression.md). You are the ORCHESTRATOR. Route work to subagents —
 you do NOT implement, fill specs, or debug yourself.
 
 Note: subagents cannot talk to the user. Only YOU can.
@@ -14,8 +14,9 @@ Target phase: $ARGUMENTS  (default: the phase marked pending in docs/PLAN.md)
 
 ## 0. PRE-FLIGHT
 
-a. INFRA CHECK (phases > 0):
-   - Read docs/INFRA.md. If Phase 0 not done -> STOP.
+a. INFRA CHECK (phases > 0): read docs/OVERVIEW.md `infra_needed`.
+   - `infra_needed: false` -> no Phase 0 exists; SKIP this check entirely.
+   - `infra_needed: true`: read docs/INFRA.md. If Phase 0 not done -> STOP.
      Tell me: "Phase 0 (infra) not complete. Run `/infra` first."
    - Exception: if $ARGUMENTS is "0", tell me to run `/infra` directly.
 
@@ -29,13 +30,14 @@ b. PHASE STATE CHECK: Read docs/STATE.md and docs/PLAN.md.
 c. FINAL PHASE CHECK: Read docs/PLAN.md. Is this the last phase (no further
    pending phases after this one)? Record this as IS_FINAL_PHASE=true/false.
 
-d. AUTH LIVENESS GATE (hard rule 16): if this phase will run a boundary/E2E suite,
-   confirm every credential it needs is live NOW.
+d. AUTH LIVENESS GATE (hard rule 16): only if this phase touches a credentialed
+   external service and will run a boundary/E2E suite. Skip otherwise.
    - If INFRA.md has no `AUTH PROOF: PASS` marker -> STOP: "Auth never proven
      reusable. Run `/infra` first."
-   - Run `scripts/auth-setup.sh --check` (Entra token obtainable + not expired)
-     and, for each external system this phase touches (docs/DATAFLOW.md external
-     rows + docs/ENDPOINTS.md auth column), confirm its credential is obtainable
+   - Run the liveness command recorded in docs/INFRA.md `## AUTH` (Azure projects:
+     the ritual per `knowledge/azure.md`, i.e. `bash scripts/auth-setup.sh`) and,
+     for each external system this phase touches (docs/DATAFLOW.md external rows +
+     docs/ENDPOINTS.md auth column), confirm its credential is obtainable
      headlessly. Any failure -> boundary/E2E is BLOCKED; tell me what to run; the
      MOCK suite may still proceed.
 
@@ -45,6 +47,10 @@ e. FRONTEND TRIGGER (hard rule 13): read docs/OVERVIEW.md `has_frontend` + the
    This is a PATH MATCH, not a judgment call. Record FRONTEND_PHASE — it gates the
    `ui` boundary run + evidence at CLOSE.
 
+f. FLAG BASELINES: read docs/OVERVIEW.md `e2e_kind` + `deploy_kind`. These are the
+   project baselines; §1 binds this phase's effective E2E_KIND and (final phase)
+   confirms DEPLOY_KIND.
+
 ---
 
 ## 1. RESEARCH + TDD APPLICABILITY
@@ -75,6 +81,11 @@ Then classify the phase:
   to me, so I can override to non-TDD BEFORE SPEC fill fires. (Hard rule 11: never
   downgrade a TDD phase just to dodge the gates.)
 
+FLAG BINDING (hard rule 10): bind this phase's effective E2E_KIND — `browser` iff
+FRONTEND_PHASE, else the OVERVIEW `e2e_kind` baseline. If IS_FINAL_PHASE, restate
+`deploy_kind` and confirm the final phase's deploy task realizes it. STATE both
+bindings. Divergence from OVERVIEW is mine to resolve — never silently re-derived.
+
 =====================================================================
 ## TDD PATH  (TDD_PHASE=true)
 =====================================================================
@@ -160,11 +171,16 @@ fixtures + research + the generated test file paths (it MAY read the tests — f
 before logic, no overfit — but must NOT edit tests, spec, or fixtures). Fill to
 green against the spec. Budget 3, WARN@2, STUCK@3.
 
-Run the BOUNDARY suite (real HTTP/CLI/message; `TEST_MODE=real`). If FRONTEND_PHASE,
-`e2e-runner` runs its emitted `ui` specs — MANDATORY (hard rule 13) — reads INFRA.md
-target, runs `scripts/e2e-stack.sh up` / Playwright / `down`, and captures a
-screenshot at EACH UI-existence assertion regardless of pass/fail to
-docs/evidence/e2e-phase-<n>/, with a summary in docs/research/e2e-<slug>.md.
+Run the BOUNDARY suite (real HTTP/CLI/message; `TEST_MODE=real`) — the outer surface
+per this phase's bound E2E_KIND. Capture evidence (hard rule 13):
+- `browser` (FRONTEND_PHASE): dispatch `e2e-runner` to run its emitted `ui` specs —
+  MANDATORY — reads INFRA.md target, runs the stack ritual per `knowledge/webapp.md`
+  (`scripts/e2e-stack.sh up` / Playwright / `down`), captures a screenshot at EACH
+  UI-existence assertion regardless of pass/fail to docs/evidence/e2e-phase-<n>/,
+  with a summary in docs/research/e2e-<slug>.md.
+- `cli` / `http` / `library-api`: the real-mode boundary suite IS the outer run;
+  capture its transcript (invocation + result) to docs/evidence/e2e-phase-<n>/.
+  No separate emitter is dispatched.
 
 PHASE GATE (rule 5) -> go to §8/§9/§10 (see GATE below).
 
@@ -177,7 +193,8 @@ PHASE GATE (rule 5) -> go to §8/§9/§10 (see GATE below).
 Dispatch `implementer` (legacy mode) with phase spec + research summary.
 Returns STUCK -> go to ESCALATE.
 If IS_FINAL_PHASE: phase spec includes the deploy task; confirm the return
-includes "deployed URL" before proceeding.
+realizes `deploy_kind` (deployed URL / published version / verified install-run)
+before proceeding.
 
 ## 3N. TEST (blind)
 
@@ -237,8 +254,11 @@ REGRESSION + COVERAGE GATES (before closing — all FAIL HARD, do not close):
   IS_FINAL_PHASE: any transition still PENDING -> FAIL HARD. (The case→test half is
   already enforced by `spec-conformance.sh` at §6 — every case-id is cited by a
   boundary test, which by placement lands in tests/regression/.)
-- EVIDENCE (FRONTEND_PHASE only, hard rule 13): docs/evidence/e2e-phase-<n>/ must
-  contain at least the per-UI-existence-assertion screenshots. Empty -> FAIL HARD.
+- EVIDENCE (hard rule 13): docs/evidence/e2e-phase-<n>/ must contain the boundary
+  run's evidence — per-UI-existence-assertion screenshots for `browser`, or the
+  captured boundary-run transcript for `cli`/`http`/`library-api`. Required whenever
+  this phase closes an E2E_KIND boundary (browser: FRONTEND_PHASE; others: the phase
+  ships/changes the outer surface). Empty when required -> FAIL HARD.
 - IF IS_FINAL_PHASE: additionally run `bash scripts/regression.sh --real` (full real
   corpus). A failure blocks close.
 
@@ -256,24 +276,28 @@ IF IS_FINAL_PHASE — FINAL CLOSE sequence:
   a. Run `/synthesize` — pass the signal that this is the final phase so the
      synthesizer runs the extended pass (OVERVIEW.md + README.md update).
 
-  b. Read docs/ENDPOINTS.md. Surface a "READY TO USE" summary to me:
+  b. Surface a "READY TO USE" summary to me, shaped by `deploy_kind`:
      ```
      ✅ PROJECT COMPLETE
 
-     Deployed at: <base URL from docs/INFRA.md "Deployed base URL">
+     <deploy_kind line:
+       cloud-deploy         -> Deployed at: <base URL from docs/INFRA.md "Deployed base URL">
+       package-publish       -> Published: <package name> @ <version> to <registry>
+       install-run-verified  -> Verified install/run: <the exact commands, confirmed working>
+       none(<reason>)        -> Not shipped: <reason>>
 
-     ## Endpoints
-     <paste the full docs/ENDPOINTS.md table>
+     ## Interface
+     <web/http: paste the full docs/ENDPOINTS.md table; cli: the command surface;
+      library: the public API surface>
 
      ## Quick start
-     - Base URL: <URL>
-     - Auth: <Bearer token / API key / none — from ENDPOINTS.md>
-     - Health check: GET <base URL>/health
+     <how to use it, per deploy_kind — base URL + auth + health check for a service;
+      install + invoke for a CLI; import + call for a library>
 
      ## Docs
-     - Full endpoint catalogue: docs/ENDPOINTS.md
+     - Full interface catalogue: docs/ENDPOINTS.md
      - Object/state flow: docs/DATAFLOW.md
-     - Infrastructure: docs/INFRA.md
+     - Infrastructure: docs/INFRA.md (if infra_needed)
      - Project history: docs/HISTORY.md
      ```
   Tell me the project is complete and ready to use.
@@ -293,6 +317,7 @@ After each step, update docs/STATE.md:
 phase: <n> (in progress)
 tdd: <true|false>
 frontend_phase: <true|false>
+e2e_kind: <browser|cli|http|library-api — the bound value>
 completed: <steps done so far>
 next: <exact next step>
 blocker: <none or open issue>

package/template/.claude/commands/quick.md

@@ -3,7 +3,7 @@ description: Make a small, obvious change directly — no agent chain, no phase
 argument-hint: [what to change]
 ---
 
-Caveman ULTRA mode. Apply `karpathy-guidelines` skill.
+compression: user (.claude/ref/compression.md). Apply `karpathy-guidelines` skill.
 
 Purpose: skip the orchestration tax for a 5-line fix.
 

package/template/.claude/commands/replan.md

@@ -3,7 +3,7 @@ description: Revise docs/PLAN.md when it no longer matches reality — add, cut,
 argument-hint: [what changed about the plan]
 ---
 
-Caveman ULTRA mode.
+compression: user (.claude/ref/compression.md).
 
 Recommended: run from plan mode (Shift+Tab). Optional; the command stops for
 your approval regardless.

package/template/.claude/commands/store-wisdom.md

@@ -2,7 +2,7 @@
 description: Promote resolved issues and research findings from this project to the shared anpunkit-kb repo. Analyzes, proposes candidates for your review, then pushes approved entries.
 ---
 
-Caveman ULTRA mode. You are the ORCHESTRATOR.
+compression: user (.claude/ref/compression.md). You are the ORCHESTRATOR.
 
 Purpose: share what this project learned with all future projects.
 Only resolved issues and completed research qualify. Open issues do NOT.

package/template/.claude/commands/synthesize.md

@@ -2,7 +2,7 @@
 description: Compress handoff docs, dedup the issue log, prune snapshots. Run before /clear.
 ---
 
-Caveman ULTRA mode.
+compression: user (.claude/ref/compression.md).
 
 Trigger: end of a phase, or any time STATE.md / ISSUES.md feel bloated.