super-board

<div align="center"> <img src="https://raw.githubusercontent.com/EricTechPro/super-board/HEAD/docs/assets/logo.svg" width="88" height="88" alt="super-board kanban logo"> <h1>super-board</h1> 작업을 추가하고, 자리를 비우고, 증거와 함께 병합된 PR(Pull Request)을 받으세요. 8가지 스킬 (직접 입력 5개, 보드가 실행하는 것 3개) · 9가지 명령어 · 6가지 가드 후크 <img alt="Version" src="https://img.shields.io/badge/version-3.1.2-1f883d?style=flat-square"> <img alt="Host" src="https://img.shields.io/badge/Claude%20Code-skills-d97757?style=flat-square"> <img alt="License" src="https://img.shields.io/badge/license-MIT-0969da?style=flat-square"> <a href="https://erictechpro.github.io/super-board/">🌐 라이브 사이트: erictechpro.github.io/super-board</a> <a href="#install">설치(Install)</a> · <a href="#quick-start">빠른 시작(Quick start)</a> · <a href="#how-it-works">작동 방식(How it works)</a> · <a href="#skills">스킬(Skills)</a> · <a href="#commands">명령어(Commands)</a> · <a href="#guards--hooks">가드(Guards)</a> </div <a href="https://erictechpro.github.io/super-board/skill-map/"><img src="https://raw.githubusercontent.com/EricTechPro/super-board/HEAD/docs/assets/skill-map.png" alt="The super-board skill map: open the interactive version" width="100%"></a> 스킬 맵(The skill map). 라이브 버전을 클릭하세요: 확대, 이동, 모든 노드 열기.

설치 (Install)

프로젝트 폴더에서:

curl -fsSL https://raw.githubusercontent.com/EricTechPro/super-board/main/get.sh | bash

또는 Claude Code 플러그인으로:

/plugin marketplace add EricTechPro/super-board
/plugin install super-board@super-board

[!NOTE]
이 플러그인은 스킬만 제공합니다. /super-board:super-board onboard을 실행하면 가드 후크, 스크립트 및 워크플로우가 추가됩니다. Claude Code, gh, jq, bash 3.2 이상, Python 3.9 이상이 필요하며, 설치 프로그램에서 확인합니다.

선택적 실행 후 학습(Optional post-run learning)은 이미 설치된 calibrate 스킬을 검증된 선택 작업이 완료된 후에 위임할 수 있습니다. 이는 명시적으로 허가된 기존의 표준 스킬 파일에만 적용되며, 이 패키지는 개인적인 스킬을 포함하지 않습니다. 실행 후 보정(post-run calibration)를 참조하세요.

빠른 시작 (Quick start)

1. 설치 (Install)

curl -fsSL https://raw.githubusercontent.com/EricTechPro/super-board/main/get.sh | bash

2. 온보딩 (Onboard)

/super-board onboard

체크(Checks) · GitHub · 보드(Board) · 브랜치(Branch) · AGENTS.md · 정책(Policies) · 버그 소스(Bug sources) · 검토(Review). <kbd>Enter</kbd>를 누르면 추천 답변이 선택됩니다.

3. 실행 (Run)

/super-board run my-app

Ready에 카드를 추가하세요. 보드가 스스로 작동합니다.

작동 방식 (How it works)

스킬 (Skills)

8개의 스킬 (직접 입력 5개, 보드가 실행하는 것 3개). Matt Pocock의 스킬, ponytail, impeccable 및 humanizer를 사용합니다.

사용자가 직접 입력 — 5개의 스킬

스킬	기능
`/super-board`	오케스트레이터(Orchestrator): 웨이브를 계획하고, 빌드 → QA → 검토 과정을 실행하며, 녹색 신호일 때 병합합니다.
...
보드가 실행하는 — 3개의 레인 (lanes)

스킬	기능
`/super-build`	빌더 레인(Builder lane): 작업 트리(worktree), 가장 작은 안전한 변경 사항, 테스트, 초안 PR을 생성합니다.
...	<!-- skills:end -->

각 이름은 해당 스킬의 README로 연결됩니다. 스킬을 추가하려면 SKILL.md와 README.md를 작성하고, skills/families.json에 한 줄을 추가하면 이 표가 자동으로 업데이트됩니다.

명령어 (Commands)

⚠️ [IMG:N] 형식 토큰은 이미지 placeholder 입니다. 번역하지 말고 원래 위치에 그대로 유지하세요.

