나는 Claude Code를 통해 여러 AI 에이전트가 운영하는 단일 Git 저장소(repository)로서 내 삶을 운영합니다. 일기 쓰기, 자기 분석, 투자, 취미, 육아: 이 모든 것들은 각자의 문제를 해결하기 위해 내가 직접 만든 작은 앱에서 시작되었습니다. 육아 휴직 덕분에 긴 자유 시간이 생겼고, 그래서 이들을 각각 따로 운영하는 대신 한곳으로 옮겼습니다. 그리고 이 저장소의 주요 독자는 내가 아니라 AI입니다.

내가 인간을 위해 쓰는 것을 멈춘 순간, 나의 일기, 투자 노트, 육아 기록은 모두 AI가 통합적으로 읽을 수 있는 하나의 지식 베이스(knowledge base)로 변했습니다. 예전에는 각각 분리되어 있던 앱들이 마침내 이곳에서 연결되었습니다.

이 포스트는 이 전체 시스템에 대한 지도입니다. 개별적인 방법론(how-tos)은 각각의 포스트로 나눌 예정이므로, 여기서는 두 가지만 다룹니다: 왜 모든 것을 하나로 묶는지, 그리고 어떻게 운영되는지입니다.

내가 만드는 이유: 나는 항상 내 집안의 문제에서 시작한다

내가 만드는 것은 거의 항상 나 자신이나 가족의 문제에서 시작됩니다.

• 나의 일기 쓰기는 며칠을 넘기지 못한다.
• 나의 투자 결정에 확신을 가질 수 없다.
• 볼 애니메이션이 떨어진다.
• 육아 정보가 너무 소란스러워 결론에 도달하지 못한다.

처음에는 이 각각을 독립된 앱으로 만들었습니다. 하지만 몇 개를 만들고 나서, 별개의 앱들이 계속해서 하나로 유지되어야 할 단 한 가지, 즉 _나 자신_을 분절시키고 있다는 것을 깨달았습니다. 나의 투자 도구는 나의 가치관을 알지 못했습니다. 나의 일기 앱은 내 사고방식의 독특한 특징을 알지 못했습니다. 동일한 사람이 이 모든 것을 사용하고 있었지만, 어떤 컨텍스트(context)도 전달되지 않았습니다.

여기서 나의 사고 습관이 드러납니다. 문제에 직면했을 때, 나는 먼저 조건을 나누고 가장 유망한 경로를 찾습니다.

편리한 도구들을 많이 늘어놓을 것인가, 아니면 모든 것을 하나의 기반 위에 둘 것인가? 두 번째 옵션은 모든 컨텍스트를 한곳에 유지하며, 더 많이 구축할수록 기반이 더 강력해집니다. 어떤 것이 복리로 쌓이는가? 이 질문이 내가 내 삶을 단일 저장소 안에 넣기로 결정한 이유입니다.

기반: 인간이 아닌 AI를 위해 작성된 문서들

이것이 핵심 전제입니다.

팀 단위에서는 인간이 공유할 수 있도록 문서를 작성합니다. 하지만 혼자 작업할 때는 그런 독자가 존재하지 않습니다. 내 저장소(repository)의 주요 독자는 AI입니다. 그래서 나는 문서를 인간이 읽기 쉽게 설계하지 않습니다. 대신 AI가 읽고 검색하기 쉬운 구조로 작성합니다.

구체적으로, 나는 세 가지를 실행합니다:

• **파일당 하나의 사실(one fact per file)**로 내용을 분리합니다.
• 프론트매터(frontmatter)에 검색 가능한 메타데이터(metadata)를 넣습니다.
• 무엇보다도 "나중에 AI가 이것을 찾을 수 있을까?"라는 질문을 바탕으로 파일 이름을 정합니다.

나는 산문(prose), 장식, 그리고 처음부터 끝까지 읽도록 의도된 모든 것을 배제합니다. 내가 콘텐츠를 다시 확인하고 싶을 때, 나는 파일을 직접 열지 않고 AI에게 물어봅니다.

이것은 일반적인 의미의 제2의 뇌(second brain)가 아닙니다. 제2의 뇌는 나중에 다시 읽기 위한 용도입니다. 나의 방식은 그 반대입니다. 내 노트는 의도적으로 내가 읽기 어렵게 작성되었습니다. 노트는 AI를 위해 작성되었으며, 인간을 향한 인터페이스는 파일이 아닌 대화(conversation)입니다.

