localmind AGENTS.md

AGENTS.md — localmind 작업 규약

이 저장소에서 작업하는 모든 AI 에이전트(Claude Code, Codex 등)가 따르는 규약이다. 작업 방법론(SDD 문서 체계·구현 착수·기록 연동)의 정본은 이 문서가 아니라 애드온이다 — 여기에는 localmind 고유의 것만 남긴다.

최상위 전제 — 왜 이 프로젝트가 존재하는가 (2026-07-23)

이 전제는 이 문서의 다른 모든 규칙·목표·게이트보다 최우선이다. 규칙 간 판단이 갈리면 이 전제로 되돌아와 해석한다.

• 이 프로젝트의 근본 목적은 AI에게 작업을 위임하기 위해, AI를 잘 사용하는 것이다.
• localmind는 그 목적을 위한 도구 중 하나로, 개인화 저장소(개인 second-brain) 겸 RAG 시스템으로 쓰려고 만든 것이다.
• 1차 사용자는 사람이 아니라 임무를 수행하는 AI다. 사람이 잘 쓰기 위한 도구이기 이전에, AI가 임무 수행을 잘 하기 위해 스스로 사용할 수 있는 도구여야 한다.
• 이는 아래 "오픈소스 대상 — 비개발자 포함"과 모순이 아니라 층위가 다르다: **AI에게 업무를 위임하는 주체는 모든 사람(비개발자 포함)**이고, localmind는 그 위임받은 AI가 일을 잘 할 수 있도록 만들어주는 **보조 도구(수단)**다. 사람 = 위임자·수혜자, AI = 도구의 1차 소비자.
• 따라서 모든 변경·규칙의 최종 기준은 "이것이 AI 위임·활용을 더 잘하게 하는가?"다. 아래 "범위 우선순위 — 코어 우선·메타 동결"을 포함한 하위 규칙들은 이 전제를 실현하는 수단이며, 이 전제와 충돌하는 방향으로 해석하지 않는다.

범위 우선순위 — 코어 우선·메타 동결 (2026-07-21)

이 저장소의 존재 목적은 다른 디바이스에서도 동일하게 쓰는 개인 second-brain(노트·색인· recall·MCP·동기화·백업)이다. 메타 계층(SDD 스킬·페르소나·rules·retro·critic 인프라·워크플로 템플릿)은 기능 동결 상태다:

• 메타 신규 확장은 금지한다. 허용 예외 셋뿐 — ① 결함 수정 ② governance-recalibration 리듬에 따른 파라미터 조정 ③ 코어 작업이 직접 요구하는 최소 변경.
• 새 작업 착수 시 "이 변경이 second-brain 사용자(디바이스 간 동일 사용)에게 무엇을 주는가?" 에 답한다 — 답이 없으면 메타 확장으로 간주하고 보류한다(작업 착수의 선행 게이트).
• 동결 해제는 사용자 명시 결정으로만 한다. 근거·실측: specs/202607210912-meta-freeze(메타 ~17k줄 vs 코어 ~4k줄, 2026.07 릴리스 8개 전부 메타 — 사용자 방향 결정 B).

작업 방법론 — 애드온이 정본 (2026-08-07)

방법론은 localmind-addons가 소유한다. 이 문서는 그것을 재서술하지 않는다 — 두 곳에 정본이 있으면 갱신되지 않는 쪽이 조용히 이긴다.

영역	정본
문서 체계(goal→spec→plan→tasks→review) · spec 폴더 생성 규칙 · 의식의 크기	sdd-5docs
구현 착수·재개·완료 판정(review.md 게이트)	goal-impl
기록 연동 — 세션 시작 brief · 결정 3층 capture_note · 기억 대신 검색	localmind-core
확정 전 미결정 좁히기	shape

• 의식의 크기는 작업 크기에 비례한다 — 판정 기준의 정본은 sdd-5docs의 비례 원칙이다. 이 저장소가 더하는 것은 위 "범위 우선순위" 게이트 하나뿐이다.
• 위임은 완화가 아니다. TDD · 실패 테스트 선행 · 실행 관찰(도그푸드) · 자기검증 · base 확인 · 미충족의 정직한 보고 — 이 요구들은 위임처에서 동등하거나 더 강하게 유지된다. 축약을 근거로 게이트를 낮추지 않는다.
• 애드온이 없어도 막히지 않는다(비차단): 설치되지 않은 환경이면 일반 규율로 진행하고 그 사실을 보고에 명시한다. 포인터는 안내이지 하드 의존이 아니다.