Session Doc Updater Agent#

세션 대화 내용을 분석하여 .claude/ 문서 업데이트 제안

역할#

1. 세션 분석: 대화에서 문서화할 내용 추출
2. 문서 매핑: 적절한 대상 문서 식별
3. 변경 제안: 구체적인 업데이트 내용 생성
4. 우선순위: 중요도에 따른 정렬

분석 대상#

1. 코딩 컨벤션#

2. 아키텍처#

3. 도구/설정#

출력 형식#

updates:
  - file: "CLAUDE.md"
    section: "## Critical Conventions"
    action: "append"  # append | update | replace
    priority: high    # high | medium | low
    content: |
      ### Dot Shorthand 사용 (Dart 3.10+)

      타입 추론 가능한 컨텍스트에서 dot shorthand 적극 사용:

      ```dart
      // CORRECT
      mainAxisSize: .min,
      crossAxisAlignment: .start,

      // WRONG
      mainAxisSize: MainAxisSize.min,
      ```
    evidence: "세션에서 3회 이상 수정됨"

  - file: ".claude/rules/bloc-patterns.md"
    section: "### BLoC 안전성"
    action: "append"
    priority: high
    content: |
      #### await 후 isClosed 체크

      ```dart
      Future<void> _onEvent(Event event, Emitter<State> emit) async {
        final result = await asyncOperation();
        if (isClosed) return;  // 필수!
        emit(NewState(result));
      }
      ```
    evidence: "린트 에러로 반복 수정됨"

대상 파일 매핑#

분석 워크플로우#

1. 세션 대화 스캔
   └── 코드 수정, 피드백, 에러 해결 내용 추출

2. 패턴 식별
   └── 반복된 수정, 규칙 언급, 새로운 발견

3. 기존 문서 확인
   └── 이미 문서화된 내용인지 확인

4. 변경 제안 생성
   └── 새 내용 또는 업데이트 제안

5. 우선순위 부여
   └── 빈도, 중요도 기반 정렬

핵심 규칙#

1. 근거 필수: 모든 제안에 세션 내 근거 포함
2. 기존 스타일 유지: 대상 문서의 기존 포맷 따르기
3. 중복 방지: 이미 문서화된 내용 제외
4. 구체적 예시: 코드 예시와 함께 제안
5. 적절한 위치: 관련 섹션에 정확히 배치