grzadr/agent-skills

크래프트 청사진 스킬

학습 프로젝트를 설계하거나 초기화하라는 요청을 받으면, 작업 공간 루트에 구조화된 ROADMAP.md 파일을 생성하세요. 어떤 애플리케이션이나 구현 코드도 작성하지 마세요.

핵심 설계 원칙

1. 마이크로 스프린트 (도파민 기반 페이싱): 모든 단계는 집중 코딩 기준 15~30분 내에 완료할 수 있어야 합니다. 기능이 더 오래 걸리면 하위 단계로 분할하세요.
2. 수평 계층보다 수직 슬라이스: "모든 데이터 모델 작성" 단계 다음에 "모든 데이터베이스 쿼리 작성" 단계를 만들지 마세요. 대신 1단계 1.1단계에서는 단일 입력을 받아 즉시 보이고 테스트 가능한 출력을 생성해야 합니다.
3. 언어 중립성: 언어별 상용구가 아닌 관찰 가능한 동작(입력, 출력, 상태 변경, 종료 코드, 반환 값 또는 API 응답)을 중심으로 명세를 구성하세요.

프로토콜

1. 최소 컨텍스트 명확화 (누락된 경우에만)

사용자가 다음을 지정하지 않은 경우:

• 대상 프로젝트 (예: ToDo 앱, BitTorrent 클라이언트, 키-값 저장소, HTTP 서버)
• 대상 언어 / 런타임 (예: Go, Rust, Python, TypeScript, C, Zig)
• 인터페이스 유형 (예: CLI, HTTP API, TUI, 라이브러리)

ROADMAP.md를 생성하기 전에 최대 2개의 간단한 질문으로 이를 확정하세요.

2. ROADMAP.md 생성

다음 구조를 사용하여 ROADMAP.md를 만드세요:

• 프로젝트 개요: 무엇을 구축할지, 학습자가 연습할 핵심 언어 개념(예: 메모리 관리, 동시성, 구조체/인터페이스, 비동기 I/O, 오류 처리)에 대한 2문장 요약.
• 진행 상황 추적기:
  • 현재 단계 및 단계 포인터 (예: Active Step: 1단계 - 1.1단계)
  • 상태 범례: [ ] 잠김/대기 중, [~] 진행 중, [x] 통과
• 단계 (총 4~6단계):
  • 1단계: 심장박동 (워킹 스켈레톤): 가장 단순한 종단 간 명령어 또는 함수를 작동시키기.
  • 2단계: 핵심 상태 및 정상 경로: 기본 데이터 구조와 핵심 작업을 메모리에서 구현.
  • 3단계: 지속성 / I/O 및 경계 사례: 상태 저장, 복잡한 입력 파싱, 우아한 오류 처리.
  • 4단계: 고급 언어 기능: 동시성, 스트리밍, 미들웨어 또는 성능 최적화 도입.
• 단계별 작업 (단계당 2~4개 작업): 각 작업마다 다음을 포함:
  • 목표: 사용자가 무엇을 구축할지 한 문장으로 설명.
  • 연습할 언어 개념: 이 작업에 필요한 2~3개의 특정 언어 기능.
  • 명세 및 수용 기준: craft-gatekeeper가 자동 테스트를 작성하는 데 사용할 구체적인 블랙박스 테스트 가능 동작(정확한 함수 시그니처, CLI 인자, 예상 stdout/stderr 또는 HTTP 상태/페이로드).

가드레일

• 이 스킬을 실행할 때 절대 소스 코드 파일이나 솔루션 스니펫을 생성하지 마세요.
• 응답을 마칠 때 사용자에게 1단계, 1.1단계를 가리키며 /craft-bootstrap (빈 프로젝트 스켈레톤 설정) 또는 /craft-gatekeeper (첫 번째 실패 테스트 생성)를 실행하도록 제안하세요.