a10-context-manager

컨텍스트 관리자 (Context Manager)

Amaranth 10 모듈의 맥락을 GNB/LNB 메뉴 계층 구조로 분할해 관리하는 방법론. 모듈 전체가 크더라도 작업하는 메뉴 단위로만 로드해 효율적인 컨텍스트 관리를 가능하게 한다.

컨텍스트 파일 계층 구조

모든 모듈은 아래 구조를 따른다. 실제 파일은 사용자가 채우며, 이 스킬은 패턴만 정의한다.

{모듈명}/
├── module-overview.md        # 항상 로드 — 모듈 전체 요약 (1페이지 이내)
├── conventions.md            # 항상 로드 — 기술스택, 코딩 컨벤션, 라이선스 규칙
└── context/
    ├── {GNB-1}/
    │   ├── _overview.md      # GNB 전체 요약 (해당 GNB 작업 시 로드)
    │   ├── {LNB-1}.md        # LNB별 기능 상세 컨텍스트
    │   └── {LNB-2}.md
    └── {GNB-2}/
        ├── _overview.md
        └── {LNB-1}.md

로드 순서 (Loading Sequence)

아래 9단계 순서를 반드시 따른다. 전체 맥락을 효율적으로 확보하면서 세션 연속성을 유지할 수 있다.

1. module-overview.md — 모듈 전체 개요, 라이선스, GNB 목록
2. conventions.md — 기술스택, 코딩 컨벤션, 라이선스 규칙
3. sessions/_current.md — 세션 체크 (진행 중인 작업 확인 필수!)
4. 관련 진행 세션 파일 — 같은 주제의 진행 중 세션이 있으면 먼저 로드
5. tasks/_current.md — 현재 진행 중인 업무 목록
6. 문서/INDEX.md — 어떤 설계서/문서가 있는지 파악
7. context/{GNB명}/_overview.md — 작업 대상 GNB 개요
8. context/{GNB명}/{LNB명}.md — 작업 대상 LNB 상세
9. history/_timeline.md — 개발 이력 흐름 파악

3단계(세션 체크)는 필수이다. 진행 중인 세션이 있으면 중복 작업을 피하고 이전 맥락을 이어받을 수 있다.

컨텍스트 로드 원칙

항상 로드: 1-6번 (module-overview, conventions, 세션, tasks, INDEX) GNB 작업 시 추가 로드: 7번 (해당 GNB의 _overview.md) LNB 작업 시 추가 로드: 8번 (해당 LNB의 상세 파일) 히스토리 필요 시: 9번 (history/_timeline.md)

이 순서를 따르면 현재 작업에 필요한 맥락이 충분히 확보되고, 세션 간 연속성도 유지된다. 전체 모듈 파일을 한꺼번에 로드하지 않는다.

세션 인식 (Session Awareness)

원칙: 같은 주제의 진행 중인 세션이 있으면 새 분석을 시작하기 전에 그 세션의 완료 항목과 남은 작업을 먼저 확인한다.

예시:

1. sessions/_current.md 읽기
2. 진행 중: "상담관리 LNB 분석" 작업
3. 완료된 것: 상담 목록, 상담 등록
4. 남은 것: 상담 수정, 상담 삭제
→ 새 분석 대신 남은 작업부터 이어받기

누락 진단 (Missing File Diagnosis)

컨텍스트 로드 중 파일이 없으면 아래 형식으로 진단하고 제안한다:

누락 파일 목록:
- `module-overview.md` → {모듈명}/module-overview.md 생성 필요
- `context/상담관리/_overview.md` → {모듈명}/context/상담관리/_overview.md 생성 필요

해당 파일이 없어도 진행은 가능하지만, "향후 작성 필요" 항목으로 기록한다.

요약 출력 표준 (Summary Format)

로드 완료 후 사용자에게 전달하는 요약은 4줄 이내로 정리한다:

[모듈명] 컨텍스트 로드 완료

목적: {GNB/LNB 역할 한 줄}
라이선스: {구분이 있으면 명시}
구현상태: {진행 중/완료/기획 중}
리스크: {확인 필요 항목이 있으면 명시}

