@arimakouyou/spec-workflow-mcp 2.2.7

package/dist/tools/spec-status.js

@@ -0,0 +1,192 @@
+import { PathUtils } from '../core/path-utils.js';
+import { SpecParser } from '../core/parser.js';
+export const specStatusTool = {
+    name: 'spec-status',
+    description: `Display comprehensive specification progress overview.
+
+# Instructions
+Call when resuming work on a spec or checking overall completion status. Shows which phases are complete and task implementation progress. After viewing status, read tasks.md directly to see all tasks and their status markers ([ ] pending, [-] in-progress, [x] completed).`,
+    inputSchema: {
+        type: 'object',
+        properties: {
+            projectPath: {
+                type: 'string',
+                description: 'Absolute path to the project root (optional - uses server context path if not provided)'
+            },
+            specName: {
+                type: 'string',
+                description: 'Name of the specification'
+            }
+        },
+        required: ['specName']
+    },
+    annotations: {
+        title: 'Spec Status',
+        readOnlyHint: true,
+    }
+};
+export async function specStatusHandler(args, context) {
+    const { specName } = args;
+    // Use context projectPath as default, allow override via args
+    const projectPath = args.projectPath || context.projectPath;
+    if (!projectPath) {
+        return {
+            success: false,
+            message: 'Project path is required but not provided in context or arguments'
+        };
+    }
+    try {
+        // Translate path at tool entry point (components expect pre-translated paths)
+        const translatedPath = PathUtils.translatePath(projectPath);
+        const parser = new SpecParser(translatedPath);
+        const spec = await parser.getSpec(specName);
+        if (!spec) {
+            return {
+                success: false,
+                message: `Specification '${specName}' not found`,
+                nextSteps: [
+                    'Check spec name',
+                    'Use spec-list for available specs',
+                    'Create spec with create-spec-doc'
+                ]
+            };
+        }
+        // Determine current phase and overall status
+        let currentPhase = 'not-started';
+        let overallStatus = 'not-started';
+        if (!spec.phases.requirements.exists) {
+            currentPhase = 'requirements';
+            overallStatus = 'requirements-needed';
+        }
+        else if (!spec.phases.design.exists) {
+            currentPhase = 'design';
+            overallStatus = 'design-needed';
+        }
+        else if (!spec.phases.testDesign.exists) {
+            currentPhase = 'test-design';
+            overallStatus = 'test-design-needed';
+        }
+        else if (!spec.phases.tasks.exists) {
+            currentPhase = 'tasks';
+            overallStatus = 'tasks-needed';
+        }
+        else if (spec.taskProgress && spec.taskProgress.pending > 0) {
+            currentPhase = 'implementation';
+            overallStatus = 'implementing';
+        }
+        else if (spec.taskProgress && spec.taskProgress.total > 0 && spec.taskProgress.completed === spec.taskProgress.total) {
+            currentPhase = 'completed';
+            overallStatus = 'completed';
+        }
+        else {
+            currentPhase = 'implementation';
+            overallStatus = 'ready-for-implementation';
+        }
+        // Phase details
+        const phaseDetails = [
+            {
+                name: 'Requirements',
+                status: spec.phases.requirements.exists ? (spec.phases.requirements.approved ? 'approved' : 'created') : 'missing',
+                lastModified: spec.phases.requirements.lastModified
+            },
+            {
+                name: 'Design',
+                status: spec.phases.design.exists ? (spec.phases.design.approved ? 'approved' : 'created') : 'missing',
+                lastModified: spec.phases.design.lastModified
+            },
+            {
+                name: 'Test Design',
+                status: spec.phases.testDesign.exists ? (spec.phases.testDesign.approved ? 'approved' : 'created') : 'missing',
+                lastModified: spec.phases.testDesign.lastModified
+            },
+            {
+                name: 'Tasks',
+                status: spec.phases.tasks.exists ? (spec.phases.tasks.approved ? 'approved' : 'created') : 'missing',
+                lastModified: spec.phases.tasks.lastModified
+            },
+            {
+                name: 'Implementation',
+                status: spec.phases.implementation.exists ? 'in-progress' : 'not-started',
+                progress: spec.taskProgress
+            }
+        ];
+        // Next steps based on current phase
+        const nextSteps = [];
+        switch (currentPhase) {
+            case 'requirements':
+                nextSteps.push('Read template: .spec-workflow/templates/requirements-template-v*.md');
+                nextSteps.push('Create: .spec-workflow/specs/{name}/requirements.md');
+                nextSteps.push('Request approval');
+                break;
+            case 'design':
+                nextSteps.push('Read template: .spec-workflow/templates/design-template-v*.md');
+                nextSteps.push('Create: .spec-workflow/specs/{name}/design.md');
+                nextSteps.push('Request approval');
+                break;
+            case 'test-design':
+                nextSteps.push('Read template: .spec-workflow/templates/test-design-template.md');
+                nextSteps.push('Create: .spec-workflow/specs/{name}/test-design.md');
+                nextSteps.push('Request approval');
+                break;
+            case 'tasks':
+                nextSteps.push('Read template: .spec-workflow/templates/tasks-template-v*.md');
+                nextSteps.push('Create: .spec-workflow/specs/{name}/tasks.md');
+                nextSteps.push('Request approval');
+                break;
+            case 'implementation':
+                if (spec.taskProgress && spec.taskProgress.pending > 0) {
+                    nextSteps.push(`Read tasks: .spec-workflow/specs/${specName}/tasks.md`);
+                    nextSteps.push('Edit tasks.md: Change [ ] to [-] for task you start');
+                    nextSteps.push('Implement the task code');
+                    nextSteps.push('Edit tasks.md: Change [-] to [x] when completed');
+                }
+                else {
+                    nextSteps.push(`Read tasks: .spec-workflow/specs/${specName}/tasks.md`);
+                    nextSteps.push('Begin implementation by marking first task [-]');
+                }
+                break;
+            case 'completed':
+                nextSteps.push('All tasks completed (marked [x])');
+                nextSteps.push('Run tests');
+                break;
+        }
+        return {
+            success: true,
+            message: `Specification '${specName}' status: ${overallStatus}`,
+            data: {
+                name: specName,
+                description: spec.description,
+                currentPhase,
+                overallStatus,
+                createdAt: spec.createdAt,
+                lastModified: spec.lastModified,
+                phases: phaseDetails,
+                taskProgress: spec.taskProgress || {
+                    total: 0,
+                    completed: 0,
+                    pending: 0
+                }
+            },
+            nextSteps,
+            projectContext: {
+                projectPath,
+                workflowRoot: PathUtils.getWorkflowRoot(projectPath),
+                currentPhase,
+                dashboardUrl: context.dashboardUrl
+            }
+        };
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        return {
+            success: false,
+            message: `Failed to get specification status: ${errorMessage}`,
+            nextSteps: [
+                'Check if the specification exists',
+                'Verify the project path',
+                'List directory .spec-workflow/specs/ to see available specifications'
+            ]
+        };
+    }
+}
+//# sourceMappingURL=spec-status.js.map

