Agent Skills: Scaffold Domain Skill

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.

UncategorizedID: semicolon-devteam/semo/scaffold-domain

Install this agent skill to your local

pnpm dlx add-skill https://github.com/semicolon-devteam/semo/tree/HEAD/semo-system/semo-skills/scaffold-domain

Skill Files

Browse the full folder contents for scaffold-domain.

Download Skill

Loading file tree…

semo-system/semo-skills/scaffold-domain/SKILL.md

Skill Metadata

Name
scaffold-domain
Description
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이 호좜되면 [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

app/{domain}/
β”œβ”€β”€ _repositories/
β”‚   β”œβ”€β”€ __tests__/
β”‚   └── index.ts
β”œβ”€β”€ _api-clients/
β”‚   └── index.ts
β”œβ”€β”€ _hooks/
β”‚   β”œβ”€β”€ __tests__/
β”‚   └── index.ts
β”œβ”€β”€ _components/
β”‚   β”œβ”€β”€ __tests__/
β”‚   └── index.ts
└── page.tsx

Usage

// 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 - Repository, API Client, Hooks, Components boilerplate
  • Output Format - Success output, naming conventions, error handling