qbarev/para-plugin

영역(Areas)

영역은 종료일이 없는 지속적인 책임입니다 — 건강, 재정, 경력 등이 이에 해당합니다. 프로젝트가 아니며 "완료"되지 않습니다. 조용해진 영역은 이 스킬이 존재하는 이유입니다: 프로젝트와 달리, 영역은 자신이 소홀히 다뤄지고 있다는 사실을 알리지 않습니다.

영역이 구성되는 방식은 여기서 결정되지 않습니다. areas.md가 모델을 소유합니다: 그룹화 레이어가 전혀 있는지, 그룹 이름이 무엇인지, 어떤 frontmatter 필드가 그룹을 기록하는지, 새 노트가 어디에 저장되는지 등이 여기에 속합니다. 이 스킬은 알고리즘을 보유하고 모델을 읽을 뿐입니다 — 그룹 이름을 하드코딩하거나 그룹 개수를 가정하지 않습니다.

기본 레이어

실행 전에 다음 파일들을 각각 읽으십시오. 각 파일은 이 스킬의 기본 디렉토리 기준 ../../para/<file>.md에 있습니다. 이 파일들은 공유 규칙을 담고 있으므로 기억에서 다시 진술하지 마십시오:

• ../../para/paths.md — 항상 읽을 것. "언어(Language)" 포함: 아래 문자열들은 lang/<LANG>.md에서 가져옵니다.
• .claude/para/areas.md (보관소 설정, REPO_ROOT 아래) — 항상 읽을 것. 이 스킬은 모델 없이 무의미합니다.
• ../../para/note-format.md — create 명령용; review의 TASKS = files에서는 "레거시 필드(Legacy fields)" 참조.
• ../../para/find-target.md — review가 이름이 지정된 영역을 찾아야 할 때 사용.
• ../../para/confirm.md — create는 쓰기 작업; review는 아무 것도 쓰지 않음.
• ../../para/thresholds.md — review용.

하위 명령어

$ARGUMENTS의 첫 번째 단어가 하위 명령어를 결정합니다: create 또는 review. 비어 있음 → 둘 다 표시하고 물어보십시오.

---

create <name> — 영역 시작하기

1. Templates/Area.md 를 디스크에서 그대로 읽으십시오.
2. 그룹을 결정하십시오. areas.md에 GROUPS 목록에 있는 값 중 하나이며, 설명에서 유추합니다. 명확하지 않다면 물어보십시오 — 그룹화 필드는 파일이 저장될 위치를 결정하므로 비워둘 수 없습니다. GROUPING = none인 경우 이 단계는 적용되지 않습니다.
3. frontmatter를 채우십시오. note-format.md의 스키마에 있는 영역(Area) 행에 따라: title, tags: [area/<slug>] (slug는 note-format.md에 따라 채움), 그리고 모델에 그룹화 필드가 있다면 해당 필드.
4. 본문을 채우십시오:
   • common.links 섹션 — 관련 노트에 대한 위키링크, 그렇지 않으면 템플릿의 빈 -.
   • area.current_state 섹션 — 이 책임의 현재 상태를 사용자가 설명한 대로. 사용자가 말하지 않았다면 비워둠.
   • area.notes 섹션 — 비워둠; 시간이 지나면서 채워집니다.
5. areas.md의 PLACEMENT 경로에 쓰십시오. 설명이 하위 폴더를 암시하면 더 깊이 들어가십시오. 먼저 보관소 전체에 대해 기본 이름 충돌이 있는지 확인하십시오.
6. 경로와 그룹을 보고하십시오.

설명에 종료 상태와 목표가 있다면, 그것은 영역이 아니라 프로젝트입니다 — 그렇게 말하고 /projects create를 제안하십시오.

---

review — 무엇이 조용해졌는가

읽기 전용입니다. "내 책임 중 내가 보고 있지 않은 것은?"에 답합니다. 인수가 있으면 해당 영역만 검토하고, 없으면 GROUPS에 나열된 모든 그룹을 검토합니다 — 그 수가 얼마든 상관없습니다.

1. Areas/를 재귀적으로 탐색하십시오. 모든 노트에 대해: 경로, 그룹화 필드, 수정 시간(mtime) (stat -f '%m %N'). TASKS = files인 경우 */Tasks/*는 건너뜁니다: 이들은 작업 노트이며 영역 노트가 아닙니다 (note-format.md "레거시 필드").

2. 각 노트의 frontmatter를 읽고, area.current_state 섹션이 있으면 함께 읽으십시오. 전체 본문은 읽지 마십시오 — 이것은 요약이 아니라 훑어보기입니다.

3. 그룹별로 계산하십시오: 노트 수, 그룹이 마지막으로 수정된 시기, 그리고 thresholds.md에 정의된 영역 부실 임계값을 넘은 개별 노트 (프로젝트보다 의도적으로 훨씬 느슨하게 설정됨).

4. 실제로 발생한 것만 표시하십시오:

   • 노트가 전혀 없는 그룹;
   • 해당 임계값을 넘은 노트 — 얼마나 지났는지 말하고, 나쁘다고 말하지 마십시오;
   • PLACEMENT_CHECK를 위반한 노트 — 그룹화 필드가 위치한 폴더와 일치하지 않는 경우. 모델이 PLACEMENT_CHECK = none으로 설정하면 건너뜁니다;
   • area/ 태그 슬러그가 채워지지 않은 영역 노트;
   • frontmatter가 전혀 없는 노트 (관례 이전의 것 — 상태를 알리고, 마이그레이션하지 마십시오);
   • common.links 섹션의 끊긴 위키링크;
   • 프로젝트 작업처럼 읽히는 목표(종료 상태가 있는 목표)를 포함한 영역. 이름을 밝히고 분리하겠다고 제안하십시오.

5. LANG으로 렌더링하십시오. REVIEW_GROUPING에 따라, 보고할 내용이 없는 그룹은 제외하고, areas.review.* 문자열을 사용하십시오. 출력의 정확한 형태는 areas.md에 있습니다 — 모델에 따라 달라지므로 모델이 있는 곳에 작성됩니다.

6. 아무 것도 쓰지 마십시오. 검토 결과 실행할 가치가 있는 것이 발견되면 말하고 사용자가 결정하게 하십시오.

참고 사항

• 영역의 침묵은 정보이지, 평가가 아닙니다. 사실대로 보고하십시오 — "74일 동안 변경되지 않음", 결코 "당신이 버렸습니다"가 아닙니다.
• 영역은 거의 보관되지 않습니다; 지속적인 책임은 끝나지 않습니다. 보관을 요청받으면, 그것은 대개 책임이 아니라 노트가 오래된 것임을 의미합니다 — /archive를 참조하십시오.
• 모든 내용은 LANG에 따릅니다.