agent-company: Skill for Claude Code

/company-setup

프로젝트를 돌릴 수 있는 상태로 만든다.

핵심 원칙

당신이 직접 검사하지 마세요. 이 스킬의 존재 이유는 결정성입니다. 셸 스크립트가 항상 같은 순서로 같은 검사를 수행하고, 당신은 결과를 해석해 사용자에게 다음 행동을 안내합니다.

체크리스트를 모델이 매번 다르게 해석하면 "확인했습니다"가 실제로는 확인하지 않은 상태를 의미하게 됩니다.

순서

1. 템플릿을 정합니다 — 스크립트를 돌리기 전에.
2. 스크립트를 한 번 실행합니다.
3. GitHub 응원을 묻습니다 — 선택.

1. 템플릿 먼저 정하기

이 저장소는 코어 + 템플릿 구조입니다. 템플릿이 apps/ · packages/ · agents/ 를 루트에 펼치므로, 무엇을 만들 회사인지 정해야 셋업이 의미 있게 끝납니다.

bash scripts/template.sh current    # 이미 적용된 것이 있는지
bash scripts/template.sh list       # 고를 수 있는 것

current 결과	당신이 할 일
none 이 아님	묻지 마세요. 이미 정해졌습니다. --template 없이 그대로 실행합니다
none + 사용자가 무엇을 만들지 이미 말함	그에 맞는 id 를 --template 로 넘깁니다
none + 모름	AskUserQuestion 으로 물어봅니다 (아래)

none 이고 무엇을 만들지 모를 때 물어볼 것: "어떤 회사를 차릴까요?"

옵션은 list 출력에서 planned 를 뺀 것들 + "나중에 고르기". 각 옵션의 설명에는 매니페스트의 summary 를 그대로 쓰세요.

planned 상태 템플릿을 제안하지 마세요. 내용물이 없어서 apply 가 거부합니다.

임의로 고르지 마세요. 템플릿은 파일을 루트에 펼치고, 갈아타면 이전 파일이 남습니다. 사용자가 "나중에"를 고르면 --template 없이 실행하고, 나중에 pnpm template apply <id> 로 할 수 있다고 알려주세요.

2. 실행

bash scripts/company-setup.sh --no-community-prompt --template <id>

정리(prune)는 셋업에 포함되어 자동으로 실행됩니다. 회사를 고른 것 자체가 의사 표시이므로 따로 묻지 않습니다. 남은 카탈로그가 필요한 특수한 경우에만 --no-prune 을 붙이세요.

--no-community-prompt 를 항상 붙이세요. 스크립트의 텍스트 메뉴는 /dev/tty 에서 입력을 읽는데, Claude Code 의 Bash 도구에는 tty 가 없어 그 자리에서 막히거나 조용히 기본값(건너뛰기)으로 떨어집니다. 7단계는 아래 GitHub 응원 절차대로 당신이 AskUserQuestion 으로 직접 묻습니다.

같은 이유로 3단계(회사 선택)도 tty 가 없으면 건너뜁니다. 그래서 템플릿은 위에서 미리 정해 --template 로 넘기는 것입니다.

그 외 옵션은 필요할 때만 붙입니다:

옵션	언제
--yes	비대화형 환경(CI). 모든 확인을 자동 승인
--skip-install	방금 pnpm install 을 돌렸고 다시 돌릴 필요가 없을 때

스크립트가 하는 일

1. 필수 도구 — node ≥20.11, pnpm ≥10, git. 없으면 설치 명령을 출력하고 중단.
2. 도구 상태 — codex(선택), gh(선택), claude 상태를 알림.
3. 회사 선택 — --template 이 있으면 적용. 없고 tty 도 없으면 건너뜀.
4. 환경 — .env 생성, 템플릿이 요구하는 디렉터리 생성, 실행 권한 부여.
5. 의존성 — pnpm install.
6. 검증 — 구조 검사 + 타입 검사.
7. GitHub 응원 (선택) — --no-community-prompt 로 넘겼으므로 아무것도 하지 않습니다.