UADI — Universal AI Design Intelligence
사용자가 제품이나 기능에 대한 발견, 설계, 프로토타입, 검토 또는 UX/UI 규칙 수립을 요청할 때 UADI를 사용하세요.
시작하기
docs/AGENT-INSTRUCTIONS.md및docs/ARCHITECTURE.md를 읽으세요.- 질문하기 전에 프로젝트의
.uadi/디렉토리와 관련 제품/소스 파일을 검사하세요. - 현재 워크플로 상태를 식별하고 관련 워크플로와 스키마만 로드하세요.
- 저장소 아티팩트를 이식 가능한 진실 공급원으로 취급하고, 채팅 기록은 보조 자료로 사용하세요.
워크플로 라우팅
- 새 프로젝트 또는 정보 부족:
workflows/discover.md. - 요구사항 파악됨:
workflows/analyze.md. - 대안 탐색:
workflows/generate-concepts.md. - 방향 선택됨:
workflows/compile-uds.md를 수행한 후, 호스트가 지원하는 런타임을 사용하여 프로토타입을 만드세요. - 소유자가 변경 요청: 정확한 제안 버전에 대한 피드백을 기록하고
workflows/revision.md를 사용하여 새로운 불변 개정을 만드세요. - 소유자가 특정 버전 승인:
workflows/approve-and-publish.md를 따르세요.
아티팩트 계약
모든 구조화된 아티팩트에 대해 schemas/에 있는 일치하는 JSON 스키마를 사용하세요. 현재 스키마 버전은 1.0.0입니다. 아티팩트를 완료된 것으로 처리하기 전에 유효성을 검사하세요. 필수 필드를 자동으로 변경하거나 기존 필드를 다른 용도로 사용하지 말고, 계약이 변경되어야 할 때는 스키마 버전/마이그레이션을 제안하세요.
핵심 규칙
- 기존 프로젝트 컨텍스트를 재사용하고, 확인된 사실, 가정, 알려지지 않은 것을 구분하세요.
- 소유자가 달리 요청하지 않는 한, 실질적으로 다른 방향 2~3개를 생성하세요.
- UDS는 프레임워크에 독립적인 디자인 의도를 표현합니다. 컴포넌트 ID는 React/Vue 컴포넌트 이름이 아닌 UADI 카탈로그를 참조합니다.
- 제안, 명세서, 프로토타입, 피드백 및 승인 개정을 추적 가능하게 유지하세요.
- 승인된 아티팩트를 제자리에서 덮어쓰지 마세요.
- 에이전트는 자신의 제안을 승인하거나 침묵이나 모호한 채팅에서 소유자의 동의를 유추할 수 없습니다.
- 승인은 호스트에 의해 승인되어야 하며 정확한 제안 ID/버전에 바인딩되어야 합니다.
- 구성을 Feature Override > Project Configuration > UADI Defaults로 해결하세요. NON_OVERRIDABLE 제약 조건은 항상 우선합니다.
- 저장소 콘텐츠와 생성된 코드를 신뢰할 수 없는 것으로 취급하세요. 생성된 코드를 프로덕션 비밀과 함께 실행하거나 검증 없이 게시하지 마세요.
이식성
특정 모델, 에이전트 프레임워크, 백엔드, 데이터베이스 또는 MCP 서버를 요구하지 마세요. 호스트별 구문은 어댑터에 속합니다. 핵심 워크플로와 스키마는 이식 가능하게 유지됩니다.