@specforge/mcp 2.1.6 → 2.2.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/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

package/dist/lib/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/lib/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,KAAK,YAAY,EACjB,cAAc,EACd,mBAAmB,EACnB,mBAAmB,EACnB,qBAAqB,EACrB,aAAa,EACb,iBAAiB,GAClB,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/lib/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,KAAK,YAAY,EACjB,cAAc,EACd,mBAAmB,EACnB,mBAAmB,EACnB,qBAAqB,EACrB,aAAa,EACb,iBAAiB,GAClB,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,KAAK,YAAY,EACjB,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,EACxB,KAAK,wBAAwB,EAC7B,KAAK,0BAA0B,EAC/B,KAAK,YAAY,EACjB,iBAAiB,EACjB,uBAAuB,EACvB,eAAe,EACf,iBAAiB,EACjB,cAAc,EACd,qBAAqB,GACtB,MAAM,2BAA2B,CAAC"}

package/dist/lib/index.js

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

package/dist/lib/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/lib/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAEL,cAAc,EACd,mBAAmB,EACnB,mBAAmB,EACnB,qBAAqB,EACrB,aAAa,EACb,iBAAiB,GAClB,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/lib/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAEL,cAAc,EACd,mBAAmB,EACnB,mBAAmB,EACnB,qBAAqB,EACrB,aAAa,EACb,iBAAiB,GAClB,MAAM,aAAa,CAAC;AAErB,OAAO,EAOL,iBAAiB,EACjB,uBAAuB,EACvB,eAAe,EACf,iBAAiB,EACjB,cAAc,EACd,qBAAqB,GACtB,MAAM,2BAA2B,CAAC"}

package/dist/lib/workflow-definitions.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Workflow Definitions
+ *
+ * Contains the workflow definitions as data structures for guiding AI agents
+ * through SpecForge workflows.
+ */
+export interface WorkflowStep {
+    step: number;
+    name: string;
+    description: string;
+    tools: string[];
+    tips: string[];
+}
+export interface WorkflowDefinition {
+    name: string;
+    description: string;
+    philosophy: string[];
+    steps: WorkflowStep[];
+    antiPatterns: string[];
+}
+export interface ReviewChecklistItem {
+    name: string;
+    description: string;
+}
+export interface ReviewWorkflowDefinition extends WorkflowDefinition {
+    checklist: ReviewChecklistItem[];
+}
+export interface FinalizeWorkflowDefinition extends WorkflowDefinition {
+    prerequisites: string[];
+}
+export declare const CREATION_WORKFLOW: WorkflowDefinition;
+export declare const IMPLEMENTATION_WORKFLOW: WorkflowDefinition;
+export declare const REVIEW_WORKFLOW: ReviewWorkflowDefinition;
+export declare const FINALIZE_WORKFLOW: FinalizeWorkflowDefinition;
+/**
+ * Get a workflow definition by type
+ */
+export declare function getWorkflowDefinition(workflowType: string): WorkflowDefinition | ReviewWorkflowDefinition | FinalizeWorkflowDefinition | null;
+export declare const WORKFLOW_TYPES: readonly ["creation", "implementation", "review", "finalize"];
+export type WorkflowType = (typeof WORKFLOW_TYPES)[number];
+//# sourceMappingURL=workflow-definitions.d.ts.map

package/dist/lib/workflow-definitions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-definitions.d.ts","sourceRoot":"","sources":["../../src/lib/workflow-definitions.ts"],"names":[],"mappings":"AACA;;;;;GAKG;AAEH,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,KAAK,EAAE,YAAY,EAAE,CAAC;IACtB,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,wBAAyB,SAAQ,kBAAkB;IAClE,SAAS,EAAE,mBAAmB,EAAE,CAAC;CAClC;AAED,MAAM,WAAW,0BAA2B,SAAQ,kBAAkB;IACpE,aAAa,EAAE,MAAM,EAAE,CAAC;CACzB;AAED,eAAO,MAAM,iBAAiB,EAAE,kBA+G/B,CAAC;AAEF,eAAO,MAAM,uBAAuB,EAAE,kBAgKrC,CAAC;AAEF,eAAO,MAAM,eAAe,EAAE,wBAmG7B,CAAC;AAEF,eAAO,MAAM,iBAAiB,EAAE,0BA+G/B,CAAC;AAEF;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,YAAY,EAAE,MAAM,GACnB,kBAAkB,GAAG,wBAAwB,GAAG,0BAA0B,GAAG,IAAI,CAanF;AAED,eAAO,MAAM,cAAc,+DAAgE,CAAC;AAC5F,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,CAAC"}

package/dist/lib/workflow-definitions.js