저장소의 골격은 다음과 같습니다:

life/
├── journal/      # 대화형 일기 (year/month/day.md)
├── persona/      # 자기 분석 (dimensions/ = 교차 분석, chapters/ = 타임라인, insights/ = 자동 추출)
...

모든 파일은 AI가 쿼리(query)할 수 있는 메타데이터로 시작합니다. 예를 들어, 일기 항목은 다음과 같이 시작합니다:

---
date: 2026-03-12
mood: 4
...

이것을 삶 전체로 확장하면, 나의 일기, 자기 분석, 가치관, 그리고 프로젝트 기록들이 모두 AI가 읽을 수 있는 구조화된 지식으로서 한곳에 쌓이게 됩니다. 이것이 내가 내 삶을 운영할 때 딛고 서 있는 토대입니다.

내가 공유하는 것과 비공개로 유지하는 것

미리 선을 그어두겠습니다. 나는 이것을 어떻게 구축했는지는 공유할 수 있지만, _나의 개인 데이터 자체_는 비공개로 유지합니다. 이 포스트는 그 선을 넘지 않습니다.

공유됨	비공개 유지
아키텍처 및 디자인 아이디어	내 일기의 내용
...

참고 사항: 제가 공개하는 기술(skills)과 CLAUDE.md는 제 저장소(repository)에서 추출하여 일반화한 것입니다. 저의 일상적인 기록은 AI를 위해 작성되지만, 사람들에게 전달하는 모든 것은 사람이 읽고 재사용할 수 있는 형태로 다시 작성합니다. 저는 이 두 가지를 별개의 것으로 취급합니다.

아래 템플릿은 GitHub에 있습니다: CLAUDE.md, 디렉토리 구조, 그리고 저널링(journaling), 주간 검토(weekly review), 자기 분석(self-analysis)을 위한 세 가지 기술(/journal, /weekly-review, /persona)이 포함되어 있습니다.

takotyan00 / claude-code-life

Claude Code를 사용하여 인생을 하나의 Git 저장소로 운영하기 위한 AI 네이티브 템플릿 — 주요 독자가 인간이 아닌 AI가 되도록 설계되었습니다.

日本語 | English

claude-code-life

Claude Code로 「인생을 하나의 리포지토리」로 운영하기 위한, AI 네이티브 개인 운영 프레임워크 (템플릿).

일기·자기 분석·프로젝트 관리·아이디어를, 인간이 아닌 AI가 제1독자가 되는 구조로 하나의 리포지토리에 통합하고, 용도별 Claude Code 기술(skills, 에이전트)로 운영합니다.

설계 사상의 전체 모습은 여기로 → 저장소는 인간을 위해 작성하지 않는다 — Claude Code로 일기·투자·육아까지 운영하기【전체 모습】

컨셉

• 제1독자는 AI: 문서를 인간의 가독성이 아니라, AI의 검색 및 횡단성(cross-referencing)을 위해 설계한다. 1파일 1사실, frontmatter에 메타데이터를 포함하며, 파일명은 "나중에 AI가 찾을 수 있는가"를 최우선으로 한다.
• 하나의 토대로 통합: 별개의 도구에 흩뜨리지 않고, 하나의 리포지토리에 집약하여 문맥(context)을 공유하게 한다. 구축할수록 기반이 강해진다.
• 다중 에이전트 운영: 용도별 기술(skills)이 동일한 지식 베이스를 참조하며, 하나의 출력이 다른 입력이 된다.

구성

.
├── CLAUDE.md                     # Claude Code를 위한 공유 지시 템플릿
├── journal/                      # 대화형 일기 (년/월/일.md)
...

포함된 내용 (이 템플릿의 범위)

• CLAUDE.md — Claude Code를 위한 공유 지침 템플릿
• .claude/skills/ — 대화형 일기 / 주간 리뷰 / 페르소나 구축의 3가지 스킬 (범용 버전)
• .claude/rules/ — 방법론 규칙 (mcp-vs-skills) + 대화 행동 규칙 (unknown-term-lookup) + 각종 포맷 양식
• .claude/rules/correction-rules/ — AI가 자신을 올바르게 읽도록 하는 보정 규칙. 범용화된 실례 1개를 포함하고 있음 (example-understated-expression.md)
• .claude/config/context.example.yaml — 모든 스킬이 공유하는 컨텍스트 (Context)의 템플릿
• journal/ ideas/ projects/ persona/ — 각 디렉토리의 역할은 README에서 설명

