setup-checks

Imported from IsthisLee/checkride (plugin/skills/setup-checks/SKILL.md). Install upstream with npx skills add IsthisLee/checkride --skill setup-checks. Copyright stays with the author.

이 저장소에 맞춘다

게이트가 여기서 실제로 일하도록 설정한다. 파일을 덮어쓰기 전에 반드시 diff 를 보여 주고 승인을 받는다.

Codex에서는 이 절차로 checkride.toml을 만들어도 자동 게이트가 켜지지 않는다. 해당 설정은 Claude Code의 checkride 훅이 읽는다. Codex에서는 검사 명령과 프로젝트별 기준을 기록하고, 자동 차단이 적용됐다고 말하지 않는다.

내가 쓰는 언어로 답하고, 설정 파일의 주석도 그 언어로 쓴다.

1. 현재 상태를 측정한다

SessionStart 프로필이 이미 사실을 실어 왔다면 거기서 출발한다. 그렇지 않으면 직접 확인한다. 패키지 매니저(락파일), 스택, 기존 checkride.toml 의 존재 여부, .claude/settings.json 의 권한 설정이 대상이다.

2. 검사 명령을 확정한다

완료 게이트는 이 순서로 찾는다. checkride.toml → package.json 의 scripts.test → Makefile 의 test 타깃 → pyproject.toml.

자동으로 찾아낸 것을 실제로 돌려 보고 출력을 보여 준 뒤, 이것이 맞는지 묻는다. 돌려 보지 않고 적어 두지 않는다. 몇 분씩 걸릴 만큼 느리면 빠른 부분집합을 함께 제안한다. 공식 best practices 의 CLAUDE.md 예시가 정확히 그것을 권한다. "Prefer running single tests, and not the whole test suite, for performance." (번역: 성능을 위해 전체 테스트 스위트보다 개별 테스트를 돌리는 쪽을 택하라.)

# checkride.toml
test_command = "pnpm test"
fast_test_command = "pnpm test -- --changed"

3. 기준선을 기록한다

지금 실패하는 테스트가 있으면 목록으로 적는다. 원래 깨져 있던 것 때문에 매 턴이 막히면 사람은 게이트를 꺼 버린다. 그것부터 고칠지, 이 상태에서 출발할지 묻는다.

Willison 의 조언도 같다. "Any time I start a new session with an agent against an existing project I'll start by prompting a variant of the following: First run the tests." (번역: 기존 프로젝트에서 에이전트와 새 세션을 시작할 때마다 나는 다음과 같은 취지의 프롬프트로 시작한다. 먼저 테스트를 돌려라.)

4. append-only 경로를 제안한다

이력을 다시 써서는 안 되는 폴더를 찾는다. 마이그레이션이 대표적이다. supabase/migrations, prisma/migrations, db/migrate 가 있으면 지목한다. 없으면 그냥 넘어간다. 없는 것을 지어내지 않는다.

append_only = "supabase/migrations, db/migrate"

5. 비밀 파일 차단을 제안한다

Claude Code용으로 .claude/settings.json 에 Read deny 규칙을 제안한다. 이 설정은 Codex 권한을 바꾸지 않는다고 알린다. 공식 권한 문서의 문장이다. "A Read deny rule also blocks the Edit and Write tools on the same path, including creating a new file there. NotebookEdit isn't covered." (번역: Read deny 규칙은 같은 경로에 대해 Edit 와 Write 도구도 막으며, 거기에 새 파일을 만드는 것까지 막는다. NotebookEdit 는 해당되지 않는다.) 이 저장소가 NotebookEdit 를 쓴다면 Edit deny 도 필요하다고 알린다.

6. 마무리

표로 보고한다. 무엇을 바꿨는지, 이제 어떤 게이트가 살아 있는지, 아직 놀고 있는 게이트는 무엇이고 왜 그런지를 적는다. 다음 세션의 프로필이 같은 내용을 보여 줄 것이다.