package/dist/tools/spec-status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec-status.js","sourceRoot":"","sources":["../../src/tools/spec-status.ts"],"names":[],"mappings":"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"}

package/dist/tools/spec-workflow-guide.d.ts

@@ -0,0 +1,5 @@
+import { Tool } from '@modelcontextprotocol/sdk/types.js';
+import { ToolContext, ToolResponse } from '../types.js';
+export declare const specWorkflowGuideTool: Tool;
+export declare function specWorkflowGuideHandler(args: any, context: ToolContext): Promise<ToolResponse>;
+//# sourceMappingURL=spec-workflow-guide.d.ts.map

package/dist/tools/spec-workflow-guide.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec-workflow-guide.d.ts","sourceRoot":"","sources":["../../src/tools/spec-workflow-guide.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAC1D,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAExD,eAAO,MAAM,qBAAqB,EAAE,IAiBnC,CAAC;AAEF,wBAAsB,wBAAwB,CAAC,IAAI,EAAE,GAAG,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC,CAsBrG"}

package/dist/tools/spec-workflow-guide.js

@@ -0,0 +1,116 @@
+export const specWorkflowGuideTool = {
+    name: 'spec-workflow-guide',
+    description: `Load essential spec workflow instructions to guide feature development from idea to implementation.
+
+# Instructions
+Call this tool FIRST when users request spec creation, feature development, or mention specifications. This provides the complete workflow sequence (Requirements → Design → Test Design → Tasks → Implementation) that must be followed. Always load before any other spec tools to ensure proper workflow understanding. It's important that you follow this workflow exactly to avoid errors.
+
+NOTE: Do NOT call this tool when the user requests setup-claude-skills. That tool is a standalone file-copy operation and does not require loading the workflow guide.`,
+    inputSchema: {
+        type: 'object',
+        properties: {},
+        additionalProperties: false
+    },
+    annotations: {
+        title: 'Spec Workflow Guide',
+        readOnlyHint: true,
+    }
+};
+export async function specWorkflowGuideHandler(args, context) {
+    // Dashboard URL is populated from registry in server.ts
+    const dashboardMessage = context.dashboardUrl ?
+        `Monitor progress on dashboard: ${context.dashboardUrl}` :
+        'Please start the dashboard with: spec-workflow-mcp --dashboard';
+    return {
+        success: true,
+        message: 'Complete spec workflow guide loaded - follow this workflow exactly',
+        data: {
+            guide: getSpecWorkflowGuide(),
+            dashboardUrl: context.dashboardUrl,
+            dashboardAvailable: !!context.dashboardUrl
+        },
+        nextSteps: [
+            'Follow sequence: Requirements → Design → Test Design → Tasks → Implementation',
+            'Load templates with get-template-context first',
+            'Request approval after each document',
+            'Use MCP tools only',
+            dashboardMessage
+        ]
+    };
+}
+function getSpecWorkflowGuide() {
+    return `# Spec Development Workflow
+
+## Overview
+
+Guide users through spec-driven development: Requirements -> Design -> Test Design -> Tasks -> Implementation.
+Feature names use kebab-case (e.g., user-authentication). Create ONE spec at a time.
+Follow this workflow exactly to avoid errors.
+
+## Phases
+
+### Phase 1: Requirements — Define WHAT to build
+- Read steering docs from \`.spec-workflow/steering/*.md\` if they exist
+- Load template: check \`user-templates/\` first, then \`templates/requirements-template.md\`
+- Create: \`.spec-workflow/specs/{spec-name}/requirements.md\`
+- Approval: request -> poll status -> handle revision/approved -> delete -> proceed
+
+### Phase 2: Design — Define HOW to build it
+- Load template: check \`user-templates/\` first, then \`templates/design-template.md\`
+- Analyze codebase for patterns to reuse
+- Create: \`.spec-workflow/specs/{spec-name}/design.md\`
+- Approval: same workflow as Phase 1
+
+### Phase 3: Test Design — Define HOW to test it
+- Load template: check \`user-templates/\` first, then \`templates/test-design-template.md\`
+- Derive UT specs from design.md components, IT specs from component interactions, E2E specs from requirements.md user stories
+- Create: \`.spec-workflow/specs/{spec-name}/test-design.md\`
+- Approval: same workflow as Phase 1
+
+### Phase 4: Tasks — Break into atomic steps
+- Load template: check \`user-templates/\` first, then \`templates/tasks-template.md\`
+- Convert design into atomic tasks (1-3 files each)
+- Generate _Prompt field for each task (Role, Task, Restrictions, _Leverage, _Requirements, Success)
+- Derive _TestFocus from test-design.md UT specifications
+- Create: \`.spec-workflow/specs/{spec-name}/tasks.md\`
+- Approval: same workflow as Phase 1
+- After cleanup: "Spec complete. Ready to implement?"
+
+### Phase 5: Implementation — Execute tasks
+- For each task: mark [-] -> implement -> log-implementation (MANDATORY) -> mark [x]
+- Search implementation logs BEFORE coding to discover existing work
+- Task status: \`[ ]\` pending, \`[-]\` in-progress, \`[x]\` completed
+
+## Approval Workflow (all phases)
+
+1. \`approvals\` action:'request' — filePath only, never content
+2. \`approvals\` action:'status' — poll until approved/needs-revision
+3. If needs-revision: update doc, create NEW approval, do NOT proceed
+4. If approved: \`approvals\` action:'delete' — must succeed before next phase
+5. If delete fails: STOP, return to polling
+
+## Key Rules
+
+- Complete phases in sequence (no skipping)
+- One spec at a time, kebab-case names
+- Verbal approval is NEVER accepted — dashboard or VS Code extension only
+- Never proceed if approval delete fails
+- Every task marked [x] MUST have log-implementation called first
+- Steering docs are optional — only create when explicitly requested
+
+## File Structure
+\`\`\`
+.spec-workflow/
+├── templates/           # Auto-populated on server start
+├── user-templates/      # Custom template overrides
+├── user-prompts/        # Custom prompt overrides
+├── specs/{spec-name}/
+│   ├── requirements.md
+│   ├── design.md
+│   ├── test-design.md
+│   ├── tasks.md
+│   └── Implementation Logs/
+└── steering/            # Optional: product.md, tech.md, structure.md
+\`\`\``;
+}
+//# sourceMappingURL=spec-workflow-guide.js.map

