Back to list
semicolon-devteam

validate-architecture

by semicolon-devteam

SEMO (Semicolon Orchestrate) - AI Agent Orchestration Framework Monorepo

1🍴 0📅 Jan 22, 2026

SKILL.md


name: validate-architecture description: Validate DDD 4-layer architecture compliance. Use when (1) after implementation completion, (2) during verification phase, (3) before PR creation, (4) architecture refactoring validation, (5) Constitution Principle I/II compliance check. tools: [Bash, Read, Grep]

🔔 시스템 메시지: 이 Skill이 호출되면 [SEMO] Skill: validate-architecture 호출 - {도메인/범위} 시스템 메시지를 첫 줄에 출력하세요.

Validate Architecture Skill

@./../_shared/ddd-patterns.md @./../_shared/ssr-rules.md

Purpose: Ensure DDD 4-layer architecture compliance and pattern adherence

Quick Start

When to Use

  • After implementation completion
  • During verification phase (Phase 5)
  • Before PR creation
  • Architecture refactoring validation

What It Does

CheckDescription
StructureAll 4 layers exist with proper naming
RepositoryServer-side only, uses createServerSupabaseClient
API ClientFactory Pattern, singleton exported
HooksReact Query, calls API client
ComponentsUses hooks, no direct API/Supabase
SSRMinimal 'use client', server-first

4-Layer Structure

app/{domain}/
├── _repositories/      ✓ Server-side data access
├── _api-clients/       ✓ Factory Pattern singleton
├── _hooks/             ✓ React Query wrappers
└── _components/        ✓ UI only, uses hooks

Usage

// Full architecture validation
skill: validateArchitecture();

// Validate specific domain
skill: validateArchitecture("posts");

// Quick check (structure only)
skill: validateArchitecture({ quick: true });

Severity Levels

LevelExamplesPR Impact
🔴 CriticalMissing layers, Repository 'use client'Blocks PR
🟡 WarningUnnecessary 'use client', missing testsShould fix
🟢 InfoNaming improvementsNice to have

Constitution Compliance

SoT 참조: Constitution 원칙은 semo-core/PRINCIPLES.md에서 관리됩니다.

  • Principle I: DDD Architecture (NON-NEGOTIABLE)
  • Principle II: SSR-First Development
  • verify - Uses this for architecture validation
  • scaffold-domain - Creates validated structure
  • implement - Ensures compliance during implementation

Score

Total Score

50/100

Based on repository quality metrics

SKILL.md

SKILL.mdファイルが含まれている

+20
LICENSE

ライセンスが設定されている

0/10
説明文

100文字以上の説明がある

0/10
人気

GitHub Stars 100以上

0/15
最近の活動

3ヶ月以内に更新がある

0/10
フォーク

10回以上フォークされている

0/5
Issue管理

オープンIssueが50未満

+5
言語

プログラミング言語が設定されている

+5
タグ

1つ以上のタグが設定されている

0/5

Reviews

💬

Reviews coming soon