Intent Map Schema

intent-map.yml의 전체 필드를 정의한다. 필수 표시가 없는 필드는 모두 선택이다.

Top-level

필드	타입	필수	설명
apiVersion	string	필수	형식 버전. 고정값 v1
metadata	object	필수	프로젝트 메타 정보
domains	object	필수	도메인 목록

metadata

필드	타입	필수	설명
name	string	필수	kebab-case 프로젝트 식별자
title	string	필수	사람이 읽는 프로젝트 제목

Domain

domains의 각 키가 하나의 도메인이다. 도메인은 specs 또는 areas 중 하나를 갖는다.

필드	타입	필수	설명
title	string	필수	도메인 제목
specs	string[]	조건부	spec 이름 목록. areas가 없을 때 사용
areas	object	조건부	하위 영역 목록. specs가 없을 때 사용

specs와 areas는 상호 배타적이다. 하나의 도메인에 둘 다 사용할 수 없다.

Area

areas의 각 키가 하나의 영역이다. area는 1단까지만 허용된다.

필드	타입	필수	설명
title	string	필수	영역 제목
specs	string[]	필수	spec 이름 목록

area 아래에 다시 areas를 넣을 수 없다. 깊이가 필요하면 도메인을 접두사로 분리한다.

규칙 요약

규칙	설명
최대 깊이	domain > area > spec 3단. area는 1단 제한
도메인 분리	커지면 이름 접두사로 분리 (issue, issue-comment)
specs vs areas	상호 배타. 한 도메인에 둘 다 사용 불가
spec 이름	kebab-case. <name>.intent.yml 파일과 매칭
검증	에이전트 워크플로우 규칙으로 관리. 자동화 도구 없음

다음 단계

• Intent Map 가이드 — 도메인 구조 규칙과 활용 방법을 확인한다