package/dist/tools/spec-workflow-guide.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec-workflow-guide.js","sourceRoot":"","sources":["../../src/tools/spec-workflow-guide.ts"],"names":[],"mappings":"AAGA,MAAM,CAAC,MAAM,qBAAqB,GAAS;IACzC,IAAI,EAAE,qBAAqB;IAC3B,WAAW,EAAE;;;;;uKAKwJ;IACrK,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE,EAAE;QACd,oBAAoB,EAAE,KAAK;KAC5B;IACD,WAAW,EAAE;QACX,KAAK,EAAE,qBAAqB;QAC5B,YAAY,EAAE,IAAI;KACnB;CACF,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAAC,IAAS,EAAE,OAAoB;IAC5E,wDAAwD;IACxD,MAAM,gBAAgB,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;QAC7C,kCAAkC,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;QAC1D,gEAAgE,CAAC;IAEnE,OAAO;QACL,OAAO,EAAE,IAAI;QACb,OAAO,EAAE,oEAAoE;QAC7E,IAAI,EAAE;YACJ,KAAK,EAAE,oBAAoB,EAAE;YAC7B,YAAY,EAAE,OAAO,CAAC,YAAY;YAClC,kBAAkB,EAAE,CAAC,CAAC,OAAO,CAAC,YAAY;SAC3C;QACD,SAAS,EAAE;YACT,+EAA+E;YAC/E,gDAAgD;YAChD,sCAAsC;YACtC,oBAAoB;YACpB,gBAAgB;SACjB;KACF,CAAC;AACJ,CAAC;AAED,SAAS,oBAAoB;IAC3B,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAwEF,CAAC;AACR,CAAC"}

