Speck-It

Speck-It Development Workflow Guide

Complete step-by-step guide to using Speck-It for project development.

Complete Speck-It Workflow Guide

Master the complete Speck-It workflow from project setup to implementation.

1. Set up a new project with a clear constitution and feature root

Initialize a new Speck-It project for your application. First, create a project constitution that establishes the core principles for your project goals. Then register the project root directory for feature artifacts storage.

Example Constitution Setup:

Set the constitution of your project using the Speck-It MCP server with these specifications:

  • Language: TypeScript
  • UI Framework: Shadcn UI
  • Code Style: Prefer efficient and reusable code
  • Type Safety: Strong typing throughout
  • Authentication: Clerk
  • Backend: Convex for auth and payment
  • Monetization: Google Ads
  • State Management: Zustand (if needed)
Use the @mcp:speck-it "set_constitution" tool to configure these settings

2. Ensure the LLM uses auto-update functionality across all workflow stages

Leverage Speck-It's auto-update capabilities to maintain seamless workflow progression.

Feature Specification Generation:

Generate a feature specification for your feature with detailed description using the speck-it mcp server. The system should automatically update project tasks when the spec is generated.

Implementation Plan Creation:

Use the speck-it mcp server to create an implementation plan for your feature with appropriate tech context (frameworks/languages). Auto-update task statuses when plan is complete.

TDD-Oriented Task Generation:

Generate TDD-oriented tasks from the implementation plan for your feature using the speck-it mcp server. The system should automatically mark planning tasks as complete and unlock implementation tasks.

3. Use the manage_project_tasks function for comprehensive task operations

Utilize the powerful task management capabilities of Speck-It for comprehensive project oversight.

Task Creation with Metadata:

Use the speck-it mcp server to create a new project task for your feature with detailed specifications:

  • Task Description: Clear, actionable task description
  • Priority: Set priority level (1-10)
  • Task Type: Choose from workflow, spec, plan, implementation, validation, or custom
  • Prerequisites: Define any prerequisite conditions
  • Estimated Hours: Set time estimates for planning

4. Complete Implementation

Execute the complete task list using the speck-it mcp server's comprehensive task management system.

Task Execution Workflow:

  1. Review the complete task list with all dependencies
  2. Execute tasks in the recommended sequence
  3. Update task completion status as you progress
  4. Add notes for execution traceability
  5. Monitor auto-updates as workflow stages complete
  6. Finalize the feature when all tasks are complete

Key Benefits of This Workflow

  • ✅ Automated Progression: Tasks automatically unlock as prerequisites are met
  • ✅ Traceability: Complete audit trail of all decisions and implementations
  • ✅ Quality Assurance: TDD-oriented approach ensures robust development
  • ✅ Efficiency: Auto-update functionality reduces manual overhead
  • ✅ Flexibility: Custom task types and priorities adapt to project needs