mycontext-cli 1.0.81 → 1.0.83

package/README.md

@@ -39,6 +39,8 @@ mycontext generate-components all --with-tests
 - **⚡ Fast Setup**: Initialize projects in seconds with Next.js, TypeScript, and Tailwind CSS
 - **🎨 Component Generation**: Create production-ready React components with Shadcn UI
 - **📋 Context-Aware**: Generates PRDs, types, and branding based on your project
+- **🧠 Interactive Strategy Planning**: AI-powered build strategy recommendations through guided questions
+- **🎯 Smart Planning**: Get personalized development approach recommendations
 - **🔧 Developer-Friendly**: Built-in validation, testing, and preview capabilities
 - **🆓 Free Tier**: Use Qwen3 Coder model for free testing, or premium X.AI/Claude for production
 
@@ -80,6 +82,132 @@ mycontext list [type]                  # List components, projects, or files
 mycontext promote                      # Promote components to production
 ```
 
+### Build Strategy Planning
+
+```bash
+mycontext build-strategy               # Interactive strategy selection
+mycontext build-strategy --recommend  # Get AI-powered strategy recommendations
+mycontext build-strategy --plan       # Generate detailed build plan
+mycontext build-strategy --tasks      # Generate task list for current phase
+mycontext build-strategy --compare    # Compare all available strategies
+mycontext build-strategy --context    # Show loaded project context
+mycontext build-strategy --list       # List all saved strategy files
+mycontext build-strategy --load <type> # Load saved strategy data
+```
+
+## Build Strategy Planning
+
+MyContext's **AI-Powered Build Strategy** feature helps you choose the right development approach for your project through interactive questions and AI-generated recommendations.
+
+### How It Works
+
+1. **Interactive Questions**: Asks about your project type, complexity, timeline, and team size
+2. **AI Processing**: Uses AI to analyze your answers and project context
+3. **Strategic Recommendations**: Generates personalized development strategies
+4. **Strategy Comparison**: Shows different approaches with pros/cons and timelines
+
+### Available Strategies
+
+- **🏗️ Foundation First**: Build core infrastructure first (auth, DB, architecture)
+- **🎯 Vertical Slice**: Build complete user journeys end-to-end
+- **📊 Horizontal Slice**: Build feature by feature across the app
+- **🔄 Iterative Scaffolding**: Small chunks everywhere, refine later
+- **⚡ Hybrid Approach**: Combines multiple strategies based on project needs
+
+### Interactive Strategy Selection
+
+The system provides:
+
+- **Project Type Selection**: Choose from client work, personal projects, team development, etc.
+- **Complexity Assessment**: Simple, medium, or complex application classification
+- **Timeline Planning**: Urgent, moderate, or flexible development timelines
+- **Team Size Consideration**: Solo developer, small team, or large team approaches
+- **AI Recommendations**: Personalized strategy suggestions based on your answers
+
+### Example Workflow
+
+```bash
+$ mycontext build-strategy --recommend
+
+🎯 Getting AI-Powered Strategy Recommendations
+
+? What type of project are you building?
+❯ Client Work
+  Personal Project
+  Team Development
+  MVP Development
+  Enterprise Application
+
+? How complex is your application?
+❯ Simple (few features, single user type)
+  Medium (multiple features, some complexity)
+  Complex (many features, multiple user types)
+
+? What's your timeline?
+❯ Urgent (need demo ASAP)
+  Moderate (balanced approach)
+  Flexible (quality over speed)
+
+? What's your team size?
+❯ Solo developer
+  Small team (2-5 people)
+  Large team (6+ people)
+
+✅ Recommended Strategies:
+
+🎯 Vertical Slice
+   Build complete user journeys end-to-end
+   Time to first demo: 2-3 weeks
+   Complexity: medium
+
+💡 Reasoning:
+   Vertical slice approach recommended for balanced development with quick user value
+
+💾 Saved to: /path/to/project/.mycontext/build-strategy-recommendations-2024-01-15.json
+```
+
+### Strategy Data Management
+
+All generated strategies are automatically saved as JSON files in `.mycontext/` for easy access and project tracking:
+
+```bash
+# List all saved strategy files
+mycontext build-strategy --list
+
+# Load specific strategy data
+mycontext build-strategy --load recommendations
+mycontext build-strategy --load plan
+mycontext build-strategy --load tasks
+mycontext build-strategy --load comparison
+```
+
+**File Structure:**
+
+```
+.mycontext/
+├── build-strategy-recommendations-2024-01-15.json
+├── build-strategy-plan-2024-01-15.json
+├── build-strategy-tasks-2024-01-15.json
+└── build-strategy-comparison-2024-01-15.json
+```
+
+**TypeScript Integration:**
+
+```typescript
+import { BuildStrategyManager } from "./buildStrategyManager";
+
+const manager = new BuildStrategyManager();
+
+// Load latest recommendations
+const recommendations = await manager.loadStrategyData("recommendations");
+
+// Load specific date
+const plan = await manager.loadStrategyData("plan", "2024-01-15");
+
+// List all available files
+const files = await manager.listStrategyFiles();
+```
+
 ## Configuration
 
 ### AI Providers
@@ -156,6 +284,25 @@ mycontext generate-components authentication
 mycontext build-app --description "E-commerce platform" --interactive
 ```
 
