@matfia/codes

미리 정의된 코드 파일 세트를 현재 프로젝트에 생성해주는 CLI입니다.

사용법

npx @matfia/codes <세트명>

예시:

npx @matfia/codes lg-cns-2

실행하면 세트에 정의된 파일들이 명령을 실행한 경로 기준으로 생성됩니다. 같은 경로에 이미 파일이 있으면 절대 덮어쓰지 않고, 생성되지 않았음을 stdout으로 알린 뒤 건너뜁니다.

생성: .claude/skills/enhance-harness/SKILL.md
건너뜀: .claude/skills/review/SKILL.md — 이미 파일이 존재하여 생성하지 않았습니다.
생성: .claude/skills/setup-harness/SKILL.md

완료 (lg-cns-2): 생성 2개, 건너뜀 1개

제공 세트

lg-cns-2

Claude 하네스 범용 스킬 3종과 tasks/ 스캐폴드를 생성합니다.

.claude/skills/setup-harness/SKILL.md
.claude/skills/review/SKILL.md
.claude/skills/enhance-harness/SKILL.md
tasks/index.json           # 태스크 목록 (00-sample-task 항목 포함)
tasks/00-sample-task/      # 산출물 형식을 보여주는 샘플 태스크
  prompt.md                #   티켓 프롬프트 원문
  clarify.md               #   Clarify 단계 기록
  context-gather.md        #   Context Gather 단계 기록
  plan.md                  #   Plan 단계 기록
  evaluate.md              #   Evaluate 단계 기록
  code-diff.md             #   git diff 캡처
  pr-body.md               #   PR 본문 (핵심 전환 / 결과·검증 요약)

eugene-2

TDD, TDD 셋업, 커밋, UI 디자인 스킬 4종을 생성합니다.

.claude/skills/tdd/SKILL.md
.claude/skills/tdd/mocking.md
.claude/skills/tdd/tests.md
.claude/skills/tdd-setup/SKILL.md
.claude/skills/commit/SKILL.md
.claude/skills/ui-design/SKILL.md

basic

요구사항 정리부터 구현·커밋까지 이어지는 범용 스킬 8종을 생성합니다. scaffold로 시작해 to-prd → to-spec → implement 순으로 진행하는 흐름입니다.

.claude/skills/scaffold/SKILL.md     # 요구사항을 받아 PRD·스펙 작성까지 진행하는 진입점
.claude/skills/to-prd/SKILL.md       # 합의된 요구사항을 docs/PRD.md로 합성
.claude/skills/to-spec/SKILL.md      # 대화 내용을 docs/specs/<name>.md 스펙으로 합성
.claude/skills/grilling/SKILL.md     # 계획·설계를 인터뷰로 압박 검증
.claude/skills/implement/SKILL.md    # 스펙 단위 구현 후 /review 실행
.claude/skills/tdd/SKILL.md          # TDD 레드-그린 루프 레퍼런스
.claude/skills/tdd/mocking.md
.claude/skills/tdd/tests.md
.claude/skills/tdd-setup/SKILL.md    # 테스트 환경 셋업 (tdd의 선행 조건)
.claude/skills/commit/SKILL.md       # 프로젝트 컨벤션에 맞춘 커밋

devmento-loop

루프 엔지니어링 실습용 findings/cycles 세트를 생성합니다. docs/findings/의 미해결 finding들을 cycle 문서로 묶어 자율 루프 에이전트에게 맡기는 구조입니다.

docs/findings/2026-07-17T1500-error-response-shape.md         # P1 — API 에러 shape 3종 혼재
docs/findings/2026-07-17T1501-string-error-branching.md       # P1 — 문자열 기반 에러 분기
docs/findings/2026-07-17T1502-silent-catch-ingest.md          # P1 — ingestion 무음 catch
docs/findings/2026-07-17T1503-api-client-parse-duplication.md # P2 — 에러 파싱 3중 복제
docs/findings/2026-07-17T1504-triple-auth-architecture.md     # P1 — 설계 결정 필요 (blocker 실습용)
cycles/AGENTS.md                                              # cycle 문서 프로토콜 (간소판)
prompts/cycle-generate.md                                     # cycle 문서 생성 프롬프트

동작 방식

• templates/<세트명>/ 아래의 디렉토리 구조가 그대로 호출 경로에 복사됩니다.
• 이미 존재하는 파일은 덮어쓰지 않습니다 (건너뜀 + stdout 안내, 종료 코드는 0).
• 알 수 없는 세트명을 주면 사용 가능한 세트 목록과 함께 종료 코드 1로 종료합니다.
• 인자 없이 실행하면 사용법과 세트 목록을 출력합니다.

새 세트 추가하기

1. templates/<새-세트명>/ 폴더를 만들고, 생성되길 원하는 상대 경로 그대로 파일을 배치합니다.
2. 끝입니다. CLI가 templates/ 하위 폴더를 자동으로 세트로 인식합니다.

주의: npm은 패키징 시 .gitignore, .npmignore, .DS_Store 같은 일부 파일명을 제외하거나 특별 취급합니다. 이런 이름의 파일을 세트에 넣어야 한다면 npm pack --dry-run으로 tarball에 포함되는지 반드시 확인하세요.

개발

Node.js 18 이상이 필요합니다. 의존성이 없으므로 npm install 없이 바로 테스트할 수 있습니다.

npm test

배포

npm login    # @matfia 스코프 권한이 있는 계정으로
npm publish  # publishConfig.access=public 설정이 이미 되어 있음

배포 전 prepublishOnly 훅이 자동으로 테스트를 실행합니다.