대화 한 마디로
Dash를 만드는 플랫폼

# ═══════════════════════════════════════════════════════════ # Dash Creator — 개발팀 AI 규칙 정의 # 이 파일을 CLAUDE.md 또는 .cursorrules에 붙여 넣으세요. # ═══════════════════════════════════════════════════════════ ## 프로젝트 개요 Dash Creator는 자연어 한 마디로 Android Kotlin Dash 위젯을 생성하는 6-Layer 파이프라인입니다. - 백엔드: Python 3.11 + FastAPI - 위젯 출력: Jetpack Compose (Kotlin) - LLM: Gemini Pro (primary) → Claude → GPT-4o (fallback) - 설계 문서: skills/dash-creator/harness/design-docs/architecture/ ## 6-Layer 구조 (절대 변경 금지) L1: creator_intent.py → 자연어 파싱, DashIntent 반환 L2a: blueprint_registry → 도메인별 UX 규칙 (required_features, layout_type) L2b: style_registry → skin 토큰 (색상, 폰트, 컴포넌트 토큰) L3: data_registry → API 설정, kotlin_data_class, 샘플 데이터 L4: creator_codegen → LLM 프롬프트 조합 + 호출 + Kotlin 3파일 생성 L5: creator_validator → Blueprint/Style 정책 준수 검사, 점수 산출 API: creator_api.py → POST /api/creator/generate (L1→L5 실행) ## 데이터 흐름 (변경 금지) text → DashIntent → (BlueprintRule, StyleRule, DataContext) → GeneratorInput → GeneratedFiles → ValidationResult ## 핵심 타입 (creator_models.py) - DashIntent: domain, subcategory, size, skin, features, confidence, raw_input - BlueprintRule: required_features[], layout_type, suggested_components[], interaction_patterns[] - StyleRule: skin, background_from/to, accent, text_primary, component_tokens(ComponentTokens) - GeneratedFiles: dash_name, dash_composable_kt, repository_kt, dash_md - ValidationResult: passed, score, failed_rules[], warnings[] ## 지원 도메인 (9개 — creator_intent.py DOMAIN_KEYWORDS) NATURE, FINANCE, WEATHER, HEALTH, PRODUCTIVITY, COMMUTE, MEDIA, BUSINESS, LIFESTYLE ## 지원 Skin (6개 — style_registry.py) dark-ocean, neon-city, warm-paper, forest-green, pure-light, sunset-warm ## LLM 구현 순서 # Phase 1 (현재): Claude Haiku (빠른 작업) + Claude Sonnet (코드 생성) # Phase 2: Gemini 추가 (intent_parse, question_gen, ocr 최적화) # Phase 3: GPT 추가 (modification, chat) ## LLM 라우터 주입 방식 (싱글톤 패턴) # main.py 또는 orchestrator.py에서 반드시 호출: from engine import creator_codegen, creator_intent creator_codegen.set_router(llm_router) # call_sync(task, prompt, system_prompt, model) 필요 creator_intent.set_router(llm_router) # LLM fallback 분류용 ## 프롬프트 파일 위치 (절대 경로 변경 금지) skills/dash-creator/prompts/_system.md → 공통 시스템 프롬프트 skills/dash-creator/prompts/{domain}.md → 도메인 전문 지식 (소문자) skills/dash-creator/prompts/components/atoms/ → 원자 컴포넌트 스펙 skills/dash-creator/prompts/components/molecules/ → 분자 컴포넌트 스펙 skills/dash-creator/prompts/sizes/{size}.md → 사이즈별 레이아웃 규칙 (소문자) ## Validator 검사 규칙 (FEATURE_CHECKS 매핑) images → AsyncImage 또는 Image() 포함 여부 location_aware → LocationManager 또는 FusedLocationProviderClient 포함 여부 tap_to_expand → AnimatedVisibility 또는 expanded/clickable 포함 여부 chart → Canvas, Path, drawPath, drawLine, Chart 포함 여부 primary_value → fontSize = {숫자}.sp (2자리 이상) 또는 H1 포함 여부 change_indicator → changePercent, change, ▲, ▼ 포함 여부 progress → CircularProgressIndicator, LinearProgressIndicator, Canvas 포함 여부 timeline → LazyColumn, Column 포함 여부 condition_icon → Icon(), painterResource, Icons. 포함 여부 kpi_cards → Row(), Grid, LazyVerticalGrid 포함 여부 ## DASH.md 필수 섹션 (스키마: harness/product-specs/DASH-schema-v1.json) meta:, trigger:, skin:, dash:, protocol: + meta.id 필수 ## 코딩 규칙 1. creator_models.py의 데이터클래스를 임의로 변경하지 않는다. 2. 새 도메인 추가 시 creator_intent.py, blueprint_registry.py, style_registry.py, data_registry.py, prompts/{domain}.md 모두 수정. 3. 새 Validator 규칙 추가 시 FEATURE_CHECKS dict와 check 메서드를 동시에 추가. 4. LLM 없이도 시뮬레이션 모드(_simulation_response)가 동작해야 한다. 5. API 응답 형식(GenerateResponse)은 변경하지 않는다. 6. 점수 계산: max(1, 10 - failed*3 - warnings) ## 시뮬레이션 테스트 (LLM 키 없이) curl -X POST http://localhost:8000/api/creator/generate \ -H "Content-Type: application/json" \ -d '{"text": "탐조 대시 만들어줘", "size": "EXTRALARGE"}' # 기대: status=success, intent.domain=NATURE, validation.passed=true ## 참조 문서 - 전체 아키텍처: harness/design-docs/architecture/overview.md - 시나리오 트레이싱: harness/design-docs/architecture/simulation-guide.md - 개발팀 스펙: harness/design-docs/architecture/dev-handoff.md - 도메인 프롬프트 작성법: prompts/README.md

# 5개 핵심 테스트 — dev-handoff.md §4 참조 test_bird_dash_generation() # NATURE → AsyncImage 포함 test_stock_dash_generation() # FINANCE → tabular-nums 포함 test_unclear_domain() # 도메인 불명확 → needs_clarification test_validation_catches_issue() # NATURE에 이미지 없음 → passed: False test_dash_md_schema_valid() # 생성 DASH.md → 스키마 통과