+### Plan Your Development Strategy
+
+```bash
+# Get AI-powered strategy recommendations
+mycontext build-strategy --recommend
+
+# Generate detailed build plan
+mycontext build-strategy --plan --strategy vertical-slice
+
+# Get task list for current phase
+mycontext build-strategy --tasks --strategy foundation-first --phase 1
+
+# Compare all strategies
+mycontext build-strategy --compare
+
+# Show project context analysis
+mycontext build-strategy --context
+```
+
 ## Documentation
 
 - [Full Documentation](https://mycontext.fbien.com/docs)

package/dist/agents/implementations/BuildStrategyAgent.d.ts

@@ -0,0 +1,99 @@
+import { SubAgent } from "../interfaces/SubAgent";
+export interface BuildStrategyInput {
+    projectPath: string;
+    strategyType?: "recommend" | "plan" | "tasks" | "compare";
+    specificStrategy?: string;
+    phaseNumber?: number;
+    userPreferences?: {
+        projectType: "client" | "personal" | "team" | "mvp" | "enterprise";
+        complexity: "simple" | "medium" | "complex";
+        userRoles: "single" | "multiple";
+        timeline: "urgent" | "moderate" | "flexible";
+        teamSize: "solo" | "small" | "large";
+    };
+}
+export interface BuildStrategyOutput {
+    strategy: {
+        id: string;
+        name: string;
+        description: string;
+        icon: string;
+        complexity: "low" | "medium" | "high";
+        timeToFirstDemo: string;
+        bestFor: string[];
+        pros: string[];
+        cons: string[];
+        phases: BuildPhase[];
+    };
+    recommendations?: {
+        recommended: any[];
+        reasoning: string;
+        alternatives: any[];
+    };
+    plan?: {
+        strategy: any;
+        plan: any[];
+        totalDuration: string;
+        milestones: string[];
+    };
+    taskList?: {
+        phase: BuildPhase;
+        tasks: TaskDetail[];
+    };
+    contextAnalysis: {
+        projectName: string;
+        description: string;
+        components: string[];
+        userRoles: string[];
+        techStack: string[];
+        contextCompleteness: number;
+        accuracyLevel: "excellent" | "good" | "limited";
+    };
+    llmInsights: {
+        projectComplexity: string;
+        riskFactors: string[];
+        successFactors: string[];
+        customRecommendations: string[];
+    };
+}
+export interface BuildPhase {
+    phase: number;
+    name: string;
+    duration: string;
+    tasks: string[];
+    deliverables: string[];
+    successCriteria: string;
+}
+export interface TaskDetail {
+    id: string;
+    title: string;
+    description: string;
+    priority: "high" | "medium" | "low";
+    estimatedTime: string;
+    dependencies: string[];
+    deliverables: string[];
+}
+export declare class BuildStrategyAgent implements SubAgent<BuildStrategyInput, BuildStrategyOutput> {
+    name: string;
+    description: string;
+    personality: string;
+    llmProvider: string;
+    expertise: string[];
+    private aiClient;
+    private contextLoader;
+    constructor();
+    run(input: BuildStrategyInput): Promise<BuildStrategyOutput>;
+    validate(input: BuildStrategyInput): Promise<boolean>;
+    cleanup(): Promise<void>;
+    getStatus(): Promise<any>;
+    private analyzeProjectContext;
+    private generateLLMInsights;
+    private generateRecommendations;
+    private generateBuildPlan;
+    private generateTaskList;
+    private generateComparison;
+    private getDefaultStrategy;
+    private getDefaultPhase;
+    private getDefaultTask;
+}
+//# sourceMappingURL=BuildStrategyAgent.d.ts.map

package/dist/agents/implementations/BuildStrategyAgent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BuildStrategyAgent.d.ts","sourceRoot":"","sources":["../../../src/agents/implementations/BuildStrategyAgent.ts"],"names":[],"mappings":"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"}