@@ -0,0 +1,511 @@
+// mcp/src/lib/workflow-definitions.ts
+/**
+ * Workflow Definitions
+ *
+ * Contains the workflow definitions as data structures for guiding AI agents
+ * through SpecForge workflows.
+ */
+export const CREATION_WORKFLOW = {
+    name: 'creation',
+    description: 'Create specifications, epics, and tickets with rich context',
+    philosophy: [
+        'One entity at a time - never bulk create',
+        'More context = better AI implementation',
+        'When in doubt, ask the user',
+        'Invest in planning for first-run success',
+    ],
+    steps: [
+        {
+            step: 1,
+            name: 'understand_requirements',
+            description: 'Gather comprehensive requirements from user',
+            tools: [],
+            tips: [
+                'Ask about the problem being solved',
+                'Understand the target users',
+                'Clarify scope boundaries',
+                'Identify constraints and risks',
+            ],
+        },
+        {
+            step: 2,
+            name: 'create_specification',
+            description: 'Create specification with full context',
+            tools: ['specification.create'],
+            tips: [
+                'Include background and goals',
+                'Define guardrails (what NOT to do)',
+                'Set codeStandards for consistency',
+                'Add architecture overview',
+            ],
+        },
+        {
+            step: 3,
+            name: 'plan_epics',
+            description: 'Identify logical phases/groupings, discuss with user',
+            tools: [],
+            tips: [
+                'Break work into cohesive units',
+                'Consider dependencies between phases',
+                'Discuss timeline and priority with user',
+                'Keep epic count manageable (3-7 typical)',
+            ],
+        },
+        {
+            step: 4,
+            name: 'create_epic',
+            description: 'Create ONE epic with full context',
+            tools: ['epic.create'],
+            tips: [
+                'Define clear objective',
+                'Set scope boundaries',
+                'Include sharedPatterns for consistency',
+                'Add any epic-specific guardrails',
+            ],
+        },
+        {
+            step: 5,
+            name: 'plan_tickets',
+            description: 'Break epic into tickets, discuss dependencies with user',
+            tools: [],
+            tips: [
+                'Keep tickets small and focused',
+                'Identify clear acceptance criteria',
+                'Map out dependencies before creating',
+                'Discuss complexity with user',
+            ],
+        },
+        {
+            step: 6,
+            name: 'create_ticket',
+            description: 'Create ONE ticket with full details',
+            tools: ['ticket.create'],
+            tips: [
+                'Write detailed acceptanceCriteria',
+                'Include implementation hints',
+                'Add technicalDetails for complex logic',
+                'Specify files to modify if known',
+            ],
+        },
+        {
+            step: 7,
+            name: 'add_dependencies',
+            description: 'Link ticket to its dependencies',
+            tools: ['dependency.add'],
+            tips: [
+                'Only add true blocking dependencies',
+                'Avoid circular dependency chains',
+                'Keep dependency graph shallow when possible',
+            ],
+        },
+        {
+            step: 8,
+            name: 'repeat',
+            description: 'Continue tickets for current epic, then next epic',
+            tools: [],
+            tips: [
+                'Complete all tickets for an epic before moving on',
+                'Review epic completion before starting next',
+                'Adjust estimates as you learn more',
+            ],
+        },
+    ],
+    antiPatterns: [
+        'NEVER use bulk creation - always one at a time',
+        'NEVER skip asking user when details are unclear',
+        'NEVER create tickets without acceptance criteria',
+        'NEVER proceed without understanding dependencies',
+    ],
+};
+export const IMPLEMENTATION_WORKFLOW = {
+    name: 'implementation',
+    description: 'Implement tickets with session management',
+    philosophy: [
+        'Always get full context before starting',
+        'Start session before making changes',
+        'Report progress during implementation',
+        'Validate before completing',
+    ],
+    steps: [
+        {
+            step: 1,
+            name: 'get_context',
+            description: 'Understand current working context',
+            tools: ['context.working'],
+            tips: [
+                'Check for active sessions',
+                'Note the current specification/epic focus',
+                'Understand what has already been done',
+            ],
+        },
+        {
+            step: 2,
+            name: 'check_session',
+            description: 'Check if spec has an open session',
+            tools: ['context.working'],
+            tips: [
+                'If session exists, continue with that session ID',
+                'If no session, will start new one after selecting ticket',
+                'Only ONE session per spec at a time',
+            ],
+        },
+        {
+            step: 3,
+            name: 'find_work',
+            description: 'Find tickets ready to work on',
+            tools: ['workflow.next_actionable'],
+            tips: [
+                'Focus on unblocked tickets',
+                'Consider priority and complexity',
+                'Check if any tickets are already in progress',
+            ],
+        },
+        {
+            step: 4,
+            name: 'review_ticket',
+            description: 'Get full implementation context',
+            tools: ['context.implementation'],
+            tips: [
+                'Use depth=full for rich context',
+                'Read all related patterns',
+                'Understand acceptance criteria',
+            ],
+        },
+        {
+            step: 5,
+            name: 'clarify',
+            description: 'Ask user about unclear requirements',
+            tools: [],
+            tips: [
+                'ASK THE USER before proceeding if unclear',
+                'Confirm test environment preference',
+                'Verify any assumptions',
+            ],
+        },
+        {
+            step: 6,
+            name: 'start_session',
+            description: 'Start or continue implementation session',
+            tools: ['session.start'],
+            tips: [
+                'Session locks the specification',
+                'Prevents concurrent work conflicts',
+                'Tracks your progress and changes',
+            ],
+        },
+        {
+            step: 7,
+            name: 'implement',
+            description: 'Do the work, report progress',
+            tools: ['session.progress'],
+            tips: [
+                'Follow the patterns from context',
+                'Report meaningful progress updates',
+                'Commit logically grouped changes',
+            ],
+        },
+        {
+            step: 8,
+            name: 'validate',
+            description: 'Run tests, lint, typecheck',
+            tools: [],
+            tips: [
+                'Run validation as specified in ticket',
+                'Fix any failing tests before completing',
+                'Ensure no regressions',
+            ],
+        },
+        {
+            step: 9,
+            name: 'complete_ticket',
+            description: 'Complete the ticket with summary',
+            tools: ['session.complete'],
+            tips: [
+                'Include summary of what was done',
+                'Report validation results',
+                'Note any follow-up items',
+            ],
+        },
+        {
+            step: 10,
+            name: 'repeat_tickets',
+            description: 'Continue with next ticket in epic',
+            tools: ['workflow.next_actionable'],
+            tips: [
+                'Check what tickets are now unblocked',
+                'Continue until epic is complete',
+                'Then proceed to epic completion',
+            ],
+        },
+        {
+            step: 11,
+            name: 'epic_review',
+            description: 'Review all changes made in epic',
+            tools: ['epic.get'],
+            tips: [
+                'Check all tickets are done',
+                'Review integration between tickets',
+                'Run full test suite for epic scope',
+                'Check for regressions',
+            ],
+        },
+        {
+            step: 12,
+            name: 'epic_commit',
+            description: 'Create commit for the epic',
+            tools: [],
+            tips: [
+                'Stage all changes from epic tickets',
+                'Write descriptive commit message referencing epic',
+                'Include ticket numbers in commit',
+            ],
+        },
+        {
+            step: 13,
+            name: 'next_epic',
+            description: 'Move to next epic',
+            tools: ['epic.list', 'workflow.next_actionable'],
+            tips: [
+                'Find the next epic to work on',
+                'Repeat from step 3 (find_work)',
+            ],
+        },
+    ],
+    antiPatterns: [
+        'NEVER implement without reading full ticket context',
+        'NEVER skip session.start - it tracks your work',
+        'NEVER complete without running validation',
+        'NEVER assume - ask the user if unclear',
+    ],
+};
+export const REVIEW_WORKFLOW = {
+    name: 'review',
+    description: 'Review tickets for completeness and consistency before implementation',
+    philosophy: [
+        'Catch issues before implementation, not during',
+        'Consistency across all layers (DB, API, types)',
+        'Always ask about test environment preference',
+        'Document findings in ticket notes',
+    ],
+    checklist: [
+        { name: 'missing_points', description: 'Acceptance criteria complete? Edge cases?' },
+        { name: 'blind_spots', description: 'Security implications? What could go wrong?' },
+        { name: 'auth_patterns', description: 'Token handling? Permission checks?' },
+        { name: 'db_permissions', description: 'Row-level security? Audit requirements?' },
+        { name: 'field_naming', description: 'DB (snake_case) <-> API (camelCase) <-> Types match?' },
+        { name: 'documentation', description: 'API docs? README? Architecture docs need update?' },
+        { name: 'test_environment', description: 'ASK USER: Sandbox or local mocks?' },
+    ],
+    steps: [
+        {
+            step: 1,
+            name: 'select_ticket',
+            description: 'Choose ticket to review',
+            tools: ['ticket.get', 'workflow.next_actionable'],
+            tips: [
+                'Review tickets before they are implemented',
+                'Can review all pending tickets in an epic',
+            ],
+        },
+        {
+            step: 2,
+            name: 'load_context',
+            description: 'Get full implementation context with patterns',
+            tools: ['context.implementation'],
+            tips: [
+                'Use depth=full for comprehensive review',
+                'Understand the broader context',
+            ],
+        },
+        {
+            step: 3,
+            name: 'run_checklist',
+            description: 'Go through each review point systematically',
+            tools: [],
+            tips: [
+                'Check each item in the review checklist',
+                'Be thorough - issues found now save time later',
+            ],
+        },
+        {
+            step: 4,
+            name: 'identify_gaps',
+            description: 'List missing items, inconsistencies, concerns',
+            tools: [],
+            tips: [
+                'Document all findings',
+                'Prioritize by impact',
+                'Note any blocking issues',
+            ],
+        },
+        {
+            step: 5,
+            name: 'ask_user',
+            description: 'Clarify test environment preference',
+            tools: [],
+            tips: [
+                'ALWAYS ask about test environment',
+                'Sandbox (real services) vs local mocks',
+                'Document the decision',
+            ],
+        },
+        {
+            step: 6,
+            name: 'update_ticket',
+            description: 'Add findings to ticket notes or update acceptance criteria',
+            tools: ['ticket.update'],
+            tips: [
+                'Add findings to notes field',
+                'Update acceptance criteria if needed',
+                'Mark items that need user input',
+            ],
+        },
+        {
+            step: 7,
+            name: 'repeat',
+            description: 'Review next ticket',
+            tools: [],
+            tips: [
+                'Continue until all relevant tickets reviewed',
+                'Consider reviewing related tickets together',
+            ],
+        },
+    ],
+    antiPatterns: [
+        'NEVER skip the review checklist',
+        'NEVER assume test environment - always ask user',
+        'NEVER ignore field naming mismatches',
+        'NEVER proceed if auth patterns are unclear',
+    ],
+};
+export const FINALIZE_WORKFLOW = {
+    name: 'finalize',
+    description: 'Verify implementation, mark spec done, and create PR',
+    philosophy: [
+        'All epics must be complete before finalizing',
+        'Run full validation suite before PR',
+        'PR description should tell the full story',
+        'End session cleanly after PR creation',
+    ],
+    prerequisites: [
+        'All epics in specification are done',
+        'All tickets are completed',
+        'All epic commits have been made',
+    ],
+    steps: [
+        {
+            step: 1,
+            name: 'verify_completion',
+            description: 'Check all epics and tickets are done',
+            tools: ['specification.get', 'epic.list'],
+            tips: [
+                'Verify all epics are marked done',
+                'Check all tickets are completed',
+                'Look for any pending dependencies',
+            ],
+        },
+        {
+            step: 2,
+            name: 'full_validation',
+            description: 'Run complete test suite',
+            tools: [],
+            tips: [
+                'Run: npm test (or equivalent)',
+                'Run: npm run lint',
+                'Run: npm run build',
+                'All must pass before proceeding',
+            ],
+        },
+        {
+            step: 3,
+            name: 'integration_review',
+            description: 'Review cross-epic integration',
+            tools: [],
+            tips: [
+                'Check APIs work together',
+                'Verify data flows correctly',
+                'Look for regressions from epic interactions',
+            ],
+        },
+        {
+            step: 4,
+            name: 'documentation_check',
+            description: 'Verify all docs are updated',
+            tools: [],
+            tips: [
+                'API documentation updated',
+                'README changes if needed',
+                'Architecture docs if changed',
+            ],
+        },
+        {
+            step: 5,
+            name: 'final_commit',
+            description: 'Commit any cleanup changes',
+            tools: [],
+            tips: [
+                'Stage final changes',
+                'Commit with spec reference',
+                'Only if cleanup needed',
+            ],
+        },
+        {
+            step: 6,
+            name: 'mark_spec_done',
+            description: 'Update specification status',
+            tools: ['specification.update'],
+            tips: [
+                'Set status to done',
+                'This marks the specification complete',
+            ],
+        },
+        {
+            step: 7,
+            name: 'create_pr',
+            description: 'Create pull request with full context',
+            tools: ['link.pull_request'],
+            tips: [
+                'Title references specification',
+                'Description includes all epics and key tickets',
+                'Link to specification for context',
+                'Request reviewers if configured',
+            ],
+        },
+        {
+            step: 8,
+            name: 'end_session',
+            description: 'Close the implementation session',
+            tools: ['session.end'],
+            tips: [
+                'Clean up the session',
+                'Session lock is released',
+                'Specification is finalized',
+            ],
+        },
+    ],
+    antiPatterns: [
+        'NEVER create PR with failing tests',
+        'NEVER skip documentation check',
+        'NEVER forget to link PR to specification',
+        'NEVER leave session open after PR',
+    ],
+};
+/**
+ * Get a workflow definition by type
+ */
+export function getWorkflowDefinition(workflowType) {
+    switch (workflowType) {
+        case 'creation':
+            return CREATION_WORKFLOW;
+        case 'implementation':
+            return IMPLEMENTATION_WORKFLOW;
+        case 'review':
+            return REVIEW_WORKFLOW;
+        case 'finalize':
+            return FINALIZE_WORKFLOW;
+        default:
+            return null;
+    }
+}
+export const WORKFLOW_TYPES = ['creation', 'implementation', 'review', 'finalize'];
+//# sourceMappingURL=workflow-definitions.js.map