scchearn/loam

loam 사용하기

이것은 loam 스킬 네임스페이스의 라우터입니다. 자체적으로 작업을 수행하지는 않습니다. 주어진 의도에 대해 어떤 loam 스킬을 호출해야 하는지, 그리고 모든 스킬에 적용되는 규칙을 알려줍니다.

이것은 라우팅/메타 스킬입니다. 일치하는 스킬을 인식하면 호스트 하네스의 스킬 로더를 통해 호출하십시오. 여기서 작업을 수행하지 마십시오.

양보할 수 없는 규칙

세 가지 규칙은 loam 작업을 메모리 모델과 일치시킵니다.

1. 모든 loam 작업 전에 관련 스킬을 호출하십시오. 단순한 도구 호출이 아닙니다. 계획 수립, 조사, 시작, 재개, 체크포인트 작성, 토론 또는 합의 도달, 계획 수정, 메모리 추가, 메모리 질의, 메모리 수정, 메모리 린트, 메모리 정규화, 메모리 검토, 학습 내용 기록, 가이던스 감사, 위키 스캐폴딩, 저장소 초기화 전: 일치하는 스킬을 호출하십시오. 이 문서는 라우터입니다. 스킬 본문에 실제 규칙이 있습니다. 그 외의 모든 것에 대한 책임은 당신에게 있습니다. 호출하는 쪽으로 오류를 범하십시오.
2. 메모리 우선, 기질은 그 다음. "메모리"에 대해 먼저 이야기하십시오. 마크다운 기질을 가이던스나 체크포인트 기질과 구분할 때만 "위키"를 사용하십시오. "메모리"를 의미할 때 "위키"라고 말하지 마십시오 — 위키는 메모리의 한 기질일 뿐, 전체가 아닙니다.
3. 에이전트 소유의 메모리 쓰기. 에이전트는 사전 승인 없이 메모리를 쓰고, 수정하고, 라우팅하고, 보관합니다. 사용자는 오래되었거나 잘못된 내용을 플래그할 수 있으며, 이는 에이전트가 발견한 모순과 동일한 수정 흐름을 트리거합니다.

메모리 모델

메모리는 loam이 캡처하는 모든 것을 포괄하는 개념입니다. 세 가지 기질이 존재합니다:

기질	설명	유지 관리 주체
wiki	wiki/ 디렉토리 아래의 내구성 있는 Obsidian 호환 마크다운 노트. 주제, 엔티티, 개념, 분석 페이지.	loam-memory 그룹 (대부분의 스킬)
guidance	AGENTS.md가 표준 가이던스 파일입니다. CLAUDE.md는 얇은 임포트 심(@AGENTS.md만)입니다. 개인 재정의를 위한 .claude.local.md.	loam-memory 그룹 (auditing-guidance, learning-from-session 가이던스 경로)
checkpoints	wiki/checkpoints/ 아래의 임시 작업 상태. 재개 노트, 내구성 있는 지식이 아닙니다.	loam-work 그룹 (checkpointing 쓰기, resuming 읽기)

wiki 기질은 qmd가 인덱싱하는 대상입니다. 가이던스 기질은 하네스가 프롬프트 컨텍스트로 로드하는 대상입니다. 체크포인트는 작업 상태이지 지식이 아닙니다 — index.md나 log.md를 건드리지 않으며 내구성 있는 주장이 되어서는 안 됩니다.

"메모리"에 대해 먼저 이야기하십시오. 기질 구분이 중요할 때만 "위키"를 사용하십시오. 마크다운 노트에서 작동하는 스킬은 메모리의 wiki 기질에서 작동합니다. AGENTS.md를 편집하는 스킬은 메모리의 guidance 기질에서 작동합니다. 둘 다 메모리입니다.

내구성 메모리 입학 심사 규칙

위키 페이지를 만들기 전에 이 규칙을 사용하십시오. 페이지 생성 스킬은 이 섹션을 복사하는 대신 참조합니다.

주장은 다음 세 가지를 모두 통과해야만 위키 페이지를 얻을 자격이 있습니다:

• R1 재사용 가능 — 다른 작업에 대한 향후 세션에서 필요할 가능성이 있어야 합니다.
• R2 프로젝트/도메인에 관한 것 — 코드베이스, 아키텍처, 결정, 규칙, 외부 종속성 또는 내구성 있는 외부 사실; 대화, 에이전트 또는 일시적인 사용자 상태에 관한 것이 아닙니다.
• R3 재구축 비용이 많이 들고 재확인 가능 — 라이브 소스(코드, 설정, 캘린더, 작업 목록)에서 주장을 다시 도출하는 비용이 페이지 유지 관리 비용보다 더 많이 들어야 합니다. 하나의 명령어나 하나의 파일 읽기로 다시 얻을 수 있다면 페이지를 얻을 자격이 없습니다. 외부 소스가 존재하는 경우 페이지는 이름을 지정하여 신선도를 재검증할 수 있도록 합니다. 순수한 결정과 근거는 그 추론을 명시함으로써 이를 충족합니다.

