maxsim-flutter 1.27.0 → 1.29.0

package/dist/cli/commands/plan.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+export declare function createPlanCommand(): Command;
+//# sourceMappingURL=plan.d.ts.map

package/dist/cli/commands/plan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/plan.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAMpC,wBAAgB,iBAAiB,IAAI,OAAO,CAiB3C"}

package/dist/cli/commands/plan.js

@@ -0,0 +1,76 @@
+import { Command } from 'commander';
+import { join } from 'node:path';
+import * as p from '@clack/prompts';
+import { runPlan } from '../../plan/plan-orchestrator.js';
+import { isValidSnakeCase } from '../../plan/types.js';
+export function createPlanCommand() {
+    const cmd = new Command('plan');
+    cmd
+        .description('Bootstrap a planning workspace for a new Flutter app with AI-guided setup')
+        .argument('[app-name]', 'Name of the Flutter application (snake_case)')
+        .option('--description <text>', 'Short description of your app (1-2 sentences)')
+        .action(async (appName, options) => {
+        try {
+            await runPlanCommand(appName, options);
+        }
+        catch (err) {
+            p.log.error(err instanceof Error ? err.message : String(err));
+            process.exit(1);
+        }
+    });
+    return cmd;
+}
+async function runPlanCommand(appName, options) {
+    p.intro('maxsim-flutter — Bootstrap a planning workspace');
+    // Prompt for project name if not provided
+    let name = appName;
+    if (!name) {
+        const nameResult = await p.text({
+            message: 'What is your project name? (snake_case)',
+            placeholder: 'my_flutter_app',
+            validate: (value) => {
+                if (!isValidSnakeCase(value)) {
+                    return 'Project name must be snake_case (lowercase letters, digits, and underscores only)';
+                }
+                return undefined;
+            },
+        });
+        if (p.isCancel(nameResult)) {
+            p.cancel('Planning cancelled.');
+            process.exit(0);
+        }
+        name = nameResult;
+    }
+    else if (!isValidSnakeCase(name)) {
+        p.log.error(`Invalid project name "${name}". Must be snake_case (e.g., my_app).`);
+        process.exit(1);
+    }
+    // Prompt for description if not provided
+    let description = options.description;
+    if (!description) {
+        const descResult = await p.text({
+            message: 'Briefly describe your app (1-2 sentences):',
+            placeholder: 'A productivity app that helps teams collaborate on daily tasks.',
+            validate: (value) => {
+                if (!value.trim())
+                    return 'Description cannot be empty';
+                return undefined;
+            },
+        });
+        if (p.isCancel(descResult)) {
+            p.cancel('Planning cancelled.');
+            process.exit(0);
+        }
+        description = descResult;
+    }
+    const outputDir = join(process.cwd(), name);
+    p.log.info(`Creating planning workspace in ./${name}/`);
+    const result = await runPlan({ name, description, outputDir });
+    p.log.success(`Created ${result.filesCreated.length} files`);
+    p.outro(`Planning workspace ready! Next steps:\n\n` +
+        `  1. cd ${name}\n` +
+        `  2. Fill in docs/project-brief-template.md\n` +
+        `  3. Open Claude Code: claude\n` +
+        `  4. Run the planning skill: /plan-app\n`);
+}
+//# sourceMappingURL=plan.js.map

package/dist/cli/commands/plan.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan.js","sourceRoot":"","sources":["../../../src/cli/commands/plan.ts"],"names":[],"mappings":"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"}

package/dist/cli/index.js

@@ -6,6 +6,7 @@ import { createAddCommand } from './commands/add.js';
 import { createMigrateCommand } from './commands/migrate.js';
 import { createListCommand } from './commands/list.js';
 import { createUpgradeCommand } from './commands/upgrade.js';
+import { createPlanCommand } from './commands/plan.js';
 import { checkForUpdate } from './version-check.js';
 const program = new Command();
 program
