feat: Add mvp-builder AgentKit

.github/workflows/lamatic-update.yml

@@ -0,0 +1,26 @@
+name: Detect & Sync Lamatic Flows
+
+on:
+  push:
+    branches:
+      - main
+    paths:
+      - '**/lamatic/flows/**'
+
+jobs:
+  detect-flow-changes:
+    environment: main
+    runs-on: ubuntu-latest
+    if: "!contains(github.event.head_commit.message, '[LAMATIC-COMMIT]')"
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Sync Flows to lamatic
+        uses: Lamatic/sync-flows-to-lamatic@v1
+        with:
+          lamatic-endpoint: ${{ secrets.LAMATIC_PROJECT_ENDPOINT }}
+          api-key: ${{ secrets.LAMATIC_PROJECT_API_KEY }}
+          project-id: ${{ secrets.LAMATIC_PROJECT_ID }}
+          auto-deploy: ${{ secrets.LAMATIC_AUTO_DEPLOY_PROJECT }}
+

README.md

@@ -81,6 +81,7 @@ Each kit includes configuration instructions, environment variables/lamatic-conf
 | **🧠 Agentic Kits** | Advanced self-directed, reasoning agents for goal-driven operations |  |  | [`/kits/agentic`](./kits/agentic) |
 | **Deep Search Agent** | A Next.js starter kit for goal-driven reasoning agents using Lamatic Flows. | Available | [![Live Demo](https://img.shields.io/badge/Live%20Demo-black?style=for-the-badge)](https://agent-kit-reasoning.vercel.app) | [`/kits/agentic/deep-search`](./kits/agentic/deep-search) |
 | **Generation Agent** | A Next.js starter kit for generating text/json/image content using Lamatic Flows. | Available | [![Live Demo](https://img.shields.io/badge/Live%20Demo-black?style=for-the-badge)](https://agent-kit-generation.vercel.app) | [`/kits/agentic/generation`](./kits/agentic/generation) |
+| **MVP Planner Agent** | A Next.js starter kit for generating a MVP plan for a project idea. | Available | [![Live Demo](https://img.shields.io/badge/Live%20Demo-black?style=for-the-badge)](https://mvp-builder-sigma.vercel.app/) | [`/kits/agentic/mvp-builder`](./kits/agentic/mvp-builder) |
 ||
 | **🤖 Automation Kits** | Automate complex business processes with robust and flexible agent workflows |  |  | [`/kits/automation`](./kits/automation) |
 | **Hiring Automation** | A Next.js starter kit for hiring automation using Lamatic Flows. | Available | [![Live Demo](https://img.shields.io/badge/Live%20Demo-black?style=for-the-badge)](https://agent-kit-hiring.vercel.app) | [`/kits/automation/hiring`](./kits/automation/hiring) |

kits/agentic/mvp-builder/.env.example

@@ -0,0 +1,4 @@
+AGENTIC_GENERATE_CONTENT = "YOUR_FLOW_ID"
+LAMATIC_API_URL = "YOUR_API_ENDPOINT"
+LAMATIC_PROJECT_ID = "YOUR_PROJECT_ID"
+LAMATIC_API_KEY = "YOUR_API_KEY"

kits/agentic/mvp-builder/.gitignore

@@ -0,0 +1,43 @@
+# See https://help.github.com/articles/ignoring-files/ for more about ignoring files.
+
+# dependencies
+/node_modules
+/.pnp
+.pnp.*
+.yarn/*
+!.yarn/patches
+!.yarn/plugins
+!.yarn/releases
+!.yarn/versions
+
+# testing
+/coverage
+
+# next.js
+/.next/
+/out/
+
+# production
+/build
+
+# misc
+.DS_Store
+*.pem
+
+# debug
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+.pnpm-debug.log*
+
+# env files (can opt-in for committing if needed)
+.env*
+!.env.example
+
+# vercel
+.vercel
+
+# typescript
+*.tsbuildinfo
+next-env.d.ts
+.context

kits/agentic/mvp-builder/README.md

@@ -0,0 +1,213 @@
+# MVP Builder – Idea to Production Plan using Lamatic AgentKit
+
+Generate a complete MVP blueprint from a single idea using Lamatic flows.
+
+This project takes a raw product idea and transforms it into a structured plan including:
+
+- App type classification
+- Core features
+- Database schema
+- API routes
+- Project structure
+- Tech stack
+- Summary
+
+---
+
+## What This Kit Does
+
+This kit converts a simple idea into a production-ready MVP plan using a multi-step Lamatic flow.
+
+Instead of generating everything in one prompt, it uses a **chained agent workflow**:
+
+1. Classifies the idea (web app, mobile app, extension, API)
+2. Generates features
+3. Designs database schema
+4. Creates API routes
+5. Builds project structure
+6. Suggests tech stack
+7. Produces a final summary
+
+Each step builds on previous outputs, ensuring structured and coherent results.
+
+---
+
+## Demo Flow
+
+```txt
+User Input (idea)
+   ↓
+Lamatic Flow (7 nodes)
+   ↓
+Structured JSON (Plan)
+   ↓
+Next.js UI Rendering
+```
+
+---
+
+## Flow Architecture
+
+This kit uses a chained Instructor-based architecture:
+
+1. Classify idea type
+2. Generate features
+3. Generate database schema
+4. Generate API routes
+5. Generate project structure
+6. Generate tech stack
+7. Generate summary
+
+---
+
+## Tech Stack
+
+- **Frontend:** Next.js (App Router) + TailwindCSS
+- **Backend:** Next.js Server Actions
+- **AI Orchestration:** Lamatic AgentKit
+- **Language:** TypeScript
+
+---
+
+## Folder Structure
+
+```txt
+.
+├── actions/
+│   └── orchestrate.ts        # Calls Lamatic flow
+├── app/
+│   ├── page.tsx             # Input screen
+│   └── plan/page.tsx        # Result screen
+├── components/
+│   ├── content.tsx          # UI renderer for plan
+│   └── loading.tsx
+├── flows/
+│   └── mvp-builder/         # Exported Lamatic flow
+├── lib/
+│   └── lamatic-client.ts    # SDK client
+├── orchestrate.js           # Flow config
+├── types/
+│   └── index.ts             # Plan types
+```
+
+---
+
+## Prerequisites
+
+- Node.js 18+
+- pnpm
+- Lamatic account
+
+---
+
+## Environment Variables
+
+Create a `.env` file using:
+
+```env
+AGENTIC_GENERATE_CONTENT="YOUR_FLOW_ID"
+LAMATIC_API_URL="YOUR_API_ENDPOINT"
+LAMATIC_PROJECT_ID="YOUR_PROJECT_ID"
+LAMATIC_API_KEY="YOUR_API_KEY"
+```
+
+Reference:
+
+---
+
+## Setup Instructions
+
+Install dependencies:
+
+```bash
+pnpm install
+```
+
+Run development server:
+
+```bash
+pnpm dev
+```
+
+What this does:
+
+- Starts Next.js dev server
+- Enables server actions
+- Connects to Lamatic flow via SDK
+
+---
+
+## How It Works
+
+### 1. User Input
+
+User enters an idea on `/`
+
+---
+
+### 2. Server Action
+
+`actions/orchestrate.ts`:
+
+- Sends idea to Lamatic
+- Executes flow via SDK
+- Returns structured response
+
+---
+
+### 3. Lamatic Flow
+
+Flow consists of multiple Instructor LLM nodes:
+
+- Each node updates part of the JSON
+- Uses schema enforcement
+- Passes context forward
+
+---
+
+### 4. UI Rendering
+
+`components/content.tsx`:
+
+- Displays:
+  - Features
+  - Tech stack
+  - Database tables
+  - API routes
+  - Project structure
+
+---
+
+## Example Output
+
+```json
+{
+  "type": "web_app",
+  "features": [...],
+  "database": { "tables": [...] },
+  "api": { "routes": [...] },
+  "structure": {...},
+  "tech_stack": {...},
+  "summary": "..."
+}
+```
+
+---
+
+## How to Run Locally
+
+1. Clone repo
+2. Add `.env`
+3. Run:
+
+```bash
+pnpm dev
+```
+
+4. Open:
+
+```
+http://localhost:3000
+```
+
+---

kits/agentic/mvp-builder/actions/orchestrate.ts

@@ -0,0 +1,25 @@
+'use server';
+
+import { lamaticClient } from '@/lib/lamatic-client';
+import { config } from '@/orchestrate';
+import { LamaticResponse } from 'lamatic/dist/types';
+
+export async function generatePlan(idea: string): Promise<LamaticResponse> {
+  const flow = config.flows.mvp;
+
+  if (!flow.workflowId) {
+    throw new Error('Workflow ID missing');
+  }
+
+  const inputs = {
+    idea
+  };
+
+  const res = await lamaticClient.executeFlow(flow.workflowId, inputs);
+
+  if (!res) {
+    throw new Error('No output from flow');
+  }
+
+  return res;
+}