Community생산성 & 협업github.com

Lujker/road-map-journal

프로젝트 로드맵, 개발 계획, 작업 대기열, 작업 일지, 항목 상태를 관리합니다. 다음 작업 확인, 계획된 작업 재개, 결정 기록, 항목 업데이트, 증거 기반 상태 조정에 사용합니다. 프로젝트 고유의 규칙을 따릅니다.

road-map-journal란 무엇인가요?

이 스킬은 AI 에이전트가 프로젝트의 로드맵, 개발 계획, 작업 일지, 항목 상태를 유지보수하고 추적 가능한 결정 기록을 관리할 수 있도록 설계되었습니다. 사용자의 지시와 프로젝트 규칙을 따르며, 새로운 형식을 강제하지 않고 기존의 이름, 식별자, 언어, 링크, 커밋되지 않은 변경 사항, 관련 없는 콘텐츠를 보존합니다. Claude Code, Cursor, Codex 등 다양한 AI 에이전트 플랫폼에서 사용할 수 있으며, '읽기 전용', '초기화', '채택', '재개', '업데이트'의 다섯 가지 모드를 지원하여 상황에 맞게 동작합니다. 이 스킬은 증거 기반 상태 확인, 결정 기록 및 조정, 버전 관리 상태 점검, 다중 저장소 동기화, 장기 실행 작업 관리 등의 기능을 제공하여 복잡한 프로젝트에서도 일관성과 추적성을 유지하도록 돕습니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Lujker/road-map-journal/tree/HEAD/skills/road-map-journal

Installed? Explore more 생산성 & 협업 skills: steipete/gemini, steipete/gh-issues, steipete/skill-creator · View all 6 →

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

로드맵 및 작업 일지

새로운 형식을 강요하지 않으면서 유용한 현재 계획과 추적 가능한 결정 기록을 유지합니다. 사용자의 지시와 프로젝트의 규칙을 따릅니다. 기존 이름, 식별자, 언어, 링크, 커밋되지 않은 변경 사항, 관련 없는 콘텐츠를 보존합니다. 새 계획의 경우 사용자가 지정하거나 합리적으로 암시하는 언어를 사용하며, 불명확할 경우 질문합니다. 언어를 강요하지 마십시오.

사용 시기

로드맵, 개발 계획, 대기열, 작업 일지, 항목 상태 또는 계획된 작업 계속에 대한 요청에 사용합니다. 예시로는 "로드맵에서 다음은 무엇인가요?", "합의된 항목을 계속하세요", «дорожная карта», «план разработки», «дневник разработки», «что дальше по плану?» 및 «продолжай разработку по плану» 등이 있습니다. 컨텍스트에서 요청된 범위를 결정합니다. 상태 질문은 읽기 전용입니다.

먼저 탐색

프로젝트 루트를 식별하고 해당 지침을 읽습니다. 기존 로드맵, 대기열, 항목 노트 및 인계 문서를 찾습니다. 이름과 위치는 다양합니다. 관련 항목, 승인 기준, 현재 대기열 및 연결된 노트를 읽습니다. 관련 구현, 가능한 경우 버전 관리 상태, 요청이 현재 상태 평가를 필요로 할 때 증거를 확인합니다. Git, 특정 디렉토리 레이아웃 또는 특정 상태 어휘를 가정하지 마십시오. 여러 저장소의 경우 기존 링크를 따르며, 접근할 수 없는 권위 있는 위치에 대해 물어보고 대체 위치를 새로 만들지 마십시오.

요청에 암시된 모드를 선택합니다:

  • 읽기 전용: 관련 문서와 증거를 바탕으로 답변합니다. 기록된 주장과 독립적으로 확인된 사실을 구분하며, 편집하지 않습니다.
  • 초기화: 계획이 없으면 소유자가 원하는 작업 방식을 논의하고 적절한 구조, 위치, 범위, 초기 항목 및 순서를 제안합니다. 관련된 트랙, 에이전트 역할 및 초기 카드를 포함합니다. 심층 탐색을 위해 사용 가능하고 적절한 경우 grill-me를 사용하고, 없으면 설치를 제안하지만 허가 없이 설치하거나 워크플로를 차단하지 마십시오. 그렇지 않으면 직접 간결한 구조화된 토론을 진행하고 해결되지 않은 선택에 대한 권장 사항을 제공합니다. 파일을 만들기 전에 정보에 입각한 사용자 동의를 얻습니다. 우선 순위나 약속을 임의로 정하지 마십시오.
  • 채택: 계획 자료가 이미 존재하면 그대로 사용합니다. 소유자가 실질적인 검토를 요청하면 초기화와 동일한 선택적 구조화된 토론을 해결되지 않은 부분에 맞게 조정하여 사용합니다. 제안된 새 파일, 마이그레이션 또는 실질적인 재작성을 설명하고 먼저 정보에 입각한 동의를 얻습니다. 묵시적으로 병렬 진실 공급원을 만들지 마십시오.
  • 재개: 최신 지시, 활성 대기열, 항목 노트 및 관련 현재 상태를 읽습니다. 모순되거나 오래된 지시를 현재 증거와 사용자의 최신 결정에 대해 해결합니다. 중요한 충돌이 남아 있으면 질문합니다. 항목이 이미 선택되거나 위임되지 않은 경우 구현 전에 하나에 동의합니다. 저장된 계획이나 문서화 승인은 작업 시작을 허가하지 않습니다.
  • 업데이트: 요청된 범위 내에서 기존 기록을 변경합니다. 항목의 상태, 남은 작업 및 영향을 받는 대기열 항목을 일관되게 유지합니다. 기록과 관련 없는 순서를 보존합니다. 새 파일이나 실질적인 재작성의 경우 제안된 변경 사항을 설명하고 먼저 정보에 입각한 동의를 얻습니다. 하나의 항목으로 제한된 요청은 나머지 계획을 구현하거나 재작성하는 것을 허가하지 않습니다.

