Plans

---
name: plans
description: VimAction 프로젝트의 진행 중 작업 플랜(단기 기억) SSOT — 여러 세션에 걸친 작업의 플랜을 기록하고, 다음 세션으로 인계하고, 완료되면 정리합니다. Use this skill whenever a multi-session work plan is created or agreed on ("이 플랜대로 진행하자", "플랜 기록해줘", plan mode 결과를 다음 세션에서 이어갈 때), whenever resuming work ("이어서 하자", "어디까지 했지?", "다음 뭐 하지?", "지난번에 하던 거"), when pausing mid-work ("오늘은 여기까지", "일단 여기서 멈추자"), and BEFORE starting any non-trivial work to check for an in-progress plan it might belong to. This is NOT a planning-method skill — 플랜을 세우는 방법은 다루지 않으며(plan mode 등이 담당), 이미 세워진 플랜의 기억·공유·수명 관리만 담당합니다.
---

# VimAction 플랜 관리 (Active Plans)

이 스킬은 **진행 중인 멀티세션 작업의 단기 기억 SSOT**입니다. 플랜 문서는 전부 `references/`에 있고, 이 파일은 규칙과 인덱스만 관리합니다.

역할 분담: `architecture`는 "지금 구조가 어떤가", `decisions`는 "언제 왜 그렇게 결정했는가", 이 스킬은 "**지금 무엇을 하는 중이고 무엇이 남았는가**"를 담당합니다. 앞의 둘과 달리 이 스킬의 문서는 **단기 기억**입니다 — 계속 갱신되는 살아있는 문서이고, 완료되면 삭제됩니다.

핵심 원칙: **낡은 플랜은 없는 것보다 나쁩니다.** 이미 끝난 일을 다시 하게 하거나 폐기된 방향으로 작업하게 만들기 때문입니다. 그래서 이 스킬의 규칙 대부분은 저장이 아니라 수명 관리(개수 제한, 갱신 강제, 완료 시 삭제)에 있습니다.

## 워크플로우 1 — 플랜 기록

멀티세션으로 진행할 작업의 플랜이 세워지면 (plan mode 결과물이든 사용자의 설명이든):

1. 활성 플랜이 이미 **3개**면 새로 만들기 전에 기존 플랜의 정리(완료/폐기)를 사용자와 먼저 확인합니다. 플랜이 많아질수록 "지금 것"이 흐려지고 방치된 플랜이 생깁니다.
2. `references/_template.md`를 복사해 `references/yyyymmdd_<kebab-case-title>.md` 생성 — 날짜는 **플랜 생성일**, `date +%Y%m%d`로 확인합니다.
3. **인계 단위로** 기록합니다: 목표, 완료된 것, 남은 것, 다음 세션이 알아야 할 컨텍스트. 세션 안에서만 의미 있는 세부 todo(함수 단위 체크리스트 등)는 기록하지 않습니다 — 그건 세션 내 TodoList의 몫이고, 여기 쌓이면 플랜이 금방 낡습니다.
4. **인덱스 테이블에 반드시 등재**합니다. 인덱스에 없는 플랜은 다음 세션이 발견하지 못합니다.

## 워크플로우 2 — 플랜 로드/재개

작업을 이어받거나("이어서 하자", "어디까지 했지?"), 새 작업 시작 전 관련 활성 플랜이 있는지 확인할 때:

1. 아래 인덱스에서 관련 플랜을 찾아 **해당 문서만** 읽습니다.
2. "완료된 것"은 다시 하지 않고, "남은 것"의 맨 위 항목부터 착수합니다. "진행 중 컨텍스트"의 막힌 지점·주의사항을 먼저 반영합니다.
3. **신선도를 확인합니다**: `갱신일` 이후에 관련 커밋이 있으면 (`git log --oneline --since=<갱신일>`) 플랜이 실제 진행보다 뒤처졌을 수 있습니다. 그대로 믿고 진행하지 말고, 차이를 확인해 플랜을 먼저 갱신하거나 사용자에게 알립니다.

## 워크플로우 3 — 진행 상태 갱신

마일스톤에 도달했거나 세션을 마무리할 때("오늘은 여기까지"):

1. 완료된 항목을 "완료된 것"으로 옮기고, "남은 것"과 "진행 중 컨텍스트"(막힌 지점, 다음에 바로 할 일)를 현재 상태로 갱신합니다. **`갱신일`도 반드시 갱신합니다** — 갱신 안 된 플랜은 다음 세션이 신뢰할 수 없고, 신뢰할 수 없는 플랜은 이 스킬의 존재 이유를 무너뜨립니다.
2. 진행 중 내려진 **기술 결정은 이 플랜 문서에 쌓지 않습니다.** 결정은 `decisions` 스킬로 라우팅하고(진입점 규칙 그대로), 플랜에는 관련 링크만 남깁니다. 플랜은 삭제될 문서라 여기 적힌 결정은 함께 사라집니다.

