b2c-app-builder 0.221.39

package/package.json

@@ -0,0 +1,290 @@
+{
+  "name": "b2c-app-builder",
+  "version": "0.221.39",
+  "description": "Brigade gives AI agents consumer-business primitives: capabilities, providers, recipes, and evidence through a CLI, MCP, and skill.",
+  "keywords": [
+    "mcp",
+    "startup",
+    "mobile",
+    "ios",
+    "app-store",
+    "launch",
+    "b2c",
+    "revenuecat",
+    "posthog"
+  ],
+  "homepage": "https://github.com/Clueless-Creations/b2c-app-builder#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Clueless-Creations/b2c-app-builder.git"
+  },
+  "bugs": {
+    "url": "https://github.com/Clueless-Creations/b2c-app-builder/issues"
+  },
+  "author": "Clueless Creations",
+  "license": "MIT",
+  "type": "module",
+  "engines": {
+    "node": ">=24"
+  },
+  "bin": {
+    "b2c": "entrypoints/cli/b2c.mjs",
+    "b2c-app-builder-mcp": "entrypoints/mcp/b2c-app-builder-mcp.mjs",
+    "b2c-app-builder": "entrypoints/mcp/b2c-app-builder-mcp.mjs"
+  },
+  "files": [
+    "SKILL.md",
+    "ACKNOWLEDGMENTS.md",
+    "THIRD_PARTY_NOTICES.md",
+    "skill-version.json",
+    "tsconfig.json",
+    "entrypoints",
+    "contracts",
+    "kernel",
+    "adapters",
+    "catalog",
+    "!**/.gradle/**",
+    "knowledge",
+    "tooling",
+    "dist",
+    "checks/validation",
+    "surfaces/starters",
+    "surfaces/ui-library",
+    "surfaces/workspace-template",
+    "agents/skills/b2c-research-opportunity",
+    "agents/skills/b2c-design-onboarding",
+    "agents/skills/b2c-review-monetization",
+    "agents/skills/b2c-define-product",
+    "agents/skills/b2c-plan-implementation",
+    "agents/skills/b2c-review-business-performance",
+    "agents/skills/b2c-review-experience",
+    "agents/skills/b2c-plan-launch",
+    "agents/skills/b2c-verify-release-readiness",
+    "surfaces/studio/seed/schema/business.empty.json",
+    "surfaces/studio/seed/schema/business.schema.json",
+    "!surfaces/studio/README.md",
+    "examples/workspace",
+    "examples/extensions",
+    "agents/skills/b2c-app-builder/references",
+    "agents/skills/b2c-research-opportunity",
+    "agents/skills/b2c-design-onboarding",
+    "agents/skills/b2c-review-monetization"
+  ],
+  "scripts": {
+    "app:check": "npm --prefix hosted/builder-console run check",
+    "app:deploy": "npm --prefix hosted/builder-console run deploy",
+    "app:deploy:prod": "npm --prefix hosted/builder-console run deploy -- --config wrangler.production.jsonc",
+    "app:provision-posthog": "tsx tooling/provision-posthog-platform.ts",
+    "app:prune-posthog": "tsx tooling/prune-posthog-persons.ts",
+    "audit": "tsx tooling/run-audit.ts",
+    "audit:ci": "tsx tooling/run-audit.ts --ci",
+    "audit:links": "tsx checks/validation/repository/audit-skill-links.ts --skill-root .",
+    "catalog:add-workflow": "tsx tooling/catalog-scaffold.ts add-workflow",
+    "catalog:render-routing": "tsx catalog/render-routing.ts",
+    "check:agent-entrypoints": "tsx checks/validation/repository/check-agent-entrypoints.ts --repo-root .",
+    "check:agent-evals": "tsx checks/validation/repository/run-agent-evals.ts",
+    "check:agent-operations": "tsx checks/validation/business/operations/check-agent-operations.ts",
+    "check:agent-roster": "tsx checks/validation/business/engineering/check-roster-overlap.ts",
+    "check:agent-roster-headless-safety": "tsx checks/validation/business/engineering/check-roster-headless-safety.ts",
+    "check:ai-provider-controls": "tsx checks/validation/business/trust/check-ai-provider-controls.ts",
+    "check:analytics-catalog": "tsx checks/validation/business/data/check-analytics-catalog.ts",
+    "check:app-archetype": "tsx checks/validation/business/product/check-app-archetype.ts",
+    "check:app-copy": "tsx checks/validation/business/words/check-app-copy.ts",
+    "check:app-review-contract": "tsx checks/validation/business/store/check-app-review-contract.ts",
+    "check:app-store-portfolio": "tsx checks/validation/business/store/check-app-store-portfolio.ts",
+    "check:app-store-portfolio-required": "tsx checks/validation/business/store/check-app-store-portfolio.ts --require-receipt",
+    "check:apple-release-readiness": "tsx checks/validation/business/store/check-apple-app-store-requirements.ts --require-signing-ready",
+    "check:apple-requirements": "tsx checks/validation/business/store/check-apple-app-store-requirements.ts",
+    "check:archetype-starter": "tsx checks/validation/business/engineering/check-archetype-starter.ts",
+    "check:architecture": "tsx checks/validation/repository/check-architecture.ts --repo-root .",
+    "check:artifact-templates": "tsx checks/validation/business/process/check-artifact-templates.ts",
+    "check:asc-command-contract": "tsx checks/validation/business/store/check-asc-command-contract.ts",
+    "check:aso-evidence": "tsx checks/validation/business/store/check-aso-evidence.ts",
+    "check:attribution": "tsx checks/validation/business/data/check-attribution-contract.ts",
+    "check:audience-identity": "tsx checks/validation/business/design/check-audience-identity.ts",
+    "check:autopilot": "tsx checks/validation/repository/check-autopilot-contract.ts",
+    "check:backend-contract": "tsx checks/validation/business/engineering/check-backend-data-contract.ts",
+    "check:browser-runtime-proof": "tsx checks/validation/business/design/check-browser-runtime-proof.ts",
+    "check:capability-delta": "tsx checks/validation/repository/check-capability-delta.ts",
+    "check:catalog": "tsx checks/validation/repository/check-catalog.ts",
+    "check:change-cascade": "tsx checks/validation/business/process/check-change-cascade.ts",
+    "check:component-contracts": "tsx checks/validation/business/design/check-component-contracts.ts --root .",
+    "check:compound-engineering": "tsx checks/validation/business/engineering/check-compound-engineering-routing.ts",
+    "check:content-assets": "tsx checks/validation/business/design/check-content-assets.ts",
+    "check:continuity-contract": "tsx checks/validation/business/orchestration/check-continuity-contract.ts --skill-root .",
+    "check:credits": "tsx tooling/render-credits.ts --check",
+    "check:design-acceptance": "tsx checks/validation/business/design/check-design-acceptance.ts",
+    "check:design-md": "tsx checks/validation/business/design/check-design-md.ts",
+    "check:design-room": "tsx checks/validation/business/design/check-design-room-contract.ts --root examples/workspace/business",
+    "check:design-worthiness": "tsx checks/validation/business/design/check-design-worthiness.ts",
+    "check:design-worthiness-mechanical": "tsx checks/validation/business/design/check-design-worthiness.ts --mechanical-only",
+    "check:documentation-ste100": "tsx checks/validation/business/engineering/check-technical-docs-ste100.ts",
+    "check:email": "tsx checks/validation/business/operations/check-email.ts",
+    "check:emotional-design": "tsx checks/validation/business/experience/check-emotional-design.ts",
+    "check:engine-e2e": "tsx checks/validation/repository/check-engine-e2e.ts",
+    "check:evidence-schema-drift": "tsx checks/validation/business/research/check-evidence-schema-drift.ts --skill-root .",
+    "check:founder-copy": "tsx checks/validation/business/words/check-founder-copy.ts",
+    "check:founder-operator": "tsx checks/validation/business/operations/check-founder-operator-bootstrap.ts",
+    "check:gates-layout": "tsx checks/validation/repository/check-gates-layout.ts --skill-root .",
+    "check:generated-pages": "tsx checks/validation/business/process/check-generated-pages.ts",
+    "check:graph-foundations": "tsx checks/validation/repository/check-graph-foundations.ts --skill-root .",
+    "check:hosted-bundle": "tsx tooling/render-hosted-bundle.ts --check",
+    "check:hub-spoke": "tsx checks/validation/repository/check-hub-spoke.ts",
+    "check:landing-funnel": "tsx checks/validation/business/growth/check-landing-funnel.ts",
+    "check:lane-coverage": "tsx checks/validation/business/process/check-lane-coverage.ts",
+    "check:learning-grounding": "tsx checks/validation/repository/check-learning-grounding.ts --skill-root .",
+    "check:localization-research": "tsx checks/validation/business/research/check-localization-research.ts",
+    "check:mobai-proof": "tsx checks/validation/business/engineering/check-mobai-proof.ts",
+    "check:mobai-proof-workflow": "tsx checks/validation/business/engineering/check-mobai-proof.ts --proof-workflow",
+    "check:motion-contract": "tsx checks/validation/business/design/check-motion-contract.ts",
+    "check:native-android": "tsx checks/validation/business/engineering/check-native-android-proof.ts",
+    "check:native-ios": "tsx checks/validation/business/engineering/check-native-ios-proof.ts",
+    "check:no-slop": "tsx checks/validation/business/words/check-no-slop.ts",
+    "check:onboarding-cutover-repository": "tsx checks/validation/business/experience/check-onboarding-cutover-repository.ts",
+    "check:onboarding-cutover-repository-complete": "tsx checks/validation/business/experience/check-onboarding-cutover-repository.ts --require-resolved",
+    "check:onboarding-evidence-onb-00": "tsx checks/validation/business/experience/check-onboarding-evidence-packet.ts --node ONB-00 --path product/onboarding/graph/ONB-00-resume-scope.md",
+    "check:onboarding-evidence-onb-01": "tsx checks/validation/business/experience/check-onboarding-evidence-packet.ts --node ONB-01 --path product/onboarding/graph/ONB-01-current-state-trace.md",
+    "check:onboarding-evidence-onb-02": "tsx checks/validation/business/experience/check-onboarding-evidence-packet.ts --node ONB-02 --path product/onboarding/graph/ONB-02-evidence-plan.md",
+    "check:onboarding-evidence-onb-03": "tsx checks/validation/business/experience/check-onboarding-evidence-packet.ts --node ONB-03 --path product/onboarding/graph/ONB-03-current-guidance.md",
+    "check:onboarding-evidence-onb-04": "tsx checks/validation/business/experience/check-onboarding-evidence-packet.ts --node ONB-04 --path product/onboarding/graph/ONB-04-competitor-reviews.md",
+    "check:onboarding-evidence-onb-05": "tsx checks/validation/business/experience/check-onboarding-evidence-packet.ts --node ONB-05 --path product/onboarding/graph/ONB-05-onbo-hub-atlas.md",
+    "check:onboarding-evidence-onb-06": "tsx checks/validation/business/experience/check-onboarding-evidence-packet.ts --node ONB-06 --path product/onboarding/graph/ONB-06-internal-guidance-audit.md",
+    "check:onboarding-evidence-onb-07": "tsx checks/validation/business/experience/check-onboarding-evidence-packet.ts --node ONB-07 --path product/onboarding/graph/ONB-07-provider-policy-landscape.md",
+    "check:onboarding-evidence-onb-08": "tsx checks/validation/business/experience/check-onboarding-evidence-packet.ts --node ONB-08 --path product/onboarding/graph/ONB-08-motion-research.md",
+    "check:onboarding-evidence-onb-09": "tsx checks/validation/business/experience/check-onboarding-evidence-packet.ts --node ONB-09 --path product/onboarding/graph/ONB-09-evidence-join.md",
+    "check:onboarding-evidence-onb-10": "tsx checks/validation/business/experience/check-onboarding-evidence-packet.ts --node ONB-10 --path product/onboarding/graph/ONB-10-first-value-activation.md",
+    "check:onboarding-evidence-onb-11": "tsx checks/validation/business/experience/check-onboarding-evidence-packet.ts --node ONB-11 --path product/onboarding/graph/ONB-11-effort-question-audit.md",
+    "check:onboarding-evidence-onb-12": "tsx checks/validation/business/experience/check-onboarding-evidence-packet.ts --node ONB-12 --path product/onboarding/graph/ONB-12-state-identity-contract.md",
+    "check:onboarding-evidence-onb-13": "tsx checks/validation/business/experience/check-onboarding-evidence-packet.ts --node ONB-13 --path product/onboarding/graph/ONB-13-analytics-experiments.md",
+    "check:onboarding-evidence-onb-14": "tsx checks/validation/business/experience/check-onboarding-evidence-packet.ts --node ONB-14 --path product/onboarding/graph/ONB-14-trust-lifecycle-policy.md",
+    "check:onboarding-evidence-onb-15": "tsx checks/validation/business/experience/check-onboarding-evidence-packet.ts --node ONB-15 --path product/onboarding/graph/ONB-15-architecture-decision.md",
+    "check:onboarding-evidence-onb-16": "tsx checks/validation/business/experience/check-onboarding-evidence-packet.ts --node ONB-16 --path product/onboarding/graph/ONB-16-journey-graph.md",
+    "check:onboarding-evidence-onb-17": "tsx checks/validation/business/experience/check-onboarding-evidence-packet.ts --node ONB-17 --path product/onboarding/graph/ONB-17-screen-control-paywall-contract.md",
+    "check:onboarding-evidence-onb-18": "tsx checks/validation/business/experience/check-onboarding-evidence-packet.ts --node ONB-18 --path product/onboarding/graph/ONB-18-visual-design-prototype.md",
+    "check:onboarding-evidence-onb-19": "tsx checks/validation/business/experience/check-onboarding-evidence-packet.ts --node ONB-19 --path product/onboarding/graph/ONB-19-implementation-cutover-contract.md",
+    "check:onboarding-evidence-onb-20": "tsx checks/validation/business/experience/check-onboarding-evidence-packet.ts --node ONB-20 --path product/onboarding/graph/ONB-20-adversarial-qa.md",
+    "check:onboarding-evidence-onb-21": "tsx checks/validation/business/experience/check-onboarding-evidence-packet.ts --node ONB-21 --path product/onboarding/graph/ONB-21-compound-engineering-plan.md",
+    "check:onboarding-foundations-identity": "tsx checks/validation/business/experience/check-onboarding-foundations.ts --stage identity",
+    "check:onboarding-foundations-measurement": "tsx checks/validation/business/experience/check-onboarding-foundations.ts --stage measurement",
+    "check:onboarding-foundations-prototype": "tsx checks/validation/business/experience/check-onboarding-foundations.ts --stage prototype",
+    "check:onboarding-foundations-research": "tsx checks/validation/business/experience/check-onboarding-foundations.ts --stage research",
+    "check:onboarding-foundations-runtime": "tsx checks/validation/business/experience/check-onboarding-foundations.ts --stage runtime",
+    "check:onboarding-graph": "tsx checks/validation/business/experience/check-onboarding-graph.ts",
+    "check:onboarding-graph-complete": "tsx checks/validation/business/experience/check-onboarding-graph.ts --require-done",
+    "check:onboarding-page-fresh": "tsx checks/validation/business/process/check-generated-pages.ts --page product/onboarding.html",
+    "check:operating-graph": "tsx checks/validation/repository/check-operating-graph.ts --skill-root .",
+    "check:orchestration": "tsx checks/validation/business/orchestration/check-parallel-orchestration.ts",
+    "check:pack-composition": "tsx checks/validation/repository/check-pack-composition.ts --skill-root .",
+    "check:package-parity": "tsx checks/validation/repository/check-package-parity.ts --repo-root . --skill-root .",
+    "check:paid-tool-intake": "tsx checks/validation/business/operations/check-paid-tool-intake.ts",
+    "check:paid-tool-intake-required": "tsx checks/validation/business/operations/check-paid-tool-intake.ts --require-intake",
+    "check:paid-ua": "tsx checks/validation/business/growth/check-paid-user-acquisition.ts",
+    "check:portfolio-registry": "tsx checks/validation/business/operations/check-portfolio-registry.ts",
+    "check:post-launch": "tsx checks/validation/business/operations/check-post-launch-ops.ts",
+    "check:price-derivation": "tsx checks/validation/business/money/check-price-derivation.ts",
+    "check:privacy": "tsx checks/validation/business/trust/check-privacy-terms.ts",
+    "check:product-md": "tsx checks/validation/business/product/check-product-md.ts --root examples/workspace/business",
+    "check:provider-contracts": "tsx checks/validation/repository/check-provider-contracts.ts",
+    "check:provider-proof": "tsx checks/validation/business/process/check-live-provider-proof.ts",
+    "check:provider-proof-onboarding": "tsx checks/validation/business/process/check-live-provider-proof.ts --providers PostHog,RevenueCat",
+    "check:public-api": "tsx tooling/render-public-api.ts --check",
+    "check:readiness-coverage": "tsx checks/validation/business/engineering/check-readiness-coverage.ts",
+    "check:reference-size": "tsx checks/validation/repository/check-reference-size.ts",
+    "check:repository-boundary": "tsx checks/validation/repository/check-repository-boundary.ts --repo-root .",
+    "check:repository-profile": "tsx checks/validation/business/process/check-repository-profile.ts",
+    "check:research": "tsx checks/validation/business/research/check-research-evidence.ts",
+    "check:research-workflow-output": "tsx checks/validation/business/research/check-research-evidence.ts --require-workflow-outputs",
+    "check:revenue": "tsx checks/validation/business/money/check-revenue.ts",
+    "check:scrollytelling": "tsx checks/validation/business/design/check-scrollytelling-contract.ts",
+    "check:secrets": "tsx checks/validation/business/trust/check-secret-routing.ts",
+    "check:security": "tsx checks/validation/business/trust/check-security-release.ts",
+    "check:skill-supply-chain": "tsx checks/validation/repository/check-skill-supply-chain.ts --skill-root .",
+    "check:skill-version": "tsx checks/validation/repository/check-skill-version.ts",
+    "check:source-checkpoint": "tsx checks/validation/business/engineering/check-source-checkpoint.ts",
+    "check:source-freshness": "tsx checks/validation/repository/check-source-freshness.ts",
+    "check:store-console": "tsx checks/validation/business/store/check-store-console-packet.ts",
+    "check:store-screenshots": "tsx checks/validation/business/store/check-store-screenshots.ts",
+    "check:template-safety": "tsx checks/validation/business/engineering/check-template-safety.ts",
+    "check:token-promotion": "tsx checks/validation/business/design/check-token-promotion.ts",
+    "check:upstreams": "tsx checks/validation/repository/check-upstreams.ts --skill-root .",
+    "check:validator-docs": "tsx checks/validation/repository/check-validator-docs.ts --repo-root .",
+    "check:version-discipline": "tsx checks/validation/repository/check-version-discipline.ts",
+    "check:vibecoded-tells": "tsx checks/validation/business/design/check-vibecoded-tells.ts",
+    "evals:behavioral": "tsx checks/validation/repository/run-behavioral-evals.ts",
+    "format": "prettier --write \"catalog/**/*.ts\" \"checks/validation/business/**/*.ts\" \"checks/validation/repository/**/*.ts\" \"tooling/**/*.ts\"",
+    "grade:design": "tsx tooling/grade-design-surface.ts",
+    "grade:screenshots": "tsx tooling/grade-screenshots.ts",
+    "hosted:bundle": "tsx tooling/render-hosted-bundle.ts",
+    "hosted:version": "tsx tooling/print-hosted-version.ts",
+    "hosted:check": "npm --prefix hosted/knowledge-mcp run check",
+    "hosted:deploy": "npm --prefix hosted/knowledge-mcp run deploy",
+    "hosted:deploy:prod": "npm --prefix hosted/knowledge-mcp run deploy -- --config wrangler.production.jsonc",
+    "install:control-permissions": "tsx adapters/install-control-permissions.ts",
+    "knowledge:add": "tsx tooling/knowledge.ts add",
+    "knowledge:capture": "tsx tooling/knowledge.ts capture",
+    "knowledge:check": "tsx tooling/knowledge.ts check",
+    "knowledge:promote": "tsx tooling/knowledge.ts promote",
+    "knowledge:refresh": "tsx tooling/knowledge.ts refresh",
+    "launchbench": "tsx checks/validation/repository/run-launchbench.ts",
+    "launchbench:lint": "tsx checks/validation/repository/run-launchbench.ts --lint-only",
+    "lint:format": "prettier --check \"catalog/**/*.ts\" \"checks/validation/business/**/*.ts\" \"checks/validation/repository/**/*.ts\" \"tooling/**/*.ts\"",
+    "onboard:run": "tsx kernel/session/onboard.ts",
+    "plan:frontier": "tsx kernel/session/plan.ts",
+    "probe:posthog": "tsx tooling/probe-posthog.ts",
+    "probe:revenuecat": "tsx tooling/probe-revenuecat.ts",
+    "probe:revenuecat-cli": "tsx tooling/probe-revenuecat-cli.ts",
+    "probe:eas": "tsx tooling/probe-eas.ts",
+    "promote:design-tokens": "tsx tooling/promote-design-tokens.ts",
+    "refresh:source-freshness": "tsx checks/validation/repository/check-source-freshness.ts --write-discovered && tsx checks/validation/repository/refresh-source-freshness.ts --knowledge-pin-root .",
+    "render:all": "npm run catalog:render-routing && npm run render:task-skills && npm run hosted:bundle && npm run render:public-api && npm run render:credits",
+    "render:artifact-pages": "tsx tooling/render-artifact-pages.ts",
+    "render:credits": "tsx tooling/render-credits.ts",
+    "render:design-room": "tsx tooling/render-design-room.ts",
+    "render:evidence-schema-version": "tsx kernel/schema/evidence-schema-version.ts --skill-root .",
+    "render:product": "tsx tooling/render-product.ts",
+    "render:public-api": "tsx tooling/render-public-api.ts",
+    "report:research-evidence-failures": "tsx tooling/report-research-evidence-failures.ts",
+    "routing:calibrate": "tsx tooling/calibrate-utterance-router.ts",
+    "runtime:check": "tsx tooling/runtime-sync.ts check --source .",
+    "runtime:sync": "tsx tooling/runtime-sync.ts sync --source .",
+    "scope:set": "tsx kernel/session/scope.ts",
+    "seed:design-brief": "tsx tooling/seed-design-brief.ts",
+    "session:bootstrap": "tsx kernel/session/bootstrap.ts",
+    "setup": "npm link && node entrypoints/cli/b2c.mjs setup",
+    "test:boundaries": "tsx checks/verification/boundaries/run.ts",
+    "test:fixtures": "tsx checks/verification/fixtures/run.ts",
+    "test:parity": "tsx checks/verification/parity/run.ts",
+    "test:public-api": "tsx tooling/test-public-api.ts",
+    "test:validators": "tsx checks/validation/repository/run-validator-fixtures.ts",
+    "build": "tsc -p tsconfig.build.json && node tooling/copy-runtime-assets.mjs",
+    "prepack": "npm run build",
+    "typecheck": "tsc --noEmit",
+    "validate:design-state": "tsx checks/validation/business/design/validate-state.ts",
+    "validate:launch-state": "tsx checks/validation/business/orchestration/validate-project-state.ts",
+    "validate:skill": "f=\"$HOME/.codex/skills/.system/skill-creator/scripts/quick_validate.py\"; if [ -f \"$f\" ]; then uv run --with pyyaml python \"$f\" .; else echo 'skill-creator quick_validate not installed; skipping maintainer-only skill lint (expected outside the author machine)'; fi",
+    "verify:node": "tsx kernel/session/verify.ts",
+    "check:design-foundation": "tsx checks/validation/business/design/check-design-md.ts --require-foundation",
+    "check:content-assets-foundation": "tsx checks/validation/business/design/check-content-assets.ts --require-foundation",
+    "test:browser-proof-chrome": "tsx checks/verification/fixtures/browser-proof.chrome-smoke.ts",
+    "render:task-skills": "tsx tooling/render-task-skills.ts",
+    "skills:export": "tsx tooling/export-task-skill.ts",
+    "check:task-skills": "tsx checks/validation/repository/check-task-skills.ts"
+  },
+  "dependencies": {
+    "@babel/parser": "8.0.4",
+    "@google/design.md": "0.4.0",
+    "@mdx-js/mdx": "3.1.1",
+    "@modelcontextprotocol/sdk": "^1.30.0",
+    "ajv": "^8.20.0",
+    "mdast-util-from-markdown": "2.0.3",
+    "yaml": "^2.6.1",
+    "zod": "^4.5.4"
+  },
+  "devDependencies": {
+    "@anthropic-ai/sdk": "0.124.0",
+    "@types/node": "^26.4.1",
+    "prettier": "^3.9.6",
+    "tsx": "^4.23.13",
+    "typescript": "7.0.2"
+  }
+}

