alexpialetski/doccraft

doccraft은(는) 무엇을 하나요?

Claude Code 및 Cursor를 위한 문서화 및 프로젝트 스토리 스킬 (ADR, story, queue-audit, session-wrap), OpenSpec 기반.

개요

doccraft는 AI 에이전트가 소프트웨어 개발 과정에서 발생하는 결정, 작업, 세션 활동을 체계적으로 기록하고 관리할 수 있도록 지원합니다. 주요 기능은 다음과 같습니다:

• ADR (Architecture Decision Record): 아키텍처 관련 결정 사항을 기록하고 추적합니다.
• Story: 프로젝트의 스토리(작업 단위)를 생성하고 관리합니다.
• Queue-audit: 작업 큐의 상태를 검토하고 정리합니다.
• Session-wrap: 현재 세션의 활동을 요약하고 종료합니다.

사용 방법

이 스킬은 Claude Code 또는 Cursor의 명령어로 호출할 수 있습니다. 각 명령어는 markdown 형식의 문서를 생성하거나 업데이트합니다.

ADR (Architecture Decision Record)

# 새로운 ADR 생성
doccraft adr "마이크로서비스 통신 방식으로 gRPC 채택"

Story

# 새로운 스토리 생성
doccraft story "사용자 인증 모듈 구현"

Queue-audit

# 작업 큐 감사 실행
doccraft queue-audit

Session-wrap

# 세션 종료 및 요약 생성
doccraft session-wrap

설정

스킬은 OpenSpec 규격을 따르며, 다음 환경 변수를 통해 구성할 수 있습니다:

• OPENSPEC_DIR: OpenSpec 문서가 저장된 디렉토리 경로 (기본값: ./docs/openspec)
• DOCCRAFT_DRY_RUN: 실제 파일 쓰기 없이 명령어 시뮬레이션 (기본값: false)

파일 구조

생성된 문서는 일반적으로 docs/openspec/ 디렉토리 아래에 저장됩니다:

docs/
└── openspec/
    ├── adrs/
    │   └── 001-마이크로서비스-통신-방식으로-grpc-채택.md
    ├── stories/
    │   └── 사용자-인증-모듈-구현.md
    └── sessions/
        └── 2025-03-20-세션-요약.md

참고 사항

• 모든 명령어는 비동기적으로 실행되며, 완료 시 메시지를 반환합니다.
• ADR에는 고유 번호가 자동 할당됩니다.
• 세션 wrap은 현재 작업 디렉토리의 .session 파일을 참조합니다.