name: db-sync description: Convention DB 데이터 분석/동기화/정비. 계층 구조 감사, .claude/ 파일 동기화, 레거시 데이터 정리. context: fork agent: convention-data-manager allowed-tools: Read, Write, Edit, Glob, Grep, Bash

/db-sync

Convention DB 데이터를 분석/동기화/정비합니다. DB 계층 구조 감사, .claude/ 파일과 DB 동기화, 레거시 데이터 정리.

사용법

/db-sync audit                        # DB 전체 계층 감사 → 보고서 생성
/db-sync audit --table layer          # 특정 테이블만 감사
/db-sync sync templates               # .claude/ agents+skills → DB config_file_template 동기화
/db-sync sync onboarding              # onboarding_context content 갱신
/db-sync fix layers                   # 구 레이어명 → 신 레이어명 일괄 치환
/db-sync report                       # 현재 데이터 현황 요약 (stdout)
/db-sync report --detail              # 상세 보고서 출력

입력

• $ARGUMENTS[0]: 서브커맨드 (audit, sync, fix, report)
• $ARGUMENTS[1]: 대상 (templates, onboarding, layers, --table {name})
• $ARGUMENTS[2]: 옵션 (--dry-run, --detail, --force)

전제 조건

1. 포트포워딩 활성화: localhost:13307 → RDS
   • 확인: lsof -i :13307
   • 없으면: docker/scripts/aws-port-forward.sh 실행
2. docker/.env.aws 존재: DB credentials 포함
3. pymysql 설치: 프로젝트 venv에 pip install pymysql

서브커맨드 상세

audit - DB 전체 계층 감사

읽기 전용. DB 22개 테이블의 정합성을 검사합니다.

실행 흐름:
1. 테이블별 row count + 최신 updated_at 수집
2. FK 무결성 체크 (고아 레코드 탐지)
3. 구 레이어명 잔존 체크 (PERSISTENCE, REST_API 등)
4. 보고서 생성

옵션:

• --table {name}: 특정 테이블만 감사

sync templates - .claude/ 파일 → DB 동기화

.claude/agents/*.md와 .claude/skills/*/SKILL.md를 스캔하여 DB config_file_template 테이블과 동기화합니다.

실행 흐름:
1. .claude/agents/*.md, .claude/skills/*/SKILL.md 스캔
2. frontmatter 파싱 (name, description)
3. DB config_file_template 조회
4. 비교: 파일에 있고 DB에 없으면 INSERT, 내용 다르면 UPDATE
5. --dry-run이면 SQL만 출력 (기본값)

sync onboarding - onboarding_context 갱신

onboarding_context 테이블의 content 필드에서 구 레이어명을 신 레이어명으로 치환합니다.

실행 흐름:
1. onboarding_context 전체 조회
2. content에서 구 레이어명 탐색
3. 신 레이어명으로 REPLACE
4. --dry-run이면 변경 대상만 출력 (기본값)

fix layers - 구 레이어명 → 신 레이어명 일괄 치환

여러 테이블의 텍스트 필드에서 구 레이어명을 일괄 치환합니다.

치환 매핑:
  PERSISTENCE → ADAPTER_OUT
  REST_API → ADAPTER_IN
  REST_API_ADMIN → ADAPTER_IN

대상 테이블/필드:
  onboarding_context.content
  coding_rule.description
  coding_rule.applies_to

report - 현재 데이터 현황 요약

읽기 전용. 현재 DB 데이터 현황을 stdout으로 출력합니다.

출력 내용:
- 테이블별 row count 요약표
- 계층 구조 트리 (tech_stack → architecture → layer → module)
- 최근 변경 이력 (최신 updated_at 기준)

옵션:

• --detail: 각 테이블의 주요 데이터까지 출력

옵션

출력

→ claudedocs/db-sync/audit-{YYYY-MM-DD}.md       (audit 보고서)
→ claudedocs/db-sync/sync-{YYYY-MM-DD}.md        (sync 결과)
→ claudedocs/db-sync/fix-{YYYY-MM-DD}.md         (fix 결과)
→ claudedocs/db-sync/backup-{table}-{date}.json   (변경 전 백업)
→ stdout                                           (report)