package/skill-version.json

@@ -0,0 +1,149 @@
+{
+  "skill": "b2c-app-builder",
+  "version": "0.221.39",
+  "updatedAt": "2026-09-19",
+  "sourcePath": ".",
+  "releaseNotes": [
+    "Add #519 SQ-08 provenance-bound semantic relationships as derived graph views: narrow ontology predicates (sameEntityAs / reportsSameFailureAs / usesSameMechanismAs / evidence); candidate edges with endpoint versions, predicate version, context digest, evidence spans, receipt refs, policy outcome, validity reason; asserted vs inferred separation; distinct type/support/sufficiency dimensions; bounded no-network queries; rebuildable indexes (no graph DB / no auto merges); cross-workspace denial; #520 deletion/invalidation hook declarations only; fixtures prove all five AC; consumes #512\u2013#518; stamp 0.221.39 + hosted:bundle; STOP after close \u2192 #520 separate.",
+    "Add #518 SQ-07 shared-state batches / speculative assessments / bounded map-reduce: group by snapshot/policy/binding/limits (no cross-workspace); spend reservations with hard bounds + estimated/unknown cost; speculative assessment-only with consumed/unused branch recording; keyed map + deterministic reduce with partial-shard honesty; reuse request/occurrence/attempt/ownership (cancel settles before lock release; reject late after ownership/revision change); barrier fixtures via fake sync transport on session/reducer/dispatch path prove all five AC; consumes #512\u2013#517; stamp 0.221.38 + hosted:bundle; STOP after close \u2192 #519 separate.",
+    "Add #517 SQ-06 scoped source projections + measured candidate generation: registered selectors (reject escape/cross-workspace); immutable projections with spans/provenance/coverage/omissions + redaction before dispatch/diagnostics; exact-key/authored-binding/bounded-rule candidates (no embeddings); separate predicates; pinned integrity (stale/missing\u2192unresolved); case-level missed-candidate reporting; fixtures prove all five AC; consumes #512\u2013#516; stamp 0.221.37 + hosted:bundle; STOP after close \u2192 #518 separate.",
+    "Add #516 SQ-05 composition-compiler semantic plan lowering (compile-pure): validate I/O types/paths/digests/provider coverage/acyclicity/bounds/effect prereqs; stage-coalesce data vs result-use vs authority/resource (four independent branches \u2192 one assessment stage; data-dep second stage retained; unauthorized never speculative-shared); stable IDs + plan digest + pure explain (estimates \u2260 observed latency/spend); bounded semantics-preserving local opts; lower to current run/occurrence machinery (no new graph engine); recipe policy owns weights/thresholds; fixtures prove all five AC; consumes #512+#513+#514+#515; stamp 0.221.36 + hosted:bundle; STOP after close \u2192 #517 separate.",
+    "Add #514 SQ-03 semantic-execution baselines + held-out decision-quality (paper; no live): three comparison arms (deterministic route/retrieval \u00b7 agent-driven \u00b7 semantic candidate) with equivalent-evidence discipline; held-out fixture classes + predeclared admission thresholds; separated decision-quality metrics + per-case traces; honesty gates (wrong high-confidence fails; cannot drop hard/unknown; report limits; no-change/reject TypeSafe OK); metamorphic rename/order \u00b7 contradiction \u00b7 duplication\u2260corroboration; cheap ultrafast fold = eval-plan doc + non-live indexed-element fixtures (cite browser-use/jev-ultrafast + jev-ops note 12); consumes #512+#513+#515; reuses #73/#75; no live browser/provider/iOS-sim/creds; stamp 0.221.35 + hosted:bundle; STOP after close \u2192 HoE next #511 child.",
+    "Add #515 SQ-04 TypeSafe adapter: support declaration + SQ-01 encode/decode + thin-direct-http transport with host effects, selected-binding coverage (coordinates #109), official-source conformance fixtures separate from fake-transport wiring, fail-closed failure modes, distinct unselected/unconfigured/unavailable, passive zero-inference, live-not-performed; consumes #512+#513; no live/creds; STOP after close \u2192 interactive proof separate.",
+    "Add #513 SQ-02 TypeSafe/Jev paper qualification: upstream identity (catalog/upstreams/typesafe-ai) with MIT SDK notice + unreviewed service terms, native Choice/Score/Noul\u2192SQ-01 mapping matrix with implement/defer/reject dispositions, independent official-doc fixtures, Eduardo local wiring recipe (docs.typesafe.ai + jev-ops pointers; env names only; confirm-without-print); live-not-performed; no Brigade SDK install; no #515 adapter; no invent credentials; STOP\u2192#515 separate.",
+    "Add #512 SQ-01 provider-boundary semantic contracts: Choice/Score/Noul question union with first-class failure outcomes, question-pack, initial query IR slice (reserved operators types-only), plan identity canonicalization, inference and policy-application receipts (unknown cost \u2260 zero; receipts \u2260 proof/truth/authority/tool), external-package semantic resource declaration without kernel privileges; contracts-only \u2014 no network, credentials, adapter, or public-command activation.",
+    "Add greenfield #72 Path A paper closeout: AC\u2192evidence map for Acceptance+report-contract+execution-recipe+comment-holds+Path-A honesty (live/publish/measured not performed; protocol\u2260completion; fixtures\u2260live; deliveryAccepted\u2260submitted\u2260released\u2260live; #73/#75 Stage B still held; #511 PARKED), thin closeout fixtures (U4 DONE; next=#511 PARKED; no Stage B unlock; prior U4 consume-only), protocol honesty refresh; fixture-tier only \u2014 no live/publish/measured, no Stage B unlock, no #66\u2013#76 redo, no #511 start.",
+    "Add greenfield #76 Required-scenario matrix closeout: AC\u2192evidence map for Acceptance+Required-scenarios+live holds, residual business-change-impact fixture rows (price/entitlement; shipping-platform; source-correction-vs-one-claim; source-metadata/URL; four proof layers), thin closeout fixtures (sequence lock #72 last; no parallel dependency DB/second graph; expected-IDs; coordinate-don't-steal #38/#68/#107/#117/#395/#397/#403/#127; live=#72), STOP\u2192#72; fixture-tier only \u2014 no live/#72 jump, no #66/#70/#71/#73/#75 redo, no sibling impl.",
+    "Add greenfield #75 Stage A no-change closeout: AC\u2192evidence map for Acceptance+Stage A/B, protocol/fixture Leave-#75-open\u2192closed-on-Stage-A-no-change (paid Stage B held; live/publish/measured interval\u2192#72), thin closeout fixtures (sequence lock #76\u2192#72; no vector/embeddings/graph; coordinate-don't-steal #378/#392/#395/#397/#403/#127/#39/#40; judgment=#75; live=#72), STOP\u2192#76; fixture-tier only \u2014 no live/#72, no paid Stage B, no #66/#70/#71/#73 redo, no sibling impl.",
+    "Add greenfield #73 Stage A retain closeout: AC\u2192evidence map for Acceptance+Stage A/B, protocol/fixture Leave-#73-open\u2192closed-on-Stage-A-retain (Stage B/measured interval held\u2192#72), thin closeout fixtures (sequence lock #75\u2192#76\u2192#72; no fake consolidation; coordinate-don't-steal #75/#403/#395/#397/#127; #38 Apple media keep), STOP\u2192#75; fixture-tier only \u2014 no live/#72, no Stage B merge, no #66/#70/#71 redo, no sibling impl.",
+    "Add greenfield #71 handoff/stop-lines closeout: AC\u2192evidence map for Verification+boundary+Sept-12 catalog matrix, core handoff matrix fixtures (sequence lock #73\u2192#75\u2192#76\u2192#72; live/#72/#75 holds; coordinate-don't-steal #395/#397/#402\u2013#405/#403/#127; stop-line honesty; catalog fail-closed consume; handoff\u2260second planner), STOP\u2192#73; fixture-tier only \u2014 no live/#72, no sibling impl, no #66/#70 redo, no second planner.",
+    "Add greenfield #70 applicability closeout: AC\u2192evidence map for matrix+Verification rows, fresh-context Quiet Receipt finding re-score (clear stale privacy-copy/19px-nav/48px-plate leftovers vs tip HTML), #403 quality-bar coordinate (ladder not stolen), STOP\u2192#71; fixture-tier only \u2014 no live/#72, no sibling impl, no #66 redo, no #108 reopen.",
+    "Add greenfield #66 delivery-audit framework: residual map + U4 sequence lock (#70\u2192#71\u2192#73\u2192#75\u2192#76\u2192#72 last; skip #74), three-pillar honesty (intent\u2260docs-padding; overhead measurable/Stage-A retain; e2e proof-class \u2260 fixture/screenshot/protocol-alone), boundary/fail-safe holds (no liveLaunchProven from synthetic; live\u2192#72; no sibling shotgun; umbrella close \u2260 children close; no U5/#511). Deterministic fixtures only \u2014 no live benchmark, no workflow consolidation, no sibling impl.",
+    "Add growth-agent #116 canonical-operation inventory/classification, adapter-boundary seams, Layers+#24-Postiz+PostHog-upstream fixture provenance, knowledge\u2260execution and discovery\u2260auto-expand fixtures (no live publish/experiment/customer-query/sign-in; no invented analytics executor; no generic MCP registry/second store; #24 ADR-0013 reconcile only; audit bucket COMPLETE \u2192 U4 separate).",
+    "Add mobile-ops #115 canonical-operation inventory/classification, adapter-boundary seams, host-native+#87+MobAI-1.9.3 fixture provenance, uncertain/no-silent-fallback and Expo non-auto-expand fixtures (no live device/MCP; MobAI DeviceProofAdapter not MOT; no second router; never #116).",
+    "Add Superwall #114 canonical-operation inventory/classification, adapter-boundary seams, 4.16.3 fixture provenance, fail-safe drift/delegation/offline fixtures, and honest catalog/upstream holds (no live campaign/account connect; presentation\u2260purchase\u2260entitlement; #67/#107 + RC owners; never #115\u2013#116).",
+    "Add Apple ASC #113 canonical-operation inventory/classification, adapter-boundary seams, 5.1.0 fixture provenance, and uncertain-execution resume-verify/fail-closed fixtures (no live sandbox/submit/release; #38/#23/#60\u2013#62 owners; never #114\u2013#116).",
+    "Add Expo #88 proof-matrix collection, cross-platform quality evidence, observability contracts, SDK upgrade dry-run, and complete-business disposition models (no live matrix/Observe/upgrade/#72; never closes #80).",
+    "Add Expo #87 skills/MCP dry-run models: discovery\u2260install, fake-schema route, device-proof bind, privacy disclosure, schema-drift refuse (no live MCP/device; host-native preferred).",
+    "Add Expo #86 web surface table, API route contracts, production origin/canary fail-closed, hosting dry-run + alternate-host holds (no live hosting; alpha SSR held; web\u2260native).",
+    "Add Expo #85 update lifecycle dry-run contracts, identity/rollout/recovery/signing holds, and fixture-tested eas-update selection (no live OTA; production hard-held).",
+    "Add Expo #84 EAS operation matrix, signing-readiness refuse paths, and dry-run/CI holds (no paid cloud, no credential write, no live submit).",
+    "Add Expo #83 capability matrix and RevenueCat custom-dev-client wiring holds (local-session bar; IdP/native-IAP/spend held; no live EAS).",
+    "Refresh Expo #81 knowledge review dates and reaffirm researched SDK 57 version-fact baselines.",
+    "Keep paid-tool holds from being recovered by asking to install recurring sessions.",
+    "Bind schedule apply to the exact dry-run effect so cadence changes cannot reuse a stale receipt.",
+    "Return schedule install outcomes from the mutation lock for typecheck.",
+    "Skip duplicate schedule writes when exact cron or launchd readback already matches.",
+    "Project research proof distinctions into planning resume so structural offer presence stays unmeasured demand.",
+    "Keep unanswered schedule scope soft in public plan even when a later install approval already exists on the node.",
+    "Reject trailing text on absent-crontab diagnostics so compound stderr stays fail-closed.",
+    "Fail closed on unverified crontab reads before schedule mutation and during installed-state readback.",
+    "Preserve unrelated scheduled jobs and refuse to certify removal when the host crontab cannot be read back.",
+    "Preserve hyphenated product-offer compounds without accepting hyphenated evidence-field instructions.",
+    "Reject direct instructions to fill evidence fields while retaining genuine signup actions and measured form-completion prose.",
+    "Assert the canonical derived-output diagnostic when a schema-valid empty corpus output is rendered as a template.",
+    "Keep explicit replacement/fill instructions incomplete, including polite forms, while preserving quoted TBD evidence.",
+    "Apply whole-cell placeholder semantics to offer labels and cover contract, decision, measurement, and waiver validators.",
+    "Locate the first invalid research field and conflicting duplicate signal identity without hiding authored uncertainty.",
+    "Reject labeled placeholder instructions and align golden evidence and design fixtures with current acceptance contracts.",
+    "Preserve authored offer-test uncertainty while rejecting placeholder-only contract, decision, measurement, and waiver fields.",
+    "Ignore Gradle caches in Expo starter app gitignore templates and recursive repo ignore rules.",
+    "Exclude Expo starter Android Gradle caches from packages, path lists, and scaffolds.",
+    "Require current scheduled-autonomy founder approval before any schedule host mutation.",
+    "Add authored row locations and bounded repair hints for offer-test contract, decision, and measurement failures.",
+    "Preserve mismatched catalog refusals across CLI and local MCP business-plan routes.",
+    "Prove schedule install and uninstall dry-runs leave the workspace untouched.",
+    "Recover a research decision cleanly when interruption occurs after its journal is written.",
+    "Refuse initialized catalogs whose version disagrees with the installed runtime pin.",
+    "Preserve initialized catalog refusals through the local MCP business-plan route.",
+    "Refuse missing initialized catalogs without falling back to fresh planning.",
+    "Keep explicit Kill research checkpoints held without silently restarting or becoming Go.",
+    "Refuse corrupt initialized catalogs without falling back to fresh planning.",
+    "Exercise the public research explanation contract without mutating a planning workspace.",
+    "Require exact launchd plist readback so concurrent target and cadence edits fail closed.",
+    "Serialize launchd schedule apply and removal behind the shared host-mutation lock.",
+    "Recover a research decision cleanly when interruption occurs after the rendered product artifact is written.",
+    "Protect the canonical writing guidance in pull-request review surfaces.",
+    "Reject malformed and conflicting Superwall-to-RevenueCat amount observations without claiming live provider proof.",
+    "Exercise runtime synchronization across Claude, Codex, Agents, and Cursor client roots.",
+    "Protect the three builder writing-owner routes in the agent entrypoint contract.",
+    "Regenerate package projections after keeping quoted research-source placeholder language as evidence narrative.",
+    "Hold changed non-idempotent effects for explicit readback before repair and preserve unrelated proof on replay.",
+    "Preserve unrelated third-party edits when recovering an interrupted research decision.",
+    "Add a source-line location and bounded repair hint when a not-applicable Signal Corpus reason is missing.",
+    "Refresh live-main task-skill host-discovery evidence while keeping Claude quota and integrated distribution holds explicit.",
+    "Keep research diagnostics bounded when invalid signal records contain hostile instruction-like or secret-like content.",
+    "Reject an explicitly unrun offer test as incomplete instead of allowing it to satisfy the run-or-waived decision contract.",
+    "Prove an activated provider binding reopens only its affected obligations while pinned and unrelated proof remain current.",
+    "Reject cosmetic design variants that reuse one underlying mechanic instead of proving distinct directions.",
+    "Expose the enforced research artifact contract through a bounded read-only explanation without initializing or certifying research.",
+    "Bind worker knowledge receipts to the dispatcher engine version and reject stale worker protocol results.",
+    "Keep unresolved scheduling intent at the founder boundary while independent design work remains available for dispatch.",
+    "Report configured cross-client engine-version mismatches without changing capability-based local versus hosted routing.",
+    "Verify the packed runtime contains every canonical task skill and required root procedure without leaking maintainer, contributor, or environment files.",
+    "Record the reproducible ten-case A0 baseline versus current candidate guidance replay while preserving the live Astra evidence hold.",
+    "Reject duplicate research finding IDs before decision preview or apply writes any product artifact.",
+    "Name the first invalid Derived Outputs, Transformation Demo, or Distribution-First Niche field in bounded research diagnostics.",
+    "Keep scheduled wrappers on the canonical workspace catalog compatibility guard before spawning any worker runtime.",
+    "Make rendered Design Room exploration prove reference access, inspection, tangible draft, critique, revision, chosen target, and runtime comparison.",
+    "Verify schedule install and uninstall preserve another workspace's managed entry while changing only the selected workspace.",
+    "Name the first invalid Corpus Inputs or Signal Records field in bounded research diagnostics.",
+    "Reject research-decision apply when the reviewed finding artifact changes after preview, before any product write.",
+    "Verify remote-effect uncertainty survives fresh-process resume without duplicating the effect or reopening the frontier.",
+    "Verify unselected scheduling stays parked across resume while explicit selection reaches only the approved effect boundary.",
+    "Bound receipt-only repair to one continuation while preserving unaccepted candidate output provenance.",
+    "Verify an approved full-launch mandate survives persisted run-state reload and re-enters without duplicate approval records.",
+    "Prove that a protected authority hold leaves unrelated permitted frontier work visible and dispatchable.",
+    "Extend the system-domain authority regression across protected effect classes and provider-bearing mutations.",
+    "Exercise malformed receipt transport followed by a candidate-mutating repair and preserve the original candidate snapshot as rejected evidence.",
+    "Preserve the original unaccepted candidate provenance when receipt-only repair mutates output bytes, forcing real rework instead of losing reconciliation state.",
+    "Serialize real cron schedule mutations with a user-level lock and fail clearly when another installer owns the lock.",
+    "Add authored row locations and bounded repair hints for Go, Pivot, Or Kill and Derived Outputs failures.",
+    "Add authored row locations and bounded repair hints for Transformation Demo and Distribution-First Niche failures.",
+    "Match managed cron entries by their terminal ownership tag so foreign commands cannot be removed by substring collision.",
+    "Bind workspace-scoped operating mandates and envelopes so authority cannot cross business contexts.",
+    "Reject expired operating mandates at effect time with an explicit stale-authority outcome.",
+    "Add authored row locations and bounded repair hints for Category Revenue and Distribution Proof failures.",
+    "Require exact managed schedule-line readback and reject leftover workspace runtime variants.",
+    "Repair a worker knowledge receipt once without rerunning the business task, while rejecting changed candidate outputs.",
+    "Refresh the Astra A0 deterministic baseline to the current integrated source revision and measured standing files.",
+    "Refresh task-skill host-discovery provenance to the current integrated artifact revision.",
+    "Record native Codex task-skill discovery and the authenticated Claude discovery hold with revision-bound evidence.",
+    "Carry a scope-bounded continuous quality principle through every managed worker prompt without imposing a universal 11-star exercise.",
+    "Replace workspace-managed cron entries when the selected runtime changes, preserving foreign jobs and exact uninstall behavior.",
+    "Retain safely observed worker output candidates when a knowledge receipt fails, without accepting or replaying the work.",
+    "Extend full-launch authority coverage across scope, draft-agreement, and rejected-mandate boundaries.",
+    "Explain the affected Go, Pivot, Or Kill evidence column when a verdict cell is empty or placeholder-only.",
+    "Preserve aggregate verdict evidence failures while adding authored row locations and safe repair hints.",
+    "Verify Pivot checkpoints hold initialization until an explicit Go continuation is accepted.",
+    "Exercise the complete research-decision handoff from planning hold through accepted initialization.",
+    "Align the post-Brigade public API start-path regression with the shipped agent guide heading.",
+    "Keep the lifecycle audit green after the product-facing Brigade terminology update.",
+    "Reject distinct completed knowledge receipts across transport envelopes while allowing an echoed prompt skeleton.",
+    "Verify managed launchd schedule installation and removal through exact label and file readback.",
+    "Refresh the evidence-schema fingerprint after rendering the authority-matrix projections.",
+    "Reject denied founder mandates before a full-launch dispatch can reach the execution frontier.",
+    "Adopt Brigade as the human-facing product name while preserving stable technical identities.",
+    "Keep the hosted wrong-surface matrix complete for every CLI-only public operation.",
+    "Route local planning capability through the canonical connection-surface selector before exposing it to MCP callers.",
+    "Add Quabble as a founder-selected consumer craft reference with explicit evidence limits.",
+    "Add a source-and-fixture-only Postiz API extension boundary without live provider access.",
+    "Verify managed cron schedule state after apply and uninstall readback.",
+    "Preserve narrative research uncertainty while rejecting placeholder-only fields.",
+    "Reject placeholder worker-receipt reasons while preserving typed explanations.",
+    "Add source-ledger and signal-corpus field diagnostics with authored locations and bounded repair hints.",
+    "Carry a continuous experience principle through portable task skills and make the reference-led design loop explicit.",
+    "Preserve worker output candidates as unaccepted evidence after knowledge-receipt failure.",
+    "Allow founder-approved local full-launch coordination while keeping protected system actions fail-closed.",
+    "Make scheduled autonomy explicitly conditional and keep optional scope questions off the foreground ready path.",
+    "Bind research decision finding IDs to the current red-team artifact before authoring.",
+    "Explain the research contract through the read-only check surface with checkpoint and safety boundaries.",
+    "Add a revision-bound research decision preview/apply action with replay, stale-input, duplicate-key, and recoverable mirror guards.",
+    "Keep valid Pivot and Kill research checkpoints distinct from initialization eligibility.",
+    "Explain missing, malformed, and mismatched offer-test waivers with source locations and safe repair hints.",
+    "Make research diagnostics field-aware, preserve legitimate narrative uncertainty, and report source lines with safe repair hints.",
+    "Parse pinned guidance revisions as literal commit IDs for reproducible A0 replay.",
+    "Verify revision parsing and missing-history handling through the existing entrypoint fixture harness.",
+    "Keep scoped writing contracts and isolate CI scenario inputs from the workflow environment."
+  ]
+}