자격 박탈 기준은 규칙을 무시합니다:

• D1 일시적 — 빌드 상태, 현재 브랜치, "오늘 나는 X를 실행함" -> 운영 보고서.
• D2 중복 — 기존 페이지가 이를 다루고 있음 -> 새 페이지를 만드는 대신 기존 페이지를 수정하십시오.

동점자 처리: 라이브 소스에서 재구성할 수 없으면 입학; 재구성할 수 있으면 폐기. wiki/.archive/는 한때 내구성 있었지만 지금은 대체된 콘텐츠만을 위한 것입니다. 결코 내구성이 없었던 자료는 위키에 작성되지 않으며 보관되지 않습니다.

라우팅 매트릭스

자료	대상	스킬 경로
재사용 가능한 프로젝트/도메인 사실, 규칙 통과	내구성 있는 위키 페이지	loam::adding-to-memory, 자기 수정
에이전트 행동 규칙/명령어/주의사항	AGENTS.md / CLAUDE.md	loam::learning-from-session 가이던스 경로
재개/인계를 위한 세션 상태	wiki/checkpoints/<slug>.md	loam::checkpointing
작업 단위에 첨부된 작업별 컨텍스트	작업 주석 / 계획 파일	loam::planning, loam::starting
빌드 출력, 브랜치 상태, 일회성, 검증 불가능, 또는 규칙 실패	폐기, 선택적으로 log.md 감사 라인 포함	없음

자기 수정 및 사용자 플래그 트리거

• 자기 수정: 에이전트가 메모리를 읽고 현재 증거와 모순을 발견하면, 대체된 내구성 페이지를 보관 헤더와 함께 wiki/.archive/로 이동하고, 라이브 위치에 수정 사항을 작성하며, log.md에 self-correct 항목을 추가하고, 원래 작업을 계속합니다.
• 사용자 플래그: 사용자가 메모리 페이지가 잘못되었거나 오래되었다고 말하면, 이를 승인 요청이 아닌 수정 트리거로 처리합니다. 플래그된 페이지와 현재 증거를 읽고, 대체된 내구성 페이지를 보관하며, 수정 사항을 작성하고, 기록하며, 변경된 사항을 보고합니다.
• 보관 범위: .archive/는 내구성이 있었지만 나중에 잘못되었거나, 오래되었거나, 대체된 페이지만을 위한 것입니다. 결코 내구성이 없었던 자료는 다른 곳으로 라우팅되거나 폐기됩니다.

신선도 검증 트리거

기존 updated_at과 린트 시점의 증거를 사용하십시오; 신선도 frontmatter를 추가하지 마십시오.

• F1 인용된 파일 경로가 페이지 updated_at 이후 변경됨.
• F2 리팩터, 이름 변경, 삭제 또는 마이그레이션이 참조된 경로에 영향을 줌 (loam::syncing-code-graph --touched).
• F3 페이지가 명명한 고정 버전, API 또는 외부 문서에 더 최신 언급이 있음.
• F4 updated_at이 90일보다 오래되었고 페이지가 API, 설정, 버전 또는 코드 경로와 같은 변동성이 높은 표면을 인용함. 린트는 이를 재검증을 위해 플래그하며 자동 보관하지 않습니다.
• F5 읽기 시 모순, 자기 수정에 의해 처리됨.

검증 결과는 다음 중 하나입니다: 확인됨 (updated_at 업데이트), 수정됨 (보관 + 재작성 + 기록), 또는 격하됨 ("더 이상 적용되지 않음" 사유로 보관).

위험 신호: STOP과 호출을 의미하는 생각

이러한 합리화는 스킬을 건너뛰게 만듭니다. 만약 이러한 생각이 든다면, 세션에서 "이미 읽었더라도" 관련 스킬을 호출하십시오.