컨텍스트 파일 작성 기준

module-overview.md

• 모듈 목적과 사용 대상 (1-2문장)
• 라이선스 구분이 있는 경우 명시 (예: 법무법인용 / 기업법무팀용)
• 주요 GNB 목록
• 기술스택 한 줄 요약
• 현재 개발 단계 및 버전

conventions.md

• 기술스택 (프레임워크, DB, 프론트엔드)
• 코딩 컨벤션 핵심 규칙
• 라이선스별 기능 분기 규칙 (있는 경우)
• API 명명 규칙
• 주요 공통 컴포넌트 목록

{GNB}/_overview.md

• 이 GNB의 역할과 포함 LNB 목록
• 해당 GNB에서 자주 발생하는 이슈나 주의사항
• 라이선스별 접근 권한 차이 (있는 경우)

{GNB}/{LNB}.md

• 기능 목적 (1-2문장)
• 주요 기능 목록 (현재 구현 상태 포함)
• 관련 테이블/엔티티
• 알려진 이슈 또는 제약사항
• 최근 변경 이력 (날짜 포함)

컨텍스트 파일 업데이트 시점

작업이 끝나면 반드시 해당 LNB 파일을 업데이트한다. /update-context 커맨드를 사용하면 방금 완료한 작업을 요약해 자동으로 반영할 수 있다.

연쇄 업데이트 규칙 (Cascade)

context 파일을 변경할 때 관련 파일도 함께 업데이트해야 맥락이 끊기지 않는다. 상세 규칙은 douzone-forge CLAUDE.md의 "연쇄 업데이트 규칙 (Cascade Update Rules)" 섹션에 정의되어 있다.

R1 — context 변경 → module-overview.md 반영

context/ 파일(GNB _overview.md 또는 LNB.md)을 신규 생성하거나 대폭 변경하면:

1. module-overview.md의 GNB 목록 테이블에 상태·LNB 수 갱신
2. module-overview.md의 context 파일 인덱스 테이블에 새 파일 추가/갱신
3. module-overview.md 상단 최종 업데이트 날짜 갱신

R3 — 담당자 변경 → 5개 파일 동시 갱신

조직 변경이나 담당자 재배치가 발생하면 아래 5곳을 모두 업데이트:

1. _참조자료/조직/더존비즈온-조직구조.md
2. 해당 모듈 module-overview.md 조직 구성 섹션
3. 해당 모듈 context/_tech-reference.md 개발 담당자 매핑
4. Workspace_a10/CLAUDE.md 조직 구성 섹션
5. 관련 _projects/PRJ-*.md 01.B 담당자 섹션

R4 — 소스 분석 완료 → douzone-forge 반영

Workspace_a10에서 소스 분석이 완료되면:

1. 해당 모듈 context/_tech-reference.md에 분석 결과 요약 추가/갱신
2. _tech-reference.md에 Workspace_a10/_doc/analysis/[모듈]/ 경로 링크 추가
3. 기술적 발견사항이 기획에 영향을 주면 관련 context/[GNB]/_overview.md에도 반영
4. Workspace_a10의 architecture.md 말미에 douzone-forge 반영 상태 기록

신규 모듈 컨텍스트 초기화

새 모듈에 처음 적용할 때는 templates/context/ 아래 템플릿 파일을 복사해 모듈 디렉토리를 만들고 내용을 채운다. 자세한 내용은 references/setup-guide.md 참고.

마크다운 링크 규칙 (필수)

마크다운 파일 작성·업데이트 시 모든 경로·파일 참조는 클릭 가능한 상대 링크로 작성한다.

# 나쁜 예 (클릭 불가)
법무관리/tasks/_current.md에서 확인

# 좋은 예 (클릭 가능)
[법무관리/tasks/_current.md](../법무관리/tasks/_current.md)에서 확인

• 상대 경로는 현재 파일 위치 기준
• 코드블록 안의 폴더 구조 다이어그램은 예외 (링크 불필요)
• 상세 규칙은 douzone-forge CLAUDE.md의 "마크다운 링크 표기 규칙" 섹션 참조