package/surfaces/starters/ai-chat-companion/README.md

@@ -0,0 +1,41 @@
+# AI Chat / Companion — Boilerplate Prompt Pack
+
+The second **app-archetype prompt pack** for this skill: a dependency-ordered set of copy-paste-ready prompts for building a B2C AI chat product (assistant, companion/character, or domain copilot). Routing, the upfront archetype question, and how each prompt threads into the launch lanes live in [`../../../knowledge/product/ai-chat-companion.md`](../../../knowledge/product/ai-chat-companion.md). Read that first.
+
+These are **starting prompts**, not final code. Each file has a copy-paste block plus skill-integration notes.
+
+## How to use
+
+1. Confirm the product shape via **AskUserQuestion** (chat type, primary surface, modality, memory depth, safety scope) — see the reference. Record the selected archetype, scope, and product decisions in `product.yaml`, then render `PRODUCT.md`.
+2. **Copy the runnable starter** ([`starter/`](./starter/README.md)) into the business repo and install it — it is the pre-wired floor (auth, tested owner-only RLS migrations, a server-side streaming Claude route, PostHog event catalog, Stripe/RevenueCat stubs, names-only `.env.example`, CI). Do not regenerate this wiring from scratch; `check:archetype-starter` enforces its contract.
+3. Run prompt **00** strategy work on the web interface / Claude.ai.
+4. Run prompts **01 → 04** in order as Claude Code build prompts against the starter (the starter README maps each prompt to the scaffold area it customizes). Build one system, test it, then move on.
+5. Add optional prompts **05 → 07** based on the founder's selection; run **08** (safety) before any public launch.
+6. Apply a **variant** (companion/character or voice-first) if relevant.
+
+## Default stack
+
+Next.js App Router + Supabase (Postgres, Auth, Realtime, Storage) + Vercel + **Claude API server routes** (key server-side only), with Stripe for web monetization. Confirm current Claude model IDs/params via the `claude-api` skill; do not hardcode from memory. For a native-mobile surface, the inference backend carries over but the client is adapted and the Apple/Play store lanes apply.
+
+## Build order
+
+| #   | File                                                                             | Build it                                                     | Optional?                     |
+| --- | -------------------------------------------------------------------------------- | ------------------------------------------------------------ | ----------------------------- |
+| 00  | [`prompts/00-positioning-strategy.md`](./prompts/00-positioning-strategy.md)     | Positioning & wedge (Claude.ai)                              | strategy                      |
+| 01  | [`prompts/01-database-schema.md`](./prompts/01-database-schema.md)               | Schema (conversations, messages, usage, memory) + RLS + seed | required                      |
+| 02  | [`prompts/02-auth-system.md`](./prompts/02-auth-system.md)                       | Auth + profile                                               | required                      |
+| 03  | [`prompts/03-chat-core-loop.md`](./prompts/03-chat-core-loop.md)                 | Chat UI + streaming + conversation history                   | required                      |
+| 04  | [`prompts/04-model-integration.md`](./prompts/04-model-integration.md)           | Claude API server route, system prompt, context management   | required                      |
+| 05  | [`prompts/05-memory-personalization.md`](./prompts/05-memory-personalization.md) | Long-term memory + personalization                           | optional                      |
+| 06  | [`prompts/06-usage-limits-metering.md`](./prompts/06-usage-limits-metering.md)   | Usage metering + free-tier caps                              | required for monetization     |
+| 07  | [`prompts/07-stripe-monetization.md`](./prompts/07-stripe-monetization.md)       | Subscription (higher limits / better model)                  | optional                      |
+| 08  | [`prompts/08-safety-and-moderation.md`](./prompts/08-safety-and-moderation.md)   | Moderation, jailbreak resistance, crisis + age gating        | required before public launch |
+
+## Variants
+
+| File                                                                                   | Turns the base into                     |
+| -------------------------------------------------------------------------------------- | --------------------------------------- |
+| [`prompts/variants/companion-character.md`](./prompts/variants/companion-character.md) | Persona-driven companion/character app  |
+| [`prompts/variants/voice-first.md`](./prompts/variants/voice-first.md)                 | Voice-in / voice-out conversational app |
+
+</content>

