Instruction 파일의 한계를 극복한 Behavior Spec 기반 AI 컨텍스트 설계

Context

CLAUDE.md나 AGENTS.md와 같은 Instruction 파일은 Workflow 설정과 코딩 컨벤션 정의에는 유효하나 제품의 비즈니스 로직과 제약 사항을 정의하기에는 부족함. 이로 인해 AI 에이전트가 코드 스타일은 준수하지만 제품의 핵심 약속(Product Promise)을 파괴하는 회귀 오류를 발생시키는 한계가 존재함.

Technical Solution

• 단순 프로세스 가이드를 넘어 제품의 진실(Product Truth)을 정의하는 Layer 4: Behavior Spec(.pbc.md) 도입
• 비정형 텍스트 기반의 Instruction 파일과 구분되는 기계 가독성 및 인간 검토 가능 포맷의 Behavior Spec 설계
• '무엇을 해야 하는가'와 '무엇을 하지 말아야 하는가'를 명시하여 AI의 임의적 판단에 의한 로직 삭제 방지
• 기존 Instruction 파일을 Behavior Spec으로 연결하는 포인터 구조를 채택하여 Context 계층화 구현
• Billing, Auth 등 장애 영향도가 높은 핵심 모듈부터 점진적으로 Spec을 적용하는 전략적 접근
• Workflow(L1) → Session(L2) → PRD(L3) → Behavior Spec(L4)로 이어지는 4단계 컨텍스트 스택 구축