package/dist/tools/steering-guide.d.ts

@@ -0,0 +1,5 @@
+import { Tool } from '@modelcontextprotocol/sdk/types.js';
+import { ToolContext, ToolResponse } from '../types.js';
+export declare const steeringGuideTool: Tool;
+export declare function steeringGuideHandler(args: any, context: ToolContext): Promise<ToolResponse>;
+//# sourceMappingURL=steering-guide.d.ts.map

package/dist/tools/steering-guide.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"steering-guide.d.ts","sourceRoot":"","sources":["../../src/tools/steering-guide.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAC1D,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAExD,eAAO,MAAM,iBAAiB,EAAE,IAe/B,CAAC;AAEF,wBAAsB,oBAAoB,CAAC,IAAI,EAAE,GAAG,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC,CAgBjG"}

package/dist/tools/steering-guide.js

@@ -0,0 +1,192 @@
+export const steeringGuideTool = {
+    name: 'steering-guide',
+    description: `Load guide for creating project steering documents.
+
+# Instructions
+Call ONLY when user explicitly requests steering document creation or asks about project architecture docs. Not part of standard spec workflow. Provides templates and guidance for product.md, tech.md, and structure.md creation. Its important that you follow this workflow exactly to avoid errors.`,
+    inputSchema: {
+        type: 'object',
+        properties: {},
+        additionalProperties: false
+    },
+    annotations: {
+        title: 'Steering Guide',
+        readOnlyHint: true,
+    }
+};
+export async function steeringGuideHandler(args, context) {
+    return {
+        success: true,
+        message: 'Steering workflow guide loaded - follow this workflow exactly to avoid errors',
+        data: {
+            guide: getSteeringGuide(),
+            dashboardUrl: context.dashboardUrl
+        },
+        nextSteps: [
+            'Only proceed if user requested steering docs',
+            'Create product.md first',
+            'Then tech.md and structure.md',
+            'Reference in future specs',
+            context.dashboardUrl ? `Dashboard: ${context.dashboardUrl}` : 'Start the dashboard with: spec-workflow-mcp --dashboard'
+        ]
+    };
+}
+function getSteeringGuide() {
+    return `# Steering Workflow
+
+## Overview
+
+Create project-level guidance documents when explicitly requested. Steering docs establish vision, architecture, and conventions for established codebases. Its important that you follow this workflow exactly to avoid errors.
+
+## Workflow Diagram
+
+\`\`\`mermaid
+flowchart TD
+    Start([Start: Setup steering docs]) --> Guide[steering-guide<br/>Load workflow instructions]
+
+    %% Phase 1: Product
+    Guide --> P1_Template[Check user-templates first,<br/>then read template:<br/>product-template.md]
+    P1_Template --> P1_Generate[Generate vision & goals]
+    P1_Generate --> P1_Create[Create file:<br/>.spec-workflow/steering/<br/>product.md]
+    P1_Create --> P1_Approve[approvals<br/>action: request<br/>filePath only]
+    P1_Approve --> P1_Status[approvals<br/>action: status<br/>poll status]
+    P1_Status --> P1_Check{Status?}
+    P1_Check -->|needs-revision| P1_Update[Update document using user comments for guidance]
+    P1_Update --> P1_Create
+    P1_Check -->|approved| P1_Clean[approvals<br/>action: delete]
+    P1_Clean -->|failed| P1_Status
+
+    %% Phase 2: Tech
+    P1_Clean -->|success| P2_Template[Check user-templates first,<br/>then read template:<br/>tech-template.md]
+    P2_Template --> P2_Analyze[Analyze tech stack]
+    P2_Analyze --> P2_Create[Create file:<br/>.spec-workflow/steering/<br/>tech.md]
+    P2_Create --> P2_Approve[approvals<br/>action: request<br/>filePath only]
+    P2_Approve --> P2_Status[approvals<br/>action: status<br/>poll status]
+    P2_Status --> P2_Check{Status?}
+    P2_Check -->|needs-revision| P2_Update[Update document using user comments for guidance]
+    P2_Update --> P2_Create
+    P2_Check -->|approved| P2_Clean[approvals<br/>action: delete]
+    P2_Clean -->|failed| P2_Status
+
+    %% Phase 3: Structure
+    P2_Clean -->|success| P3_Template[Check user-templates first,<br/>then read template:<br/>structure-template.md]
+    P3_Template --> P3_Analyze[Analyze codebase structure]
+    P3_Analyze --> P3_Create[Create file:<br/>.spec-workflow/steering/<br/>structure.md]
+    P3_Create --> P3_Approve[approvals<br/>action: request<br/>filePath only]
+    P3_Approve --> P3_Status[approvals<br/>action: status<br/>poll status]
+    P3_Status --> P3_Check{Status?}
+    P3_Check -->|needs-revision| P3_Update[Update document using user comments for guidance]
+    P3_Update --> P3_Create
+    P3_Check -->|approved| P3_Clean[approvals<br/>action: delete]
+    P3_Clean -->|failed| P3_Status
+
+    P3_Clean -->|success| Complete([Steering docs complete])
+
+    style Start fill:#e6f3ff
+    style Complete fill:#e6f3ff
+    style P1_Check fill:#ffe6e6
+    style P2_Check fill:#ffe6e6
+    style P3_Check fill:#ffe6e6
+\`\`\`
+
+## Steering Workflow Phases
+
+### Phase 1: Product Document
+**Purpose**: Define vision, goals, and user outcomes.
+
+**File Operations**:
+- Check for custom template: \`.spec-workflow/user-templates/product-template.md\`
+- Read template: \`.spec-workflow/templates/product-template.md\` (if no custom template)
+- Create document: \`.spec-workflow/steering/product.md\`
+
+**Tools**:
+- steering-guide: Load workflow instructions
+- approvals: Manage approval workflow (actions: request, status, delete)
+
+**Process**:
+1. Load steering guide for workflow overview
+2. Check for custom template at \`.spec-workflow/user-templates/product-template.md\`
+3. If no custom template, read from \`.spec-workflow/templates/product-template.md\`
+4. Generate product vision and goals
+5. Create \`product.md\` at \`.spec-workflow/steering/product.md\`
+6. Request approval using approvals tool with action:'request' (filePath only)
+7. Poll status using approvals with action:'status' until approved/needs-revision (NEVER accept verbal approval)
+8. If needs-revision: update document using comments, create NEW approval, do NOT proceed
+9. Once approved: use approvals with action:'delete' (must succeed) before proceeding
+10. If delete fails: STOP - return to polling
+
+### Phase 2: Tech Document
+**Purpose**: Document technology decisions and architecture.
+
+**File Operations**:
+- Check for custom template: \`.spec-workflow/user-templates/tech-template.md\`
+- Read template: \`.spec-workflow/templates/tech-template.md\` (if no custom template)
+- Create document: \`.spec-workflow/steering/tech.md\`
+
+**Tools**:
+- approvals: Manage approval workflow (actions: request, status, delete)
+
+**Process**:
+1. Check for custom template at \`.spec-workflow/user-templates/tech-template.md\`
+2. If no custom template, read from \`.spec-workflow/templates/tech-template.md\`
+3. Analyze existing technology stack
+4. Document architectural decisions and patterns
+5. Create \`tech.md\` at \`.spec-workflow/steering/tech.md\`
+6. Request approval using approvals tool with action:'request'
+7. Poll status using approvals with action:'status' until approved/needs-revision
+8. If needs-revision: update document using comments, create NEW approval, do NOT proceed
+9. Once approved: use approvals with action:'delete' (must succeed) before proceeding
+10. If delete fails: STOP - return to polling
+
+### Phase 3: Structure Document
+**Purpose**: Map codebase organization and patterns.
+
+**File Operations**:
+- Check for custom template: \`.spec-workflow/user-templates/structure-template.md\`
+- Read template: \`.spec-workflow/templates/structure-template.md\` (if no custom template)
+- Create document: \`.spec-workflow/steering/structure.md\`
+
+**Tools**:
+- approvals: Manage approval workflow (actions: request, status, delete)
+
+**Process**:
+1. Check for custom template at \`.spec-workflow/user-templates/structure-template.md\`
+2. If no custom template, read from \`.spec-workflow/templates/structure-template.md\`
+3. Analyze directory structure and file organization
+4. Document coding patterns and conventions
+5. Create \`structure.md\` at \`.spec-workflow/steering/structure.md\`
+6. Request approval using approvals tool with action:'request'
+7. Poll status using approvals with action:'status' until approved/needs-revision
+8. If needs-revision: update document using comments, create NEW approval, do NOT proceed
+9. Once approved: use approvals with action:'delete' (must succeed) before proceeding
+10. If delete fails: STOP - return to polling
+11. After successful cleanup: "Steering docs complete. Ready for spec creation?"
+
+## Workflow Rules
+
+- Create documents directly at specified file paths
+- Check for custom templates in \`.spec-workflow/user-templates/\` first
+- Read templates from \`.spec-workflow/templates/\` directory if no custom template exists
+- Follow exact template structures
+- Get explicit user approval between phases (using approvals tool with action:'request')
+- Complete phases in sequence (no skipping)
+- Approval requests: provide filePath only, never content
+- BLOCKING: Never proceed if approval delete fails
+- CRITICAL: Must have approved status AND successful cleanup before next phase
+- CRITICAL: Verbal approval is NEVER accepted - dashboard or VS Code extension only
+- NEVER proceed on user saying "approved" - check system status only
+
+## File Structure
+\`\`\`
+.spec-workflow/
+├── templates/           # Auto-populated on server start
+│   ├── product-template.md
+│   ├── tech-template.md
+│   └── structure-template.md
+└── steering/
+    ├── product.md
+    ├── tech.md
+    └── structure.md
+\`\`\``;
+}
+//# sourceMappingURL=steering-guide.js.map

