Appearance
Changelog
.intent.yml 명세 형식의 주요 변경사항을 기록한다.
형식은 Keep a Changelog를 따르며, 패키지 버전은 Semantic Versioning을 준수한다.
버전 정책
이 패키지는 두 가지 버전 식별자를 사용한다.
apiVersion(.intent.yml파일 내) — 포맷 호환성 버전. 깨지는 변경이 있을 때만 올린다 (v1→v2).v1을 지원하는 파서는 모든0.x.x패키지 버전의 명세를 처리할 수 있다.- 패키지 버전 (
package.json) — semver로 모든 명세 변경을 추적한다. major = 깨지는 포맷 변경 (apiVersion과 동기화), minor = 새 필드 또는 기능 추가, patch = 문서 수정 또는 명확화.
[0.2.0] - 2026-02-17
Added
- Intent Map (
intent-map.yml) — 프로젝트 전체 spec을 도메인별로 관리하는 매니페스트 형식 domain > area > spec최대 3단 구조 (area 1단 제한)- 도메인 접두사 분리 규칙 (
issue,issue-comment) - Scope & Boundaries — 행위 중심 범위 원칙, 에이전트 워크플로우 기반 검증
- Intent Map Schema 레퍼런스 문서
- Intent Map 예시 (Planit) 및 템플릿
[0.1.0] - 2026-02-16
.intent.yml 명세 형식 초기 릴리스. (apiVersion: v1)
Added
- 핵심 명세 구조:
apiVersion,kind,metadata,context,spec - 세 가지 kind 타입:
Feature,Enhancement,Integration spec.behaviors— 상위 수준 동작 선언spec.scenarios— BDD 스타일 Given/When/Then 시나리오drivers— 비즈니스 근거 (source선택 필드 포함)constraints— RFC 2119 수준 (MUST,SHOULD,MAY)examples— 구체적인 입출력 데이터openQuestions— 미결 사항 추적 (decidedAt,decision)metadata.status생명주기:draft→review→approved→implemented- 목록 필드의 문자열-객체 정규화
- VitePress 기반 문서 사이트 (가이드 + 레퍼런스)