create-ailk 0.19.1 → 0.21.0

package/site-templates/shapes/person-service/TEMPLATE-MANIFEST.md

@@ -232,6 +232,14 @@ _Code route — no content, no sections._
 
 <!-- generated:end -->
 
+<!-- generated:begin page=/working-agreement -->
+
+| #   | Section                             | Component         | Copy (first line) |
+| --- | ----------------------------------- | ----------------- | ----------------- |
+| 1   | `document-chassis` (layout=article) | `DocumentChassis` | Working Agreement |
+
+<!-- generated:end -->
+
 `/blog` (the Free teaser row, § 1.9 — served by the generic `[slug]` route over the always-copied overlay's `BlogList/blog.mdx`):
 
 <!-- generated:begin page=/blog -->
@@ -287,8 +295,9 @@ The standard page set for this shape (`derive-roster.py --shape person-service -
 | `PortfolioList` · `PortfolioItem` | the portfolio pair belongs to every shape's standard roster (operator, 2026-09-25; roadmap § 4)                                                                                                                               |
 | `BlogList`                        | every Free scaffold's nav links `/blog` unconditionally (`renderNavConfig`, operator ruling 2026-09-23); the Free teaser serves it, as on organization-product (#6753 D3)                                                     |
 | `LandingPage`                     | the Free `/meet` meeting-types hub is a LandingPage seed, the same generic `[slug]` route serves it through (#6897 D3); the four `/meet/[slug]` BookCall detail seeds ride the `BookCall` type already in the standard roster |
+| `WorkingAgreementPage`            | the Contact form's terms checkbox links `/working-agreement` beside `/terms` and `/privacy`, so every starter ships the page from `_base` (#8661 D10)                                                                         |
 
-`|S − D| = 13` and `|R| = 18`.
+`|S − D| = 13` and `|R| = 19`.
 
 `/sign-in` and `/sign-up` are also rostered (#6797) — code routes (`kind: route`) with no page type, so they sit outside this set equation: the locale layout's header links both, and the roster of record lists every page the scaffold serves.
 
@@ -305,26 +314,27 @@ person-service:
   shape: person-service
   design: standard
   roster:
-    - { route: "/",                 kind: page, content: ["content/en/HomePage/home.mdx"] }
-    - { route: "/services",         kind: page, content: ["content/en/ServicesList/services.mdx"] }
-    - { route: "/services/[slug]",  kind: page, contentDir: "content/en/Service" }
-    - { route: "/for",              kind: page, content: ["content/en/UseCasesList/for.mdx"] }
-    - { route: "/for/[slug]",       kind: page, contentDir: "content/en/UseCase" }
-    - { route: "/about",            kind: page, content: ["content/en/AboutPage/about.mdx"] }
-    - { route: "/contact",          kind: page, content: ["content/en/ContactPage/contact.mdx"] }
-    - { route: "/faq",              kind: page, content: ["content/en/FAQPage/faq.mdx"] }
-    - { route: "/glossary",         kind: page, content: ["content/en/GlossaryList/glossary.mdx"] }
-    - { route: "/newsletter",       kind: page, content: ["content/en/NewsletterSignup/newsletter.mdx"] }
-    - { route: "/sign-in",          kind: route }
-    - { route: "/sign-up",          kind: route }
-    - { route: "/purchase-policy",  kind: page, content: ["content/en/PurchasePolicyPage/purchase-policy.mdx"] }
-    - { route: "/privacy",          kind: page, content: ["content/en/PrivacyPage/privacy.mdx"] }
-    - { route: "/terms",            kind: page, content: ["content/en/TermsPage/terms.mdx"] }
-    - { route: "/blog",             kind: page, content: ["content/en/BlogList/blog.mdx"] }
-    - { route: "/meet",             kind: page, content: ["content/en/LandingPage/meet.mdx"] }
-    - { route: "/meet/[slug]",      kind: page, content: ["content/en/BookCall/book-a-call.mdx", "content/en/BookCall/onsite-estimate.mdx", "content/en/BookCall/start-project.mdx", "content/en/BookCall/onsite-service.mdx"] }
-    - { route: "/portfolio",        kind: page, content: ["content/en/PortfolioList/portfolio.mdx"] }
-    - { route: "/portfolio/[slug]", kind: page, contentDir: "content/en/PortfolioItem" }
+    - { route: "/",                  kind: page, content: ["content/en/HomePage/home.mdx"] }
+    - { route: "/services",          kind: page, content: ["content/en/ServicesList/services.mdx"] }
+    - { route: "/services/[slug]",   kind: page, contentDir: "content/en/Service" }
+    - { route: "/for",               kind: page, content: ["content/en/UseCasesList/for.mdx"] }
+    - { route: "/for/[slug]",        kind: page, contentDir: "content/en/UseCase" }
+    - { route: "/about",             kind: page, content: ["content/en/AboutPage/about.mdx"] }
+    - { route: "/contact",           kind: page, content: ["content/en/ContactPage/contact.mdx"] }
+    - { route: "/faq",               kind: page, content: ["content/en/FAQPage/faq.mdx"] }
+    - { route: "/glossary",          kind: page, content: ["content/en/GlossaryList/glossary.mdx"] }
+    - { route: "/newsletter",        kind: page, content: ["content/en/NewsletterSignup/newsletter.mdx"] }
+    - { route: "/sign-in",           kind: route }
+    - { route: "/sign-up",           kind: route }
+    - { route: "/purchase-policy",   kind: page, content: ["content/en/PurchasePolicyPage/purchase-policy.mdx"] }
+    - { route: "/privacy",           kind: page, content: ["content/en/PrivacyPage/privacy.mdx"] }
+    - { route: "/terms",             kind: page, content: ["content/en/TermsPage/terms.mdx"] }
+    - { route: "/working-agreement", kind: page, content: ["content/en/WorkingAgreementPage/working-agreement.mdx"] }
+    - { route: "/blog",              kind: page, content: ["content/en/BlogList/blog.mdx"] }
+    - { route: "/meet",              kind: page, content: ["content/en/LandingPage/meet.mdx"] }
+    - { route: "/meet/[slug]",       kind: page, content: ["content/en/BookCall/book-a-call.mdx", "content/en/BookCall/onsite-estimate.mdx", "content/en/BookCall/start-project.mdx", "content/en/BookCall/onsite-service.mdx"] }
+    - { route: "/portfolio",         kind: page, content: ["content/en/PortfolioList/portfolio.mdx"] }
+    - { route: "/portfolio/[slug]",  kind: page, contentDir: "content/en/PortfolioItem" }
 ```
 
 <!-- generated:end -->

package/templates/.claude/cloudparity-repo-hooks.json

@@ -0,0 +1,9 @@
+{
+  "hooks": [
+    {
+      "event": "PostToolUse",
+      "matcher": "Edit|Write",
+      "command": "bash .claude/hooks/architecture-check.sh"
+    }
+  ]
+}

package/templates/.claude/hooks/architecture-check.sh

@@ -0,0 +1,8 @@
+#!/usr/bin/env bash
+# PostToolUse (Edit|Write): run the architecture boundary lint after an edit.
+# Exits 0 until dependencies are installed, and 2 on a violation so Claude
+# reads the finding. Registered in .claude/settings.json and declared in
+# .claude/cloudparity-repo-hooks.json; keep the two in step.
+cd "$CLAUDE_PROJECT_DIR" || exit 0
+[ -x node_modules/.bin/tsx ] || exit 0
+pnpm --silent architecture >&2 || exit 2

package/templates/.claude/rules/loop-contract.md

@@ -0,0 +1,129 @@
+# Per-Issue Workflow
+
+The contract every change goes through. One issue in, one PR out, no
+scope creep.
+
+This is the single-developer flow. If you're working solo on this
+project, this is what every meaningful change looks like.
+
+## Pick
+
+Open an issue or claim one from your backlog. The issue must have:
+
+- A `## Acceptance Criteria` section listing observable, verifiable
+  outcomes.
+- A `## Scope` section listing the files or path globs you intend
+  to touch.
+
+If either is missing, write them before you start — not as a
+formality but because the rest of the workflow depends on them.
+
+## Read
+
+Before any edits:
+
+1. The issue body in full — every acceptance bullet, scope path,
+   and dependency note.
+2. `CLAUDE.md` — the operating manual you're already reading.
+3. The files inside `## Scope` — confirm they exist and your mental
+   model matches what's actually there.
+
+If anything is missing or the issue is infeasible as written, stop
+and refine the issue before coding.
+
+## Branch
+
+```bash
+git checkout main
+git pull --ff-only origin main
+git checkout -b issue-<N>-<kebab-slug>
+```
+
+Use a 3–6 word slug from the issue title. Branch names show up in
+your PR list — make them scannable.
+
+## TDD: RED → GREEN
+
+For functional acceptance criteria:
+
+1. Write tests from the criteria first. They should fail (RED) —
+   your implementation doesn't exist yet.
+2. Implement the smallest change that makes the tests pass (GREEN).
+3. Refactor if the implementation is messy. Tests stay green
+   throughout.
+
+Skip TDD only for: pure documentation, prompt-only changes, or
+single-line fixes already covered by an existing test.
+
+## Verify
+
+Before commit AND before push:
+
+```bash
+pnpm preflight
+```
+
+This runs `architecture` + `claude-md:check` + `type-check` + `lint` +
+`build`. It runs no tests, so it is not a stand-in for CI: run
+`pnpm test` as well whenever your change has tests, and read CI's own
+result on the PR.
+
+For PRs touching specific surfaces:
+
+- `database/` schema changes — also run `pnpm db:migrate` locally if
+  you added a migration.
+
+## Commit + PR
+
+- Commit message format: `feat(area): description (#N)`. Include
+  the issue number when one exists.
+- Multiple commits on the branch are fine; squash-merge collapses
+  them.
+- PR title: same as the commit message format.
+- PR body must include:
+  - **Summary** — what the PR does, in plain language.
+  - **Scope** — paths actually touched (a subset of the issue's
+    scope).
+  - **Verification** — checklist of what you ran, with
+    `[x] pnpm preflight` ticked.
+  - `Closes #N` line — required for issue PRs; triggers GitHub's
+    auto-close on merge.
+
+## After PR open
+
+1. Wait for CI. If it goes red, diagnose and fix; do not merge red.
+2. Wait for any automated reviewers (Bugbot, code review bots) to
+   return. Address every finding — either fix it or write a short
+   reply explaining why it's not actionable.
+3. Merge once CI is green and reviews are reconciled.
+
+## After merge
+
+1. Close the issue if the PR didn't auto-close it.
+2. Delete the local and remote branch.
+3. Pick the next issue.
+
+## Mid-task scope expansion
+
+If you realize mid-task that the issue's `## Scope` was insufficient:
+
+1. Stop before writing outside scope.
+2. Update the PR description to add the new path with a one-line
+   reason.
+3. Continue.
+
+That short pause is the entire point — it forces you to acknowledge
+that the work has grown, instead of letting it grow silently.
+
+## When to escalate
+
+Stop and surface the question rather than make the call alone if:
+
+- An architecture invariant in `.claude/rules/architecture.md` would
+  have to bend.
+- A change to a published `@working-theory/*` package is needed (file the
+  issue upstream; don't fork locally).
+- The acceptance criteria contradict each other or the existing code.
+- You'd be deleting or moving more than five files at once.
+
+A short clarifying question beats a long detour down the wrong path.

package/templates/.claude/settings.json

@@ -6,7 +6,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "cd \"$CLAUDE_PROJECT_DIR\" && [ -x node_modules/.bin/tsx ] || exit 0; pnpm --silent architecture >&2 || exit 2"
+            "command": "bash .claude/hooks/architecture-check.sh"
           }
         ]
       }
