@itz4blitz/agentful 0.1.9 → 0.1.11

package/.claude/commands/agentful-status.md

@@ -9,6 +9,43 @@ This command shows the current state of autonomous product development.
 
 ## Display Format
 
+### Product Readiness (if `.agentful/product-analysis.json` exists)
+
+Display this section FIRST, before the header:
+
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+Product Readiness: 85% ⚠️
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+Completeness:    92% ✅
+Clarity:         88% ⚠️
+Feasibility:     78% ⚠️
+Testability:     85% ⚠️
+Consistency:     82% ⚠️
+
+⚠️  2 blocking issues - run /agentful-product to resolve
+
+⚠️  Product spec has minor gaps - recommend refinement
+
+Last analyzed: 2 hours ago
+Update: /agentful-product
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+```
+
+Emoji guidelines for scores:
+- 90-100%: ✅
+- 70-89%: ⚠️
+- Below 70%: ❌
+
+Overall readiness status:
+- Score >= 90%: "✅ Product spec is ready for development"
+- Score >= 70%: "⚠️  Product spec has minor gaps - recommend refinement"
+- Score < 70%: "❌ Product spec needs refinement before development"
+
+Blocking issues line only shows if there are blocking issues (count > 0).
+
 ### Header
 
 ```
@@ -81,10 +118,16 @@ Iterations: 24
 
 Read and display:
 
-1. `.agentful/state.json` - Current work, phase, iterations
-2. `.agentful/completion.json` - Features and gates
-3. `.agentful/decisions.json` - Pending decisions
-4. `.claude/product/index.md` - Product name and overview
+1. `.agentful/product-analysis.json` (optional) - Product readiness score and breakdown
+   - Only display product readiness section if this file exists
+   - Calculate emoji based on score thresholds (90-100: ✅, 70-89: ⚠️, <70: ❌)
+   - Show blocking issues count if > 0
+   - Format timestamp as relative time (e.g., "2 hours ago", "just now", "3 days ago")
+
+2. `.agentful/state.json` - Current work, phase, iterations
+3. `.agentful/completion.json` - Features and gates
+4. `.agentful/decisions.json` - Pending decisions
+5. `.claude/product/index.md` - Product name and overview
 
 Format the output nicely with ASCII art for readability.
 

package/.claude/commands/agentful.md

@@ -40,8 +40,19 @@ npx @itz4blitz/agentful init
 | `/agentful-status` | Show completion percentage, current work |
 | `/agentful-validate` | Run quality gates (tests, lint, security) |
 | `/agentful-decide` | Answer blocking decisions |
+| `/agentful-product` | Smart product requirements planning and analysis |
 | `/agentful` | Show this reference |
 
+### Product Planning (Optional)
+
+Before starting development, you can use `/agentful-product` to:
+- Create and refine product specifications
+- Analyze requirements for gaps and ambiguities
+- Get a readiness score before development begins
+- Resolve blocking issues interactively
+
+This is optional but recommended for complex projects. Run `/agentful-product` to get started.
+
 ## How It Works
 
 ### 1. Define Your Product
@@ -308,6 +319,7 @@ It learns **your project's patterns** and generates agents that match your conve
 │  └─ Template creation                       │
 ├─────────────────────────────────────────────┤
 │  Slash Commands (Claude Code)               │
+│  ├─ /agentful-product (requirements)        │
 │  ├─ /agentful-start  (orchestrator)        │
 │  ├─ /agentful-status (progress)             │
 │  ├─ /agentful-validate (quality gates)      │

package/README.md

@@ -21,7 +21,24 @@ This command creates the necessary directory structure and configuration files i
 
 ### 1. Define Product Specification
 
-After initialization, edit your product specification file with features and requirements.
+After initialization, define your product requirements:
+
+#### Option A: Interactive Planning (Recommended)
+
+```bash
+claude  # Start Claude Code
+```
+
+Use `/agentful-product` for guided product planning:
+- **New projects**: Interactive Q&A creates your product spec
+- **Existing specs**: Analyzes for gaps, ambiguities, blocking issues
+- **Readiness scoring**: Get a score (0-100) before development
+- **Issue resolution**: Walk through blocking issues with smart suggestions
+- **Q&A mode**: Ask planning questions in context
+
+#### Option B: Manual Creation
+
+Create your specification manually:
 
 **Flat structure** (single file at project root):
 - `PRODUCT.md` - All features in one file
@@ -132,6 +149,7 @@ Runtime state is stored in `.agentful/`:
 
 | Command | Description |
 |---------|-------------|