@@ -18,6 +19,7 @@ program.addCommand(createAddCommand());
 program.addCommand(createMigrateCommand());
 program.addCommand(createListCommand());
 program.addCommand(createUpgradeCommand());
+program.addCommand(createPlanCommand());
 program.parse();
 // Non-blocking update nudge (fires after the command completes)
 const opts = program.opts();

package/dist/cli/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":";AACA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEpD,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,gBAAgB,CAAC;KACtB,OAAO,CAAC,OAAO,CAAC;KAChB,WAAW,CAAC,4GAA4G,CAAC;KACzH,MAAM,CAAC,mBAAmB,EAAE,2BAA2B,CAAC,CAAC;AAE5D,OAAO,CAAC,UAAU,CAAC,mBAAmB,EAAE,CAAC,CAAC;AAC1C,OAAO,CAAC,UAAU,CAAC,gBAAgB,EAAE,CAAC,CAAC;AACvC,OAAO,CAAC,UAAU,CAAC,oBAAoB,EAAE,CAAC,CAAC;AAC3C,OAAO,CAAC,UAAU,CAAC,iBAAiB,EAAE,CAAC,CAAC;AACxC,OAAO,CAAC,UAAU,CAAC,oBAAoB,EAAE,CAAC,CAAC;AAE3C,OAAO,CAAC,KAAK,EAAE,CAAC;AAEhB,gEAAgE;AAChE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,EAA4B,CAAC;AACtD,IAAI,IAAI,CAAC,WAAW,KAAK,KAAK,EAAE,CAAC;IAC/B,cAAc,EAAE;SACb,IAAI,CAAC,CAAC,aAAa,EAAE,EAAE;QACtB,IAAI,aAAa,EAAE,CAAC;YAClB,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,EAAE,IAAI,OAAO,CAAC;YAC7C,OAAO,CAAC,GAAG,CACT,KAAK,CAAC,MAAM,CACV,uBAAuB,OAAO,MAAM,aAAa,gDAAgD,CAClG,CACF,CAAC;QACJ,CAAC;IACH,CAAC,CAAC;SACD,KAAK,CAAC,GAAG,EAAE;QACV,kBAAkB;IACpB,CAAC,CAAC,CAAC;AACP,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":";AACA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEpD,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,gBAAgB,CAAC;KACtB,OAAO,CAAC,OAAO,CAAC;KAChB,WAAW,CAAC,4GAA4G,CAAC;KACzH,MAAM,CAAC,mBAAmB,EAAE,2BAA2B,CAAC,CAAC;AAE5D,OAAO,CAAC,UAAU,CAAC,mBAAmB,EAAE,CAAC,CAAC;AAC1C,OAAO,CAAC,UAAU,CAAC,gBAAgB,EAAE,CAAC,CAAC;AACvC,OAAO,CAAC,UAAU,CAAC,oBAAoB,EAAE,CAAC,CAAC;AAC3C,OAAO,CAAC,UAAU,CAAC,iBAAiB,EAAE,CAAC,CAAC;AACxC,OAAO,CAAC,UAAU,CAAC,oBAAoB,EAAE,CAAC,CAAC;AAC3C,OAAO,CAAC,UAAU,CAAC,iBAAiB,EAAE,CAAC,CAAC;AAExC,OAAO,CAAC,KAAK,EAAE,CAAC;AAEhB,gEAAgE;AAChE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,EAA4B,CAAC;AACtD,IAAI,IAAI,CAAC,WAAW,KAAK,KAAK,EAAE,CAAC;IAC/B,cAAc,EAAE;SACb,IAAI,CAAC,CAAC,aAAa,EAAE,EAAE;QACtB,IAAI,aAAa,EAAE,CAAC;YAClB,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,EAAE,IAAI,OAAO,CAAC;YAC7C,OAAO,CAAC,GAAG,CACT,KAAK,CAAC,MAAM,CACV,uBAAuB,OAAO,MAAM,aAAa,gDAAgD,CAClG,CACF,CAAC;QACJ,CAAC;IACH,CAAC,CAAC;SACD,KAAK,CAAC,GAAG,EAAE;QACV,kBAAkB;IACpB,CAAC,CAAC,CAAC;AACP,CAAC"}

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