/super-board onboard          # 8단계 설정, 재개
/super-board lint             # 모호한 AC?
/super-board status           # 읽기 전용 스냅샷
...

플래그: run --low|--high · run --codex[=<모델>] · super-collect --since 30d

가드 및 후크 (Guards & hooks)

설치 시 자동으로 실행됩니다. Python 표준 라이브러리, JSON 입력, JSON 출력.


guard-worktree-path	`.claude/worktrees/` 외부에서 `git worktree add`를 차단합니다.
...

모델 (Models)

저렴한 라우터가 각 카드를 쉬움(easy), 보통(medium), 어려움(hard) 순으로 판별하며, 실행 플래그는 각 등급에 맞는 모델을 선택합니다. --codex를 사용하면 모든 레인이 Claude 대신 Codex GPT 모델에서 실행됩니다.

명령어	라우터	쉬운 카드 (Easy card)	보통 카드 (Medium card)	어려운 카드 (Hard card)
`/super-board run`	Haiku 4.5	Sonnet 5.5	Opus 5.5	세션 모델 (session model)
...
`/super-board run --codex=<모델>`은 각 카드에 하나의 모델을 고정하고 라우터를 건너뜁니다.

Codex 내부에서 실행하려면, 일반 /super-board run이 자체적으로 Codex 계층으로 전환합니다. Codex에는 /super-board 명령어가 없습니다: 이는 .agents/skills/ (심볼릭 링크 추적)에서 스킬을 찾기 때문입니다. 따라서 여기에 .claude/skills/super-board를 연결하고 $super-board run을 입력하세요.

작성 표준 (Writing standard)

커밋, 티켓, PR 본문 및 댓글은 패키지 내와 설치되는 모든 프로젝트에서 하나의 작성 표준을 따릅니다.

<details> <summary>2.x에서 업그레이드하는 방법</summary>

설치 라인을 다시 실행합니다.
/super-board onboard를 실행합니다. 1단계가 사용자님을 위해 업그레이드하고 백업본을 유지합니다.
먼저 복사된 보드에서 board-migrate --dry-run을 시도해 보세요.

전체 노트

</details>

기여 (Credits)

<a href="https://erictechpro.github.io/super-board/">실제 사이트</a> · <a href="https://erictechpro.github.io/super-board/skill-map/">스킬 맵</a> · <a href="https://erictechpro.github.io/super-board/writing-standard/">작문 표준</a> · <a href="https://erictechpro.github.io/super-board/onboarding/">설정 시뮬레이터</a> · <a href="https://erictechpro.github.io/super-board/impeccable/">Impeccable 맵</a> · <a href="https://erictechpro.github.io/super-board/pstack/">pstack 맵</a> · <a href="RELEASE-NOTES.md">릴리스 노트</a> · <a href="RELEASING.md">릴리스 확인</a> · <a href="https://youtu.be/nX_bGyIOFM4">YouTube 워크스루</a> Eric Tech 제작

Worker 스킬 가용성

설정(Setup) 및 배포(dispatch)는 실제 Claude 또는 Codex 호스트를 위한 실질적이고 비어있지 않은 SKILL.md 파일을 해결합니다. 필수 스킬 누락 시 클레임이나 워커가 시작되기 전에 중단되며, lockfiles나 임의의 플러그인 캐시는 계산되지 않습니다. scripts/super-board-skills-ready.py에 있는 공유 레지스트리가 레이널 의존성(lane dependencies), 오버라이드(overrides) 및 두 개의 선언된 포니테일 폴백(ponytail fallbacks)을 소유합니다. 설정의 전체 헬퍼 유니온은 선택된 카드가 실행 가능할 때 빨간색일 수 있습니다. 읽기 전용 확인(Read-only checks)은 절대 설치하지 않으며, 명시적인 온보드 복구(onboard repair)는 설치 후 파일을 재확인합니다.

CLI는 --home <fixture-home> 및 --catalog <active-skills.json>을 허용합니다. 로더(Launchers)는 SUPER_BOARD_SKILLS_HOME과 SUPER_BOARD_SKILLS_CATALOG를 통해 동일한 인벤토리를 사용하며, 어느 쪽도 실제 호스트를 변경하지 않습니다. 카탈로그 형태: {"host":"codex","skills":[{"name":"vendor:skill","path":"/exact/SKILL.md","enabled":true,"scope":"project","project_root":"/exact/project"}]}. 사용자 항목은 `scope: