feat: add recipe-ready SaaS prompts

Co-authored-by: Cursor <cursoragent@cursor.com>

Author: jesseoue

CHANGELOG.md

@@ -9,7 +9,7 @@
 - Added an installable `cloudflare-next-starter` module for consuming apps while keeping StackFoundry itself on the standard Next.js/Vercel path.
 - Added Vercel AI building blocks: `ai-sdk`, `ai-elements`, and `ai-chatbot-sdk`.
 - Added `cloudflare-kumo-ui` as an optional Cloudflare UI building-block module.
-- Added `agent-ready-installs` with prompt packs and context files for Cursor, Codex, Claude, and similar coding agents.
+- Added `agent-ready-installs` with prompt packs and context files for coding assistants.
 - Added docs for recipes, install order, readiness, conventions, and a mirrored docs changelog.
 - Added OpenSSF Scorecard scanning and private vulnerability reporting links.
 

README.md

@@ -9,7 +9,7 @@ shadcn for production SaaS systems.
 [![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](./LICENSE)
 ![Next.js](https://img.shields.io/badge/Next.js-16-black)
 ![Vercel](https://img.shields.io/badge/deploy-Vercel-black)
-![Modules](https://img.shields.io/badge/modules-156-orange)
+![Modules](https://img.shields.io/badge/modules-157-orange)
 ![Recipes](https://img.shields.io/badge/recipes-9-purple)
 ![Presets](https://img.shields.io/badge/presets-13-teal)
 ![Inspired by shadcn](https://img.shields.io/badge/inspired%20by-shadcn-111111)
@@ -18,7 +18,7 @@ StackFoundry is a public source registry for the production systems SaaS teams r
 
 Modules install as source files in your app. You review the code, own the code, and keep the maintenance context that ships with it.
 
-StackFoundry installs are also coding-agent-ready: Cursor, Codex, Claude, and similar tools can inspect recipes, dry-run installs, review generated diffs, and follow included prompt packs.
+StackFoundry installs are also coding-assistant-ready: tools can inspect recipes, dry-run installs, review generated diffs, and follow included prompt packs.
 
 > [!IMPORTANT]
 > The registry is the product. Modules are the unit of value. Recipes are the guided path. Presets are convenience bundles.
@@ -45,7 +45,7 @@ pnpm stackfoundry add recipe api-saas-starter --target ./my-app
 The API SaaS recipe installs the path most developer tools, AI APIs, data APIs, and B2B platforms need first:
 
 - API key lifecycle and verification
-- agent-ready prompt packs for Cursor, Codex, Claude, and similar tools
+- one-shot prompt packs for coding-assistant install and review workflows
 - usage metering, quotas, and rate limits
 - credit wallet and Stripe billing foundations
 - webhook inbox and outbound delivery
@@ -109,7 +109,7 @@ Current source registry coverage:
 <details>
 <summary>Current scale</summary>
 
-- 156 ready module manifests
+- 157 ready module manifests
 - 36 canonical categories
 - 13 preset bundles
 - 9 architecture recipes
@@ -127,13 +127,15 @@ The public hierarchy is intentionally simple:
 
 ## Agent-Ready Installs
 
-The `agent-ready-installs` module adds prompt packs and context files for Cursor, Codex, Claude, and other coding agents:
+The `agent-ready-installs` module adds one-shot prompt packs and context files for coding assistants:
 
 ```bash
 pnpm stackfoundry add agent-ready-installs --target ./my-app --dry-run
 ```
 
-It gives agents a safe workflow for inspecting recipes, dry-running installs, reviewing diffs, checking env notes, and verifying the target app after source lands.
+It includes recipe-aligned prompts for API SaaS, minimal SaaS, enterprise SaaS, AI SaaS, customer intelligence, Cloudflare SaaS, integration marketplace, security center, and support ops installs. Each prompt defines the completed SaaS endpoint, dry-run/install workflow, expected modules, verification steps, and production handoff.
+
+It gives agents a safe workflow for inspecting recipes, dry-running installs, reviewing diffs, checking env notes, and verifying the target app after source lands with Biome lint/format, TypeScript typecheck, tests, production build, and responsive smoke checks.
 
 ## Recipes
 

apps/web/app/docs/page.tsx

@@ -53,8 +53,8 @@ const pathCards = [
   },
   {
     title: "Agent-ready installs",
-    eyebrow: "Cursor, Codex, Claude",
-    body: "Use agent-ready-installs when a coding agent should inspect recipes, run dry-runs, review diffs, and follow safe infrastructure install prompts.",
+    eyebrow: "one-shot prompts",
+    body: "Use agent-ready-installs when a coding assistant should inspect recipes, run dry-runs, review diffs, and follow safe infrastructure install prompts.",
     modules: ["agent-ready-installs", "api-saas-starter", "api-keys", "usage-metering"],
   },
   {
@@ -101,6 +101,63 @@ const pathCards = [
   },
 ];
 
+const promptCards = [
+  {
+    title: "API SaaS",
+    prompt: "one-shot-api-saas.md",
+    recipe: "api-saas-starter",
+    body: "Keys, usage, quotas, credits, billing, docs, webhooks, and request visibility.",
+  },
+  {
+    title: "Minimal SaaS",
+    prompt: "one-shot-minimal-saas.md",
+    recipe: "saas-starter-minimal",
+    body: "Small shell, settings, database, auth boundary, billing path, health, and security.",
+  },
+  {
+    title: "Enterprise SaaS",
+    prompt: "one-shot-enterprise-saas.md",
+    recipe: "enterprise-saas",
+    body: "SSO, SCIM, RBAC, audit, compliance, support, incidents, and status workflows.",
+  },
+  {
+    title: "AI SaaS",
+    prompt: "one-shot-ai-saas.md",
+    recipe: "ai-saas-starter",
+    body: "AI SDK routes, chat UI, usage metering, quota enforcement, and cost controls.",
+  },
+  {
+    title: "Customer Intelligence",
+    prompt: "one-shot-customer-intelligence.md",
+    recipe: "customer-intelligence",
+    body: "Analytics, large event ingestion, usage data, customer health, and risk signals.",
+  },
+  {
+    title: "Cloudflare SaaS",
+    prompt: "one-shot-cloudflare-saas.md",
+    recipe: "cloudflare-saas",
+    body: "Workers, Pages, storage, queues, workflows, Durable Objects, security, and deploy path.",
+  },
+  {
+    title: "Integration Marketplace",
+    prompt: "one-shot-integration-marketplace.md",
+    recipe: "integration-marketplace",
+    body: "Connected accounts, provider adapters, permissions, health, webhooks, and sync visibility.",
+  },
+  {
+    title: "Security Center",
+    prompt: "one-shot-security-center.md",
+    recipe: "security-center",
+    body: "Security posture, MFA, browser/API controls, data lifecycle, secrets, and audit history.",
+  },
+  {
+    title: "Support Ops",
+    prompt: "one-shot-support-ops.md",
+    recipe: "support-ops",
+    body: "Support, feedback, incidents, on-call, postmortems, status updates, and health signals.",
+  },
+];
+
 const moduleGroups = [
   {
     category: "Foundation",
@@ -496,14 +553,18 @@ export default function DocsPage() {
               <span />
               Choose a path
             </a>
+            <a href="#one-shot-prompts">
+              <span />
+              One-shot prompts
+            </a>
             <a href="#module-catalog">
               <span />
               Module catalog
             </a>
           </div>
           <div className="docs-side-section">
             <h4>
-              Registry <strong>156</strong>
+              Registry <strong>157</strong>
             </h4>
             {moduleGroups.slice(0, 7).map((group) => (
               <a href="#module-catalog" key={group.category}>
@@ -612,9 +673,9 @@ $ pnpm stackfoundry add recipe api-saas-starter --target ./my-app`}</CodeBlock>
               <strong>Review the source</strong>
               <p>
                 A module can add routes, schema, dependencies, env documentation, tests/checklists,
-                and maintenance skills. Run your app's normal lint, typecheck, migration, and test
-                flow after install. Secrets belong in your environment manager, not in committed
-                files.
+                and maintenance skills. Run Biome lint/format, TypeScript typecheck, migration,
+                tests, production build, and responsive smoke checks after install. Secrets belong
+                in your environment manager, not in committed files.
               </p>
             </section>
           </section>
@@ -657,9 +718,33 @@ $ pnpm stackfoundry add recipe api-saas-starter --target ./my-app`}</CodeBlock>
 $ pnpm stackfoundry recipe api-saas-starter`}</CodeBlock>
           </section>
 
+          <section aria-labelledby="one-shot-prompts">
+            <h2 id="one-shot-prompts">
+              5. Use a one-shot SaaS prompt <Anchor id="one-shot-prompts" />
+            </h2>
+            <p>
+              The `agent-ready-installs` module now ships prompt files that match real recipes. Use
+              them when a coding assistant should inspect the target app, run a recipe dry-run,
+              explain the diff, ask before writing, and verify the installed source with Biome,
+              typecheck, build, tests, and responsive smoke checks.
+            </p>
+            <div className="docs-prompt-grid">
+              {promptCards.map((card) => (
+                <article className="docs-prompt-card" key={card.prompt}>
+                  <span>{card.recipe}</span>
+                  <h3>{card.title}</h3>
+                  <p>{card.body}</p>
+                  <code>{card.prompt}</code>
+                </article>
+              ))}
+            </div>
+            <CodeBlock label="terminal">{`$ pnpm stackfoundry add agent-ready-installs --target ./my-app
+$ code ./my-app/.stackfoundry/prompts/one-shot-api-saas.md`}</CodeBlock>
+          </section>
+
           <section aria-labelledby="module-catalog">
             <h2 id="module-catalog">
-              5. Module catalog <Anchor id="module-catalog" />
+              6. Module catalog <Anchor id="module-catalog" />
             </h2>
             <p>
               The registry covers foundation, data, auth and tenancy, billing, API product,
@@ -683,7 +768,7 @@ $ pnpm stackfoundry recipe api-saas-starter`}</CodeBlock>
 
           <section aria-labelledby="authoring">
             <h2 id="authoring">
-              6. Author modules with contracts <Anchor id="authoring" />
+              7. Author modules with contracts <Anchor id="authoring" />
             </h2>
             <p>
               Every module is more than a code snippet. It ships the implementation, the install
@@ -721,7 +806,7 @@ $ pnpm stackfoundry recipe api-saas-starter`}</CodeBlock>
 
           <section aria-labelledby="safety">
             <h2 id="safety">
-              7. Review and update safely <Anchor id="safety" />
+              8. Review and update safely <Anchor id="safety" />
             </h2>
             <p>
               StackFoundry is designed for normal code review. Install commands should be paired
@@ -758,12 +843,13 @@ $ pnpm stackfoundry recipe api-saas-starter`}</CodeBlock>
           </a>
           <a href="#install-existing">Existing app</a>
           <a href="#choose-path">Choose a path</a>
+          <a href="#one-shot-prompts">One-shot prompts</a>
           <a href="#module-catalog">Module catalog</a>
           <a href="#authoring">Authoring</a>
           <a href="#safety">Safety</a>
           <div className="docs-toc-meta">
             <span>Registry-first</span>
-            <span>156 modules</span>
+            <span>157 modules</span>
             <a href="https://github.com/jesseoue/stackfoundry">GitHub →</a>
           </div>
         </aside>

apps/web/app/globals.css

@@ -176,6 +176,7 @@ pre {
 .docs-side-section a:focus-visible,
 .docs-toc a:focus-visible,
 .docs-chip-row a:focus-visible,
+.docs-prompt-card:focus-within,
 .docs-pager a:focus-visible {
   outline: 2px solid var(--focus);
   outline-offset: 4px;
@@ -930,11 +931,14 @@ pre {
   justify-content: space-between;
   margin-top: 2px;
   padding-top: 10px;
+  min-width: 0;
 }
 
 .module-footer-actions {
   display: inline-flex;
+  flex-wrap: wrap;
   gap: 10px;
+  justify-content: flex-end;
 }
 
 .module-footer a {
@@ -1823,6 +1827,7 @@ pre {
 
 .docs-steps,
 .docs-path-grid,
+.docs-prompt-grid,
 .docs-catalog-grid,
 .docs-manifest-grid {
   display: grid;
@@ -1836,6 +1841,7 @@ pre {
 
 .docs-step,
 .docs-path-card,
+.docs-prompt-card,
 .docs-catalog-card,
 .docs-manifest-card {
   background: var(--surface);
@@ -1854,6 +1860,7 @@ pre {
 
 .docs-step p,
 .docs-path-card p,
+.docs-prompt-card p,
 .docs-catalog-card p,
 .docs-manifest-card p {
   font-size: 13.5px;
@@ -1867,6 +1874,39 @@ pre {
   margin: 22px 0 28px;
 }
 
+.docs-prompt-grid {
+  grid-template-columns: repeat(auto-fit, minmax(160px, 1fr));
+  margin: 22px 0 18px;
+}
+
+.docs-prompt-card {
+  display: grid;
+  gap: 10px;
+  min-height: 190px;
+}
+
+.docs-prompt-card span {
+  color: var(--accent);
+  font-family: var(--font-mono);
+  font-size: 10px;
+  letter-spacing: 0.08em;
+  text-transform: uppercase;
+}
+
+.docs-prompt-card code {
+  align-self: end;
+  background: color-mix(in oklch, var(--bg) 58%, transparent);
+  border: 1px solid var(--border);
+  border-radius: 999px;
+  color: var(--muted-2);
+  display: block;
+  font-size: 11px;
+  overflow: hidden;
+  padding: 5px 8px;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+}
+
 .docs-card-eyebrow {
   color: var(--accent);
   font-family: var(--font-mono);
@@ -2151,6 +2191,7 @@ pre {
   .docs-layout,
   .docs-steps,
   .docs-path-grid,
+  .docs-prompt-grid,
   .docs-catalog-grid,
   .docs-manifest-grid,
   .sponsor-strip {
@@ -2340,10 +2381,21 @@ pre {
   .artifact-module strong,
   .artifact-module small,
   .module-name,
-  .module-pill span:first-child {
+  .module-pill span:first-child,
+  .module-row-desc {
     white-space: normal;
   }
 
+  .module-footer {
+    align-items: flex-start;
+    flex-direction: column;
+    gap: 8px;
+  }
+
+  .module-footer-actions {
+    justify-content: flex-start;
+  }
+
   .section {
     padding: 64px 0;
   }

apps/web/app/page.tsx

@@ -22,7 +22,7 @@ type LandingModuleCard = {
 };
 
 const stats = [
-  { value: "156", label: "Modules" },
+  { value: "157", label: "Modules" },
   { value: "13", label: "Presets" },
   { value: "36", label: "Categories" },
   { value: "MIT", label: "License" },
@@ -83,15 +83,15 @@ const moduleCards: LandingModuleCard[] = [
     category: "developer platform",
     version: "ready",
     description:
-      "Prompt packs and context files for Cursor, Codex, Claude, and other coding agents to install infra safely.",
+      "One-shot prompt packs and context files for coding assistants to install SaaS paths safely.",
     tags: [
       { label: "agent-ready", tone: "accent" },
-      { label: "prompts", tone: "success" },
-      { label: "Cursor/Codex/Claude", tone: "provider" },
+      { label: "one-shot prompts", tone: "success" },
+      { label: "recipe-aware", tone: "provider" },
       { label: "review workflow", tone: "skill" },
     ],
     footer: {
-      summary: "4 files · prompts · context JSON",
+      summary: "13 files · prompts · context JSON",
       actions: [{ label: "json", href: "/r/agent-ready-installs.json" }],
     },
   },

apps/web/app/registry/page.tsx

@@ -336,7 +336,7 @@ const providerOptions = [
 ];
 
 const stats = [
-  ["156", "Module manifests"],
+  ["157", "Module manifests"],
   ["13", "Preset bundles"],
   ["9", "Recipes"],
   ["17", "Provider cards"],