사용 방법

1. 이 리포지토리를 clone(또는 템플릿으로 이용)한다.
2. .claude/config/context.example.yaml을 같은 위치에 .claude/config/context.yaml로 복사하고, 자신의 관심사 및 프로젝트를 기입한다.
3. Claude Code에서 /journal /weekly-review /persona를 실행한다.
4. 자신의 운영 방식에 맞춰 CLAUDE.md · rules · skills를 조정한다.

아직 포함되지 않은 것 (순차적으로 추가 예정)

• 보정 규칙 추가분 — 범용화된 실례 1개를 이미 포함하고 있습니다 (.claude/rules/correction-rules/ 참조). 나머지는 개인적인 사례를 포함하고 있으므로, 범용화한 후 순차적으로 배포할 예정입니다. 설계 철학은 위의 기사와 후속편에서 다루겠습니다.
• finance / 취미 추천 등 도메인별 스킬.
• /trend (트렌드 수집) · /improve (환경 개선) 등의 주변 스킬 — 본 템플릿에는 포함되어 있지 않습니다. context.yaml의 sources /...

View on GitHub

개인적인 사례를 포함하는 보정 규칙과 도메인별 스킬은 제가 범용화하는 대로 그곳에 추가될 것입니다.

작동 방식: 멀티 에이전트 시스템 (Multi-agent system)으로서의 Claude Code 스킬

이 기반 위에서, 각 작업에 맞는 목적별 에이전트(스킬)가 실행됩니다. 일기를 쓰는 에이전트, 자기 분석을 심화하는 에이전트, 모든 것을 매주 리뷰하는 에이전트, 트렌드를 수집하는 에이전트가 각각 존재합니다. 각 에이전트는 동일한 지식 베이스 (Knowledge base)를 읽습니다.

flowchart TB
    subgraph AG["Agents (skills)"]
        direction LR
...

여기서 "멀티 에이전트 (multi-agent)" 부분이 실제로 의미하는 바는 다음과 같습니다. 한 에이전트의 출력이 다른 에이전트의 입력이 된다는 것입니다. 주간 검토 (weekly-review) 에이전트는 나의 일기, 프로젝트 진행 상황, 그리고 건강 데이터를 한꺼번에 읽습니다. 그리고 이 모든 과정을 수행하면서, 문제를 조건으로 분해하는 나만의 방식이 에이전트들이 따르는 지침 (instructions)에 녹아들어 있습니다. 특정한 개인인 내가 생각하는 방식의 독특함이 시스템의 동작으로 재현되는 것입니다. 일반적인 AI 도구는 이를 재현할 수 없습니다.

교정 규칙 (Correction rules): AI가 나를 단순화하는 것을 막는 법

네 가지 영역 중에서, 제가 가장 많은 공을 들인 부분입니다.

대부분의 "AI 어시스턴트 (AI assistants)"는 사람 외부의 세계, 즉 일정이나 작업 등을 다룹니다. 하지만 이 시스템은 그보다 앞선 단계, 즉 AI가 나를 잘못 읽는 것을 멈추게 하는 데 집중합니다. 심오하고 신비로운 의미가 아니라, 구체적인 의미에서 말입니다.

AI를 그대로 내버려 두면, AI는 사람을 편리한 요약본으로 단순화(flatten)해 버립니다. 예를 들어 제가 어떤 날을 "평소와 같았다"라고 언급한다고 가정해 봅시다. 에이전트는 이를 "가벼운 하루"로 읽고 넘어가 버립니다. 하지만 저의 교정 규칙 중 하나는 다음과 같습니다. 내가 무언가를 "평소와 같다"라고 말할 때, 그것을 가벼운 것으로 취급하지 말고 — 실제로 그날 내가 무엇을 했는지 확인하라. 이 규칙이 있기 전에는 일기 작성 (journaling) 에이전트가 그런 날을 노력이 적게 들어간 날로 취급했을 것입니다. 규칙이 적용된 후에는, 동일한 문구가 에이전트로 하여금 그날의 기록을 먼저 열어보게 만들어, 그날을 가벼운 날로 분류하는 것을 멈추게 합니다. 또한 에이전트의 후속 질문들도 더 날카로워지는 경향이 있습니다.

