10/11 일요일. 실제 수강생 리허설 전이며, 일별 배치와 분량은 운영 결과로 조정합니다.
오늘의 결과
이번 개선이 명세대로 됐는지 점검하고, 실제로 만들어진 것을 스펙에 반영합니다. 실패한 변경을 되돌리는 방법도 익힙니다.
시작할 재료
구현 결과, 명세의 확인 행동, 변경 전 상태 기록.
이 페이지의 순서
작업 위치 확인 → 완료 점검 → 내가 직접 검사 → 스펙 업데이트 → 되돌리기 연습입니다.
1. 작업 위치 확인하기
작업 위치: Codex에서 연 내 MVP 폴더
specs/ 안의 현재 기능에서 spec.md·plan.md·tasks.md를 읽고 현재 상태를 요약해줘.
아직 아무것도 고치지 마.완료 확인: 이번 개선의 문서 3개 위치와 현재 상태가 확인됐습니다.
2. 완료 점검 맡기기
작업 위치: 같은 MVP 폴더 대화
입력창에 /를 누르고 speckit-converge을 골라, 아래 내용을 이어 붙입니다.
구현이 명세대로 됐는지 점검해줘.
명세의 확인 행동마다 실제 코드에서 되는지 안 되는지 나눠서 보여줘.
코드만 읽고 판단한 것과 실제로 실행해서 확인한 것을 구분해서 표시해줘.
명세에 있는데 구현되지 않은 것, 구현됐는데 명세에 없는 것을 각각 알려줘.완료 확인: 점검 결과를 받았고, 실행으로 확인된 것과 코드만 읽은 것이 구분됩니다.
3. 내가 직접 검사하기
작업 위치: 내 앱 화면
점검 결과만으로 끝내지 않습니다. AI의 통과 보고는 내 확인을 대신하지 못합니다.
명세의 확인 행동을 직접 해보고 표로 적습니다.
| 확인 행동 | 기대 | 실제 | 통과 |
|---|---|---|---|
| (명세에서 가져옵니다) |
세 줄만 채워도 충분합니다. 쓰면서 하는 게 핵심입니다 — 머릿속으로만 하면 빠뜨립니다.
완료 확인: 확인 행동마다 통과·실패가 적혔습니다.
4. 실제 결과를 스펙에 반영하기
작업 위치: 같은 MVP 폴더 대화
여기가 이번 주의 핵심 습관입니다. 만들다 보면 명세와 다르게 가는 부분이 반드시 생깁니다. 그걸 그냥 두면 문서가 거짓이 되고, 다음 개선에서 쓸 수 없습니다.
입력창에 /를 누르고 speckit-specify을 골라, 아래 내용을 이어 붙입니다.
구현 결과와 내가 직접 검사한 결과를 명세에 반영해줘.
실제로 만들어진 동작이 명세와 다른 부분을 실제에 맞게 고쳐줘.
이번에 못 한 것은 지우지 말고 다음 사이클로 남겨줘.
기준 명세에서 이번 변경으로 달라진 항목을 갱신해줘.
새 기능을 추가하지 말고 지금 상태를 정확히 적는 것만 해줘.완료 확인: 명세가 지금 실제 동작과 맞습니다. 못 한 것은 다음 사이클로 남아 있습니다.
5. 되돌리기 — 지금 연습해둡니다
작업 위치: 같은 MVP 폴더 대화
지금 문제가 없어도 이 단계를 읽어두세요. 급할 때 처음 해보면 더 망가집니다.
되돌릴 때는 범위를 먼저 확인하고 실행합니다.
되돌리기를 하려고 해. 실제로 되돌리기 전에 먼저 보여줘:
어떤 파일이 어느 상태로 돌아가는지, 지금 작업 중인 것 중 무엇이 보존되는지,
되돌린 뒤 내가 확인할 방법이 무엇인지.
전체 초기화나 무조건 덮어쓰기는 하지 마. 내가 확인한 다음에 실행해줘.| 상황 | 할 일 |
|---|---|
| 방금 한 변경만 잘못됐다 | 그 파일만 되돌립니다 |
| 이번 개선 전체가 잘못됐다 | 1일차 "Spec Kit 설치 전 상태" 커밋으로 돌아갑니다 |
| 뭐가 잘못됐는지 모르겠다 | 되돌리지 말고 먼저 어디서부터 달라졌는지 찾습니다 |
완료 확인: 되돌릴 지점이 어디인지 알고, 되돌리는 순서를 읽었습니다.
개념 한 가지
스펙은 만들고 끝나는 문서가 아닙니다. 만든 뒤에 실제와 맞추는 것까지가 한 사이클입니다.
이 습관이 있으면 다음 개선을 시작할 때 "지금 뭐가 되는지"를 다시 조사하지 않아도 됩니다. 없으면 매번 처음부터 AI에게 설명해야 합니다. 2주차가 끝나도 남는 건 코드가 아니라 이 사이클입니다.
알아두면 좋은 것 — 테스트
오늘 한 "확인 행동을 직접 해보는 것"이 테스트의 기본 모양입니다.
- 테스트 — 내가 만든 것이 기대대로 동작하는지 미리 정해둔 방법으로 확인하는 것.
- 지금처럼 사람이 직접 눌러보는 것도 테스트고, AI에게 "이 동작들을 자동으로 확인하는 코드를 짜줘"라고 하면 자동 테스트가 됩니다.
지금 명세의 확인 행동들을 자동으로 검사하는 테스트를 짜줄 수 있어?
매번 직접 눌러보지 않아도 한 번에 확인하고 싶어.프로젝트가 커질수록 사람이 매번 다 눌러보기 어려워집니다. 자동 테스트는 그때 "방금 고친 게 다른 걸 안 깼는지"를 빠르게 알려줍니다. 지금 당장 필요한 건 아니고, 프로젝트가 자라면 떠올릴 이름으로 기억해두면 됩니다.
막혔을 때
| 증상 | 할 일 |
|---|---|
| 점검은 통과인데 내가 해보면 안 된다 | 실제 결과가 정답입니다. 차이를 그대로 전달해 고칩니다 |
| 명세와 구현이 너무 많이 다르다 | 범위가 컸던 것입니다. 실제에 맞춰 명세를 고치고, 다음엔 더 작게 잡습니다 |
| 되돌렸는데 다른 게 사라졌다 | 보존 범위를 확인하지 않고 실행한 경우입니다. 다음엔 5번 프롬프트로 범위를 먼저 봅니다 |
오늘의 마무리
1단계 · 학습일지 — 학습허브 폴더에서 학습메이트한테 아래 프롬프트를 넣으세요.
오늘 학습일지 작성해줘.오늘 남길 재료는 확인 행동 검사 표, 명세와 실제가 달랐던 부분, 명세에 반영한 내용, 다음 사이클로 남긴 것입니다. 다 끝내지 못했어도 현재 상태를 기록해요.
2단계 · 사례글 — 학습메이트가 제안하는 소재 중 하나 골라 사례글로.
3단계 · 업로드 — 미리보기로 복사 → 지피터스에 붙여넣기 → 24기 AI놀이터 태그 → 발행
✅ 사례글이 올라가면 오늘 완주.