@specforge/mcp 2.1.6 → 2.3.0

package/dist/cli/templates/agents/index.js

@@ -0,0 +1,63 @@
+/**
+ * Agent Templates Module
+ *
+ * Defines all SpecForge agent templates for scaffolding to AI CLI tools.
+ */
+// Import core agents
+import { SFAG_ORCHESTRATOR } from './content/core/sfag-orchestrator.js';
+import { SFAG_IMPLEMENTER } from './content/core/sfag-implementer.js';
+import { SFAG_SPEC_CREATOR } from './content/core/sfag-spec-creator.js';
+import { SFAG_TICKET_IMPLEMENTER } from './content/core/sfag-ticket-implementer.js';
+// Import task-type agents
+import { SFAG_API_IMPLEMENTER } from './content/task-type/sfag-api-implementer.js';
+import { SFAG_SCHEMA_DESIGNER } from './content/task-type/sfag-schema-designer.js';
+import { SFAG_FRONTEND_BUILDER } from './content/task-type/sfag-frontend-builder.js';
+import { SFAG_INFRA_ARCHITECT } from './content/task-type/sfag-infra-architect.js';
+import { SFAG_TEST_WRITER } from './content/task-type/sfag-test-writer.js';
+import { SFAG_DOCS_WRITER } from './content/task-type/sfag-docs-writer.js';
+// Import research agents
+import { SFAG_PACKAGE_RESEARCHER } from './content/research/sfag-package-researcher.js';
+/**
+ * All agent templates
+ */
+const AGENT_TEMPLATES = [
+    // Core agents
+    SFAG_ORCHESTRATOR,
+    SFAG_IMPLEMENTER,
+    SFAG_SPEC_CREATOR,
+    SFAG_TICKET_IMPLEMENTER,
+    // Task-type agents
+    SFAG_API_IMPLEMENTER,
+    SFAG_SCHEMA_DESIGNER,
+    SFAG_FRONTEND_BUILDER,
+    SFAG_INFRA_ARCHITECT,
+    SFAG_TEST_WRITER,
+    SFAG_DOCS_WRITER,
+    // Research agents
+    SFAG_PACKAGE_RESEARCHER,
+];
+/**
+ * Get all agent templates
+ */
+export function getAgentTemplates() {
+    return AGENT_TEMPLATES;
+}
+/**
+ * Get a specific agent template by name
+ */
+export function getAgentTemplate(name) {
+    return AGENT_TEMPLATES.find(t => t.name === name);
+}
+/**
+ * Get agent templates by category
+ */
+export function getAgentsByCategory(category) {
+    return AGENT_TEMPLATES.filter(t => t.category === category);
+}
+/**
+ * Get all agent template names
+ */
+export function getAgentNames() {
+    return AGENT_TEMPLATES.map(t => t.name);
+}
+//# sourceMappingURL=index.js.map

package/dist/cli/templates/agents/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/cli/templates/agents/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,qBAAqB;AACrB,OAAO,EAAE,iBAAiB,EAAE,MAAM,qCAAqC,CAAC;AACxE,OAAO,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAC;AACtE,OAAO,EAAE,iBAAiB,EAAE,MAAM,qCAAqC,CAAC;AACxE,OAAO,EAAE,uBAAuB,EAAE,MAAM,2CAA2C,CAAC;AAEpF,0BAA0B;AAC1B,OAAO,EAAE,oBAAoB,EAAE,MAAM,6CAA6C,CAAC;AACnF,OAAO,EAAE,oBAAoB,EAAE,MAAM,6CAA6C,CAAC;AACnF,OAAO,EAAE,qBAAqB,EAAE,MAAM,8CAA8C,CAAC;AACrF,OAAO,EAAE,oBAAoB,EAAE,MAAM,6CAA6C,CAAC;AACnF,OAAO,EAAE,gBAAgB,EAAE,MAAM,yCAAyC,CAAC;AAC3E,OAAO,EAAE,gBAAgB,EAAE,MAAM,yCAAyC,CAAC;AAE3E,yBAAyB;AACzB,OAAO,EAAE,uBAAuB,EAAE,MAAM,+CAA+C,CAAC;AAExF;;GAEG;AACH,MAAM,eAAe,GAAoB;IACvC,cAAc;IACd,iBAAiB;IACjB,gBAAgB;IAChB,iBAAiB;IACjB,uBAAuB;IAEvB,mBAAmB;IACnB,oBAAoB;IACpB,oBAAoB;IACpB,qBAAqB;IACrB,oBAAoB;IACpB,gBAAgB;IAChB,gBAAgB;IAEhB,kBAAkB;IAClB,uBAAuB;CACxB,CAAC;AAEF;;GAEG;AACH,MAAM,UAAU,iBAAiB;IAC/B,OAAO,eAAe,CAAC;AACzB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAY;IAC3C,OAAO,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;AACpD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,QAAuB;IACzD,OAAO,eAAe,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC;AAC9D,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa;IAC3B,OAAO,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;AAC1C,CAAC"}

package/dist/cli/templates/content/sf-create-epics.d.ts

@@ -3,5 +3,5 @@
  *
  * Template for creating epics with epic-level patterns from plan phases.
  */
-export declare const SF_CREATE_EPICS_CONTENT = "# Create Epics (SpecForge)\n\nCreate epics for a specification with patterns extracted from plan phases.\n\n## Arguments\n- `$ARGUMENTS` - Required: Specification ID\n\n## Task\n\n### 1. Get Specification\n\n**MCP Calls:**\n```typescript\nget_specification($ARGUMENTS)\n```\n\n### 2. Read Original Plan\n\n**Logic:**\n- Locate original plan file from specification metadata\n- Parse plan phases/sections\n- Extract epic-level descriptions\n- Identify patterns per epic\n\n### 3. Create Epics\n\n**MCP Calls:**\n```typescript\n// For each phase/section in plan\nfor (const phase of phases) {\n  await create_epic({\n    specificationId: $ARGUMENTS,\n    title: phase.title,\n    description: phase.description,\n    patterns: phase.patterns,\n    order: phase.order\n  })\n}\n```\n\n### 4. Display Creation Results\n\n**Output:**\n```\n\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\nEPICS CREATED\n\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\nSpecification: {title}\n\nCREATED EPICS\n\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\nE1  \u2502 {title} \u2502 {description}\nE2  \u2502 {title} \u2502 {description}\nE3  \u2502 {title} \u2502 {description}\n\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\n\nNext: Run /sf-create-tickets <epic-id> for each epic\n```\n\n## Notes\n- Creates epic structure from plan phases\n- Preserves patterns for ticket creation\n- Use /sf-create-tickets for each epic\n";
+export declare const SF_CREATE_EPICS_CONTENT = "# Create Epics (SpecForge)\n\nCreate epics for a specification with objectives extracted from plan phases.\n\n## Arguments\n- `$ARGUMENTS` - Required: Specification ID\n\n## Task\n\n### 1. Get Specification\n\n**MCP Calls:**\n```typescript\nspecification({\n  operation: 'get',\n  specificationId: $ARGUMENTS,\n  include: ['epics', 'patterns']  // Get existing epics and inherited patterns\n})\n```\n\n### 2. Read Original Plan\n\n**Logic:**\n- Locate original plan file from specification metadata\n- Parse plan phases/sections\n- Extract epic-level titles, descriptions, and objectives\n- Identify epic-specific technical details\n\n### 3. Create Epics\n\n**MCP Calls:**\n```typescript\n// For each phase/section in plan\nfor (const phase of phases) {\n  await epic({\n    operation: 'create',\n\n    // === REQUIRED ===\n    specificationId: $ARGUMENTS,\n    title: phase.title,\n    description: phase.description,\n    objective: phase.objective,     // Clear goal statement\n\n    // === CORE (recommended) ===\n    content: phase.fullContent,     // Full markdown content\n    scope: phase.scope,             // What's in/out of scope\n    priority: 'high',               // high | medium | low\n    tags: ['phase1', 'backend'],\n    estimatedHours: 40,\n\n    // === PLANNING ===\n    goals: ['Implement X', 'Enable Y'],\n    acceptanceCriteria: ['Feature X works', 'Tests pass'],\n    guardrails: ['Do NOT break existing API'],\n    constraints: ['Must be backward compatible'],\n    assumptions: ['Database schema is stable'],\n    risks: ['May require migration'],\n\n    // === TECHNICAL ===\n    architecture: 'Service layer with repository pattern',\n    fileStructure: 'src/services/\\n  user.service.ts\\n  auth.service.ts',\n    techStack: ['typescript', 'prisma'],\n    dependencies: ['zod', '@prisma/client'],\n    apiContracts: { endpoints: [{ path: '/api/users', method: 'POST' }] },\n\n    // === PATTERN OVERRIDES (override spec-level patterns) ===\n    sharedPatterns: {\n      errorHandling: 'Custom error handling for this epic',\n      validation: 'Use zod schemas'\n    },\n    additionalImports: [\n      \"import { z } from 'zod'\",\n      \"import { PrismaClient } from '@prisma/client'\"\n    ],\n    commonFiles: {\n      'types.ts': 'Shared types for this epic',\n      'utils.ts': 'Epic-specific utilities'\n    }\n  })\n}\n```\n\n### 4. Display Creation Results\n\n**Output:**\n```\n\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\nEPICS CREATED\n\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\nSpecification: {title}\n\nCREATED EPICS\n\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\nE1  \u2502 {title} \u2502 {objective}\nE2  \u2502 {title} \u2502 {objective}\nE3  \u2502 {title} \u2502 {objective}\n\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\n\nNext: Run /sf-create-tickets <epic-id> for each epic\n```\n\n## Field Reference\n\n| Field | Required | Description |\n|-------|----------|-------------|\n| specificationId | \u2705 | Parent specification |\n| title | \u2705 | Epic title |\n| description | \u2705 | Epic description |\n| objective | \u2705 | Clear goal statement |\n| content | | Full markdown content |\n| scope | | In/out of scope |\n| goals | | Epic-specific goals |\n| guardrails | | What NOT to do |\n| architecture | | Epic-level design |\n| sharedPatterns | | Override spec patterns |\n| additionalImports | | Extra imports for tickets |\n\n## Notes\n- specificationId, title, description, and objective are required\n- sharedPatterns override specification-level patterns\n- additionalImports are added to spec-level commonImports\n- Use /sf-create-tickets for each epic after creation\n";
 //# sourceMappingURL=sf-create-epics.d.ts.map

