# 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.

- Skill: `agentskillexchange/run-spec-first-claude-code-development-workflows-with-moai-a` (Agent Skill)
- Install (CLI): `npx skillmds@latest add agentskillexchange/run-spec-first-claude-code-development-workflows-with-moai-a`
- Raw SKILL.md: https://api.skillmd.com/api/skills/agentskillexchange/run-spec-first-claude-code-development-workflows-with-moai-a/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: agentskillexchange (https://skillmd.com/u/agentskillexchange)
- Updated: 2026-09-08
- Page: https://skillmd.com/skills/agentskillexchange/run-spec-first-claude-code-development-workflows-with-moai-a

---


# 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/)