package/surfaces/starters/ai-chat-companion/prompts/00-positioning-strategy.md

@@ -0,0 +1,45 @@
+# 00 — Positioning Strategy (Claude.ai, not Claude Code)
+
+**Run this first, on the web interface / Claude.ai.** AI chat is the most crowded app category of 2026; a generic "ChatGPT but…" loses. The win is a specific persona, domain, or relationship that a general assistant serves poorly. Replace the bracketed parts with the founder's answers.
+
+```
+I want to build an AI chat product: [assistant / companion / domain copilot] for
+[describe your target user and the job they hire it for].
+
+Help me define the positioning:
+1. What do people find frustrating or missing when they use a general assistant
+   (ChatGPT, Claude, Gemini) for this job?
+2. What does my product know, remember, or do that a general assistant does not?
+3. What is the persona and voice of the AI, and where are its hard boundaries
+   (what it must refuse or defer)?
+4. What is the free experience, and what specifically does a paid tier unlock
+   (limits, a better model, memory, voice, tools)?
+5. What is the one moment in a conversation that would make a user tell a friend
+   about it?
+
+Also define:
+- The product name direction (3 options with rationale)
+- The tagline (under 8 words)
+- The single sharpest use case to feature in onboarding and the App Store
+- The moat contract for `PRODUCT.md`'s category and wedge section: the top 2-3
+  incumbents by revenue (what each does well, the moment we beat them, what stops
+  each shipping a copy in a week), the moat class being built (data / workflow /
+  community / taste / model / distribution) with its concrete build plan, and the
+  one-week-copy test answer
+
+Strings: every user-facing label, headline, button, empty state, and error
+comes from product/copy/COPY_DECK.md (author missing rows first — voice from product/copy/COPY_BRIEF.md,
+craft from knowledge/words/conversion-copy.md), typed via the externalized resource
+named in engineering/TECH_SPEC.md. Example copy in this prompt is voice guidance, not
+shipping strings.
+```
+
+## Skill-integration notes
+
+- Answers 1–2 define the wedge → `strategy/RESEARCH.md` and the 11-star magical moment.
+- Answer 3 (persona, voice, boundaries) is the seed of the system prompt (prompt 04) and `strategy/BRAND.md §Voice`; the boundaries seed the safety pass (prompt 08).
+- Answer 4 constrains usage metering (prompt 06) and monetization (prompt 07) — reconcile with `revenue-monetization.md`.
+- Answer 5 feeds `VIRAL_GROWTH.md` and `growth/LAUNCH_NARRATIVE.md`.
+- Name directions feed naming/collision checks; the tagline and featured use case feed `APP_STORE_LISTING.md` and landing copy (run `geo-seo.md` before editing landing copy).
+</content>
+- **Transcribe the wedge into the product contract:** the answers above land in `PRODUCT.md`'s evidence and category section and are held to `product-moat.md`'s tests (one-week-copy, moat class, incumbent beat moment). A done product lane needs a real incumbent row and a named moat class in `PRODUCT.md` — a wedge that lives only in this chat is invisible to every gate.

