MiniCITY v0.2 구조 및 업데이트 규칙

📁 디렉토리 구조

MiniCITY/
├── 00.INBOX/                    # 미분류 임시 보관 (매주 일요일 정리)
├── 01.SYSTEM/                   # 볼트 표준 및 관리
│   ├── 00-볼트구조도.md
│   ├── 01-명명규칙.md
│   ├── 02-버전관리.md
│   └── 03-업데이트규칙.md
├── 02.INFRA/                    # 인프라 (하드웨어 + 네트워크)
│   ├── 01-하드웨어/
│   │   ├── 메인컴.md
│   │   ├── 보조컴.md
│   │   ├── 맥미니.md
│   │   ├── 개인나스.md
│   │   ├── 백업나스.md
│   │   └── 기타주변기기/
│   ├── 02-네트워크/
│   │   ├── 아지트-네트워크.md
│   │   ├── 회사-네트워크.md
│   │   ├── Tailscale-설정.md
│   │   └── SSH-접근정보.md
│   └── 03-보안/
│       └── 인증키-관리.md
├── 03.AGENTS/                   # 에이전트 통합 관리
│   ├── 00-에이전트개요.md
│   ├── 01-OpenClaw-미미/
│   │   ├── 설정/
│   │   │   ├── 초기셋팅.md
│   │   │   ├── 스킬목록.md
│   │   │   └── 도구설정.md
│   │   ├── 메모리/
│   │   │   └── MEMORY.md
│   │   └── 로그/
│   ├── 02-Hermes-Agent/
│   │   ├── 설정/
│   │   │   ├── 메인컴-셋팅기.md
│   │   │   ├── 보조컴-성공기.md
│   │   │   └── 설치메뉴얼.md
│   │   └── 로그/
│   └── 03-LLM-모델/
│       ├── Ollama-모델목록.md
│       └── 모델별-사용처.md
├── 04.SOFTWARE/                 # 소프트웨어 설정 가이드
│   ├── WSL-설정.md
│   ├── SSH-자동인증.md
│   ├── Docker-설정.md
│   └── 기타도구/
├── 05.PROJECTS/                 # 진행 중 프로젝트
│   ├── A.mini-happy/
│   ├── B.선번조사툴/
│   ├── C.공사관리ERP/
│   ├── D.자동화/
│   ├── E.공가신청해지/
│   └── F.자료정리/
├── 06.QnA/                      # 에이전트 문의답변 이력
│   ├── 코파일럿-문의답변/
│   └── 제미나이-문의답변/
├── 07.ARCHIVE/                  # 아카이브 (교훈 저장소)
│   ├── 버전별/
│   │   └── v0.1-백업/
│   ├── 완료프로젝트/
│   ├── 교훈로그/
│   │   ├── 실패사례.md
│   │   └── 결정이유.md
│   └── memory.openclaw/         # 자동 세션 로그 (30일 보관)
└── 99.TEMPLATES/                # 문서 템플릿
    ├── 프로젝트-개요.md
    ├── 설정-문서.md
    └── 아카이브-기록.md

📝 명명 규칙

파일명 형식

[내용]-[버전].md
예: 메인컴-Hermes-셋팅기-v0.2.md
예: Tailscale-설정-v0.3.md

버전 표기

주 버전 (v1→v2): 구조 대변경
부 버전 (v0.1→v0.2): 내용 추가/수정

Frontmatter (모든 .md 파일 필수)

---
type: [infra | agent | software | project | qna | archive | template | system]
version: v0.X
created: YYYY-MM-DD
updated: YYYY-MM-DD
system: [메인컴 | 보조컴 | 맥미니 | 나스 | 공통]
agent: [OpenClaw | Hermes | 없음]
tags: [태그1, 태그2]
---

🔄 업데이트 규칙

새 문서 vs 기존 수정

상황	행동
완전히 새로운 주제	새 문서 생성
기존 문서 30% 이상 변경	수정 + 버전업
내용 추가만 (구조 변경 없음)	수정 + 날짜 업데이트
주제가 2개 이상으로 분리 필요	기존은 인덱스로, 새 문서 생성
내용 모순	병합 후 구버전은 아카이브 이동

에이전트(미미, Hermes) 업데이트 규칙

1. 수정 전: memory_search로 기존 문서 + 중복 확인
2. 작성 시: frontmatter 필수, 버전 번호 증가
3. 작성 후: 01.SYSTEM/03-업데이트규칙.md에 변경 로그 1줄 추가
4. 중복 처리: 80% 이상 중복 → 병합 후 구문서 아카이브
5. 00.INBOX: 매주 일요일 정리 (분류 또는 삭제)

버전 마이그레이션 규칙

1. 07.ARCHIVE/버전별/v0.X-백업/에 전체 복사
2. 새 구조에 따라 문서 재배치
3. 01.SYSTEM/03-업데이트규칙.md에 변경 로그 기록
4. 기존 파일은 삭제하지 않고 아카이브 이동만

📊 변경 로그

날짜	버전	내용	수정자
2026-04-19	v0.2	v0.1 → v0.2 마이그레이션, 구조 재편	미미