생각	행동
"그냥 위키에 이걸 쓰면 되겠다"	loam-adding-to-memory를 호출하십시오. 입학 심사 규칙을 적용한 다음, 쓰거나 라우팅하십시오.
"그냥 계획을 세우면 되겠다, 간단해"	loam-writing-spec을 호출하십시오. loam-planning 전에 스펙이 필요합니다.
"그냥 에이전트들끼리 빠른 토론을 하면 되겠다"	loam-configuring-agents를 호출하십시오. 토론은 승인 게이트가 있습니다; 게이트 전에 전송하지 마십시오.
"그냥 이 계획을 직접 수정하면 되겠다"	loam-amending-plan을 호출하십시오. 계획 변경은 연쇄 효과를 냅니다; 스킬이 영향을 검토합니다.
"나중에 도움이 될 수 있으니 이 메모리 페이지를 쓰겠다"	먼저 입학 심사 규칙을 적용하십시오. 실패하면 라우팅하거나 폐기하십시오.
"위키가 오래되었다, 인라인으로 수정하겠다"	대체된 내구성 페이지를 보관하고, 수정 사항을 작성하며, 기록하고, 계속하십시오.
"그냥 이 학습 내용을 노트로 캡처하겠다"	loam-learning-from-session을 호출하십시오. 위키나 가이던스로 라우팅하며, 당신이 직접 하지 않습니다.
"그냥 위키를 잠깐 확인하겠다"	loam-querying-memory를 호출하십시오. 오래된 컨텍스트가 아닌 메모리에 근거하십시오.
"그냥 이 명령어를 AGENTS.md에 추가하겠다"	전체 감사를 위해 loam-learning-from-session (가이던스 경로) 또는 loam-auditing-guidance를 호출하십시오.
"그냥 잠시 멈추고 나중에 다시 시작하겠다"	loam-checkpointing을 호출하십시오. 체크포인트는 재개 가능한 아티팩트이지, 정신적 노트가 아닙니다.
"중단한 지점에서 다시 시작하겠다"	loam-resuming을 호출하십시오. 행동하기 전에 라이브 상태를 확인하십시오.
"위키를 설정하겠다"	먼저 loam-scaffolding-wiki를 호출한 다음, Obsidian 설정을 위해 loam-initializing-vault를 호출하십시오.

loam 라이프사이클

모든 loam 작업에 대해:

1. 방향 설정. 아래 결정 그래프에서 일치하는 스킬을 인식하십시오. 두 스킬이 관련 있어 보이면 우선 순위 규칙을 적용하십시오.
2. 스킬 선택. 호스트 하네스의 스킬 로더를 통해 호출하십시오.
3. 기질 경계 유지. 체크포인트를 내구성 페이지에 작성하지 마십시오. 가이던스를 위키 페이지에 작성하지 마십시오. 위키 콘텐츠를 AGENTS.md에 작성하지 마십시오. 각 기질에는 해당 스킬이 있습니다.
4. 메모리 쓰기 전에 입학 심사 및 라우팅 적용. 내구성 있는 위키 페이지는 규칙을 통과해야 합니다; 그 외의 모든 것은 가이던스, 체크포인트, 작업 주석 또는 폐기로 이동합니다.
5. 일치하는 스킬을 통해서만 계획/체크포인트/가이던스를 업데이트하십시오. 계획을 인라인으로 편집하지 마십시오 — loam-amending-plan을 사용하십시오. 체크포인트를 인라인으로 작성하지 마십시오 — loam-checkpointing을 사용하십시오. AGENTS.md를 인라인으로 편집하지 마십시오 — loam-learning-from-session 또는 loam-auditing-guidance를 사용하십시오.

충돌 규칙 (두 스킬이 관련 있어 보일 때)

• 프로세스/현재 작업 스킬이 메모리 유지 관리 스킬보다 우선합니다. 실행 중에 메모리 문제를 발견하면, 현재 작업 단계를 먼저 완료하거나(또는 체크포인트를 작성한 다음) 메모리 스킬을 호출하십시오.
• 메모리 쓰기는 에이전트 소유입니다. 현재 작업이 학습 내용을 생성하면 매트릭스를 통해 라우팅하십시오; 오래된 메모리를 발견하면 보관 + 기록과 함께 인라인으로 수정하십시오.
• 체크포인트는 일시적입니다. wiki/checkpoints/ 아래에 있지만 내구성 있는 주장이 아닙니다. index.md나 log.md를 업데이트하지 않습니다. loam-adding-to-memory를 거치지 않고 체크포인트를 내구성 노트로 승격시키지 마십시오.
• 수정 vs 린트. loam-amending-memory는 특정 잘못된 주장을 수정합니다. loam-linting-memory는 전체 그래프의 상태를 점검합니다. 특정 오류를 발견했다면 수정하십시오. 일반적인 점검을 원한다면 린트하십시오.
• 질의 vs 검토. loam-querying-memory는 질문에 답합니다. loam-reviewing-memory는 공백을 표면화합니다. 답변을 원한다면 질의하십시오. 해결되지 않은 것이 무엇인지 알고 싶다면 검토하십시오.
• 추가 vs 학습. loam-adding-to-memory는 소스(파일, 기사, 대화를 노트로)를 수집합니다. loam-learning-from-session은 세션에서 파생된 통찰력을 캡처하여 위키나 가이던스로 라우팅합니다. 소스가 있으면 추가하십시오. 세션이 통찰력을 생성했다면 학습하십시오.

결정 그래프

