---
name: "Run spec-first Claude Code development workflows with MoAI-ADK"
slug: "run-spec-first-claude-code-development-workflows-with-moai-adk"
description: "Use MoAI-ADK to install Claude Code agents and skills for spec-first implementation, TDD, DDD, and quality-gated development."
github_stars: 1117
verification: "security_reviewed"
source: "https://github.com/modu-ai/moai-adk"
author: "modu-ai"
publisher_type: "organization"
category: "Templates & Workflows"
framework: "Claude Code"
tool_ecosystem:
  github_repo: "modu-ai/moai-adk"
  github_stars: 1117
---

# Run spec-first Claude Code development workflows with MoAI-ADK

Use MoAI-ADK to install Claude Code agents and skills for spec-first implementation, TDD, DDD, and quality-gated development.

## Prerequisites

Claude Code, MoAI-ADK CLI, Git, local shell

## Installation

Use the upstream install or setup path that matches your environment:
- git clone https://github.com/modu-ai/moai-adk.git

Requirements and caveats from upstream:
- Requires [Git for Windows](https://gitforwindows.org/) to be installed first.
- **Workaround 2:** Disable 8.3 filename generation (requires admin):

Basic usage or getting-started notes:
- | **Session Persistence** | progress.md tracks completed phases across sessions; interrupted runs resume automatically | /moai run SPEC-XXX |
- | **Failing Checklist** | All acceptance criteria registered as pending tasks at run start; marked complete as implemented | /moai run SPEC-XXX |
- | **Scaffolding First** | Empty file stubs created before implementation to prevent entropy | /moai run SPEC-XXX |

- Source: https://github.com/modu-ai/moai-adk
- Extracted from upstream docs: https://raw.githubusercontent.com/modu-ai/moai-adk/HEAD/README.md

## Documentation

- https://adk.mo.ai.kr

## Source

- [Agent Skill Exchange](https://agentskillexchange.com/skills/run-spec-first-claude-code-development-workflows-with-moai-adk/)