@@ -0,0 +1,6 @@
+export interface BriefTemplateInput {
+    name: string;
+    description: string;
+}
+export declare function generateBriefTemplate(input: BriefTemplateInput): string;
+//# sourceMappingURL=brief-template-generator.d.ts.map

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

@@ -0,0 +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,CA+DvE"}

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

@@ -0,0 +1,65 @@
+export function generateBriefTemplate(input) {
+    return `# Project Brief — ${input.name}
+
+## App Description
+
+${input.description}
+
+## Problem Statement
+
+<!-- What specific problem does this app solve? Why does it need to exist? -->
+
+## Target Users
+
+<!-- Who are the primary users of this app? -->
+
+### Persona: [Primary User Type]
+
+- **Role**: (e.g., freelancer, student, team manager)
+- **Goal**: What they want to accomplish
+- **Pain point**: What frustrates them today
+- **Tech comfort**: Low / Medium / High
+
+### Persona: [Secondary User Type] (optional)
+
+- **Role**:
+- **Goal**:
+- **Pain point**:
+
+## Core User Journeys
+
+<!-- Describe the 3-5 most important flows a user will complete. -->
+
+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 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)
+
+## Technical Constraints
+
+<!-- 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

@@ -0,0 +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;;;;EAItC,KAAK,CAAC,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyDlB,CAAC;AACF,CAAC"}

package/dist/plan/config-writer.d.ts

@@ -0,0 +1,6 @@
+export interface PartialConfigInput {
+    name: string;
+    description: string;
+}
+export declare function writePartialConfig(outputDir: string, input: PartialConfigInput): Promise<string>;
+//# sourceMappingURL=config-writer.d.ts.map

package/dist/plan/config-writer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-writer.d.ts","sourceRoot":"","sources":["../../src/plan/config-writer.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,wBAAsB,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,MAAM,CAAC,CAgBtG"}

package/dist/plan/config-writer.js

@@ -0,0 +1,18 @@
+import { join } from 'node:path';
+import { mkdir, writeFile } from 'node:fs/promises';
+export async function writePartialConfig(outputDir, input) {
+    await mkdir(outputDir, { recursive: true });
+    const content = [
+        `project:`,
+        `  name: ${input.name}`,
+        `  description: >-`,
+        `    ${input.description}`,
+        ``,
+        `# Run maxsim-flutter create to complete your project setup`,
+        `# after filling in the project-brief-template.md`,
+    ].join('\n');
+    const filePath = join(outputDir, 'maxsim.config.yaml');
+    await writeFile(filePath, content, 'utf-8');
+    return filePath;
+}
+//# sourceMappingURL=config-writer.js.map

package/dist/plan/config-writer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-writer.js","sourceRoot":"","sources":["../../src/plan/config-writer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAOpD,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,SAAiB,EAAE,KAAyB;IACnF,MAAM,KAAK,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAE5C,MAAM,OAAO,GAAG;QACd,UAAU;QACV,WAAW,KAAK,CAAC,IAAI,EAAE;QACvB,mBAAmB;QACnB,OAAO,KAAK,CAAC,WAAW,EAAE;QAC1B,EAAE;QACF,4DAA4D;QAC5D,kDAAkD;KACnD,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAEb,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,EAAE,oBAAoB,CAAC,CAAC;IACvD,MAAM,SAAS,CAAC,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IAC5C,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/plan/plan-orchestrator.d.ts

@@ -0,0 +1,3 @@
+import type { PlanInput, PlanResult } from './types.js';
+export declare function runPlan(input: PlanInput): Promise<PlanResult>;
+//# sourceMappingURL=plan-orchestrator.d.ts.map

package/dist/plan/plan-orchestrator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan-orchestrator.d.ts","sourceRoot":"","sources":["../../src/plan/plan-orchestrator.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAKxD,wBAAsB,OAAO,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,CA6BnE"}

