Communitygithub.com

usereportly/decision-memory-skill

코딩 에이전트가 코드 내에 설계 의사 결정과 중요한 제약 조건을 기록하는 '의사 결정 메모리(decision-memory)' 주석을 읽고, 쓰고, 보존하도록 가르치는 스킬입니다.

decision-memory-skill란 무엇인가요?

이 스킬은 AI 코딩 에이전트가 코드 전반에 걸쳐 의사 결정 메모리(decision-memory) 주석을 체계적으로 작성하고 유지 관리할 수 있도록 합니다. 개발자가 특정 설계를 선택한 이유, 피해야 할 위험, 또는 향후 수정 시 절대 깨뜨리면 안 되는 제약 조건을 코드 내에 명확하게 기록할 수 있게 해줍니다. 주요 기능으로는 기존 의사 결정 메모리 주석 읽기, 새로운 결정 사항 기록, 그리고 관련 코드 변경 시 해당 주석 업데이트가 포함됩니다. 이 스킬은 다양한 AI 코딩 에이전트 플랫폼(Claude Code, Cursor 등)과 호환되며, 시간이 지나도 코드 설계의 의도가 유지되고 중요한 결정이 실수로 덮어쓰여지지 않도록 보장합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add usereportly/decision-memory-skill

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

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

문서

decision-memory-skill은(는) 무엇을 하나요?

코딩 에이전트가 코드 내에 설계 의사 결정과 중요한 제약 조건을 기록하는 '의사 결정 메모리(decision-memory)' 주석을 읽고, 쓰고, 보존하도록 가르치는 스킬입니다.

사용 방법

에이전트가 이 스킬을 활성화하면 다음 작업을 수행할 수 있습니다:

  1. 의사 결정 메모리 주석 읽기: 코드 내 // DECISION:, /* DECISION: */, # DECISION: 등의 태그가 붙은 주석을 인식하고 그 내용을 이해합니다.
  2. 의사 결정 메모리 주석 쓰기: 새로운 설계 결정이나 중요한 제약 조건을 발견할 때 적절한 형식으로 주석을 추가합니다.
  3. 의사 결정 메모리 주석 보존: 코드 수정 시 기존 의사 결정 메모리 주석을 실수로 삭제하거나 변경하지 않도록 주의합니다.

지원 플랫폼

  • Claude Code
  • Cursor
  • Codex
  • 기타 AI 코딩 에이전트

예시

// DECISION: 이 컴포넌트는 상태 관리를 위해 React Context를 사용합니다.
// 이유: prop drilling을 방지하고 전역 상태를 효율적으로 공유하기 위함입니다.
// 주의: 이 컨텍스트를 제거하면 모든 하위 컴포넌트가 리팩토링되어야 합니다.
const AppContext = React.createContext();
# DECISION: 데이터베이스 연결은 Singleton 패턴을 사용합니다.
# 이유: 여러 연결을 생성하여 리소스가 낭비되는 것을 방지합니다.
# 경고: 이 패턴을 변경하면 모든 데이터베이스 호출을 수정해야 합니다.
class DatabaseConnection:
    _instance = None

스킬 규칙

  • 의사 결정 메모리 주석은 항상 DECISION: 태그로 시작합니다.
  • 각 결정에는 이유와 잠재적 영향에 대한 설명이 포함되어야 합니다.
  • 코드 수정 시 관련 의사 결정 메모리 주석을 검토하고 업데이트해야 합니다.
  • 불필요한 의사 결정 메모리 주석은 제거하거나 통합할 수 있습니다.

관련 스킬