기록 및 조정

프로젝트의 정해진 방식을 사용합니다. 일반적으로 로드맵은 항목과 현재 순서를 요약하고, 일지는 결정, 발견, 증거 및 기록을 보관합니다. 긴 세부 사항은 연결하고 복제하지 않습니다. 식별자를 안정적으로 유지합니다. 결정이나 취소된 작업을 묵시적으로 삭제하지 마십시오. 관련된 경우 이유와 함께 '대체됨' 또는 '취소됨'으로 표시합니다.

결정, 일시 중지 또는 순서가 변경되면 승인된 범위 내에서 영향을 받는 현재 요약과 다음 단계 지침을 업데이트하고 이전 지침을 '역사적'으로 표시합니다. 일시 중지되거나 연기된 계획은 계속하라는 활성 지침으로 보여서는 안 됩니다. 단지 노트가 추가되었다고 관련 없는 작업의 우선 순위를 다시 정하지 마십시오. 필요한 수정이 승인된 범위를 벗어나면 편집을 확장하는 대신 사용자에게 알립니다.

소유자가 더 넓은 범위를 승인하지 않는 한 한 번에 하나의 항목 작업을 수행하고 자동으로 다음 항목을 시작하지 마십시오. 완료된 하위 단계는 상위 항목을 완료하지 않습니다. 나머지를 기록합니다. 작업 모드를 권한 및 예산과 분리합니다. 계속 승인은 프로덕션 작업 또는 외부 쓰기에 대한 전면적 허가가 아닙니다. 기록된 완료, 사용자 승인 대기 및 완전히 승인된 작업을 구분합니다. 인계, 결정, 검증된 결과 및 차단 항목에서 무엇이 남았는지, 어떻게 재개할지 포함하여 간결한 체크포인트를 유지합니다. 재시도하기 전에 불확실한 진행 중인 작업을 확인합니다. 공유 체크아웃에서 여러 파일 업데이트 전에 쓰기 직전에 버전 관리 상태와 더티 경로를 확인하고, 새로 읽은 콘텐츠에 대해 좁은 편집을 적용하고, 관련 없는 작업을 보존하고, 승인되지 않는 한 커밋하거나 게시하지 않고 범위 내 변경 사항을 확인합니다.

여러 항목, 에이전트 또는 세션에 걸친 작업, 예산이 있거나 소유자가 트랙 또는 연속 모드를 승인한 경우 먼저 장기 실행 작업을 읽습니다.

상태 및 증거

프로젝트의 상태 어휘를 사용합니다. 없으면 OPEN, IN PROGRESS, BLOCKED, PARTIAL, DONE을 제안하고 프로젝트에 동의된 의미를 부여합니다. 승인 기준과 실제 증거에 따라 상태를 기록하며, 의도나 대리인의 입증되지 않은 주장이 아닙니다. PARTIAL의 경우 무엇이 남았는지와 차단 항목을 명시합니다. 영향을 받는 상태 참조를 일관되게 유지합니다.

실제로 수행된 검사, 그 결과 및 범위, 그리고 관련된 경우 수행자를 기록합니다. 증거는 역사적이거나 다른 실행자로부터 온 것일 수 있습니다. 출처와 적용 가능성을 표시하고 재실행되었음을 암시하지 마십시오. 이후 변경으로 검사가 무효화되면 적절한 확인을 식별하거나 수행합니다. 명령, 결과, 테스트 수, 승인 또는 사용자 수용을 절대 만들어 내지 마십시오. 자동화된 테스트, 릴리스된 코드, 실시간 운영은 서로 다른 주장입니다. 구현이나 테스트에서 실시간 수용을 추론하지 마십시오. 요구된 수용이 발생하지 않은 경우 PARTIAL 또는 프로젝트의 동등한 상태를 유지하고 누락된 환경 또는 승인을 명시합니다.

승인된 편집 후 영향을 받은 상태, 대기열, 링크 및 증거와 범위와의 일관성을 확인합니다. 변경 사항, 실제로 수행된 검사 및 해결되지 않은 항목을 보고합니다. 수행되지 않은 검증을 주장하지 마십시오.

참조

  • 일반 템플릿 — 프로젝트에 맞게 조정된 선택적 시작점.
  • 시나리오 — 모드 및 범위 선택의 간결한 예시.
  • 장기 실행 작업 — 트랙, 체크포인트, 일시 중지 및 중지, 수용, 예산, 공유 체크아웃.
  • 다중 저장소 동기화 — 작업을 보존하고 체크아웃 간에 기록된 상태, Git 상태 및 라이브 상태를 구분합니다.

관련 스킬