package/dist/tools/steering-guide.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"steering-guide.js","sourceRoot":"","sources":["../../src/tools/steering-guide.ts"],"names":[],"mappings":"AAGA,MAAM,CAAC,MAAM,iBAAiB,GAAS;IACrC,IAAI,EAAE,gBAAgB;IACtB,WAAW,EAAE;;;ySAG0R;IACvS,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE,EAAE;QACd,oBAAoB,EAAE,KAAK;KAC5B;IACD,WAAW,EAAE;QACX,KAAK,EAAE,gBAAgB;QACvB,YAAY,EAAE,IAAI;KACnB;CACF,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,IAAS,EAAE,OAAoB;IACxE,OAAO;QACL,OAAO,EAAE,IAAI;QACb,OAAO,EAAE,+EAA+E;QACxF,IAAI,EAAE;YACJ,KAAK,EAAE,gBAAgB,EAAE;YACzB,YAAY,EAAE,OAAO,CAAC,YAAY;SACnC;QACD,SAAS,EAAE;YACT,8CAA8C;YAC9C,yBAAyB;YACzB,+BAA+B;YAC/B,2BAA2B;YAC3B,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,cAAc,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,yDAAyD;SACxH;KACF,CAAC;AACJ,CAAC;AAED,SAAS,gBAAgB;IACvB,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2JF,CAAC;AACR,CAAC"}