package/surfaces/starters/ai-chat-companion/prompts/01-database-schema.md

@@ -0,0 +1,44 @@
+# 01 — Database Schema (build first)
+
+The foundation: conversations, messages, per-user usage metering, and (optionally) long-term memory. Get RLS right so one user can never read another's conversations.
+
+```
+Design a PostgreSQL database schema for an AI chat application (Supabase).
+
+The product supports:
+- Users with accounts (auth handled by Supabase Auth)
+- Conversations: each user has many conversations, each with a title and timestamps
+- Messages: each conversation has many messages with role (user/assistant/system),
+  text content, token counts (input/output), the model used, and created_at
+- Usage metering: track per-user message and token usage per billing period for
+  free-tier caps and analytics
+- Subscription status stored on the user (free / active / cancelled) and the plan
+- Long-term memory: a per-user table of durable facts/preferences the assistant
+  can recall across conversations (text + optional embedding for retrieval)
+
+Create:
+1. Full schema with all tables, columns, data types, and constraints
+2. Indexes for the most-queried patterns (a user's conversation list, a
+   conversation's messages in order, current-period usage lookups)
+3. Row Level Security policies for Supabase so a user can only read/write their
+   own conversations, messages, usage, and memory
+4. A seed script with 2 test users, a few conversations, and sample messages
+
+Output as SQL I can run directly in Supabase's SQL editor. If you include an
+embedding column, use pgvector and note the extension to enable.
+
+Strings: every user-facing label, headline, button, empty state, and error
+comes from product/copy/COPY_DECK.md (author missing rows first — voice from product/copy/COPY_BRIEF.md,
+craft from knowledge/words/conversion-copy.md), typed via the externalized resource
+named in engineering/TECH_SPEC.md. Example copy in this prompt is voice guidance, not
+shipping strings.
+```
+
+## Skill-integration notes
+
+- Reconcile with `engineering/TECH_SPEC.md` (data model, API contracts, RLS). RLS here is critical: conversations are private user data — every table (conversations, messages, usage, memory) needs a tested owner-only policy referenced from `trust/SECURITY.md`.
+- Token counts per message are the metering substrate for prompt 06 and for cost analytics — store input/output tokens and the model, not just text.
+- The memory table (and any `pgvector` embeddings) is sensitive personal data — note retention and deletion in `privacy-terms.md`.
+- Keep the schema stable across variants; companion/character and voice-first add columns (persona, audio URL) rather than reshaping the core.
+- Seed data is development-only.
+</content>