package/dist/plan/plan-orchestrator.js

@@ -0,0 +1,31 @@
+import { join } from 'node:path';
+import { mkdir, writeFile } from 'node:fs/promises';
+import { writePartialConfig } from './config-writer.js';
+import { generateBriefTemplate } from './brief-template-generator.js';
+import { generatePlanAppSkill } from './skill-generator.js';
+export async function runPlan(input) {
+    const { name, description, outputDir } = input;
+    const filesCreated = [];
+    // Create project directory
+    await mkdir(outputDir, { recursive: true });
+    // Write partial maxsim.config.yaml
+    const configPath = await writePartialConfig(outputDir, { name, description });
+    filesCreated.push(configPath);
+    // Write .claude/skills/plan-app.md
+    const skillsDir = join(outputDir, '.claude', 'skills');
+    await mkdir(skillsDir, { recursive: true });
+    const skillPath = join(skillsDir, 'plan-app.md');
+    await writeFile(skillPath, generatePlanAppSkill({ name, description }), 'utf-8');
+    filesCreated.push(skillPath);
+    // Write docs/project-brief-template.md
+    const docsDir = join(outputDir, 'docs');
+    await mkdir(docsDir, { recursive: true });
+    const briefPath = join(docsDir, 'project-brief-template.md');
+    await writeFile(briefPath, generateBriefTemplate({ name, description }), 'utf-8');
+    filesCreated.push(briefPath);
+    return {
+        projectDir: outputDir,
+        filesCreated,
+    };
+}
+//# sourceMappingURL=plan-orchestrator.js.map

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

@@ -0,0 +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,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

@@ -0,0 +1,6 @@
+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

@@ -0,0 +1 @@
+{"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,CAmF/D"}

package/dist/plan/skill-generator.js

@@ -0,0 +1,84 @@
+export function generatePlanAppSkill(input) {
+    const name = input?.name ?? 'your_app';
+    const description = input?.description ?? 'A Flutter app';
+    return `---
+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 — ${name}
+
+You are a product planning expert helping design a Flutter app using maxsim-flutter.
+
+**Project**: ${name}
+**Description**: ${description}
+
+> **Important**: Ask questions one at a time. Wait for the user's answer before asking the next question.
+
+---
+
+## 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
+
+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)?
+
+---
+
+## After Collecting Answers
+
+Once you have answers to all questions, generate:
+
+1. **Updated \`maxsim.config.yaml\`** with selected modules
+2. **\`prd.json\`** with user stories organized by phase
+3. **\`docs/architecture.md\`** with system design overview
+
+Then tell the user:
+\`\`\`
+maxsim-flutter create --config maxsim.config.yaml
+\`\`\`
+`;
+}
+//# sourceMappingURL=skill-generator.js.map

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

@@ -0,0 +1 @@
+{"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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA0DrD,CAAC;AACF,CAAC"}

package/dist/plan/types.d.ts

@@ -0,0 +1,11 @@
+export interface PlanInput {
+    name: string;
+    description: string;
+    outputDir: string;
+}
+export interface PlanResult {
+    projectDir: string;
+    filesCreated: string[];
+}
+export declare function isValidSnakeCase(name: string): boolean;
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/plan/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,UAAU;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAGtD"}

package/dist/plan/types.js

@@ -0,0 +1,6 @@
+export function isValidSnakeCase(name) {
+    if (!name)
+        return false;
+    return /^[a-z][a-z0-9_]*$/.test(name);
+}
+//# sourceMappingURL=types.js.map

package/dist/plan/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/plan/types.ts"],"names":[],"mappings":"AAWA,MAAM,UAAU,gBAAgB,CAAC,IAAY;IAC3C,IAAI,CAAC,IAAI;QAAE,OAAO,KAAK,CAAC;IACxB,OAAO,mBAAmB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACxC,CAAC"}

package/package.json

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