cc-settings

cc-settings는 Claude Code와 Codex에 Darkroom engineering 팀의 표준, 작업 흐름(task workflows), 안전 점검(safety checks), 그리고 증명 게이트(proof gates)를 제공합니다. 이 설치 프로그램은 개인 설정 중 cc-settings가 소유하지 않은 부분은 대체하지 않으면서도 새로운 기기가 나머지 팀원들처럼 작동하게 만듭니다.

실질적인 효과는 간단합니다: '이 버그를 수정해 줘'라는 요청은 원인부터 파악하는 디버깅 작업 흐름을 갖게 되고, '내 변경 사항 검토해 줘'는 읽기 전용(read-only) 상태가 유지되며, '배포해 줘'는 무언가를 게시하기 전에 실제 빌드와 테스트를 거쳐야 합니다.

새로운 사용자이신가요? 설치하고 (5분 소요), 읽기 전용 작업을 한 번 실행한 다음, 일일 루프를 학습하세요. 이것만으로도 대부분의 가치를 얻기에 충분합니다. 그 이후 내용은 참고 자료이니 필요할 때 돌아와서 확인하시면 됩니다.

5분 만에 첫 성공 경험하기

1. 사용할 제품 설치

Claude Code 또는 Codex CLI 둘 중 하나를 설치하고 인증하세요. cc-settings는 이러한 제품들을 설정할 뿐, 구독이나 계정을 직접 설치하지는 않습니다.

2. cc-settings 설치

모든 플랫폼 (Node 18+):

npx darkroom-settings

모든 설치기 플래그가 작동합니다: npx darkroom-settings --light --auto-update=on. bunx darkroom-settings도 동일한 역할을 합니다. npm 패키지는 다운로더 역할만 하며, 설정은 항상 이 저장소의 고정된 GitHub origin에서 설치됩니다.

macOS 또는 Linux (Node 미사용 시):

curl -fsSL https://raw.githubusercontent.com/darkroomengineering/cc-settings/main/setup.sh | bash

플래그는 -s -- 뒤에 붙입니다. 모든 setup.sh 플래그는 클론이나 다운로드가 필요 없이 원격으로 작동합니다:

curl -fsSL https://raw.githubusercontent.com/darkroomengineering/cc-settings/main/setup.sh | bash -s -- --light --auto-update=on

Windows PowerShell:

powershell -ExecutionPolicy Bypass -c 

원격으로 Windows에서 플래그를 전달하려면 다운로드한 스크립트를 스크립트 블록으로 호출하십시오:

