> ## Documentation Index
> Fetch the complete documentation index at: https://docs.decepticon.red/llms.txt
> Use this file to discover all available pages before exploring further.

# 기여 가이드 (Contributing Guide)

> Decepticon에 기여하는 방법 — 코드, 스킬, 문서, 커뮤니티.

## 기여를 환영합니다

보안 연구자든, AI 엔지니어든, 더 나은 방어 체계를 만드는 것에 관심이 있는 분이든 — 여러분의 자리가 여기에 있습니다.

## 기여 방법

<CardGroup cols={2}>
  <Card title="코드" icon="code">
    에이전트 개선, 도구 통합, 인프라 강화, 버그 수정, 테스트 커버리지.
  </Card>

  <Card title="스킬" icon="book-open">
    스킬 라이브러리에 새로운 오펜시브 기법 추가 — MITRE ATT\&CK ID 태그, 에이전트 역할별 구성.
  </Card>

  <Card title="문서" icon="file-text">
    이 문서를 개선하고, 튜토리얼을 작성하고, 예제를 추가하거나, 새 언어로 번역하세요.
  </Card>

  <Card title="커뮤니티" icon="users">
    Discord에서 질문에 답하고, 인게이지먼트 패턴을 공유하고, 버그를 보고하거나, 새로운 기능을 논의하세요.
  </Card>
</CardGroup>

## 기여 워크플로우

<Steps>
  <Step title="저장소 포크">
    [PurpleAILAB/Decepticon](https://github.com/PurpleAILAB/Decepticon)을 여러분의 GitHub 계정으로 포크합니다.
  </Step>

  <Step title="기능 브랜치 생성">
    `main`에서 설명적인 이름으로 브랜치를 생성합니다:

    ```bash theme={null}
    git checkout -b feature/add-kerberoasting-skill
    ```
  </Step>

  <Step title="개발">
    [개발자 설정](/ko/contributing/developer-setup)을 사용하여 변경 사항을 작성합니다. 테스트를 실행합니다:

    ```bash theme={null}
    make test
    make lint
    ```
  </Step>

  <Step title="Conventional Commits로 커밋">
    Decepticon은 [Conventional Commits](https://www.conventionalcommits.org/) 형식을 따릅니다: `type(scope): subject`. 일반적인 타입: `feat`, `fix`, `docs`, `refactor`, `test`, `chore`. 본문에서 *무엇*이 아닌 *왜*를 설명하세요.

    ```text theme={null}
    feat(agents): add Cloud Hunter skill for AWS metadata abuse
    fix(opplan): resolve dependency cycle in objective_expand
    docs(features): document the offensive vaccine pipeline
    ```
  </Step>

  <Step title="풀 리퀘스트 열기">
    브랜치를 푸시하고 `main`에 대한 PR을 엽니다. 변경 사항이 무엇이고 왜 필요한지 설명합니다.
  </Step>
</Steps>

## 스킬 기여

스킬 라이브러리에 새로운 스킬을 추가하는 것은 가장 가치 있는 기여 중 하나입니다. 각 스킬은 다음을 포함해야 합니다:

* **프론트매터** — 이름, 설명, MITRE ATT\&CK 기법 ID, 필요 도구
* **내용** — 단계별 기법 실행, 명령어 예시, 예상 출력
* **탐지 노트** — 방어자가 이 기법을 탐지할 수 있는 방법 (방어 진화 비전에 기여)
* **사전 요구사항** — 필요한 접근 권한 또는 조건

## 코드 스타일

* 코드베이스의 기존 패턴을 따르세요
* 제출 전 `make lint`를 실행하세요
* 새로운 기능에 대한 테스트를 포함하세요
* 자명하지 않은 설계 결정은 주석으로 문서화하세요

## 커뮤니티

<CardGroup cols={3}>
  <Card title="Discord" icon="message-circle" href="https://discord.gg/TZUYsZgrRG">
    질문하고, 기법을 공유하고, 팀과 소통하세요.
  </Card>

  <Card title="GitHub Issues" icon="circle-dot" href="https://github.com/PurpleAILAB/Decepticon/issues">
    버그 보고, 기능 요청, 로드맵 추적.
  </Card>

  <Card title="GitHub Discussions" icon="messages-square" href="https://github.com/PurpleAILAB/Decepticon/discussions">
    아키텍처, 전략, 아이디어에 대한 심도 있는 대화.
  </Card>
</CardGroup>

## 라이선스

Decepticon은 [Apache-2.0](https://github.com/PurpleAILAB/Decepticon/blob/main/LICENSE) 라이선스 하에 배포됩니다. 기여함으로써 여러분의 기여가 동일한 조건으로 라이선스됨에 동의합니다.