Speckit Workflow for Openclaw

---

name: speckit-workflow description: Complete Spec-Driven Development (SDD) orchestrator for OpenClaw. Initializes SpecKit and manages the full engineering lifecycle. compatibility: Requires OpenClaw and a project repository metadata: author: vinayak source: custom/speckit-workflow

---

Speckit Workflow Skill 🦞

This is the master orchestrator for the SpecKit for OpenClaw engineering workflow.

⚠️ Security & Credentials

This workflow is designed to automate git operations to save progress and isolate work.

Agent Requirement: Before starting the workflow or initializing a new project, you MUST ask the user: > "Do you want to enable automated git commit, git push, and branch creation for this project? (Yes/No)"

If YES: Proceed with automated commits, pushes, and branch creation as described in the workflow. Ensure you have write access.

If NO: You MUST NOT perform any git operations (commits, pushes, or branch creation). You will only write files locally. The user is responsible for version control.

🚀 Step 1: Initialization

If this project has not been initialized with SpecKit yet, you MUST ensure the .specify/ directory is present in the project root.

Initialization Instructions for Agent: 1. Ask for Git Permission (see above). 2. Check if .specify/ exists in the project root. 3. If missing, copy the .specify/ directory from this skill package (located at ./.specify/) to .specify/ in the project root. - Create the destination directory if it doesn't exist. 4. Confirm successful initialization.

---

🔄 Resuming Workflow

Before starting or when returning to a project, you MUST determine the current state by checking for the existence of SpecKit artifacts:

1. Check for Initialization: Verify if .specify/ exists. 2. Determine Current Phase: - If .specify/memory/constitution.md exists -> Constitution complete. - If specs//spec.md exists -> Specify complete. - If specs//plan.md exists -> Plan complete. - If specs//tasks.md exists -> Tasks complete. - If tasks in tasks.md are partially marked [X] -> Implementation in progress.

Always resume from the first incomplete phase in the Execution Order.

---

🏗️ Step 2: Workflow Orchestration

Once initialized, you MUST follow the canonical Spec-kit order by delegating to sub-agents.

When to Create a Sub-Agent:

For each phase below, you should create or delegate to a specialized sub-agent that uses the corresponding skill found in the subskills/ directory relative to this skill file (./subskills/).

The Execution Order:

1. 📜 Constitution: Delegate to speckit-constitution. Establish code quality, testing standards, and architectural constraints. 2. 📝 Specify: Delegate to speckit-specify. Transform requirements into a formal spec.md. 3. 🔍 Clarify (Optional): Delegate to speckit-clarify if the specification is ambiguous. 4. 🏗️ Plan: Delegate to speckit-plan. Derive technical design and implementation architecture. 5. 📋 Tasks: Delegate to speckit-tasks. Break the plan into actionable task lists. 6. ⚖️ Analyze (Optional): Delegate to speckit-analyze for cross-artifact consistency. 7. 👷 Implement: Delegate to speckit-implement.

---

👷 Implementation Session Management

When executing the speckit-implement phase, you MUST:

Isolate Context: Trigger a new agent session for implementation to ensure focus.

Dynamic Task Chunking: Group tasks from tasks.md dynamically based on requirements and complexity.

- If tasks are small/simple, group 3-5 tasks (e.g., T001 to T005). - If tasks are complex, group 1-2 tasks.

Sub-Agent Execution: For each chunk, delegate to a sub-agent using speckit-implement.

Commit & Push: After each successfully completed chunk, the sub-agent MUST commit and push the changes to the repository.

Mark Completion: Ensure the sub-agent marks tasks as complete [X] in tasks.md before returning.

Avoid Over-grouping: Do not group too many tasks in a single sub-agent session to maintain precision and manageable diffs.

---

User Provided Context

{{user_provided_context}}

Use this context to start or resume the workflow. If the project is not yet initialized, begin with Step 1: Initialization.