@@ -23,5 +23,6 @@
   },
   "enabledPlugins": {
     "ailk@working-theory": true
-  }
+  },
+  "x-cloudparity-managed-keys": ["hooks"]
 }

package/templates/.env.example

@@ -14,6 +14,7 @@ AILK_PUBLIC_DOMAIN=ailaunchkit.ai
 #   3. <meta name="robots" content="noindex,nofollow"> tag (apps/web/app/[locale]/layout.tsx)
 # At launch, set STEALTH=false on the hosting platform's env vars and redeploy.
 # See README.md § "Going live" for the full flip checklist.
+# Accepted (any case): true, 1, yes, on hide the site; false, 0, no, off or empty allow indexing. Any other value fails the build.
 STEALTH=true
 
 # Blog-OFF launch gate (#3413) — SITE-ARCHITECTURE §4.1 parks the blog at
@@ -520,6 +521,18 @@ CONTENT_ADAPTER=mdx
 # it from one egress address. A whole number from 1 to 999999. Default: 120.
 # AILK_RATE_LIMIT_DIRECTORY_PER_MINUTE=120
 #
+# apps/api. Which store rateLimitMiddleware's per-IP/per-key counters use
+# (#5040). `database` counts in the deployment's own Postgres (DATABASE_URL),
+# so the limit holds across every concurrent isolate; `memory` keeps the
+# pre-#5040 in-process Map, which does not. Default: `database` when
+# DATABASE_URL is set, else `memory`. A database failure or a 1s-slow call
+# falls back to the in-process Map for that request rather than letting it
+# through uncounted. Run `pnpm --filter @working-theory/api rate-limit:probe
+# --origin <https origin>` against a live deployment to check which store it
+# selected and whether a burst holds — see
+# docs/runbooks/site-configuration.md.
+# AILK_RATE_LIMIT_STORE=
+#
 # SPOKE (apps/web, server-only — never NEXT_PUBLIC_). This spoke's key: one
 # entry of the hub's AILK_VISITOR_FORWARD_KEYS. Sent only when AILK_API_URL
 # is https (or loopback). Issue a key only to a spoke whose platform

