maxsim-flutter 1.28.0 → 1.30.0

package/dist/plan/brief-template-generator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"brief-template-generator.d.ts","sourceRoot":"","sources":["../../src/plan/brief-template-generator.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,kBAAkB,GAAG,MAAM,CA6CvE"}
+{"version":3,"file":"brief-template-generator.d.ts","sourceRoot":"","sources":["../../src/plan/brief-template-generator.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,kBAAkB,GAAG,MAAM,CA+DvE"}

package/dist/plan/brief-template-generator.js

@@ -1,47 +1,65 @@
 export function generateBriefTemplate(input) {
     return `# Project Brief — ${input.name}
 
-> ${input.description}
+## App Description
 
-## Vision
+${input.description}
 
-<!-- What problem does this app solve? Who is the target user? -->
+## Problem Statement
 
-## Core Features
+<!-- What specific problem does this app solve? Why does it need to exist? -->
 
-<!-- List the 3-5 most important features. Be specific. -->
+## Target Users
 
-1.
-2.
-3.
+<!-- Who are the primary users of this app? -->
 
-## User Journeys
+### Persona: [Primary User Type]
 
-<!-- Describe the key user flows step by step. -->
+- **Role**: (e.g., freelancer, student, team manager)
+- **Goal**: What they want to accomplish
+- **Pain point**: What frustrates them today
+- **Tech comfort**: Low / Medium / High
 
-### Primary Journey
+### Persona: [Secondary User Type] (optional)
 
-1. User opens the app
-2.
+- **Role**:
+- **Goal**:
+- **Pain point**:
 
-## Technical Constraints
+## Core User Journeys
 
-<!-- Platform targets, performance requirements, integrations. -->
+<!-- Describe the 3-5 most important flows a user will complete. -->
 
-- Platforms: iOS, Android
--
+1. **[Journey 1]**: (e.g., Sign up → complete profile → create first item)
+2. **[Journey 2]**:
+3. **[Journey 3]**:
+4.
+5.
+
+## Explicit Non-Goals
+
+<!-- What are you NOT building in v1? Be specific to avoid scope creep. -->
+
+- Not building:
+- Not supporting:
+- Deferred to v2:
 
 ## Success Metrics
 
-<!-- How will you measure if the app is successful? -->
+<!-- How will you know the app is successful? -->
 
--
+- Activation: (e.g., X% of users complete onboarding)
+- Engagement: (e.g., DAU/MAU ratio)
+- Retention: (e.g., 30-day retention rate)
 
-## Out of Scope
+## Technical Constraints
 
-<!-- What are you explicitly NOT building in v1? -->
+<!-- Platform targets, integrations, performance requirements. -->
 
--
+- Platforms: iOS, Android
+- Authentication:
+- Backend / API:
+- Offline support: Yes / No
 `;
 }
 //# sourceMappingURL=brief-template-generator.js.map

package/dist/plan/brief-template-generator.js.map

@@ -1 +1 @@
-{"version":3,"file":"brief-template-generator.js","sourceRoot":"","sources":["../../src/plan/brief-template-generator.ts"],"names":[],"mappings":"AAKA,MAAM,UAAU,qBAAqB,CAAC,KAAyB;IAC7D,OAAO,qBAAqB,KAAK,CAAC,IAAI;;IAEpC,KAAK,CAAC,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyCpB,CAAC;AACF,CAAC"}
+{"version":3,"file":"brief-template-generator.js","sourceRoot":"","sources":["../../src/plan/brief-template-generator.ts"],"names":[],"mappings":"AAKA,MAAM,UAAU,qBAAqB,CAAC,KAAyB;IAC7D,OAAO,qBAAqB,KAAK,CAAC,IAAI;;;;EAItC,KAAK,CAAC,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyDlB,CAAC;AACF,CAAC"}

package/dist/plan/index.d.ts

@@ -0,0 +1,12 @@
+export { isValidSnakeCase } from './types.js';
+export type { PlanInput, PlanResult } from './types.js';
+export { writePartialConfig } from './config-writer.js';
+export type { PartialConfigInput } from './config-writer.js';
+export { generateBriefTemplate } from './brief-template-generator.js';
+export type { BriefTemplateInput } from './brief-template-generator.js';
+export { generatePlanAppSkill } from './skill-generator.js';
+export type { SkillInput } from './skill-generator.js';
+export { runPlan } from './plan-orchestrator.js';
+export { classifyAppType } from './app-type-classifier.js';
+export type { AppType, AppTypeResult, ModuleSuggestion } from './app-type-classifier.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/plan/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/plan/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAC9C,YAAY,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxD,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,YAAY,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAC7D,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AACtE,YAAY,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AACxE,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAC5D,YAAY,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAC3D,YAAY,EAAE,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/plan/index.js

@@ -0,0 +1,7 @@
+export { isValidSnakeCase } from './types.js';
+export { writePartialConfig } from './config-writer.js';
+export { generateBriefTemplate } from './brief-template-generator.js';
+export { generatePlanAppSkill } from './skill-generator.js';
+export { runPlan } from './plan-orchestrator.js';
+export { classifyAppType } from './app-type-classifier.js';
+//# sourceMappingURL=index.js.map

package/dist/plan/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/plan/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAE9C,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAExD,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AAEtE,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAE5D,OAAO,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/plan/plan-orchestrator.js

@@ -15,7 +15,7 @@ export async function runPlan(input) {
     const skillsDir = join(outputDir, '.claude', 'skills');
     await mkdir(skillsDir, { recursive: true });
     const skillPath = join(skillsDir, 'plan-app.md');
-    await writeFile(skillPath, generatePlanAppSkill(), 'utf-8');
+    await writeFile(skillPath, generatePlanAppSkill({ name, description }), 'utf-8');
     filesCreated.push(skillPath);
     // Write docs/project-brief-template.md
     const docsDir = join(outputDir, 'docs');

package/dist/plan/plan-orchestrator.js.map

@@ -1 +1 @@
-{"version":3,"file":"plan-orchestrator.js","sourceRoot":"","sources":["../../src/plan/plan-orchestrator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAEpD,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AACtE,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAE5D,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,KAAgB;IAC5C,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,SAAS,EAAE,GAAG,KAAK,CAAC;IAC/C,MAAM,YAAY,GAAa,EAAE,CAAC;IAElC,2BAA2B;IAC3B,MAAM,KAAK,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAE5C,mCAAmC;IACnC,MAAM,UAAU,GAAG,MAAM,kBAAkB,CAAC,SAAS,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,CAAC;IAC9E,YAAY,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAE9B,mCAAmC;IACnC,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC;IACvD,MAAM,KAAK,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC5C,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC;IACjD,MAAM,SAAS,CAAC,SAAS,EAAE,oBAAoB,EAAE,EAAE,OAAO,CAAC,CAAC;IAC5D,YAAY,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAE7B,uCAAuC;IACvC,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;IACxC,MAAM,KAAK,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC1C,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,EAAE,2BAA2B,CAAC,CAAC;IAC7D,MAAM,SAAS,CAAC,SAAS,EAAE,qBAAqB,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,EAAE,OAAO,CAAC,CAAC;IAClF,YAAY,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAE7B,OAAO;QACL,UAAU,EAAE,SAAS;QACrB,YAAY;KACb,CAAC;AACJ,CAAC"}
+{"version":3,"file":"plan-orchestrator.js","sourceRoot":"","sources":["../../src/plan/plan-orchestrator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAEpD,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AACtE,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAE5D,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,KAAgB;IAC5C,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,SAAS,EAAE,GAAG,KAAK,CAAC;IAC/C,MAAM,YAAY,GAAa,EAAE,CAAC;IAElC,2BAA2B;IAC3B,MAAM,KAAK,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAE5C,mCAAmC;IACnC,MAAM,UAAU,GAAG,MAAM,kBAAkB,CAAC,SAAS,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,CAAC;IAC9E,YAAY,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAE9B,mCAAmC;IACnC,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC;IACvD,MAAM,KAAK,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC5C,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC;IACjD,MAAM,SAAS,CAAC,SAAS,EAAE,oBAAoB,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,EAAE,OAAO,CAAC,CAAC;IACjF,YAAY,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAE7B,uCAAuC;IACvC,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;IACxC,MAAM,KAAK,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC1C,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,EAAE,2BAA2B,CAAC,CAAC;IAC7D,MAAM,SAAS,CAAC,SAAS,EAAE,qBAAqB,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,EAAE,OAAO,CAAC,CAAC;IAClF,YAAY,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAE7B,OAAO;QACL,UAAU,EAAE,SAAS;QACrB,YAAY;KACb,CAAC;AACJ,CAAC"}

package/dist/plan/skill-generator.d.ts

@@ -1,2 +1,6 @@
-export declare function generatePlanAppSkill(): string;
+export interface SkillInput {
+    name: string;
+    description: string;
+}
+export declare function generatePlanAppSkill(input?: SkillInput): string;
 //# sourceMappingURL=skill-generator.d.ts.map

package/dist/plan/skill-generator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"skill-generator.d.ts","sourceRoot":"","sources":["../../src/plan/skill-generator.ts"],"names":[],"mappings":"AAAA,wBAAgB,oBAAoB,IAAI,MAAM,CAmD7C"}
+{"version":3,"file":"skill-generator.d.ts","sourceRoot":"","sources":["../../src/plan/skill-generator.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,wBAAgB,oBAAoB,CAAC,KAAK,CAAC,EAAE,UAAU,GAAG,MAAM,CA2H/D"}

package/dist/plan/skill-generator.js

@@ -1,50 +1,121 @@
-export function generatePlanAppSkill() {
+export function generatePlanAppSkill(input) {
+    const name = input?.name ?? 'your_app';
+    const description = input?.description ?? 'A Flutter app';
     return `---
-description: AI-guided planning for your Flutter app. Leads you through vision, module selection, user journeys, and PRD generation.
+description: AI-guided planning for ${name}. Leads through vision, features, technical decisions, and PRD generation. Ask questions one at a time.
 model: claude-opus-4-6
 ---
 
-# /plan-app
+# /plan-app — ${name}
 
-You are helping to plan a Flutter app using the maxsim-flutter framework.
+You are a product planning expert helping design a Flutter app using maxsim-flutter.
 
-## Instructions
+**Project**: ${name}
+**Description**: ${description}
 
-Guide the user through the following planning phases:
+> **Important**: Ask questions one at a time. Wait for the user's answer before asking the next question.
 
-### Phase 1: Vision & Core Features
+---
+
+## Step 1: Understand Vision
+
+Start by understanding the core problem this app solves.
+
+**Question 1.1** — What specific problem does **${name}** solve, and for whom?
+*(Understanding the problem before building ensures you build the right thing.)*
+
+**Question 1.2** — Walk me through the most important user journey: what does the user do from the moment they open the app to achieving their goal?
+*(This reveals the critical path and core feature set.)*
+
+---
+
+## Step 2: Define Core Features
+
+Narrow down what the app will actually build.
+
+**Question 2.1** — What are the top 3 features that **must** exist in v1? (Ignore "nice to haves" for now.)
+*(Focused scope prevents the most common cause of project failure.)*
+
+**Question 2.2** — What are the explicit **non-goals** — features you are intentionally NOT building in v1?
+*(Saying "no" early saves months of scope creep.)*
+
+**Question 2.3** — Is this a solo project or will you work with a team?
+*(This affects architecture complexity, auth requirements, and CI/CD needs.)*
+
+---
+
+## Step 3: Technical Decisions
 
-1. Read \`docs/project-brief-template.md\` if it exists
-2. Ask the user to describe their app in 2-3 sentences
-3. Identify 3-5 core features
-4. Ask clarifying questions about each feature
+Use this decision tree to guide module selection. Ask each sub-question only if relevant.
+
+### Auth Decision
+**Question 3.1** — Does the app require user accounts?
+- **Yes** → Which provider? Firebase Auth / Supabase / Custom backend
+- **No** → Skip auth module
+
+### Backend & Database Decision
+**Question 3.2** — Does the app need to store or sync data across devices?
+- **Cloud sync** → Which backend? Firebase Firestore / Supabase / REST API
+- **Local only** → Use the \`database\` module (SQLite/Hive)
+- **No persistence** → Skip database module
+
+### Platform Decision
+**Question 3.3** — Which platforms must ship in v1?
+- iOS and Android (default)
+- Web app as well?
+- Desktop (macOS / Windows / Linux)?
+
+---
+
+## Step 4: Module Suggestions
+
+Based on the app description and answers collected, suggest modules using this decision matrix.
+
+**Classify the app type** from the description, then apply the relevant row:
+
+| App Type | REQUIRED | RECOMMENDED | NICE-TO-HAVE |
+|---|---|---|---|
+| **team-collaboration** | auth, push, database | analytics, deep-linking | i18n, theme |
+| **e-commerce** | auth, database, api | push, analytics, deep-linking | theme, i18n |
+| **content-social** | auth, analytics, database | push, deep-linking | i18n, theme |
+| **utility-tool** | theme | i18n, analytics | — |
+| **fitness-health** | auth, database, push | analytics, theme | — |
+| **education** | auth, database, api | push, i18n | analytics |
+| **general** | auth, api | theme | — |
+
+**For each suggested module, explain the rationale** (why it is needed for this specific app):
+
+Example format:
+- \`auth\` ✅ REQUIRED — *Because ${name} needs user accounts to save personal data*
+- \`push\` ⭐ RECOMMENDED — *Because users benefit from timely notifications*
+- \`i18n\` 💡 NICE-TO-HAVE — *If you plan to target non-English markets in the future*
+
+Present the suggestions clearly, then ask:
+
+**Question 4.1** — Do these module suggestions match your vision, or would you add/remove anything?
+
+---
 
-### Phase 2: Module Selection
+## Step 5: Confirm Selections & Approve
 
-Based on the app description, suggest which maxsim-flutter modules to enable:
-- \`auth\` — User authentication
-- \`api\` — Backend API integration
-- \`database\` — Local data persistence
-- \`theme\` — Custom branding & dark mode
-- \`push\` — Push notifications
-- \`analytics\` — Usage analytics
-- \`i18n\` — Internationalization
-- \`deep-linking\` — Deep links & universal links
+Summarize all decisions collected in Steps 1-4:
 
-### Phase 3: User Journeys & Architecture
+**Summary of choices:**
+- App type: [detected type]
+- Platforms: [selected]
+- Auth: [yes/no, provider if yes]
+- Database: [local/cloud/none]
+- Modules: [final list with priorities]
 
-1. Map the 2-3 primary user journeys
-2. Identify key screens and navigation flows
-3. Define the Clean Architecture layers needed
+**Question 5.1** — Does this summary accurately reflect your app? Should we proceed with generating the config and PRD, or would you like to adjust anything?
 
-### Phase 4: Generate Artifacts
+Once the user confirms and approves, generate:
 
-Generate the following:
-1. Complete \`maxsim.config.yaml\` with selected modules
-2. \`prd.json\` with user stories for each module
-3. \`docs/architecture.md\` with system design
+1. **Complete \`maxsim.config.yaml\`** with all selected modules configured
+2. **\`prd.json\`** with user stories organized by phase
+3. **\`docs/architecture.md\`** with system design overview
 
-When ready, tell the user to run:
+Then tell the user:
 \`\`\`
 maxsim-flutter create --config maxsim.config.yaml
 \`\`\`

package/dist/plan/skill-generator.js.map

@@ -1 +1 @@
-{"version":3,"file":"skill-generator.js","sourceRoot":"","sources":["../../src/plan/skill-generator.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,oBAAoB;IAClC,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAiDR,CAAC;AACF,CAAC"}
+{"version":3,"file":"skill-generator.js","sourceRoot":"","sources":["../../src/plan/skill-generator.ts"],"names":[],"mappings":"AAKA,MAAM,UAAU,oBAAoB,CAAC,KAAkB;IACrD,MAAM,IAAI,GAAG,KAAK,EAAE,IAAI,IAAI,UAAU,CAAC;IACvC,MAAM,WAAW,GAAG,KAAK,EAAE,WAAW,IAAI,eAAe,CAAC;IAE1D,OAAO;sCAC6B,IAAI;;;;gBAI1B,IAAI;;;;eAIL,IAAI;mBACA,WAAW;;;;;;;;;;kDAUoB,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;mCAiEnB,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAiCtC,CAAC;AACF,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "maxsim-flutter",
-  "version": "1.28.0",
+  "version": "1.30.0",
   "description": "AI-powered Flutter app scaffolding with Clean Architecture, Riverpod, and autonomous development via Ralph",
   "type": "module",
   "bin": {