db-sync

Audit Convention DB hierarchy and sync .claude/ files with templates.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/ryu-qqq/conventionHub --skill db-sync
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: db-sync
Source: https://github.com/ryu-qqq/conventionHub/tree/main/.claude/skills/db-sync
Command: npx skills add https://github.com/ryu-qqq/conventionHub --skill db-sync

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Convention DB 데이터를 분석, 동기화 및 정비하여 팀 규칙의 계층 구조를 일관되게 유지하고, .claude/ 파일과 DB 간의 동기화를 통해 레거시 데이터를 정리합니다.

Core Features & Use Cases

  • DB 계층 구조 감사 및 보고서 생성: DB 계층 구조를 점검하고 최신 상태의 보고서를 생성합니다 (예: 계층 트리, FK 무결성 체크, 구/신 레이어 매핑 검토).
  • .claude/ 파일과 DB 간의 동기화: .claude/agents/.md 및 .claude/skills//SKILL.md의 프런트맷터를 DB의 config_file_template에 동기화합니다.
  • onboarding_context 및 레이어명 정합성 유지: onboarding_context의 내용을 구 레이어명에서 신 레이어명으로 치환합니다.
  • 레거시 데이터 정리 및 백업 관리: 구 레이어명 잔존 데이터 제거 및 변경 전 백업 관리.

Quick Start

Run the /db-sync audit command to audit the DB and generate a full report, then run /db-sync sync templates to align the DB with .claude/ definitions.

Frequently Asked Questions about db-sync

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I audit my Convention DB layer structure and check for integrity issues?

Auditing a Convention DB layer structure involves analyzing the hierarchy tree, verifying foreign key integrity, and reviewing old-to-new layer name mappings. The audit command generates a comprehensive report covering these structural checks and highlights inconsistencies.

What is the best way to sync .claude/ files with a Convention DB?

Syncing .claude/ files with a Convention DB requires aligning the frontmatter of .claude/agents/*.md and .claude/skills/*/SKILL.md files with the DB's config_file_template. The sync templates command automates this frontmatter-driven alignment to enforce consistency.

How do I migrate onboarding_context content when layer names change?

Migrating onboarding_context content during layer name changes requires substituting old layer names with new ones to maintain data alignment. The onboarding command handles this text replacement while preserving hierarchical context integrity.

Can I clean up legacy layer name data without losing my current Convention DB hierarchy?

Cleaning legacy layer name data while preserving the current hierarchy requires secure data cleanup with backup management before modifications. The fix layers command removes residual old layer name data while maintaining pre-change backup snapshots.

Does db-sync work without external dependencies or frameworks?

db-sync operates without external dependencies or component frameworks, running entirely within the Claude environment. It requires only access to the Convention DB and the .claude/ directory structure to perform audits, synchronization, and cleanup operations.