package/templates/CLAUDE.md

@@ -64,7 +64,7 @@ your module set; `pnpm architecture` enforces it, and a hook in
 | Change the look                                | `create-ailk apply-design <name\|path>` (keeps `brand:`); at scaffold, `--design <folder>`         |
 | Logos, photos, brand reference                 | `brand_assets/`                                                                                    |
 | Repo identity, labels, hard floors             | `project.yaml`                                                                                     |
-| Diff hygiene when editing existing files       | `.claude/rules/preserve-existing-style.md`                                                         |
+| Diff hygiene when editing existing files       | `CONVENTIONS.md` § Commit + diff hygiene                                                           |
 | Code style, testing, security                  | `CONVENTIONS.md`                                                                                   |
 | Environment variables and what they unlock     | `.env.example`                                                                                     |
 | Deploy configuration                           | `apps/api/vercel.json`; the `/ailk:setup-deploy` skill                                             |

package/templates/CONVENTIONS.md

@@ -196,8 +196,9 @@ move.
   cleanup goes in its own follow-up PR.
 - **Diff is the contract.** A 20-line behavioral change should produce
   a ~20-line diff. If your editor reformatted unrelated lines, revert
-  the formatting before committing. See
-  `.claude/rules/preserve-existing-style.md`.
+  the formatting before committing. Match the file's existing quotes,
+  indentation and import order, and check `git diff --stat` before you
+  commit.
 - **Commit message format:** `feat(area): description (#N)`. Include
   the issue number when one exists.
 - **Squash merge only.** Multiple commits on the branch are fine; the