## 워크플로우 4 — 완료 처리

플랜의 모든 항목이 완료된 것으로 보이면:

1. 사용자에게 완료 여부를 **확인**합니다 ("이 플랜 완료된 것 같은데 정리할까요?"). 삭제는 되돌리기 어렵고, "사실 아직 남은 게 있다"를 이 단계에서 걸러냅니다.
2. 삭제 전, 기록 가치가 있는 결정·교훈이 플랜에 남아있다면 `decisions` 스킬로 라우팅합니다.
3. 확인되면 플랜 문서를 **삭제**하고 인덱스에서 제거합니다. 아카이브·완료 보관함을 만들지 않습니다 — 히스토리 가치가 있는 내용은 decisions가 담당하고, 완료 플랜 무덤은 아무도 읽지 않으면서 낡은 컨텍스트 주입 위험만 남깁니다. (플랜 문서는 git에 커밋되므로 정말 필요하면 히스토리에서 복구할 수 있습니다.)

플랜이 완료가 아니라 **폐기**되는 경우(방향 자체가 접힘)도 같은 플로우입니다 — 폐기가 구조·방향에 대한 결정을 내포하면 그 결정을 decisions에 남기고 삭제합니다.

## Active Plan Index

| Created | Updated | Title | Short Description | Reference |
|---|---|---|---|---|
| 2026-08-02 | 2026-08-18 | M5 — AX 어댑터 + auto 전략 | MVP 1단계(M1~M4) 완료 후의 1차 확장. AX 읽기 혼용이 축 — M3 수용 엣지 대부분이 여기서 해소된다. **PR 단위 7개로 분해됨**(A 읽기 기반 → B·C 혼용 → D AX 어댑터·auto → E 스키마), PR마다 worktree. **PR-A·B·C1·C2 + D1-설계 세션 + PR-D1a(#39) + PR-D1b([PR #41](https://github.com/pilyang/vim-action/pull/41), main `544005c`) 머지 완료 — D1 트랙 종료**(AX 쓰기 통로·단일 `.ax` 드라이버·`FocusedTextOffsets`·편집/삽입/Visual 하이브리드·`strategy` 파싱). **PR-D2 머지 완료**([#56](https://github.com/pilyang/vim-action/pull/56) main `d8d155c` + 문서 [#57](https://github.com/pilyang/vim-action/pull/57) main `1c62cb7`, 2026-08-18 — auto 프로브·거짓말 감지·force-text·기본값 auto + 세션 6 브라우저 클래스 규칙·숨은 입력 기하 신호). **다음은 PR-E**(스키마 확장·마감 — `per_element`, D2 이월: 브라우저 per-element 판정·value-슬라이스 폴백·킬스위치 #59) | [20260802_m5-ax-adapter.md](references/20260802_m5-ax-adapter.md) |
| 2026-08-18 | 2026-08-18 | Normal mode exit 키 허용목록 | **미착수 — 예정 기록용.** `Exit Normal mode on ⌘/⌥ shortcuts`를 전체 on/off에서 "기본은 전환 안 함 + 등록한 키 조합에서만 Normal → Insert"로 고도화. 등록은 키를 직접 눌러 캡처하는 UI | [20260818_normal-mode-exit-key-allowlist.md](references/20260818_normal-mode-exit-key-allowlist.md) |
| 2026-08-18 | 2026-08-18 | `Y` 동작 지원 | **미착수 — 예정 기록용.** 현재 미지원인 `Y` 키 동작 추가 | [20260818_support-uppercase-y.md](references/20260818_support-uppercase-y.md) |
| 2026-08-18 | 2026-08-18 | `s` / `S` 동작 지원 | **미착수 — 예정 기록용.** 현재 미지원인 `s`, `S` 키 동작 추가 | [20260818_support-s-substitute.md](references/20260818_support-s-substitute.md) |
| 2026-08-18 | 2026-08-18 | 업데이트 릴리스 노트 노출 | **미착수 — 예정 기록용.** 신규 버전 유무만 알리는 지금에서 나아가, 그 버전의 변경사항 목록을 업데이트 전에 볼 수 있게 (Sparkle appcast에 릴리스 노트 배선) | [20260818_update-release-notes.md](references/20260818_update-release-notes.md) |