mindforge-cc 11.8.2 → 11.9.0

package/.mindforge/dynamic-workflows/scripts/design-system-audit.js

@@ -10,106 +10,104 @@ export const meta = {
   ],
 };
 
-export default async function run({ agent, parallel, pipeline, phase, log, args, budget }) {
-  const INVENTORY_SCHEMA = {
-    type: 'object',
-    properties: {
-      stylingApproach: { type: 'string' },
-      tokenFiles: { type: 'array', items: { type: 'string' } },
-      componentFiles: { type: 'array', items: { type: 'string' } },
-      designSystem: { type: 'string' },
-    },
-    required: ['stylingApproach', 'componentFiles'],
-  };
+const INVENTORY_SCHEMA = {
+  type: 'object',
+  properties: {
+    stylingApproach: { type: 'string' },
+    tokenFiles: { type: 'array', items: { type: 'string' } },
+    componentFiles: { type: 'array', items: { type: 'string' } },
+    designSystem: { type: 'string' },
+  },
+  required: ['stylingApproach', 'componentFiles'],
+};
 
-  const DIM_SCHEMA = {
-    type: 'object',
-    properties: {
-      dimension: { type: 'string' },
-      score: { type: 'number' },
-      violations: {
-        type: 'array',
-        items: {
-          type: 'object',
-          properties: {
-            file: { type: 'string' },
-            severity: { type: 'string', enum: ['critical', 'high', 'medium', 'low'] },
-            description: { type: 'string' },
-            fix: { type: 'string' },
-          },
-          required: ['severity', 'description', 'fix'],
+const DIM_SCHEMA = {
+  type: 'object',
+  properties: {
+    dimension: { type: 'string' },
+    score: { type: 'number' },
+    violations: {
+      type: 'array',
+      items: {
+        type: 'object',
+        properties: {
+          file: { type: 'string' },
+          severity: { type: 'string', enum: ['critical', 'high', 'medium', 'low'] },
+          description: { type: 'string' },
+          fix: { type: 'string' },
         },
+        required: ['severity', 'description', 'fix'],
       },
-      positives: { type: 'array', items: { type: 'string' } },
     },
-    required: ['dimension', 'score', 'violations'],
-  };
+    positives: { type: 'array', items: { type: 'string' } },
+  },
+  required: ['dimension', 'score', 'violations'],
+};
 
-  const REPORT_SCHEMA = {
-    type: 'object',
-    properties: {
-      overallScore: { type: 'number' },
-      summary: { type: 'string' },
-      dimensionScores: {
-        type: 'array',
-        items: {
-          type: 'object',
-          properties: {
-            dimension: { type: 'string' },
-            score: { type: 'number' },
-            topIssue: { type: 'string' },
-          },
-          required: ['dimension', 'score', 'topIssue'],
+const REPORT_SCHEMA = {
+  type: 'object',
+  properties: {
+    overallScore: { type: 'number' },
+    summary: { type: 'string' },
+    dimensionScores: {
+      type: 'array',
+      items: {
+        type: 'object',
+        properties: {
+          dimension: { type: 'string' },
+          score: { type: 'number' },
+          topIssue: { type: 'string' },
         },
+        required: ['dimension', 'score', 'topIssue'],
       },
-      topFixes: { type: 'array', items: { type: 'string' } },
-      tokenizationGaps: { type: 'array', items: { type: 'string' } },
     },
-    required: ['overallScore', 'summary', 'dimensionScores', 'topFixes'],
-  };
+    topFixes: { type: 'array', items: { type: 'string' } },
+    tokenizationGaps: { type: 'array', items: { type: 'string' } },
+  },
+  required: ['overallScore', 'summary', 'dimensionScores', 'topFixes'],
+};
 
-  const target = args || 'current codebase (run from repo root)';
+const target = args || 'current codebase (run from repo root)';
 
-  phase('Inventory');
-  log(`Design system audit target: ${target}`);
-  const inventory = await agent(
-    `Inventory the design system foundations of: "${target}". Identify: (1) styling approach (CSS modules, Tailwind, styled-components, CSS-in-JS, etc.), (2) design token files (variables, theme files, constants), (3) component files (UI components, primitives), (4) which design system library is used if any (shadcn, MUI, Chakra, etc.).`,
-    { schema: INVENTORY_SCHEMA, label: 'inventory' }
-  );
-  if (!inventory) { log('Warning: agent returned null for inventory, skipping'); return { target, error: 'agent-null' }; }
-  log(`Styling: ${inventory.stylingApproach}, ${inventory.componentFiles.length} component files`);
+phase('Inventory');
+log(`Design system audit target: ${target}`);
+const inventory = await agent(
+  `Inventory the design system foundations of: "${target}". Identify: (1) styling approach (CSS modules, Tailwind, styled-components, CSS-in-JS, etc.), (2) design token files (variables, theme files, constants), (3) component files (UI components, primitives), (4) which design system library is used if any (shadcn, MUI, Chakra, etc.).`,
+  { schema: INVENTORY_SCHEMA, label: 'inventory' }
+);
+if (!inventory) { log('Warning: agent returned null for inventory, skipping'); return { target, error: 'agent-null' }; }
+log(`Styling: ${inventory.stylingApproach}, ${inventory.componentFiles.length} component files`);
 
-  phase('Audit');
-  const ctx = `Styling: ${inventory.stylingApproach}. Design system: ${inventory.designSystem || 'custom'}. Token files: ${(inventory.tokenFiles || []).join(', ')}`;
+phase('Audit');
+const ctx = `Styling: ${inventory.stylingApproach}. Design system: ${inventory.designSystem || 'custom'}. Token files: ${(inventory.tokenFiles || []).join(', ')}`;
 
-  const DIMENSIONS = [
-    { label: 'spacing', prompt: `Audit SPACING CONSISTENCY in: "${target}". ${ctx}. Check: Are spacing values taken from a defined scale (4px/8px/16px etc.)? Are there magic numbers (arbitrary pixel values)? Is padding/margin/gap consistent for similar components? Are layout spacings reusing tokens? Score 0-100 (100=perfectly consistent) and list all violations with fixes.` },
-    { label: 'color', prompt: `Audit COLOR USAGE in: "${target}". ${ctx}. Check: Are colors from the defined palette/tokens only? Are there hardcoded hex values that bypass tokens? Is color used for meaning (red=error, green=success) consistently? Are brand colors consistent? Score 0-100 and list all violations.` },
-    { label: 'typography', prompt: `Audit TYPOGRAPHY SCALE in: "${target}". ${ctx}. Check: Are font sizes from a defined type scale? Are font weights consistent for similar hierarchy levels? Are line-heights defined? Is the heading hierarchy (h1>h2>h3) visually consistent? Score 0-100 and list violations.` },
-    { label: 'icons', prompt: `Audit ICON CONSISTENCY in: "${target}". ${ctx}. Check: Is a single icon library used consistently? Are icon sizes consistent for the same context (nav icons vs inline icons)? Are icon meanings consistent (same icon for same action everywhere)? Are there mixed icon styles (outline vs filled)? Score 0-100 and list violations.` },
-    { label: 'accessibility', prompt: `Audit ACCESSIBILITY in the design system of: "${target}". ${ctx}. Check: Do color combinations meet WCAG AA contrast ratio (4.5:1 for normal text, 3:1 for large)? Are interactive elements at least 44x44px touch targets? Are focus states visible? Are disabled states visually distinct? Score 0-100 and list violations.` },
-  ];
+const DIMENSIONS = [
+  { label: 'spacing', prompt: `Audit SPACING CONSISTENCY in: "${target}". ${ctx}. Check: Are spacing values taken from a defined scale (4px/8px/16px etc.)? Are there magic numbers (arbitrary pixel values)? Is padding/margin/gap consistent for similar components? Are layout spacings reusing tokens? Score 0-100 (100=perfectly consistent) and list all violations with fixes.` },
+  { label: 'color', prompt: `Audit COLOR USAGE in: "${target}". ${ctx}. Check: Are colors from the defined palette/tokens only? Are there hardcoded hex values that bypass tokens? Is color used for meaning (red=error, green=success) consistently? Are brand colors consistent? Score 0-100 and list all violations.` },
+  { label: 'typography', prompt: `Audit TYPOGRAPHY SCALE in: "${target}". ${ctx}. Check: Are font sizes from a defined type scale? Are font weights consistent for similar hierarchy levels? Are line-heights defined? Is the heading hierarchy (h1>h2>h3) visually consistent? Score 0-100 and list violations.` },
+  { label: 'icons', prompt: `Audit ICON CONSISTENCY in: "${target}". ${ctx}. Check: Is a single icon library used consistently? Are icon sizes consistent for the same context (nav icons vs inline icons)? Are icon meanings consistent (same icon for same action everywhere)? Are there mixed icon styles (outline vs filled)? Score 0-100 and list violations.` },
+  { label: 'accessibility', prompt: `Audit ACCESSIBILITY in the design system of: "${target}". ${ctx}. Check: Do color combinations meet WCAG AA contrast ratio (4.5:1 for normal text, 3:1 for large)? Are interactive elements at least 44x44px touch targets? Are focus states visible? Are disabled states visually distinct? Score 0-100 and list violations.` },
+];
 
-  const auditResults = await parallel(
-    DIMENSIONS.map(d => () => agent(d.prompt, { schema: DIM_SCHEMA, label: `audit:${d.label}`, phase: 'Audit' }))
-  );
+const auditResults = await parallel(
+  DIMENSIONS.map(d => () => agent(d.prompt, { schema: DIM_SCHEMA, label: `audit:${d.label}`, phase: 'Audit' }))
+);
 
-  phase('Score');
-  const validAudits = auditResults.filter(Boolean);
-  const avgScore = validAudits.length > 0
-    ? Math.round(validAudits.reduce((sum, a) => sum + (a.score || 0), 0) / validAudits.length)
-    : 0;
-  log(`Dimension scores: ${validAudits.map(a => `${a.dimension}=${a.score}`).join(', ')} | Overall: ${avgScore}`);
+phase('Score');
+const validAudits = auditResults.filter(Boolean);
+const avgScore = validAudits.length > 0
+  ? Math.round(validAudits.reduce((sum, a) => sum + (a.score || 0), 0) / validAudits.length)
+  : 0;
+log(`Dimension scores: ${validAudits.map(a => `${a.dimension}=${a.score}`).join(', ')} | Overall: ${avgScore}`);
 
-  phase('Report');
-  const dimSummary = validAudits.map(a => `${a.dimension}: ${a.score}/100, top issue: ${(a.violations[0] || {}).description || 'none'}`).join('\n');
-  const allViolations = validAudits.flatMap(a => a.violations.map(v => `[${a.dimension}/${v.severity}] ${v.description}`)).slice(0, 15).join('\n');
+phase('Report');
+const dimSummary = validAudits.map(a => `${a.dimension}: ${a.score}/100, top issue: ${(a.violations[0] || {}).description || 'none'}`).join('\n');
+const allViolations = validAudits.flatMap(a => a.violations.map(v => `[${a.dimension}/${v.severity}] ${v.description}`)).slice(0, 15).join('\n');
 
-  const report = await agent(
-    `Generate a design system health report for: "${target}"\n\nDimension scores:\n${dimSummary}\n\nTop violations:\n${allViolations}\n\nOverall consistency score: ${avgScore}/100\n\nProvide: executive summary, dimension score table with top issue each, top 5 priority fixes, and which values should be tokenized but aren't.`,
-    { schema: REPORT_SCHEMA, label: 'report' }
-  );
-  if (!report) { return { target, inventory, audits: validAudits, error: 'report-agent-null' }; }
+const report = await agent(
+  `Generate a design system health report for: "${target}"\n\nDimension scores:\n${dimSummary}\n\nTop violations:\n${allViolations}\n\nOverall consistency score: ${avgScore}/100\n\nProvide: executive summary, dimension score table with top issue each, top 5 priority fixes, and which values should be tokenized but aren't.`,
+  { schema: REPORT_SCHEMA, label: 'report' }
+);
+if (!report) { return { target, inventory, audits: validAudits, error: 'report-agent-null' }; }
 
-  return { target, inventory, audits: validAudits, report };
-}
+return { target, inventory, audits: validAudits, report };

package/.mindforge/dynamic-workflows/scripts/documentation-gen.js

@@ -10,82 +10,80 @@ export const meta = {
   ],
 };
 
-export default async function run({ agent, parallel, pipeline, phase, log, args, budget }) {
-  const FILE_LIST_SCHEMA = {
-    type: 'object',
-    properties: {
-      files: {
-        type: 'array',
-        items: {
-          type: 'object',
-          properties: {
-            path: { type: 'string' },
-            type: { type: 'string', enum: ['module', 'class', 'function', 'api-route', 'config', 'util'] },
-            priority: { type: 'string', enum: ['high', 'medium', 'low'] },
-            currentDocStatus: { type: 'string', enum: ['none', 'partial', 'outdated', 'current'] },
-          },
-          required: ['path', 'type', 'priority', 'currentDocStatus'],
+const FILE_LIST_SCHEMA = {
+  type: 'object',
+  properties: {
+    files: {
+      type: 'array',
+      items: {
+        type: 'object',
+        properties: {
+          path: { type: 'string' },
+          type: { type: 'string', enum: ['module', 'class', 'function', 'api-route', 'config', 'util'] },
+          priority: { type: 'string', enum: ['high', 'medium', 'low'] },
+          currentDocStatus: { type: 'string', enum: ['none', 'partial', 'outdated', 'current'] },
         },
+        required: ['path', 'type', 'priority', 'currentDocStatus'],
       },
     },
-    required: ['files'],
-  };
+  },
+  required: ['files'],
+};
 
-  const DOC_SCHEMA = {
-    type: 'object',
-    properties: {
-      path: { type: 'string' },
-      summary: { type: 'string' },
-      description: { type: 'string' },
-      parameters: { type: 'array', items: { type: 'object', properties: { name: { type: 'string' }, type: { type: 'string' }, description: { type: 'string' }, required: { type: 'boolean' } }, required: ['name', 'type', 'description'] } },
-      returns: { type: 'string' },
-      examples: { type: 'array', items: { type: 'string' } },
-      sideEffects: { type: 'array', items: { type: 'string' } },
-    },
-    required: ['path', 'summary', 'description'],
-  };
+const DOC_SCHEMA = {
+  type: 'object',
+  properties: {
+    path: { type: 'string' },
+    summary: { type: 'string' },
+    description: { type: 'string' },
+    parameters: { type: 'array', items: { type: 'object', properties: { name: { type: 'string' }, type: { type: 'string' }, description: { type: 'string' }, required: { type: 'boolean' } }, required: ['name', 'type', 'description'] } },
+    returns: { type: 'string' },
+    examples: { type: 'array', items: { type: 'string' } },
+    sideEffects: { type: 'array', items: { type: 'string' } },
+  },
+  required: ['path', 'summary', 'description'],
+};
 
-  const PUBLISH_SCHEMA = {
-    type: 'object',
-    properties: {
-      readmeSection: { type: 'string' },
-      apiReference: { type: 'string' },
-      quickStart: { type: 'string' },
-      changelogEntries: { type: 'array', items: { type: 'string' } },
-    },
-    required: ['readmeSection', 'apiReference', 'quickStart'],
-  };
+const PUBLISH_SCHEMA = {
+  type: 'object',
+  properties: {
+    readmeSection: { type: 'string' },
+    apiReference: { type: 'string' },
+    quickStart: { type: 'string' },
+    changelogEntries: { type: 'array', items: { type: 'string' } },
+  },
+  required: ['readmeSection', 'apiReference', 'quickStart'],
+};
 
-  const target = args || 'current codebase (run from repo root)';
+const target = args || 'current codebase (run from repo root)';
 
-  phase('Scope');
-  log(`Scoping documentation for: ${target}`);
-  const fileList = await agent(
-    `Discover all files in: "${target}" that need documentation. Focus on: public APIs, exported functions/classes, route handlers, configuration modules. For each file note its type (module/class/function/api-route/config/util), documentation priority (high=public API, medium=internal, low=util), and current doc status (none/partial/outdated/current). Skip test files and auto-generated files.`,
-    { schema: FILE_LIST_SCHEMA, label: 'scope' }
-  );
+phase('Scope');
+log(`Scoping documentation for: ${target}`);
+const fileList = await agent(
+  `Discover all files in: "${target}" that need documentation. Focus on: public APIs, exported functions/classes, route handlers, configuration modules. For each file note its type (module/class/function/api-route/config/util), documentation priority (high=public API, medium=internal, low=util), and current doc status (none/partial/outdated/current). Skip test files and auto-generated files.`,
+  { schema: FILE_LIST_SCHEMA, label: 'scope' }
+);
 
-  const highAndMedium = ((fileList || {}).files || []).filter(f => f.priority === 'high' || f.priority === 'medium').slice(0, 15);
-  log(`Generating docs for ${highAndMedium.length} priority files`);
+const highAndMedium = ((fileList || {}).files || []).filter(f => f.priority === 'high' || f.priority === 'medium').slice(0, 15);
+log(`Generating docs for ${highAndMedium.length} priority files`);
 
-  phase('Generate');
-  const docs = await parallel(
-    highAndMedium.map(f => () => agent(
-      `Generate complete documentation for the file at "${f.path}" in codebase: "${target}". It is a ${f.type}. Write: (1) one-line summary, (2) full description with purpose and usage context, (3) all parameters with types and descriptions, (4) return value description, (5) 1-2 concrete usage examples, (6) any side effects or important caveats.`,
-      { schema: DOC_SCHEMA, label: `doc:${f.path.split('/').pop().replace('.', '-')}`, phase: 'Generate' }
-    ))
-  );
+phase('Generate');
+const docs = await parallel(
+  highAndMedium.map(f => () => agent(
+    `Generate complete documentation for the file at "${f.path}" in codebase: "${target}". It is a ${f.type}. Write: (1) one-line summary, (2) full description with purpose and usage context, (3) all parameters with types and descriptions, (4) return value description, (5) 1-2 concrete usage examples, (6) any side effects or important caveats.`,
+    { schema: DOC_SCHEMA, label: `doc:${f.path.split('/').pop().replace('.', '-')}`, phase: 'Generate' }
+  ))
+);
 
-  phase('Normalize');
-  const validDocs = docs.filter(Boolean);
-  const docSummaries = validDocs.map(d => `${d.path}: ${d.summary}`).join('\n');
-  log(`${validDocs.length} docs generated — normalizing style`);
+phase('Normalize');
+const validDocs = docs.filter(Boolean);
+const docSummaries = validDocs.map(d => `${d.path}: ${d.summary}`).join('\n');
+log(`${validDocs.length} docs generated — normalizing style`);
 
-  phase('Publish');
-  const publish = await agent(
-    `Assemble publish-ready documentation for: "${target}"\n\nGenerated docs:\n${docSummaries}\n\nProduce: (1) README API section (markdown table of all public exports with one-line descriptions), (2) full API reference (each entry with params, returns, example), (3) quick-start guide showing the most common 3-5 use cases, (4) CHANGELOG entry lines for newly documented items.`,
-    { schema: PUBLISH_SCHEMA, label: 'publish' }
-  );
+phase('Publish');
+const publish = await agent(
+  `Assemble publish-ready documentation for: "${target}"\n\nGenerated docs:\n${docSummaries}\n\nProduce: (1) README API section (markdown table of all public exports with one-line descriptions), (2) full API reference (each entry with params, returns, example), (3) quick-start guide showing the most common 3-5 use cases, (4) CHANGELOG entry lines for newly documented items.`,
+  { schema: PUBLISH_SCHEMA, label: 'publish' }
+);
 
-  return { target, fileList, docs: validDocs, publish };
-}
+return { target, fileList, docs: validDocs, publish };

package/.mindforge/dynamic-workflows/scripts/feature-planner.js

@@ -10,95 +10,93 @@ export const meta = {
   ],
 };
 
-export default async function run({ agent, parallel, pipeline, phase, log, args, budget }) {
-  const BRIEF_SCHEMA = {
-    type: 'object',
-    properties: {
-      featureName: { type: 'string' },
-      problem: { type: 'string' },
-      targetUsers: { type: 'string' },
-      successCriteria: { type: 'array', items: { type: 'string' } },
-      outOfScope: { type: 'array', items: { type: 'string' } },
-    },
-    required: ['featureName', 'problem', 'targetUsers', 'successCriteria', 'outOfScope'],
-  };
+const BRIEF_SCHEMA = {
+  type: 'object',
+  properties: {
+    featureName: { type: 'string' },
+    problem: { type: 'string' },
+    targetUsers: { type: 'string' },
+    successCriteria: { type: 'array', items: { type: 'string' } },
+    outOfScope: { type: 'array', items: { type: 'string' } },
+  },
+  required: ['featureName', 'problem', 'targetUsers', 'successCriteria', 'outOfScope'],
+};
 
-  const PRD_SCHEMA = {
-    type: 'object',
-    properties: {
-      overview: { type: 'string' },
-      requirements: { type: 'array', items: { type: 'object', properties: { id: { type: 'string' }, type: { type: 'string' }, description: { type: 'string' }, priority: { type: 'string' } }, required: ['id', 'type', 'description', 'priority'] } },
-      nonFunctional: { type: 'array', items: { type: 'string' } },
-      acceptanceCriteria: { type: 'array', items: { type: 'string' } },
-    },
-    required: ['overview', 'requirements', 'nonFunctional', 'acceptanceCriteria'],
-  };
+const PRD_SCHEMA = {
+  type: 'object',
+  properties: {
+    overview: { type: 'string' },
+    requirements: { type: 'array', items: { type: 'object', properties: { id: { type: 'string' }, type: { type: 'string' }, description: { type: 'string' }, priority: { type: 'string' } }, required: ['id', 'type', 'description', 'priority'] } },
+    nonFunctional: { type: 'array', items: { type: 'string' } },
+    acceptanceCriteria: { type: 'array', items: { type: 'string' } },
+  },
+  required: ['overview', 'requirements', 'nonFunctional', 'acceptanceCriteria'],
+};
 
-  const ARCH_SCHEMA = {
-    type: 'object',
-    properties: {
-      approach: { type: 'string' },
-      components: { type: 'array', items: { type: 'object', properties: { name: { type: 'string' }, responsibility: { type: 'string' } }, required: ['name', 'responsibility'] } },
-      dataFlow: { type: 'string' },
-      newFiles: { type: 'array', items: { type: 'string' } },
-      modifiedFiles: { type: 'array', items: { type: 'string' } },
-      risks: { type: 'array', items: { type: 'string' } },
-    },
-    required: ['approach', 'components', 'dataFlow', 'newFiles', 'modifiedFiles', 'risks'],
-  };
+const ARCH_SCHEMA = {
+  type: 'object',
+  properties: {
+    approach: { type: 'string' },
+    components: { type: 'array', items: { type: 'object', properties: { name: { type: 'string' }, responsibility: { type: 'string' } }, required: ['name', 'responsibility'] } },
+    dataFlow: { type: 'string' },
+    newFiles: { type: 'array', items: { type: 'string' } },
+    modifiedFiles: { type: 'array', items: { type: 'string' } },
+    risks: { type: 'array', items: { type: 'string' } },
+  },
+  required: ['approach', 'components', 'dataFlow', 'newFiles', 'modifiedFiles', 'risks'],
+};
 
-  const STORIES_SCHEMA = {
-    type: 'object',
-    properties: {
-      stories: {
-        type: 'array',
-        items: {
-          type: 'object',
-          properties: {
-            id: { type: 'string' },
-            title: { type: 'string' },
-            asA: { type: 'string' },
-            iWant: { type: 'string' },
-            soThat: { type: 'string' },
-            acceptanceCriteria: { type: 'array', items: { type: 'string' } },
-            estimate: { type: 'string' },
-          },
-          required: ['id', 'title', 'asA', 'iWant', 'soThat', 'acceptanceCriteria', 'estimate'],
+const STORIES_SCHEMA = {
+  type: 'object',
+  properties: {
+    stories: {
+      type: 'array',
+      items: {
+        type: 'object',
+        properties: {
+          id: { type: 'string' },
+          title: { type: 'string' },
+          asA: { type: 'string' },
+          iWant: { type: 'string' },
+          soThat: { type: 'string' },
+          acceptanceCriteria: { type: 'array', items: { type: 'string' } },
+          estimate: { type: 'string' },
         },
+        required: ['id', 'title', 'asA', 'iWant', 'soThat', 'acceptanceCriteria', 'estimate'],
       },
     },
-    required: ['stories'],
-  };
+  },
+  required: ['stories'],
+};
 
-  const feature = args || 'No feature described — pass your feature description as args.';
+const feature = args || 'No feature described — pass your feature description as args.';
 
-  phase('Brief');
-  log(`Feature: ${feature.slice(0, 60)}`);
-  const brief = await agent(
-    `Create a feature brief for: "${feature}". Clarify the core problem, target users, measurable success criteria, and explicit out-of-scope items.`,
-    { schema: BRIEF_SCHEMA, label: 'brief' }
-  );
+phase('Brief');
+log(`Feature: ${feature.slice(0, 60)}`);
+const brief = await agent(
+  `Create a feature brief for: "${feature}". Clarify the core problem, target users, measurable success criteria, and explicit out-of-scope items.`,
+  { schema: BRIEF_SCHEMA, label: 'brief' }
+);
 
-  phase('PRD');
-  const briefText = `Feature: ${brief.featureName}\nProblem: ${brief.problem}\nUsers: ${brief.targetUsers}\nSuccess: ${brief.successCriteria.join(', ')}`;
-  const prd = await agent(
-    `Write a product requirements document for this feature:\n${briefText}\n\nInclude functional requirements (must/should/could), non-functional requirements, and acceptance criteria.`,
-    { schema: PRD_SCHEMA, label: 'prd' }
-  );
+phase('PRD');
+const briefText = `Feature: ${brief.featureName}\nProblem: ${brief.problem}\nUsers: ${brief.targetUsers}\nSuccess: ${brief.successCriteria.join(', ')}`;
+const prd = await agent(
+  `Write a product requirements document for this feature:\n${briefText}\n\nInclude functional requirements (must/should/could), non-functional requirements, and acceptance criteria.`,
+  { schema: PRD_SCHEMA, label: 'prd' }
+);
 
-  phase('Architecture');
-  const reqSummary = prd.requirements.slice(0, 8).map(r => `${r.id} [${r.priority}]: ${r.description}`).join('\n');
-  const arch = await agent(
-    `Design the technical architecture for this feature:\nBrief: ${briefText}\nRequirements:\n${reqSummary}\n\nIdentify the implementation approach, components, data flow, files to create/modify, and key risks.`,
-    { schema: ARCH_SCHEMA, label: 'architecture' }
-  );
+phase('Architecture');
+const reqSummary = prd.requirements.slice(0, 8).map(r => `${r.id} [${r.priority}]: ${r.description}`).join('\n');
+const arch = await agent(
+  `Design the technical architecture for this feature:\nBrief: ${briefText}\nRequirements:\n${reqSummary}\n\nIdentify the implementation approach, components, data flow, files to create/modify, and key risks.`,
+  { schema: ARCH_SCHEMA, label: 'architecture' }
+);
 
-  phase('Stories');
-  const archSummary = `Approach: ${arch.approach}\nNew files: ${arch.newFiles.join(', ')}\nModified: ${arch.modifiedFiles.join(', ')}`;
-  const stories = await agent(
-    `Break this feature into user stories:\nBrief: ${briefText}\nArchitecture: ${archSummary}\n\nWrite stories in "As a [user], I want [goal], so that [benefit]" format with acceptance criteria and t-shirt size estimates (XS/S/M/L/XL).`,
-    { schema: STORIES_SCHEMA, label: 'stories' }
-  );
+phase('Stories');
+const archSummary = `Approach: ${arch.approach}\nNew files: ${arch.newFiles.join(', ')}\nModified: ${arch.modifiedFiles.join(', ')}`;
+const stories = await agent(
+  `Break this feature into user stories:\nBrief: ${briefText}\nArchitecture: ${archSummary}\n\nWrite stories in "As a [user], I want [goal], so that [benefit]" format with acceptance criteria and t-shirt size estimates (XS/S/M/L/XL).`,
+  { schema: STORIES_SCHEMA, label: 'stories' }
+);
 
-  return { feature, brief, prd, architecture: arch, stories: stories.stories };
-}
+return { feature, brief, prd, architecture: arch, stories: stories.stories };