package/templates/README.md

@@ -43,31 +43,32 @@ The pages of the Free `organization-product` shape, and where each one's copy li
 
 <!-- generated:begin content -->
 
-| Page                | Content file                                                                                                                                                        | Ships in                       |
-| ------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------ |
-| `/`                 | `content/en/HomePage/home.mdx`                                                                                                                                      | every scaffold                 |
-| `/features`         | `content/en/FeaturesList/features.mdx`                                                                                                                              | `--shape organization-product` |
-| `/features/[slug]`  | — (a code route)                                                                                                                                                    | `--shape organization-product` |
-| `/for`              | `content/en/UseCasesList/for.mdx`                                                                                                                                   | `--shape organization-product` |
-| `/for/[slug]`       | — (a code route)                                                                                                                                                    | `--shape organization-product` |
-| `/pricing`          | `content/en/Pricing/pricing.mdx`                                                                                                                                    | `--shape organization-product` |
-| `/about`            | `content/en/AboutPage/about.mdx`                                                                                                                                    | every scaffold                 |
-| `/faq`              | `content/en/FAQPage/faq.mdx`                                                                                                                                        | every scaffold                 |
-| `/contact`          | `content/en/ContactPage/contact.mdx`                                                                                                                                | every scaffold                 |
-| `/glossary`         | `content/en/GlossaryList/glossary.mdx`                                                                                                                              | `--shape organization-product` |
-| `/newsletter`       | `content/en/NewsletterSignup/newsletter.mdx`                                                                                                                        | `--shape organization-product` |
-| `/sign-in`          | — (a code route)                                                                                                                                                    | every scaffold                 |
-| `/sign-up`          | — (a code route)                                                                                                                                                    | every scaffold                 |
-| `/privacy`          | `content/en/PrivacyPage/privacy.mdx`                                                                                                                                | `--shape organization-product` |
-| `/terms`            | `content/en/TermsPage/terms.mdx`                                                                                                                                    | `--shape organization-product` |
-| `/purchase-policy`  | `content/en/PurchasePolicyPage/purchase-policy.mdx`                                                                                                                 | every scaffold                 |
-| `/blog`             | `content/en/BlogList/blog.mdx`                                                                                                                                      | every scaffold                 |
-| `/meet`             | `content/en/LandingPage/meet.mdx`                                                                                                                                   | every scaffold                 |
-| `/meet/[slug]`      | `content/en/BookCall/book-a-call.mdx`, `content/en/BookCall/onsite-estimate.mdx`, `content/en/BookCall/start-project.mdx`, `content/en/BookCall/onsite-service.mdx` | every scaffold                 |
-| `/portfolio`        | `content/en/PortfolioList/portfolio.mdx`                                                                                                                            | `--shape organization-product` |
-| `/portfolio/[slug]` | — (a code route)                                                                                                                                                    | `--shape organization-product` |
-| `/team`             | `content/en/TeamList/team.mdx`                                                                                                                                      | `--shape organization-product` |
-| `/team/[slug]`      | — (a code route)                                                                                                                                                    | `--shape organization-product` |
+| Page                 | Content file                                                                                                                                                        | Ships in                       |
+| -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------ |
+| `/`                  | `content/en/HomePage/home.mdx`                                                                                                                                      | every scaffold                 |
+| `/features`          | `content/en/FeaturesList/features.mdx`                                                                                                                              | `--shape organization-product` |
+| `/features/[slug]`   | — (a code route)                                                                                                                                                    | `--shape organization-product` |
+| `/for`               | `content/en/UseCasesList/for.mdx`                                                                                                                                   | `--shape organization-product` |
+| `/for/[slug]`        | — (a code route)                                                                                                                                                    | `--shape organization-product` |
+| `/pricing`           | `content/en/Pricing/pricing.mdx`                                                                                                                                    | `--shape organization-product` |
+| `/about`             | `content/en/AboutPage/about.mdx`                                                                                                                                    | every scaffold                 |
+| `/faq`               | `content/en/FAQPage/faq.mdx`                                                                                                                                        | every scaffold                 |
+| `/contact`           | `content/en/ContactPage/contact.mdx`                                                                                                                                | every scaffold                 |
+| `/glossary`          | `content/en/GlossaryList/glossary.mdx`                                                                                                                              | `--shape organization-product` |
+| `/newsletter`        | `content/en/NewsletterSignup/newsletter.mdx`                                                                                                                        | `--shape organization-product` |
+| `/sign-in`           | — (a code route)                                                                                                                                                    | every scaffold                 |
+| `/sign-up`           | — (a code route)                                                                                                                                                    | every scaffold                 |
+| `/privacy`           | `content/en/PrivacyPage/privacy.mdx`                                                                                                                                | `--shape organization-product` |
+| `/terms`             | `content/en/TermsPage/terms.mdx`                                                                                                                                    | `--shape organization-product` |
+| `/working-agreement` | `content/en/WorkingAgreementPage/working-agreement.mdx`                                                                                                             | `--shape organization-product` |
+| `/purchase-policy`   | `content/en/PurchasePolicyPage/purchase-policy.mdx`                                                                                                                 | every scaffold                 |
+| `/blog`              | `content/en/BlogList/blog.mdx`                                                                                                                                      | every scaffold                 |
+| `/meet`              | `content/en/LandingPage/meet.mdx`                                                                                                                                   | every scaffold                 |
+| `/meet/[slug]`       | `content/en/BookCall/book-a-call.mdx`, `content/en/BookCall/onsite-estimate.mdx`, `content/en/BookCall/start-project.mdx`, `content/en/BookCall/onsite-service.mdx` | every scaffold                 |
+| `/portfolio`         | `content/en/PortfolioList/portfolio.mdx`                                                                                                                            | `--shape organization-product` |
+| `/portfolio/[slug]`  | — (a code route)                                                                                                                                                    | `--shape organization-product` |
+| `/team`              | `content/en/TeamList/team.mdx`                                                                                                                                      | `--shape organization-product` |
+| `/team/[slug]`       | — (a code route)                                                                                                                                                    | `--shape organization-product` |
 
 <!-- generated:end -->
 