+| `/agentful-product` | Smart product planning: create, analyze, and refine requirements |
 | `/agentful-start` | Start or resume autonomous development |
 | `/agentful-status` | Display progress and current state |
 | `/agentful-validate` | Run all quality checks |

package/bin/cli.js

@@ -339,79 +339,48 @@ ${analysis && analysis.domains.length > 0 ? analysis.domains.map((d, i) => `${i
   // Update .gitignore
   checkGitignore();
 
-  // Perform smart project analysis (unless explicitly disabled)
+  // Perform essential project detection (unless explicitly disabled)
   if (smart) {
     console.log('');
-    log(colors.bright, '🔍 Analyzing your project...');
+    log(colors.bright, '🔍 Detecting project essentials...');
     console.log('');
 
     try {
-      const startTime = Date.now();
       analysis = await analyzeProject(targetDir);
       await exportToArchitectureJson(targetDir, analysis);
-      const duration = ((Date.now() - startTime) / 1000).toFixed(1);
 
-      // Show detected tech stack
+      // Show only essential info
       if (analysis.language && analysis.language !== 'unknown') {
         log(colors.cyan, `  Language:    ${analysis.language}`);
-        if (analysis.primaryLanguage && analysis.primaryLanguage !== analysis.language) {
-          log(colors.dim, `  Primary:     ${analysis.primaryLanguage}`);
-        }
       }
 
       if (analysis.frameworks.length > 0) {
-        log(colors.cyan, `  Frameworks:  ${analysis.frameworks.join(', ')}`);
+        log(colors.cyan, `  Framework:   ${analysis.frameworks[0]}`);
       }
 
       if (analysis.packageManager && analysis.packageManager !== 'unknown') {
         log(colors.cyan, `  Package Mgr: ${analysis.packageManager}`);
       }
 
-      if (analysis.buildSystem && analysis.buildSystem !== 'unknown') {
-        log(colors.cyan, `  Build:       ${analysis.buildSystem}`);
-      }
-
       console.log('');
+      log(colors.dim, `  ✓ Detection complete`);
 
-      // Show detected domains
-      if (analysis.domains.length > 0) {
-        log(colors.bright, '📊 Detected domains:');
-        console.log('');
-
-        analysis.domains.slice(0, 5).forEach(domain => {
-          const confidence = analysis.domainConfidence[domain] || 0.5;
-          const confidenceBar = '█'.repeat(Math.round(confidence * 10)) + '░'.repeat(10 - Math.round(confidence * 10));
-          const confidencePct = Math.round(confidence * 100);
-
-          // Color code based on confidence
-          let confidenceColor = colors.red;
-          if (confidence >= 0.8) confidenceColor = colors.green;
-          else if (confidence >= 0.5) confidenceColor = colors.yellow;
-
-          log(confidenceColor, `  • ${domain.padEnd(20)} ${confidenceBar} ${confidencePct}%`);
-        });
-
-        if (analysis.domains.length > 5) {
-          log(colors.dim, `  ... and ${analysis.domains.length - 5} more`);
-        }
-
-        console.log('');
-      }
-
-      log(colors.dim, `  Analysis completed in ${duration}s (${Math.round(analysis.confidence * 100)}% confidence)`);
-
-      // Show warnings if any
+      // Show critical warnings only
       if (analysis.warnings && analysis.warnings.length > 0) {
-        console.log('');
-        log(colors.yellow, '⚠️  Warnings:');
-        analysis.warnings.slice(0, 3).forEach(warning => {
-          log(colors.dim, `  • ${warning}`);
-        });
+        const criticalWarnings = analysis.warnings.filter(w =>
+          w.includes('empty') || w.includes('not detect')
+        );
+        if (criticalWarnings.length > 0) {
+          console.log('');
+          log(colors.yellow, '⚠️  Warnings:');
+          criticalWarnings.forEach(warning => {
+            log(colors.dim, `  • ${warning}`);
+          });
+        }
       }
 
     } catch (error) {
-      log(colors.dim, '  ⊙ Smart analysis skipped (project may be empty or unsupported)');
-      log(colors.dim, `     Error: ${error.message}`);
+      log(colors.dim, '  ⊙ Detection skipped (project may be empty)');
       analysis = null;
     }
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@itz4blitz/agentful",
-  "version": "0.1.9",
+  "version": "0.1.11",
   "description": "Autonomous product development kit for Claude Code with smart product analysis and natural conversation",
   "type": "module",
   "bin": {

package/version.json

@@ -1,3 +1,3 @@
 {
-  "version": "0.1.9"
+  "version": "0.1.11"
 }