package/dist/cli/templates/content/sf-create-epics.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sf-create-epics.d.ts","sourceRoot":"","sources":["../../../../src/cli/templates/content/sf-create-epics.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,eAAO,MAAM,uBAAuB,m9EA+DnC,CAAC"}
+{"version":3,"file":"sf-create-epics.d.ts","sourceRoot":"","sources":["../../../../src/cli/templates/content/sf-create-epics.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,eAAO,MAAM,uBAAuB,upJA0HnC,CAAC"}

package/dist/cli/templates/content/sf-create-epics.js

@@ -5,7 +5,7 @@
  */
 export const SF_CREATE_EPICS_CONTENT = `# Create Epics (SpecForge)
 
-Create epics for a specification with patterns extracted from plan phases.
+Create epics for a specification with objectives extracted from plan phases.
 
 ## Arguments
 - \`$ARGUMENTS\` - Required: Specification ID
@@ -16,7 +16,11 @@ Create epics for a specification with patterns extracted from plan phases.
 
 **MCP Calls:**
 \`\`\`typescript
-get_specification($ARGUMENTS)
+specification({
+  operation: 'get',
+  specificationId: $ARGUMENTS,
+  include: ['epics', 'patterns']  // Get existing epics and inherited patterns
+})
 \`\`\`
 
 ### 2. Read Original Plan
@@ -24,8 +28,8 @@ get_specification($ARGUMENTS)
 **Logic:**
 - Locate original plan file from specification metadata
 - Parse plan phases/sections
-- Extract epic-level descriptions
-- Identify patterns per epic
+- Extract epic-level titles, descriptions, and objectives
+- Identify epic-specific technical details
 
 ### 3. Create Epics
 
@@ -33,12 +37,50 @@ get_specification($ARGUMENTS)
 \`\`\`typescript
 // For each phase/section in plan
 for (const phase of phases) {
-  await create_epic({
+  await epic({
+    operation: 'create',
+
+    // === REQUIRED ===
     specificationId: $ARGUMENTS,
     title: phase.title,
     description: phase.description,
-    patterns: phase.patterns,
-    order: phase.order
+    objective: phase.objective,     // Clear goal statement
+
+    // === CORE (recommended) ===
+    content: phase.fullContent,     // Full markdown content
+    scope: phase.scope,             // What's in/out of scope
+    priority: 'high',               // high | medium | low
+    tags: ['phase1', 'backend'],
+    estimatedHours: 40,
+
+    // === PLANNING ===
+    goals: ['Implement X', 'Enable Y'],
+    acceptanceCriteria: ['Feature X works', 'Tests pass'],
+    guardrails: ['Do NOT break existing API'],
+    constraints: ['Must be backward compatible'],
+    assumptions: ['Database schema is stable'],
+    risks: ['May require migration'],
+
+    // === TECHNICAL ===
+    architecture: 'Service layer with repository pattern',
+    fileStructure: 'src/services/\\n  user.service.ts\\n  auth.service.ts',
+    techStack: ['typescript', 'prisma'],
+    dependencies: ['zod', '@prisma/client'],
+    apiContracts: { endpoints: [{ path: '/api/users', method: 'POST' }] },
+
+    // === PATTERN OVERRIDES (override spec-level patterns) ===
+    sharedPatterns: {
+      errorHandling: 'Custom error handling for this epic',
+      validation: 'Use zod schemas'
+    },
+    additionalImports: [
+      "import { z } from 'zod'",
+      "import { PrismaClient } from '@prisma/client'"
+    ],
+    commonFiles: {
+      'types.ts': 'Shared types for this epic',
+      'utils.ts': 'Epic-specific utilities'
+    }
   })
 }
 \`\`\`
@@ -54,17 +96,34 @@ Specification: {title}
 
 CREATED EPICS
 ─────────────────────────────────────────────────────────────────
-E1  │ {title} │ {description}
-E2  │ {title} │ {description}
-E3  │ {title} │ {description}
+E1  │ {title} │ {objective}
+E2  │ {title} │ {objective}
+E3  │ {title} │ {objective}
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 
 Next: Run /sf-create-tickets <epic-id> for each epic
 \`\`\`
 
+## Field Reference
+
+| Field | Required | Description |
+|-------|----------|-------------|
+| specificationId | ✅ | Parent specification |
+| title | ✅ | Epic title |
+| description | ✅ | Epic description |
+| objective | ✅ | Clear goal statement |
+| content | | Full markdown content |
+| scope | | In/out of scope |
+| goals | | Epic-specific goals |
+| guardrails | | What NOT to do |
+| architecture | | Epic-level design |
+| sharedPatterns | | Override spec patterns |
+| additionalImports | | Extra imports for tickets |
+
 ## Notes
-- Creates epic structure from plan phases
-- Preserves patterns for ticket creation
-- Use /sf-create-tickets for each epic
+- specificationId, title, description, and objective are required
+- sharedPatterns override specification-level patterns
+- additionalImports are added to spec-level commonImports
+- Use /sf-create-tickets for each epic after creation
 `;
 //# sourceMappingURL=sf-create-epics.js.map

package/dist/cli/templates/content/sf-create-epics.js.map

@@ -1 +1 @@
-{"version":3,"file":"sf-create-epics.js","sourceRoot":"","sources":["../../../../src/cli/templates/content/sf-create-epics.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,CAAC,MAAM,uBAAuB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+DtC,CAAC"}
+{"version":3,"file":"sf-create-epics.js","sourceRoot":"","sources":["../../../../src/cli/templates/content/sf-create-epics.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,CAAC,MAAM,uBAAuB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA0HtC,CAAC"}

package/dist/cli/templates/content/sf-create-spec.d.ts

@@ -3,5 +3,5 @@
  *
  * Template for creating a SpecForge specification with patterns from a plan.
  */
-export declare const SF_CREATE_SPEC_CONTENT = "# Create Specification (SpecForge)\n\nCreate a SpecForge specification structure with patterns extracted from a plan document.\n\n## Arguments\n- `$ARGUMENTS` - Required: Path to plan markdown file\n\n## Task\n\n### 1. Read and Analyze Plan\n\n**Logic:**\n- Read file at $ARGUMENTS\n- Extract specification metadata\n- Identify patterns and guardrails\n- Parse high-level structure\n- Extract success criteria\n\n### 2. Create Specification\n\n**MCP Calls:**\n```typescript\ncreate_specification({\n  title: extractedTitle,\n  description: extractedDescription,\n  patterns: extractedPatterns,\n  guardrails: extractedGuardrails,\n  successCriteria: extractedCriteria\n})\n```\n\n### 3. Display Creation Results\n\n**Output:**\n```\n\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\nSPECIFICATION CREATED\n\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\nTitle: {title}\nID:    {specificationId}\n\nEXTRACTED PATTERNS\n\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\u2022 {pattern1}\n\u2022 {pattern2}\n\u2022 {pattern3}\n\nGUARDRAILS\n\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\u2022 {guardrail1}\n\u2022 {guardrail2}\n\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\n\nNext: Run /sf-create-epics {specificationId} to create epics\n```\n\n## Notes\n- Creates specification structure only\n- Extracts patterns for epic/ticket creation\n- Use /sf-create-epics to add epics\n";
+export declare const SF_CREATE_SPEC_CONTENT = "# Create Specification (SpecForge)\n\nCreate a SpecForge specification structure with metadata extracted from a plan document.\n\n## Arguments\n- `$ARGUMENTS` - Required: Path to plan markdown file\n\n## Task\n\n### 1. Read and Analyze Plan\n\n**Logic:**\n- Read file at $ARGUMENTS\n- Extract specification title and description\n- Identify priority level (high/medium/low)\n- Parse tags from plan categories/themes\n- Extract goals, requirements, and constraints\n\n### 2. Create Specification\n\n**MCP Calls:**\n```typescript\nspecification({\n  operation: 'create',\n\n  // === REQUIRED ===\n  projectId: currentProjectId,\n  title: extractedTitle,\n\n  // === CORE (recommended) ===\n  description: shortSummary,        // 2-3 sentence summary\n  content: fullMarkdownContent,     // Full markdown content\n  background: problemContext,       // Why this exists\n  scope: scopeDefinition,           // What's in/out of scope\n  priority: 'high',                 // high | medium | low\n  tags: ['feature', 'api'],\n  estimatedHours: 40,\n  targetAudience: 'developers',\n\n  // === GOALS & REQUIREMENTS ===\n  goals: ['Enable X', 'Improve Y'],\n  requirements: ['Must do A', 'Must support B'],\n  nonFunctionalRequirements: ['< 100ms latency', '99.9% uptime'],\n  acceptanceCriteria: ['Users can X', 'System handles Y'],\n  successMetrics: ['50% reduction in Z'],\n\n  // === GUARDRAILS & RISKS ===\n  guardrails: ['Do NOT modify X', 'Avoid pattern Y'],\n  constraints: ['Must use existing auth', 'Budget limit'],\n  assumptions: ['Users have Node 18+'],\n  risks: ['Third-party API may change'],\n\n  // === TECHNICAL ===\n  architecture: 'Microservices with event-driven communication',\n  fileStructure: 'src/\\n  components/\\n  services/\\n  utils/',\n  techStack: ['typescript', 'react', 'node'],\n  dependencies: ['@aws-sdk/client-s3', 'zod'],\n  apiContracts: { endpoints: [{ path: '/api/v1/users', method: 'GET' }] },\n\n  // === PATTERN INHERITANCE (for epics/tickets) ===\n  codeStandards: {\n    errorHandling: 'Use Result<T, E> pattern',\n    naming: 'camelCase for functions, PascalCase for types'\n  },\n  commonImports: [\n    \"import { logger } from '@/lib/logger'\",\n    \"import { db } from '@/lib/db'\"\n  ],\n  returnTypes: {\n    success: '{ success: true, data: T }',\n    error: '{ success: false, error: string }'\n  },\n\n  // === VALIDATION (for CI/CD) ===\n  validationCommands: {\n    test: 'npm test',\n    lint: 'npm run lint',\n    build: 'npm run build',\n    typeCheck: 'npm run typecheck'\n  },\n  workingDirectory: './src',\n  outputDirectory: './dist'\n})\n```\n\n### 3. Display Creation Results\n\n**Output:**\n```\n\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\nSPECIFICATION CREATED\n\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\nTitle:    {title}\nID:       {specificationId}\nPriority: {priority}\n\nDESCRIPTION\n\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n{description}\n\nTAGS\n\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n{tags}\n\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\n\nNext: Run /sf-create-epics {specificationId} to create epics\n```\n\n## Field Reference\n\n| Field | Required | Description |\n|-------|----------|-------------|\n| projectId | \u2705 | Project to create spec in |\n| title | \u2705 | Specification title |\n| description | | Short summary |\n| content | | Full markdown content |\n| background | | Problem context |\n| scope | | In/out of scope |\n| goals | | Business objectives |\n| requirements | | Functional requirements |\n| guardrails | | What NOT to do |\n| architecture | | System design |\n| techStack | | Technologies used |\n| codeStandards | | Inherited by epics/tickets |\n\n## Notes\n- Only projectId and title are required\n- codeStandards, commonImports, returnTypes are inherited by child epics/tickets\n- Use /sf-create-epics to add epics after creation\n";
 //# sourceMappingURL=sf-create-spec.d.ts.map

package/dist/cli/templates/content/sf-create-spec.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sf-create-spec.d.ts","sourceRoot":"","sources":["../../../../src/cli/templates/content/sf-create-spec.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,eAAO,MAAM,sBAAsB,gxFA4DlC,CAAC"}
+{"version":3,"file":"sf-create-spec.d.ts","sourceRoot":"","sources":["../../../../src/cli/templates/content/sf-create-spec.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,eAAO,MAAM,sBAAsB,wsKAiIlC,CAAC"}

package/dist/cli/templates/content/sf-create-spec.js

@@ -5,7 +5,7 @@
  */
 export const SF_CREATE_SPEC_CONTENT = `# Create Specification (SpecForge)
 
-Create a SpecForge specification structure with patterns extracted from a plan document.
+Create a SpecForge specification structure with metadata extracted from a plan document.
 
 ## Arguments
 - \`$ARGUMENTS\` - Required: Path to plan markdown file
@@ -16,21 +16,75 @@ Create a SpecForge specification structure with patterns extracted from a plan d
 
 **Logic:**
 - Read file at $ARGUMENTS
-- Extract specification metadata
-- Identify patterns and guardrails
-- Parse high-level structure
-- Extract success criteria
+- Extract specification title and description
+- Identify priority level (high/medium/low)
+- Parse tags from plan categories/themes
+- Extract goals, requirements, and constraints
 
 ### 2. Create Specification
 
 **MCP Calls:**
 \`\`\`typescript
-create_specification({
+specification({
+  operation: 'create',
+
+  // === REQUIRED ===
+  projectId: currentProjectId,
   title: extractedTitle,
-  description: extractedDescription,
-  patterns: extractedPatterns,
-  guardrails: extractedGuardrails,
-  successCriteria: extractedCriteria
+
+  // === CORE (recommended) ===
+  description: shortSummary,        // 2-3 sentence summary
+  content: fullMarkdownContent,     // Full markdown content
+  background: problemContext,       // Why this exists
+  scope: scopeDefinition,           // What's in/out of scope
+  priority: 'high',                 // high | medium | low
+  tags: ['feature', 'api'],
+  estimatedHours: 40,
+  targetAudience: 'developers',
+
+  // === GOALS & REQUIREMENTS ===
+  goals: ['Enable X', 'Improve Y'],
+  requirements: ['Must do A', 'Must support B'],
+  nonFunctionalRequirements: ['< 100ms latency', '99.9% uptime'],
+  acceptanceCriteria: ['Users can X', 'System handles Y'],
+  successMetrics: ['50% reduction in Z'],
+
+  // === GUARDRAILS & RISKS ===
+  guardrails: ['Do NOT modify X', 'Avoid pattern Y'],
+  constraints: ['Must use existing auth', 'Budget limit'],
+  assumptions: ['Users have Node 18+'],
+  risks: ['Third-party API may change'],
+
+  // === TECHNICAL ===
+  architecture: 'Microservices with event-driven communication',
+  fileStructure: 'src/\\n  components/\\n  services/\\n  utils/',
+  techStack: ['typescript', 'react', 'node'],
+  dependencies: ['@aws-sdk/client-s3', 'zod'],
+  apiContracts: { endpoints: [{ path: '/api/v1/users', method: 'GET' }] },
+
+  // === PATTERN INHERITANCE (for epics/tickets) ===
+  codeStandards: {
+    errorHandling: 'Use Result<T, E> pattern',
+    naming: 'camelCase for functions, PascalCase for types'
+  },
+  commonImports: [
+    "import { logger } from '@/lib/logger'",
+    "import { db } from '@/lib/db'"
+  ],
+  returnTypes: {
+    success: '{ success: true, data: T }',
+    error: '{ success: false, error: string }'
+  },
+
+  // === VALIDATION (for CI/CD) ===
+  validationCommands: {
+    test: 'npm test',
+    lint: 'npm run lint',
+    build: 'npm run build',
+    typeCheck: 'npm run typecheck'
+  },
+  workingDirectory: './src',
+  outputDirectory: './dist'
 })
 \`\`\`
 
@@ -41,27 +95,42 @@ create_specification({
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 SPECIFICATION CREATED
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-Title: {title}
-ID:    {specificationId}
+Title:    {title}
+ID:       {specificationId}
+Priority: {priority}
 
-EXTRACTED PATTERNS
+DESCRIPTION
 ─────────────────────────────────────────────────────────────────
-• {pattern1}
-• {pattern2}
-• {pattern3}
+{description}
 
-GUARDRAILS
+TAGS
 ─────────────────────────────────────────────────────────────────
-• {guardrail1}
-• {guardrail2}
+{tags}
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 
 Next: Run /sf-create-epics {specificationId} to create epics
 \`\`\`
 
+## Field Reference
+
+| Field | Required | Description |
+|-------|----------|-------------|
+| projectId | ✅ | Project to create spec in |
+| title | ✅ | Specification title |
+| description | | Short summary |
+| content | | Full markdown content |
+| background | | Problem context |
+| scope | | In/out of scope |
+| goals | | Business objectives |
+| requirements | | Functional requirements |
+| guardrails | | What NOT to do |
+| architecture | | System design |
+| techStack | | Technologies used |
+| codeStandards | | Inherited by epics/tickets |
+
 ## Notes
-- Creates specification structure only
-- Extracts patterns for epic/ticket creation
-- Use /sf-create-epics to add epics
+- Only projectId and title are required
+- codeStandards, commonImports, returnTypes are inherited by child epics/tickets
+- Use /sf-create-epics to add epics after creation
 `;
 //# sourceMappingURL=sf-create-spec.js.map

package/dist/cli/templates/content/sf-create-spec.js.map

@@ -1 +1 @@
-{"version":3,"file":"sf-create-spec.js","sourceRoot":"","sources":["../../../../src/cli/templates/content/sf-create-spec.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,CAAC,MAAM,sBAAsB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4DrC,CAAC"}
+{"version":3,"file":"sf-create-spec.js","sourceRoot":"","sources":["../../../../src/cli/templates/content/sf-create-spec.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,CAAC,MAAM,sBAAsB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAiIrC,CAAC"}

package/dist/cli/templates/content/sf-create-tickets.d.ts

@@ -3,5 +3,5 @@
  *
  * Template for creating detailed tickets individually with full implementation context.
  */
-export declare const SF_CREATE_TICKETS_CONTENT = "# Create Tickets (SpecForge)\n\nCreate detailed tickets for an epic with full implementation context.\n\n## Arguments\n- `$ARGUMENTS` - Required: Epic ID\n\n## Task\n\n### 1. Get Epic Context\n\n**MCP Calls:**\n```typescript\nget_epic($ARGUMENTS)\nget_specification(epic.specificationId)\n```\n\n### 2. Extract Ticket Definitions\n\n**Logic:**\n- Read epic description and patterns\n- Parse task breakdown\n- Extract dependencies\n- Generate acceptance criteria\n- Add implementation guidance\n\n### 3. Create Tickets\n\n**MCP Calls:**\n```typescript\n// For each task in epic\nfor (const task of tasks) {\n  await create_ticket({\n    epicId: $ARGUMENTS,\n    title: task.title,\n    description: task.description,\n    acceptanceCriteria: task.criteria,\n    dependencies: task.dependencies,\n    implementationGuidance: task.guidance,\n    estimatedComplexity: task.complexity\n  })\n}\n```\n\n### 4. Display Creation Results\n\n**Output:**\n```\n\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\nTICKETS CREATED\n\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\nEpic: E{n} - {epicTitle}\n\nCREATED TICKETS\n\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\nE{n}-T1  \u2502 {title} \u2502 {complexity}\nE{n}-T2  \u2502 {title} \u2502 {complexity} \u2502 Depends: E{n}-T1\nE{n}-T3  \u2502 {title} \u2502 {complexity}\n\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\n\nTotal: {ticketCount} tickets created\n\nNext: Run /sf-status to see overall progress\n```\n\n## Notes\n- Creates tickets with full implementation details\n- Establishes dependency relationships\n- Use /sf-next to start implementation\n";
+export declare const SF_CREATE_TICKETS_CONTENT = "# Create Tickets (SpecForge)\n\nCreate detailed tickets for an epic with full implementation context.\n\n## Arguments\n- `$ARGUMENTS` - Required: Epic ID\n\n## Task\n\n### 1. Get Epic Context\n\n**MCP Calls:**\n```typescript\nepic({\n  operation: 'get',\n  epicId: $ARGUMENTS,\n  include: ['tickets', 'specification']  // Get existing tickets and parent spec\n})\n```\n\n### 2. Extract Ticket Definitions\n\n**Logic:**\n- Read epic description and objective\n- Parse task breakdown from epic content\n- Determine complexity and dependencies\n- Extract acceptance criteria for each ticket\n\n### 3. Create Tickets\n\n**MCP Calls:**\n```typescript\n// For each task in epic\nfor (const task of tasks) {\n  await ticket({\n    operation: 'create',\n\n    // === REQUIRED ===\n    epicId: $ARGUMENTS,\n    title: task.title,\n\n    // === CORE (recommended) ===\n    description: task.description,\n    priority: 'high',               // high | medium | low\n    complexity: 'medium',           // small | medium | large | xlarge\n    estimatedHours: 4,\n    tags: ['feature', 'api'],\n    notes: 'Watch out for edge case X',  // Warnings, considerations\n\n    // === ACCEPTANCE CRITERIA ===\n    acceptanceCriteria: [\n      'Function returns correct result for valid input',\n      'Function throws error for invalid input',\n      'Unit tests cover all branches'\n    ],\n\n    // === IMPLEMENTATION GUIDANCE ===\n    implementation: {\n      filesToCreate: ['src/services/user.service.ts'],\n      filesToModify: ['src/index.ts'],\n      steps: [\n        'Create UserService class',\n        'Implement createUser method',\n        'Add validation with zod',\n        'Write unit tests'\n      ],\n      testing: 'Use vitest with mocked database'\n    },\n    technicalDetails: {\n      approach: 'Repository pattern with dependency injection',\n      stack: ['typescript', 'prisma', 'zod'],\n      endpoints: ['/api/users POST'],\n      databaseChanges: ['Add users table']\n    },\n\n    // === CODE REFERENCES ===\n    codeReferences: [{\n      name: 'createUser',\n      language: 'typescript',\n      code: `async function createUser(data: CreateUserInput): Promise<User> {\n  const validated = createUserSchema.parse(data);\n  return await db.user.create({ data: validated });\n}`\n    }],\n    typeReferences: [{\n      name: 'CreateUserInput',\n      definition: `interface CreateUserInput {\n  email: string;\n  name: string;\n  role?: 'admin' | 'user';\n}`\n    }],\n\n    // === DEPENDENCIES ===\n    dependsOn: ['ticket-id-1', 'ticket-id-2']  // Must complete these first\n  })\n}\n```\n\n### 4. Display Creation Results\n\n**Output:**\n```\n\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\nTICKETS CREATED\n\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\nEpic: E{n} - {epicTitle}\n\nCREATED TICKETS\n\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\nE{n}-T1  \u2502 {title} \u2502 {complexity} \u2502 ready\nE{n}-T2  \u2502 {title} \u2502 {complexity} \u2502 pending (depends on T1)\nE{n}-T3  \u2502 {title} \u2502 {complexity} \u2502 ready\n\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\n\nTotal: {ticketCount} tickets created\n\nNext: Run /sf-status to see overall progress\n```\n\n## Field Reference\n\n| Field | Required | Description |\n|-------|----------|-------------|\n| epicId | \u2705 | Parent epic |\n| title | \u2705 | Ticket title |\n| description | | What to implement |\n| complexity | | small \\| medium \\| large \\| xlarge |\n| acceptanceCriteria | | Success criteria (array of strings) |\n| implementation | | Steps, files to create/modify |\n| technicalDetails | | Approach, stack, endpoints |\n| codeReferences | | Code snippets to guide implementation |\n| typeReferences | | Type definitions to implement |\n| dependsOn | | Ticket IDs that must complete first |\n| notes | | Warnings, edge cases, considerations |\n\n## Notes\n- Only epicId and title are required\n- Tickets with dependsOn start as 'pending', others as 'ready'\n- codeReferences and typeReferences provide implementation guidance\n- Use /sf-next to start working on ready tickets\n";
 //# sourceMappingURL=sf-create-tickets.d.ts.map

package/dist/cli/templates/content/sf-create-tickets.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sf-create-tickets.d.ts","sourceRoot":"","sources":["../../../../src/cli/templates/content/sf-create-tickets.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,eAAO,MAAM,yBAAyB,upFAqErC,CAAC"}
+{"version":3,"file":"sf-create-tickets.d.ts","sourceRoot":"","sources":["../../../../src/cli/templates/content/sf-create-tickets.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,eAAO,MAAM,yBAAyB,4kKA6IrC,CAAC"}

package/dist/cli/templates/content/sf-create-tickets.js

@@ -16,18 +16,20 @@ Create detailed tickets for an epic with full implementation context.
 
 **MCP Calls:**
 \`\`\`typescript
-get_epic($ARGUMENTS)
-get_specification(epic.specificationId)
+epic({
+  operation: 'get',
+  epicId: $ARGUMENTS,
+  include: ['tickets', 'specification']  // Get existing tickets and parent spec
+})
 \`\`\`
 
 ### 2. Extract Ticket Definitions
 
 **Logic:**
-- Read epic description and patterns
-- Parse task breakdown
-- Extract dependencies
-- Generate acceptance criteria
-- Add implementation guidance
+- Read epic description and objective
+- Parse task breakdown from epic content
+- Determine complexity and dependencies
+- Extract acceptance criteria for each ticket
 
 ### 3. Create Tickets
 
@@ -35,14 +37,67 @@ get_specification(epic.specificationId)
 \`\`\`typescript
 // For each task in epic
 for (const task of tasks) {
-  await create_ticket({
+  await ticket({
+    operation: 'create',
+
+    // === REQUIRED ===
     epicId: $ARGUMENTS,
     title: task.title,
+
+    // === CORE (recommended) ===
     description: task.description,
-    acceptanceCriteria: task.criteria,
-    dependencies: task.dependencies,
-    implementationGuidance: task.guidance,
-    estimatedComplexity: task.complexity
+    priority: 'high',               // high | medium | low
+    complexity: 'medium',           // small | medium | large | xlarge
+    estimatedHours: 4,
+    tags: ['feature', 'api'],
+    notes: 'Watch out for edge case X',  // Warnings, considerations
+
+    // === ACCEPTANCE CRITERIA ===
+    acceptanceCriteria: [
+      'Function returns correct result for valid input',
+      'Function throws error for invalid input',
+      'Unit tests cover all branches'
+    ],
+
+    // === IMPLEMENTATION GUIDANCE ===
+    implementation: {
+      filesToCreate: ['src/services/user.service.ts'],
+      filesToModify: ['src/index.ts'],
+      steps: [
+        'Create UserService class',
+        'Implement createUser method',
+        'Add validation with zod',
+        'Write unit tests'
+      ],
+      testing: 'Use vitest with mocked database'
+    },
+    technicalDetails: {
+      approach: 'Repository pattern with dependency injection',
+      stack: ['typescript', 'prisma', 'zod'],
+      endpoints: ['/api/users POST'],
+      databaseChanges: ['Add users table']
+    },
+
+    // === CODE REFERENCES ===
+    codeReferences: [{
+      name: 'createUser',
+      language: 'typescript',
+      code: \`async function createUser(data: CreateUserInput): Promise<User> {
+  const validated = createUserSchema.parse(data);
+  return await db.user.create({ data: validated });
+}\`
+    }],
+    typeReferences: [{
+      name: 'CreateUserInput',
+      definition: \`interface CreateUserInput {
+  email: string;
+  name: string;
+  role?: 'admin' | 'user';
+}\`
+    }],
+
+    // === DEPENDENCIES ===
+    dependsOn: ['ticket-id-1', 'ticket-id-2']  // Must complete these first
   })
 }
 \`\`\`
@@ -58,9 +113,9 @@ Epic: E{n} - {epicTitle}
 
 CREATED TICKETS
 ─────────────────────────────────────────────────────────────────
-E{n}-T1  │ {title} │ {complexity}
-E{n}-T2  │ {title} │ {complexity} │ Depends: E{n}-T1
-E{n}-T3  │ {title} │ {complexity}
+E{n}-T1  │ {title} │ {complexity} │ ready
+E{n}-T2  │ {title} │ {complexity} │ pending (depends on T1)
+E{n}-T3  │ {title} │ {complexity} │ ready
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 
 Total: {ticketCount} tickets created
@@ -68,9 +123,26 @@ Total: {ticketCount} tickets created
 Next: Run /sf-status to see overall progress
 \`\`\`
 
+## Field Reference
+
+| Field | Required | Description |
+|-------|----------|-------------|
+| epicId | ✅ | Parent epic |
+| title | ✅ | Ticket title |
+| description | | What to implement |
+| complexity | | small \\| medium \\| large \\| xlarge |
+| acceptanceCriteria | | Success criteria (array of strings) |
+| implementation | | Steps, files to create/modify |
+| technicalDetails | | Approach, stack, endpoints |
+| codeReferences | | Code snippets to guide implementation |
+| typeReferences | | Type definitions to implement |
+| dependsOn | | Ticket IDs that must complete first |
+| notes | | Warnings, edge cases, considerations |
+
 ## Notes
-- Creates tickets with full implementation details
-- Establishes dependency relationships
-- Use /sf-next to start implementation
+- Only epicId and title are required
+- Tickets with dependsOn start as 'pending', others as 'ready'
+- codeReferences and typeReferences provide implementation guidance
+- Use /sf-next to start working on ready tickets
 `;
 //# sourceMappingURL=sf-create-tickets.js.map

package/dist/cli/templates/content/sf-create-tickets.js.map

@@ -1 +1 @@
-{"version":3,"file":"sf-create-tickets.js","sourceRoot":"","sources":["../../../../src/cli/templates/content/sf-create-tickets.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,CAAC,MAAM,yBAAyB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAqExC,CAAC"}
+{"version":3,"file":"sf-create-tickets.js","sourceRoot":"","sources":["../../../../src/cli/templates/content/sf-create-tickets.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,CAAC,MAAM,yBAAyB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA6IxC,CAAC"}

package/dist/cli/templates/index.d.ts

@@ -1,7 +1,8 @@
 /**
  * Templates Module
  *
- * Exports all template functions for command scaffolding.
+ * Exports all template functions for command and agent scaffolding.
  */
 export { getCommandTemplates, getCommandTemplate, getCommandsByCategory } from './commands.js';
+export { getAgentTemplates, getAgentTemplate, getAgentsByCategory, getAgentNames, } from './agents/index.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/cli/templates/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/cli/templates/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/cli/templates/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAG/F,OAAO,EACL,iBAAiB,EACjB,gBAAgB,EAChB,mBAAmB,EACnB,aAAa,GACd,MAAM,mBAAmB,CAAC"}

package/dist/cli/templates/index.js

@@ -1,7 +1,10 @@
 /**
  * Templates Module
  *
- * Exports all template functions for command scaffolding.
+ * Exports all template functions for command and agent scaffolding.
  */
+// Command templates
 export { getCommandTemplates, getCommandTemplate, getCommandsByCategory } from './commands.js';
+// Agent templates
+export { getAgentTemplates, getAgentTemplate, getAgentsByCategory, getAgentNames, } from './agents/index.js';
 //# sourceMappingURL=index.js.map

package/dist/cli/templates/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/cli/templates/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/cli/templates/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,oBAAoB;AACpB,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAE/F,kBAAkB;AAClB,OAAO,EACL,iBAAiB,EACjB,gBAAgB,EAChB,mBAAmB,EACnB,aAAa,GACd,MAAM,mBAAmB,CAAC"}

package/dist/lib/index.d.ts

@@ -4,4 +4,5 @@
  * Exports shared utility modules for the MCP server.
  */
 export { type OutputFormat, formatResponse, formatArrayResponse, formatErrorResponse, formatSuccessResponse, isValidFormat, getFormatFromArgs, } from './format.js';
+export { type WorkflowStep, type WorkflowDefinition, type ReviewChecklistItem, type ReviewWorkflowDefinition, type FinalizeWorkflowDefinition, type WorkflowType, CREATION_WORKFLOW, IMPLEMENTATION_WORKFLOW, REVIEW_WORKFLOW, FINALIZE_WORKFLOW, WORKFLOW_TYPES, getWorkflowDefinition, } from './workflow-definitions.js';
 //# sourceMappingURL=index.d.ts.map