plugins: Instructions file for Claude Code

CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

Repository Overview

Claude Code 플러그인 마켓플레이스 레포지토리. Skills, Commands, Agents, Hooks를 제공합니다.

• GitHub: roboco-io/plugins
• Marketplace 이름: roboco-plugins

Architecture

.claude-plugin/
└── marketplace.json              # Marketplace 정의 (필수)

plugins/
└── {category}/                   # development, security, workflow, documentation
    ├── .claude-plugin/
    │   └── plugin.json           # 플러그인 메타데이터
    ├── agents/                   # 에이전트 정의 (선택)
    ├── commands/                 # 커맨드 정의 (선택)
    └── skills/                   # 스킬 정의
        └── {skill-name}/
            ├── SKILL.md          # 스킬 지침 (YAML frontmatter + Markdown)
            └── references/       # Progressive disclosure용 참조 파일 (선택)

스킬 간 호출 관계

aws-well-architected 스킬은 오케스트레이터로서 6개 Pillar별 하위 스킬(aws-wa-*)을 호출하고 통합 리포트를 생성함. 이처럼 스킬이 다른 스킬을 호출하는 패턴이 존재하므로, 오케스트레이터 스킬 수정 시 하위 스킬의 인터페이스(입출력 형식)가 유지되는지 확인 필요.

기능 개발 워크플로우 (issues/)

큰 기능은 issues/{번호}-{slug}/ 디렉토리에서 SPEC → PLAN → TASKS 3단계로 진행됩니다.

• SPEC.md — 요구사항·동작 명세
• PLAN.md — 구현 계획·아키텍처 결정
• TASKS.md — 체크박스 작업 목록

신규 기능 작업 시 이 구조를 따르고, 기존 디렉토리(8-llm-wiki 등)를 참고하세요.

Plugin Development

새 플러그인 추가 시 필수 작업

1. plugins/{category}/.claude-plugin/plugin.json 생성
2. plugins/{category}/skills/{name}/SKILL.md 생성 (YAML frontmatter 포함)
3. .claude-plugin/marketplace.json의 plugins 배열에 추가
4. README.md의 플러그인 목록 업데이트 (아래 규칙 참조)

marketplace.json 스키마

{
  "name": "roboco-plugins",
  "owner": { "name": "roboco-io" },
  "plugins": [
    {
      "name": "category-name",
      "source": "./plugins/category-name",
      "category": "category",
      "skills": ["./skills/skill-name/SKILL.md"]
    }
  ]
}

주의사항:

• plugins 배열 항목은 문자열이 아닌 객체여야 함
• 로컬 플러그인의 source는 문자열 경로, 외부 플러그인의 source는 { "source": "npm"|"github", ... } 객체
• skills 배열의 경로는 플러그인 source 디렉토리 기준 상대 경로 (예: ./skills/skill-name/SKILL.md)