# Scaffold Domain

> Bootstrap DDD 4-layer domain structure. Use when (1) starting new domain implementation, (2) during v0.1.x PROJECT phase, (3) need to create repositories/api-clients/hooks/components with __tests__ and index.ts exports.

- Skill: `majiayu000/scaffold-domain` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds add majiayu000/scaffold-domain`
- Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/scaffold-domain/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Integrations & APIs
- Author: majiayu000 (https://skillmd.com/u/majiayu000)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/majiayu000/scaffold-domain

---


> **🔔 시스템 메시지**: 이 Skill이 호출되면 `[SEMO] Skill: scaffold-domain 호출 - {도메인명}` 시스템 메시지를 첫 줄에 출력하세요.

# Scaffold Domain Skill

@./../_shared/ddd-patterns.md
@./../_shared/test-templates.md

**Purpose**: Generate complete DDD 4-layer architecture structure for a new domain

## When to Use

Agents should invoke this skill when:

- Starting new domain implementation
- During v0.1.x PROJECT phase
- Implementing feature in new domain
- Refactoring existing code to DDD

## Quick Start

### Generated Structure

```text
app/{domain}/
├── _repositories/
│   ├── __tests__/
│   └── index.ts
├── _api-clients/
│   └── index.ts
├── _hooks/
│   ├── __tests__/
│   └── index.ts
├── _components/
│   ├── __tests__/
│   └── index.ts
└── page.tsx
```

### Usage

```javascript
// Agent invokes this skill
skill: scaffoldDomain("posts");

// Creates:
// app/posts/_repositories/ + _api-clients/ + _hooks/ + _components/ + page.tsx
// + all test boilerplates + index.ts exports
```

## Standard Components Created

Each domain gets 6 standard components:

| Component | Purpose |
|-----------|---------|
| `{Domain}Header` | Page header with title and actions |
| `{Domain}Filter` | Filter controls (search, sort) |
| `{Domain}List` | Main list/grid display |
| `{Domain}EmptyState` | Empty state UI |
| `{Domain}LoadingState` | Loading skeletons |
| `{Domain}ErrorState` | Error display |

## Critical Rules

1. **All 4 Layers**: Must create repositories, api-clients, hooks, components
2. **Test Directories**: Always create `__tests__/` for testable layers
3. **Index Exports**: Always create `index.ts` for clean imports
4. **Factory Pattern**: API clients must export singleton instances

## Constitution Compliance

- **Principle I**: DDD Architecture (4-layer structure)
- Creates proper separation of concerns
- Follows established patterns

## Dependencies

- File system operations
- Template files (optional, can use inline templates)

## Related Skills

- `implement` - Uses this skill during v0.1.x PROJECT phase
- `fetch-supabase-example` - Used to implement Repository
- `validate-architecture` - Validates created structure

## References

- [Layer Templates](references/layer-templates.md) - Repository, API Client, Hooks, Components boilerplate
- [Output Format](references/output-format.md) - Success output, naming conventions, error handling