```powershell
powershell -ExecutionPolicy Bypass -c "& ([scriptblock]::Create((irm https://raw.githubusercontent.com/darkroomengineering/cc-settings/main/setup.ps1))) --light"

기본 대상(target)은 codex가 PATH에 있을 때 두 제품을 모두 설치하며, 그렇지 않을 때는 Claude Code만 설치합니다. --light는 최소한의 초급자 등급을 설치하므로, 전체 설정을 얻으려면 이 플래그 없이 다시 실행하십시오.

저장소(repository)를 클론하는 것은 자신이 소유할 소스 체크아웃이 필요할 때만 하십시오:

git clone https://github.com/darkroomengineering/cc-settings.git
cd cc-settings
bash setup.sh --target=both --dry-run
...

모든 요구 사항, 등급(tier), 시스템 변경 사항, 프롬프트, 관리 경로 및 되돌리기 동작은 설치 참고 자료에서 검토하십시오.

3. 재시작 및 검사

선택한 모든 제품을 재시작하십시오. Codex 전체 설치의 경우 /hooks를 열고 설치된 후크(hook)를 한 번 검토하십시오. Claude 사용자는 어떤 디렉토리에서든 설치된 사용자 범위 구성(user-scope configuration)을 검사할 수 있습니다:

bun ~/.claude/src/scripts/whats-on.ts

이 보고서는 무엇이 설치되었고 Claude 사용자 범위를 어떻게 형성하는지 보여줍니다. 이전 프롬프트를 어떤 기술(skill)이 처리했는지 또는 프로젝트 재정의를 완전히 해결했는지는 식별하지 않습니다.

4. 무해한 작업 실행

저장소를 열고 다음과 같이 말하십시오:

Explain where this project's configuration is loaded. Read only. Cite the files and lines.

결과는 읽기 전용 범위(read-only scope)를 명시하고, 증거를 인용하며, 작업 트리를 변경하지 않아야 합니다.
첫 세션에서는 예상 출력, 백그라운드 동작, 후속 조치 및 복구 과정을 보여줍니다.

일일 루프

명령어를 암기할 필요가 없습니다. 일반 언어로 결과를 설명하면 cc-settings가 일치하는 워크플로우(

큰 작업은 스스로 분할됩니다. 여러 파일을 아우르거나, 긴 도구 호출 체인 또는 보안에 민감한 코드는 백그라운드에서 실행되어 보고하는 전용 에이전트(explore, implement, test, review, security)에게 전달됩니다. 이들이 작업하는 동안 메인 대화에서는 계속 이야기할 수 있습니다.

감사 감사(audits), 클라이언트 리포지토리 분류(triage of a client repo), 적대적 검증(adversarial verification)을 포함한 모든 상황에 대한 워크플로우는 매뉴얼에 있습니다. 스킬 가이드에는 각각의 스킬이 무엇을 변경할 수 있고 언제 멈춰서 물어보는지 나와 있습니다.

작업하는 프로젝트 설정하기

cc-settings는 모든 리포지토리에 팀 표준을 가져옵니다. 각 프로젝트는 그 위에 자체 지침을 추가할 수 있습니다.

• 새로운 Darkroom 프로젝트 시작: "new darkroom project"라고 말하거나 /dr-init을 실행하세요. 이는 satus 또는 novus 스타터로부터 프로젝트를 생성합니다. 네이티브 /init은 CLAUDE.md만 작성하는 다른 명령어입니다.
• 프로젝트에 자체 지침 부여하기: 프로젝트 루트의 AGENTS.md에 넣으세요. Claude Code와 Codex 모두 이를 읽습니다. 좋은 내용은 에이전트가 코드로부터 배울 수 없는 것, 즉 실행할 명령어, 환경, 함정(traps), 그리고 잘못되어 보이지만 의도적인 결정입니다.
• CLAUDE.md가 있는 기존 프로젝트: "agents.md로 마이그레이션하기(migrate to agents.md)"라고 말하거나 /cc migrate를 실행하세요. CLAUDE.md가 존재하는 동안 Claude Code는 AGENTS.md를 무시하므로, 둘은 서로 달라지게 됩니다. 세션 배너가 프로젝트에 이것이 필요할 때 알려줍니다.
• GitHub에서 계획된 작업: 이슈를 연결하고 /handoff를 게시하여 진행 상황을 업데이트하면, 에이전트들이 해당 이슈를 읽고 그에 따라 업데이트합니다.## 결과의 변화를 가져오는 습관들

세션의 성공 여부는 작은 습관들이 가장 큰 차이를 만듭니다:

1. 단계가 아닌 결과물을 말하세요. 명령어 목록보다 "불안정한 체크아웃 테스트를 수정해 줘"가 더 효과적입니다. 신경 쓰는 제약 조건("읽기 전용", "API 건드리지 마")을 추가하세요.
2. 세션당 하나의 작업만 하세요. 관련 없는 작업 사이에는 /clear를 실행하세요. 길고 혼합된 세션은 느려지고, 비용이 더 많이 들며, 세부 사항을 놓치게 합니다.
3. 멈추기 전에 저장하거나 무언가를 위험에 빠뜨리지 마세요. 하루나 긴 세션 끝에는 /handoff를 사용하고; 위험한 리팩토링이나 마이그레이션 전에는 /checkpoint를 사용하여 롤백할 수 있게 하세요.
4. 어려운 전환 시에만 노력도를 높이세요. 기본값은 일상적인 작업을 위해 조정되었습니다. 어려운 디버깅, 감사 또는 마이그레이션을 위해서는 /effort high나 /effort xhigh를 사용하거나 단일 메시지에 ultrathink를 추가하세요.
5. 중요할 때 두 번째 의견을 구하세요. "여기에 허점을 찾아줘" (/poke-holes)는 독립적인 에이전트를 보내 문제를 찾고 반증합니다. 계획에 전념하기 전에 "무엇이 잘못될 수 있을까?"라고 묻는 것은 위험 검토를 받습니다.
6. 상태 표시줄을 읽으세요. 여기에는 컨텍스트 크기와 사용 한도가 표시됩니다. 컨텍스트가 약 150K 토큰에 도달하면, 계속 밀어붙이기보다 핸드오프하거나 압축하세요.
7. 뭔가 이상하다고 느껴질 때, 추측하기 전에 확인하세요. whats-on.ts는 무엇이 설치되어 있고 활성화되었는지 보여주며; 문제 해결은 훅 경고 및 설치 상태를 다룹니다.

모두에게 더 좋게 만들기

cc-settings는 사람들이 배운 것을 피드백할 때 개선됩니다. 가장 빠르거나 가장 관여도가 높은 세 가지 수준이 있습니다:

1. 배운 점을 공유하세요. 팀이 알아야 할 문제점, 규칙 또는 결정에 부딪혔을 때,

모든 기기에서 명령이나 파일 편집이 적용되기 직전에 이를 확인합니다.
2. 작동했던 워크플로우 유지. 세션에서 반복 가능한 작업을 수행하는 좋은 방법을 찾았다면, "이 세션을 스킬로 만들어줘"라고 말하거나 /harvest를 실행하세요. 실제로 발생한 내용을 바탕으로 스킬, 규칙 또는 팀 메모를 제안합니다.
3. 주간 회고. /retro는 배포된 내용, 세션 진행 상황 및 품질 추세를 보고하고, 어떤 가드레일이 작동했는지 그리고 그것이 도움이 되었는지 보여줍니다.

cc-settings 자체를 변경하려면 클론한 후 유지보수자 문서를 읽으세요.
간단히 말해:

• 설정은 config/에 조각(fragments) 형태로 존재하며, 설치 프로그램이 이를 ~/.claude/settings.json으로 병합합니다. 설치된 파일은 절대 수정하지 마세요. 설정을 변경하려면 조각을 편집하세요.
• 새롭거나 수정된 스킬은 evals/에 평가 케이스를 포함하여 배포됩니다. 스킬 작성를 참조하세요.
• 푸시하기 전에 bun test, bun run typecheck, 그리고 bun run lint를 실행하세요.
• 무언가를 제안하고 싶을 때만, 관찰한 동작과 예상했던 내용을 담아 이슈를 여세요.

최신 상태 유지

• 업데이트: 세션에서 "cc-settings 업데이트"라고 말하거나 /cc update를 실행하거나 설치 명령을 다시 실행하세요. 그 후에 제품을 재시작해야 합니다.
• 자동 업데이트 (macOS): --auto-update=on을 설치 명령에 추가하면 현지 시간으로 매일 10시에 확인합니다. --auto-update=off는 이를 제거합니다.
• 상태 확인: npx darkroom-settings --status는 설치된 상태와 패키징된 상태를 보고합니다.
• 되돌리기 (Undo): 체크아웃에서 bun src/setup.ts --rollback을 실행하면 최신 백업으로 복원됩니다. 설치 참고 자료에는 제거(uninstall)에 대한 내용이 포함되어 있습니다.

cc-settings가 기본 설치 위에 추가하는 것

새로운 Claude Code 또는 Codex 설치는 이 팀이 어떻게 작동하는지에 대한 기억이 없는 유능한 일반 비서입니다. cc-settings는 그 기억과, '완료'라는 것이 모든 기기에서 동일한 의미를 갖도록 만드는 검사 기능들을 설치합니다. 같은 요청이라도 설치된 후에는 다르게 동작합니다:

구성 요소