개인지식 시스템

지정된 접근 문자를 입력하면 이 브라우저에서 열람이 허용됩니다.

정적 사이트용 간단 게이트입니다. 강한 보안은 Cloudflare Access를 권장합니다.

← All Notes

Agent Skills Agent Skills 70-agent-skills/hermes/knowledge-repo-ingest.md

knowledge repo ingest

Hermes Workflow: knowledge-repo-ingest

Trigger examples:

  • "지식에 쌓아줘"
  • "이거 지식에 쌓아줘"
  • "이 대화 PKM에 반영해줘"
  • "이 유튜브 분석해서 지식저장소에 넣어줘"
  • "방금 나온 인사이트 저장해줘"
  • "knowledge repo 업데이트해줘"
  • "agent-knowledge-base에 저장해줘"

Repo Wrapper

  • Canonical repo: https://github.com/malda231125/agent-knowledge-base
  • Default local path: /opt/data/agent-knowledge-base
  • Astro/Cloudflare Pages wrapper는 Markdown graph 위의 read layer다. Markdown folder들과 AGENTS.md가 계속 source of truth다.

Workflow

  1. Repo wrapper를 찾거나 clone한다. /opt/data/agent-knowledge-base가 없고 GitHub auth가 가능하면 canonical repo를 clone한다.
  2. Human-facing architecture와 wrapper convention을 파악하기 위해 README.md를 읽는다.
  3. AGENTS.md를 읽는다. Folder semantic과 data-loading rule의 source of truth로 취급한다.
  4. 새 note type을 만들기 전에 60-schemas/의 관련 schema를 읽는다.
  5. 입력 type을 식별한다: source, conversation, insight, decision, map, project context.
  6. 입력을 repository data-loading contract에 따라 라우팅한다.
    • external source / YouTube / article / paper / meeting / chat -> primary artifact는 10-sources/
    • 재사용 가능한 비자명한 takeaway -> 20-insights/
    • 오래 유지되는 term/framework/model -> 30-concepts/
    • 지속되는 user/team choice -> 50-decisions/
    • topic navigation / MOC -> 40-maps/
    • unclassified raw material은 임시로만 00-inbox/
  7. 새 concept를 만들기 전에 existing concept note와 alias를 검색한다.
  8. 한 파일만 만들지 말고 knowledge graph를 갱신한다: source -> claims -> concepts/insights/decisions/maps.
  9. 저장되는 Markdown note body는 한국어로 작성한다. 영어/외국어 source라도 claim, insight, concept explanation, caveat, open question은 한국어로 변환한다. 원문 제목, URL, proper noun, code/API name, exact quote처럼 의미 보존이 필요한 표현만 원어를 유지한다.
  10. Obsidian wikilink와 YAML frontmatter를 보존한다.
  11. 덮어쓰기보다 누적한다.
  • canonical note가 이미 있으면 existing section과 source-backed claim을 보존한다.
  • 전체 note를 새 summary로 교체하지 말고 relevant section 아래에 새 claim/caveat/link를 추가한다.
  • older material은 명시적으로 superseded/stale이거나 reviewable commit으로 refactor할 때만 제거/재작성한다.
  1. Lightweight consistency check를 실행한다.
  • required frontmatter가 존재하는지
  • obvious duplicate concept title이 없는지
  • durable claim이 source를 cite하는지
  • raw source, interpretation, decision이 분리되어 있는지
  • folder choice가 data-loading contract와 맞는지
  1. Interactive 상황에서는 git diff를 사용자에게 보여준다.
  2. 승인되었거나 명시적으로 commit 요청을 받았을 때 clear prefix로 commit한다.

Default Commit Prefixes

  • source: add ...
  • insight: add ...
  • concept: update ...
  • decision: record ...
  • map: update ...