"나는...를 원한다"
├─ 새로운 것을 시작
│  ├─ 질문 조사 ──────────────── /loam::writing-spec
│  ├─ 승인된 작업 계획 ────────── /loam::planning
│  └─ 토론 / 합의 도달 ───────── /loam::configuring-agents
├─ 작업 실행
│  ├─ 계획 시작 ───────────────── /loam::starting
│  ├─ 일시 중지 / 인계 ─────────── /loam::checkpointing
│  ├─ 일시 중지 후 재개 ──────── /loam::resuming
│  └─ 진행 중인 계획 변경 ──────── /loam::amending-plan
├─ 메모리 작업
│  ├─ 소스 추가 ───────────────── /loam::adding-to-memory
│  ├─ 코드베이스 수집 ─────────── /loam::ingesting-codebase
│  ├─ 코드 그래프 드리프트 동기화 ─ /loam::syncing-code-graph
│  ├─ 질문하기 ─────────────────── /loam::querying-memory
│  ├─ 잘못된 것 수정 ──────────── /loam::amending-memory
│  ├─ 상태 점검 ───────────────── /loam::linting-memory
│  ├─ 지저분한 코퍼스 정규화 ────── /loam::normalizing-memory
│  ├─ 해결되지 않은 것 확인 ────── /loam::reviewing-memory
│  ├─ 세션 학습 내용 캡처 ──────── /loam::learning-from-session
│  └─ 에이전트 가이던스 감사 ────── /loam::auditing-guidance
└─ 기질 설정
   ├─ 위키 스캐폴딩 ───────────── /loam::scaffolding-wiki
   └─ Obsidian 저장소 초기화 ───── /loam::initializing-vault

모호한 경우를 위한 우선 순위 참고

의도가 두 스킬에 매핑되면 위 트리가 기본 라우터입니다. 트리가 명확히 구분되지 않을 때는 라이프사이클 섹션의 충돌 규칙을 적용하십시오. 그래도 확실하지 않으면: 사용자에게 어떤 의도가 더 가까운지 물어보십시오.

간결한 스킬 참조

스킬당 한 줄. 결정 그래프가 기본 라우터이며, 이것은 빠른 조회용입니다.

• loam-writing-spec — 질문을 조사하고 specs/<slug>.md를 생성합니다.
• loam-planning — 승인된 스펙을 실행 가능한 계획으로 컴파일합니다.
• loam-starting — 계획 실행을 시작하거나 재개합니다.
• loam-resuming — 체크포인트 노트에서 재개합니다.
• loam-checkpointing — 일시 중지 전에 재개 가능한 체크포인트를 작성합니다.
• loam-configuring-agents — 고유한 입장과 수렴 결과물을 가진 에이전트들 간의 승인 게이트가 있는 구조화된 토론 또는 회의를 실행합니다.
• loam-amending-plan — 범위 변경 후 진행 중인 계획을 업데이트합니다.
• loam-adding-to-memory — 소스를 메모리(wiki 기질)에 수집합니다.
• loam-ingesting-codebase — 위키링크 가장자리가 있는 엔티티 페이지로 코드베이스를 수집합니다.
• loam-syncing-code-graph — 계획 게이트에서 또는 온디맨드로 코드 그래프를 저장소와 조정합니다.
• loam-querying-memory — 메모리에서 질문에 답합니다.
• loam-amending-memory — 특정 잘못되거나 오래된 메모리 주장을 수정합니다.
• loam-linting-memory — 메모리 그래프의 상태를 점검합니다.
• loam-normalizing-memory — 지저분한 메모리 코퍼스에 구조를 적용합니다.
• loam-reviewing-memory — 메모리에서 해결되지 않은 공백을 표면화합니다.
• loam-learning-from-session — 세션 학습 내용을 캡처하여 위키나 가이던스로 라우팅합니다.
• loam-auditing-guidance — AGENTS.md / CLAUDE.md / .claude.local.md를 감사하고 개선합니다.
• loam-scaffolding-wiki — 새로운 wiki 기질 스캐폴드를 인스턴스화합니다.
• loam-initializing-vault — 설정과 함께 Obsidian 저장소를 설정합니다.

슬래시 명령어 설치하기

사용자가 /checkpoint 및 /resume을 ( /loam::checkpointing 및 /loam::resuming을 입력하는 대신) 단축 명령어로 사용하려면 설치할 수 있습니다. 명령어 파일은 loam 저장소의 commands/ 디렉토리에 있습니다.

전체 프로토콜은 references/commands-install.md를 읽으십시오. 여기에는 다음이 포함됩니다:

• 어떤 하네스에서 실행 중인지 (감지 신호)
• 하네스가 기대하는 명령어 형식 (마크다운 vs TOML)
• 설치 위치 (전역 vs 프로젝트 로컬)
• 복사 전 허가 요청 프로토콜

명령어 파일은 assets/commands/ 아래에 번들로 제공됩니다.

…

[번역을 위해 잘림]