저는 대화형 일기 (dialogue journal)를 통해 이러한 규칙들을 구축합니다. 저의 가치관, 사고의 독특함, 그리고 감정적 패턴들이 인용된 일기 문구와 날짜라는 증거와 함께 천천히 구조화됩니다. 이 구조화된 모습이 저의 페르소나 (persona)이며, 교정 규칙은 AI가 이를 잘못 읽지 않도록 유지하는 부분입니다. 이 중 어느 것도 자기 이해 (self-understanding) 내부에만 머물지 않습니다. 동일한 페르소나와 규칙 덕분에 다른 에이전트들도 나의 맥락 (context)을 염두에 두고 행동할 수 있습니다.

네 가지 모듈 (자기 이해, 돈, 취미, 육아)

현재 저는 네 가지 영역에 대한 앱을 가지고 있습니다. 각 영역은 별도의 포스팅을 할 가치가 있으므로, 여기 지도를 그려둡니다.

• 자기 이해 (Self-understanding): 위에서 언급한 대화형 저널(dialogue journal)과 교정 규칙들입니다. 이것이 제가 가장 앞세우는 핵심입니다.
• 돈 (투자, Money (investing)): 투자 결정을 위한 시장 데이터 기반으로, 세 가지 계층으로 구성됩니다. 중립적인 데이터베이스를 바탕으로, "공격" (구조적 변화를 조기에 포착하는 것)과 "방어" (배당금을 꾸준히 쌓아가는 것)로 나뉩니다.
• 취미 (Hobbies): 제 애니메이션 평점으로부터 (저조차 말로 표현하지 못했던) 제 취향의 형상을 끌어내어 추천 시스템으로 전환하는 것입니다.
• 육아 (Parenting): 근거 기반(evidence-based) 육아 정보를 가져와 노이즈를 제거하고, 최단 경로로 결론에 도달하는 앱입니다.

이 네 가지는 흩어져 있는 것처럼 보이지만, 동일한 AI 기반 지식 베이스(AI-read knowledge base)와 동일한 사고 방식을 공유하기 때문에 하나로 통합됩니다. 자기 분석을 통해 구축한 성향들은 다른 에이전트들에게도 보입니다. 모든 에이전트가 동일한 베이스를 읽기 때문입니다. 네 개의 앱이 단순히 나란히 놓여 있는 것만으로는 이런 일을 할 수 없습니다.

솔직히 말해서

저의 접근 방식은 "작동하는 데 필요한 만큼만 가져온 다음, 이를 여러 영역에 걸쳐 묶는 것"입니다. 저는 무언가를 구축하기 전에 그것을 완전히 이해하지 못합니다. 일단 실행하는 데 필요한 만큼만 가지고 앞으로 나아갑니다. 따라서 저는 특정 영역의 이론적 깊이, 예를 들어 딥러닝 (deep learning)의 가장 깊은 부분이나 금융 공학 (financial engineering) 같은 분야에서 경쟁하지 않습니다. 저는 "여기까지가 내가 도달한 지점이다"라고 솔직하게 선을 긋습니다. 제가 제공할 수 있는 가치는 깊이가 아니라, 영역을 가로지르는 설계 (cross-cutting design)에 있습니다.

그리고 모든 것이 매끄럽게 돌아가는 것은 아닙니다. 저의 개발은 파도처럼 밀려옵니다. 새로운 것을 만드는 것은 즐겁고 추진력이 생기지만, 그 이후의 정리 단계, 즉 이미 구축된 것을 다듬는 과정은 지루하며 제 손은 멈춰버립니다. 네 가지 영역 중 일부는 현재 실행 중이고, 일부는 제가 멈춰둔 곳에 그대로 있습니다. 그것들이 멈춘 이유는 "지루해졌기 때문"이며, 그 이상의 이유는 없습니다.

그래서 저는 여전히 매일 사용하고 있는 것들부터 시작하여, 한 번에 하나의 모듈씩 이 내용들을 작성해 나가겠습니다.