docs: cli 용 문서 업로드 (runbook: 개발, runbook_planner: 기획)

This commit is contained in:
2026-02-14 02:05:07 +09:00
parent 99c996b20e
commit 8e9ba0431b
41 changed files with 2818 additions and 1 deletions

35
.cli/docs/rules.md Normal file
View File

@@ -0,0 +1,35 @@
# .cli/rules.md
## 범위 & 출력
- 변경 사항은 항상 **레포지토리에 직접 적용**한다. (diff만 출력하고 끝내기 금지)
- 출력은 최소로 유지한다:
1. 수정/생성/삭제된 파일 경로 목록
2. AC 체크리스트
3. housekeeping 결과 1줄
- 응답에 코드 전체를 덤프하지 않는다.
## 단일 진실(Source of Truth)
- `@.cli/current.md`는 요구사항과 AC의 **단일 진실**이다.
- current.md가 기존 문서/과거 지시와 충돌하면, **해당 실행(run)에서는 current.md를 우선**한다.
## FSD 경계 규칙
- `app/**``widgets`의 public API만 import 한다.
- `widgets/**``index.ts`를 통해 public API를 노출한다.
- `shared/**`는 안쪽 의존성이 없다(즉, `entities/features/widgets/app`를 import 하면 안 된다).
- 튜닝 파라미터는 가능하면 `shared/config`를 우선 사용한다.
## 검색 규율(토큰 절약)
- 필요하지 않으면 레포 전체를 스캔하지 않는다.
- 검색이 필요하면:
- `rg`는 1회만 실행한다
- 결과 요약은 5줄 이내로 제한한다 (내부 판단용; 장황한 로그 출력 금지)
## 안전 규칙
- current.md에 명시되지 않은 신규 기능을 추가하지 않는다.
- 요구되지 않으면 디자인/동작을 변경하지 않는다.
- 포맷만 바꾸는 변경(diff)은 피한다.