package/templates/_gitignore

@@ -0,0 +1,162 @@
+# Dependencies
+node_modules/
+
+# Build output
+dist/
+build/
+.next/
+*.tsbuildinfo
+
+# Turborepo local task cache
+.turbo/
+
+# Fumadocs MDX codegen output (generated by fumadocs-mdx/next at build time)
+apps/web/.source/
+apps-paid/marketing-web/.source/
+
+# Prisma generated client (regenerated via `pnpm db:generate`)
+database/generated/
+apps-paid/license-issuer/src/generated/
+
+# api-client generated types (regenerated via `pnpm codegen`, run at build time)
+packages/api-client/src/generated/
+
+# Environment files
+.env
+.env.local
+.env.*.local
+
+# Logs
+*.log
+npm-debug.log*
+pnpm-debug.log*
+
+# Editor / OS
+.DS_Store
+.vscode/
+.idea/
+
+# Test coverage
+coverage/
+
+# Coverage audit baseline output (tools/audit-coverage.ts; on-demand only)
+coverage-baseline-*.json
+
+# Stryker mutation testing — temp sandbox + per-run report output
+.stryker-tmp/
+**/reports/mutation/
+
+# Caches
+.eslintcache
+.cache/
+
+# Claude Code session state (worktree manager)
+.claude/worktrees/
+
+# AILK file-fallback inbox (OSS standalone mode; leads written here when DB unavailable)
+.ailk/
+
+# AILK license refresh-cached JWT (default storage path for @working-theory/license)
+.ailk-license.jwt
+
+# Lead capture JSONL store (contains customer contact data — never commit)
+apps/api/leads.jsonl
+apps/api/leads.jsonl.*
+
+# Build-time content manifest (generated by pnpm content:compile; not committed)
+content/.compiled/
+
+# Preflight success marker (written by pnpm preflight; read by require-preflight-on-push hook)
+.claude/.preflight-ok
+
+# Maintainer-only orchestration (Sam's /loop, dispatch, autonomy, babysit/cron skills).
+# These live on the maintainer's filesystem and are not part of the public template.
+.claude/rules/dispatch-defaults.md
+.claude/rules/parallel-agent-discipline.md
+.claude/rules/autonomy-ailk.md
+.claude/skills/babysit/
+.claude/skills/post-merge-sweeper/
+.claude/skills/pr-pruner/
+
+# Other ephemeral Claude Code state
+.claude/.continue-after-simplify-attempts
+.claude/.simplify-last-run
+.claude/.enforce-checkpoint-before-stop-attempts
+.claude/.worktree-root
+.claude/scheduled_tasks.lock
+.claude/logs/
+.claude/settings.local.json
+.claude/review-findings/
+
+# db:generate advisory lock dir (runtime-only; created/removed by database/scripts/db-generate-locked.sh)
+.claude/.db-generate.lock
+
+# Playwright MCP session artifacts (accessibility snapshots auto-created during browser_* runs)
+.playwright-mcp/
+
+# Saved Playwright login sessions the extract-*-from-reference skills write
+# (cookies for an auth-gated reference site). This file is also every
+# scaffold's .gitignore (build-templates.mjs SNAPSHOT_FILES), so a customer
+# never commits one either.
+brand_assets/.playwright-auth/
+
+# Visual-iteration scratch — directory tracked via .gitkeep, contents ignored
+screenshots/*
+!screenshots/.gitkeep
+
+# Content pipeline per-repo scratch (PAGE-COPY, site architecture files, etc.)
+# Collocated with repo for /copywriting and /compile-page skills. See claude-setup#423.
+strategy/
+# Allow versioned strategy docs in docs/internal/strategy/ (claude-setup#486)
+!docs/internal/strategy/
+# Allow the flat versioned strategy docs in docs/strategy/ (claude-setup#3424).
+# Kept out of the public OSS repo via project.yaml strip_for_oss.exclude_dirs.
+!docs/strategy/
+
+# Storybook build output
+storybook-static/
+
+# Playwright test-run bookkeeping (per-run status + failure artifacts) — never
+# committed; a local `pnpm visual:test` run previously left `.last-run.json`
+# and a per-failure `error-context.md` tracked in the repo (#6577).
+test-results/
+
+# Static export output — @working-theory/design-reference-gallery's build
+# artifact (the ailk-storybook hosting shape: a static tree served from a
+# protected origin). Rebuilt by `pnpm --filter @working-theory/design-reference-gallery build`.
+apps-paid/design-reference-gallery/out/
+
+# Vercel CLI local state — `vercel pull` writes project settings + a pulled
+# .env.<env>.local here, and `vercel build` writes the Build Output API tree.
+# The deploy workflow creates all of it at the repo root at run time (#4482).
+.vercel/
+
+# impeccable detect CLI pilot (epic #4501, issue #4511) — per-developer
+# override + ephemeral working state. .impeccable/config.json itself IS
+# committed (e.g. packages/ui/.impeccable/config.json) — only these are not.
+# Patterns are `**/`-prefixed since .impeccable/ lives under packages/ui, not
+# the repo root.
+**/.impeccable/config.local.json
+**/.impeccable/*.ndjson
+**/.impeccable/cache/
+**/.impeccable/hook.cache.json
+
+# Root-anchored scratch-artifact guard (#5179 / PUB-902, PUB-903, PUB-910).
+# Design-iteration screenshots and profiling dumps have no directory to live
+# under at the repository root, so nothing else stops them from recurring
+# there. The leading `/` anchors each pattern to the repo root only — images
+# tracked elsewhere (brand_assets/**, package public/ assets, visual-regression
+# baselines) are untouched. Bytecode caches are unwanted anywhere, so those two
+# patterns are unanchored.
+/*.png
+/*.jpeg
+/*.jpg
+__pycache__/
+*.pyc
+
+# e2e journey tests (.claude/skills/e2e): the running stack's state, logs and secrets, and each run's raw results
+tests/e2e/.stack/
+tests/e2e/.results/
+
+# create-ailk licence key file (`--license`, `ailk license set`) — owner-only, never committed
+ailk.key