eyupcanbodur/agent-knowledge-hub

agent-knowledge-hub은(는) 무엇을 하나요?

에이전트에 구애받지 않는 개인 지식 모노레포 템플릿으로, 코딩 에이전트가 읽고, 쓰고, 유지 관리합니다: 차터 기반 서브 허브, 프라임/캡처/유지 스킬, 결정론적 위생 루프. AGENTS.md 계약 + 일반 CLI는 모든 에이전트와 작동합니다.

개요

이 템플릿은 AI 코딩 에이전트(Claude Code, Cursor, Codex 등)를 위한 개인 지식 관리 시스템을 제공합니다. 에이전트가 당신의 지식 베이스를 능동적으로 읽고, 새로운 정보를 추가하며, 지식을 최신 상태로 유지할 수 있도록 설계되었습니다.

주요 특징

• 에이전트 독립적: 특정 에이전트에 종속되지 않으며, AGENTS.md 계약을 통해 모든 에이전트가 작동 방식을 이해합니다.
• 차터 기반 서브 허브: 주제별로 지식을 분류하고 관리합니다. 각 서브 허브는 고유의 목적(헌장)을 가집니다.
• 프라임/캡처/유지 스킬: 세 가지 기본 스킬을 통해 지식의 생애주기를 관리합니다.
  • 프라임(Prime): 에이전트 시작 시 관련 지식을 로드하여 컨텍스트를 준비합니다.
  • 캡처(Capture): 새로운 지식(아이디어, 조각 정보 등)을 체계적으로 저장합니다.
  • 유지(Maintain): 지식의 정리, 중복 제거, 업데이트 등 위생 작업을 수행합니다.
• 결정론적 위생 루프: 정기적인 위키 정리, 링크 검증, 중복 제거 등을 자동화하여 지식 베이스의 건강을 유지합니다.

시작하기

1. 이 템플릿을 복제하거나 포크합니다.
2. AGENTS.md 파일을 열고 에이전트에게 프로젝트 구조와 규칙을 설명합니다.
3. 필요에 따라 서브 허브를 생성하거나 수정합니다.
4. prime, capture, maintain 스킬을 사용하여 지식을 관리합니다.

디렉토리 구조

.
├── AGENTS.md          # 에이전트 계약 파일
├── hub.d/             # 서브 허브 디렉토리
│   ├── research/      # 연구 노트 허브
│   ├── projects/      # 프로젝트 문서 허브
│   └── ...            # 기타 허브
├── skills/            # 스킬 디렉토리
│   ├── prime.sh       # 프라임 스킬
│   ├── capture.sh     # 캡처 스킬
│   └── maintain.sh    # 유지 스킬
└── scripts/           # 유틸리티 스크립트

사용 예시

프라임(Prime) - 에이전트 시작 시 컨텍스트 로드

에이전트가 시작될 때 자동으로 hub.d/의 관련 지식을 읽어들입니다.

캡처(Capture) - 새로운 지식 추가

# 에이전트가 새로운 정보를 캡처하여 적절한 서브 허브에 저장합니다.
./skills/capture.sh "프로젝트 X의 새로운 API 설계"

유지(Maintain) - 지식 정리

# 중복 확인, 링크 검증 등을 수행합니다.
./skills/maintain.sh

라이선스

MIT