10/7 수요일 · 라이브와 이 페이지의 관계
라이브에서는 빈 연습 폴더로 Spec Kit 사용법만 익힙니다. 각자 MVP 상태가 달라 같은 화면을 볼 수 없고, 정해진 시간 안에 끝나지 않기 때문입니다.
이 페이지는 내 MVP로 하는 작업입니다. 라이브가 끝난 뒤, 또는 라이브에 못 왔다면 여기부터 시작하세요. 라이브에서 익힌 순서가 그대로 쓰입니다.
오늘의 결과
내 MVP 폴더에 Spec Kit을 설치하고, 지금 내 앱이 무엇을 하는지를 스펙 문서로 만듭니다.
오늘은 코드를 고치지 않습니다. 이번 주 내내 쓸 기준 문서를 만드는 날입니다.
이 페이지의 순서
작업 위치 확인 → 되돌릴 지점 만들기 → Spec Kit 설치 → 프로젝트 원칙 → 현재 상태를 스펙으로 → 읽고 확인입니다. 한 칸씩 실행하고 완료 확인을 보세요. 개선할 것을 고르는 일은 내일 합니다.
스킬을 부르는 방법
Spec Kit 단계는 Codex 입력창에서 /를 눌러 목록에서 고릅니다. 이름을 외워서 타이핑하지 않습니다.
- Codex 입력창에
/를 입력합니다. - 목록에서
speckit-으로 시작하는 항목을 찾습니다.speckit까지 치면 목록이 줄어듭니다. - 쓰려는 단계를 선택합니다. 입력창에 그 단계가 들어갑니다.
- 그 뒤에 이어서 아래 교안의 내용을 붙입니다.
목록에 speckit-이 안 보이면 아직 설치가 안 된 것입니다. 아래 3번 단계에서 설치합니다.
라이브에 오셨다면 연습 폴더에서 이미 해본 방식입니다. 같은 순서를 내 MVP 폴더에서 다시 합니다.
1. 작업 위치 확인하기
작업 위치: Codex에서 연 내 MVP 폴더 (1주차에 앱을 만든 폴더)
학습허브가 아니라 앱을 만든 폴더여야 합니다. 두 폴더를 헷갈리면 엉뚱한 곳에 스펙이 생깁니다.
Codex에서 그 폴더 여는 방법
1주차에 쓰던 프로젝트가 그대로 열린다면 그걸 쓰면 됩니다. 새로 열어야 한다면:
- Codex 입력창 아래 폴더 모양 버튼을 누르고 새 프로젝트를 누릅니다. 버튼에는 프로젝트 선택 또는 지금 프로젝트 이름이 적혀 있습니다.
- 프로젝트 이름을 적고 소스 폴더의 추가를 누릅니다. 영어 창(
Select Project Root)이 뜨면 1주차 MVP 폴더를 찾아 고른 뒤 폴더 선택을 누릅니다. 소스 폴더에 폴더 이름이 보이면 프로젝트 만들기를 누릅니다. 폴더를 고르기 전에도 이 버튼이 눌리니 먼저 누르지 마세요. - "이 폴더를 신뢰할까요?"가 나오면 내가 만든 폴더인지 확인하고 폴더 신뢰를 누릅니다.
폴더가 어디였는지 모르겠다면
1주차에 앱을 실행했던 대화를 열어 경로를 확인하세요. 그래도 모르겠으면 Codex에 물어봅니다.
지금 열려 있는 작업 폴더의 전체 경로를 보여줘.
이 폴더가 1주차에 만든 MVP 폴더인지, 학습허브 폴더인지 파일 목록으로 판단해줘.
MVP 폴더가 아니면 코드를 만들지 말고, 내가 열어야 할 폴더 위치를 알려줘.Codex에서 다른 폴더를 열어야 한다면, 작업 폴더를 그 폴더로 바꾼 뒤 새 대화로 시작합니다.
Codex가 Not inside a trusted directory라고 하면, 폴더 신뢰를 아직 안 누른 것이거나 깃 저장소가 아닌 것입니다. 2번에서 해결됩니다.
완료 확인: 지금 열려 있는 폴더가 1주차 MVP 폴더이고, 내 앱 파일이 보입니다.
2. 되돌릴 지점 만들기
작업 위치: 같은 MVP 폴더 대화
이 단계를 건너뛰지 마세요. 다음 단계에서 파일이 여러 개 추가됩니다. 뭔가 잘못됐을 때 돌아올 지점이 지금 필요합니다.
지금 상태를 깃 커밋해줘.
커밋 전에 바뀐 파일 목록을 먼저 보여주고, 커밋 메시지는 "Spec Kit 설치 전 상태"로 해줘.깃 저장소가 아니라고 하면 Codex가 초기화하고 커밋합니다. 그대로 두면 됩니다.
완료 확인: 커밋이 만들어졌고, 돌아올 지점이 생겼습니다.
3. Spec Kit 설치 상태 확인하고 설치하기
작업 위치: 같은 MVP 폴더 대화
이미 설치되어 있을 수도 있습니다. 먼저 확인합니다.
이 프로젝트에 Spec Kit이 설치되어 있는지 읽기 전용으로 확인해줘.
.specify/ 폴더, .agents/skills/speckit-* 폴더, specs/ 폴더가 있는지 봐줘.
없으면 설치하지 말고 결과만 알려줘.이미 있으면 4번으로 갑니다. 다시 설치하지 않습니다.
없으면 아래를 Codex에 그대로 보냅니다. 터미널을 직접 열지 않아도 됩니다.
Spec Kit(버전 v1.1.1)을 설치해줘. 공식 설치 방법을 써줘.
설치가 끝나면 버전을 확인해서 보여줘.승인을 묻는 창이 뜨면 허용을 누릅니다.
그다음 초기화합니다. 지금 작업 폴더가 내 MVP 폴더인지 먼저 확인하세요.
이 폴더에 Spec Kit을 Codex용으로 초기화해줘. 스킬까지 함께 설치되는 방법으로 해줘.
이미 내 파일이 있는 폴더니까 기존 파일을 덮어쓰지 말고,
추가될 파일을 먼저 보여준 뒤 내가 확인하면 진행해줘.설치 후 내 파일이 그대로인지 확인합니다.
방금 설치로 추가되거나 바뀐 파일 목록을 보여줘. 내 기존 코드가 바뀐 게 있으면 알려줘.완료 확인: .specify/와 .agents/skills/speckit-*가 있고, 내 기존 코드는 그대로입니다. Codex 입력창에서 /를 누르면 speckit- 항목이 보입니다.
4. 프로젝트 원칙 만들기
작업 위치: 같은 MVP 폴더 대화
1주차에 쓴 PRD가 여기서 재료가 됩니다. 버리지 않고 이어씁니다.
Codex 입력창에서 입력창에 /를 누르고 speckit-constitution을 골라, 아래 내용을 이어 붙입니다.
docs/prd.md를 읽고 이 프로젝트의 지침과 원칙을 세워줘.
새 PRD를 만들지 말고 기존 PRD를 근거로 써줘.
내가 이 프로젝트에서 지킬 기준을 중심으로 정리해줘..specify/memory/constitution.md가 생깁니다. 열어서 읽어보세요. 내가 동의하지 않는 원칙이 있으면 지금 고칩니다. 이번 주 내내 AI가 이 문서를 따릅니다.
완료 확인: constitution.md가 있고, 내가 읽고 동의한 내용입니다.
5. 지금 내 앱을 스펙으로 작성하기
작업 위치: 같은 MVP 폴더 대화
여기가 오늘의 핵심입니다. 고칠 것을 쓰는 게 아니라, 지금 되는 것을 쓰는 겁니다.
입력창에 /를 누르고 speckit-specify을 골라, 아래 내용을 이어 붙입니다.
지금 이 프로젝트가 실제로 하는 일을 기준 명세로 작성해줘. 새 기능을 추가하지 마.
코드를 읽어서 현재 동작하는 기능, 입력과 결과, 저장 방식을 정리해줘.
각 기능마다 내가 직접 실행해 통과·실패를 판정할 수 있는 확인 행동을 적어줘.
코드에 없는 기능을 있는 것처럼 쓰지 말고, 확인하지 못한 부분은 미확인으로 표시해줘.
docs/prd.md의 목적과 지금 실제 동작이 다른 부분이 있으면 차이를 보여줘.specs/00X-.../spec.md가 생깁니다. 이게 내 앱의 현재 기준판입니다.
완료 확인: 지금 되는 기능이 명세에 적혀 있고, 각 기능에 내가 확인할 행동이 붙어 있습니다.
6. 읽고 확인하기
작업 위치: 내 화면에서 직접
생긴 spec.md를 열어 읽으면서, 적힌 대로 실제로 되는지 2~3개만 직접 해봅니다.
적힌 것과 실제가 다르면 그게 오늘의 수확입니다. AI가 코드를 잘못 읽었거나, 내가 기억하던 동작과 실제가 다른 것입니다.
내가 직접 해보니 다음이 명세와 달랐어: (차이를 적습니다)
명세를 실제 동작에 맞게 고쳐줘. 코드는 아직 고치지 마.완료 확인: 명세가 실제 동작과 맞습니다. 다른 부분은 명세에 반영했거나 미확인으로 남겼습니다.
개념 한 가지
| 내 문서 | 역할 | 언제 바뀌나 |
|---|---|---|
docs/prd.md | 이 프로젝트가 무엇을 하려는가 | 거의 안 바뀜 |
constitution.md | 이 프로젝트에서 무엇을 지키는가 | 거의 안 바뀜 |
spec.md | 지금 무엇이 되는가 / 무엇이 되면 성공인가 | 개선마다 추가·갱신 |
PRD는 하나, 스펙은 여러 개입니다. 이번 주에 개선할 때마다 스펙을 추가하거나 갱신하고, PRD는 그대로 둡니다. 매번 처음부터 설명하지 않아도 되는 상태를 만드는 게 목적입니다.
막혔을 때
| 증상 | 할 일 |
|---|---|
| MVP 폴더가 어디인지 모르겠다 | 1주차에 앱을 실행한 대화를 열어 경로를 확인합니다. 그래도 모르면 1번의 프롬프트로 Codex에 묻습니다 |
| MVP가 아직 실행되지 않는다 | 실행 복구를 이번 주 작업으로 잡습니다. 지금 되는 것까지만 스펙에 적고, 안 되는 것은 미확인으로 남깁니다 |
uv 명령을 못 찾는다 | uv를 먼저 설치하고 터미널을 새로 엽니다 |
/ 목록에 speckit-이 안 보인다 | .agents/skills/ 폴더가 있는지 확인합니다. 설치 직후면 Codex를 다시 시작해봅니다 |
| 설치가 기존 파일을 건드릴 것 같다 | 멈추고 추가·변경 목록부터 확인합니다. 2번 커밋이 있으면 되돌릴 수 있습니다 |
| 명령을 보냈는데 멈춘 것처럼 보인다 | 잠깐 기다려봅니다. 그래도 안 움직이면 프롬프트를 다시 보냅니다 |
설치가 막혀서 멈췄다면 그것도 오늘의 결과입니다. 오류 메시지와 멈춘 단계를 남기되, Spec Kit 실습 완료로 표시하지는 않습니다.
오늘의 마무리
1단계 · 학습일지 — 학습허브 폴더에서 학습메이트한테 아래 프롬프트를 넣으세요.
오늘 학습일지 작성해줘.오늘 남길 재료는 설치 전 커밋 위치, 생긴 문서 세 개의 경로, 명세와 실제가 달랐던 부분, 내일 고르고 싶은 개선 후보입니다. 다 끝내지 못했어도 현재 상태를 기록해요.
2단계 · 사례글 — 학습메이트가 제안하는 소재 중 하나 골라 사례글로.
3단계 · 업로드 — 미리보기로 복사 → 지피터스에 붙여넣기 → 24기 AI놀이터 태그 → 발행
✅ 사례글이 올라가면 오늘 완주.