고치면 다른 화면이 깨지는 이유

고치면 다른 화면이 깨지는 건 코드를 잘못 고쳐서가 아니에요. 고친 것은 코드뿐이고 문서는 옛날 그대로라서예요.

AI는 문서를 보고 만들기 때문에, 옛날 문서를 보면 옛날 화면을 만들어요. 코드는 고쳤는데 화면이 옛날로 돌아가요.

플랜디는 25년차 기획자가 만든 AI 기획 도구예요.

고친 것은 코드만이 아니에요

문서가 옛날 것이라는 것은 무엇인가요?

문서가 옛날 것이라는 건, 고치기 전의 설명이 그대로 남아 있다는 거예요. 코드는 바뀌었는데 설명은 안 바뀐 상태예요.

겉으로는 다 고친 것 같아 보여요.

고치기 전의 설명이 그대로 남아 있으면, AI는 그 설명을 진짜로 믿어요. 그래서 다음 화면을 옛날 설명대로 만들어요.

믿는 것은 사람이 아니라 AI예요.

깨지는 것을 확인하는 순서

1단계. 고친 화면을 적어요

이번에 고친 화면이 무엇인지 적어요. 버튼 하나라도 고쳤으면 적어요.

적어 두지 않으면 까먹어요.

2단계. 그 화면을 설명한 문서를 찾아요

고친 화면을 설명한 문서를 찾아요. 화면 목록, 한 줄 기록, 공통 규칙을 봐요.

문서가 여러 개면 다 봐요.

3단계. 문서의 설명이 지금과 같은지 봐요

문서의 설명과 지금 화면을 비교해 봐요. 다르면 그 문서가 옛날 문서예요.

하나라도 다르면 표시해 둬요.

4단계. 다르면 문서부터 고쳐요

문서가 다르면 코드보다 문서를 먼저 고쳐요

고치는 순서는 다음 글에서 자세히 봐요. 순서를 지키면 깨지는 일이 줄어요.

한계

문서를 다 고쳐도 깨지는 것은 생겨요. 문서는 설명이고, 실제 동작은 코드에 있어요.

그래도 문서가 맞으면 깨진 곳을 찾는 시간이 확 줄어요. 문서가 틀리면 찾는 데서부터 막혀요.

문서는 지도가 되는 거예요.

자주 묻는 질문

코드를 고쳤는데 왜 문서를 봐요?

AI는 문서를 보고 만들기 때문이에요. 코드는 결과이고, 문서는 설명서예요.

설명서가 옛날 것이면 다음 결과도 옛날 것이 돼요. AI는 설명서를 의심하지 않아요.

문서가 없으면 어떻게 해요?

화면 목록부터 만들어요. 목록이 있어야 고친 곳을 표시할 수 있어요.

목록이 없으면 고친 것도 안 보여요. 목록을 파일로 넣어 읽히는 순서는 AI 코딩툴에 기획 문서를 넣는 법 글에 있어요.

작은 수정도 문서를 고쳐야 하나요?

네, 고쳐야 해요. 작은 수정이 쌓이면 문서와 화면이 점점 멀어져요.

멀어진 것은 나중에 한 번에 못 고쳐요. 작을 때 고치는 게 쉬워요.

누가 문서를 고치나요?

고친 사람이 바로 고쳐요. 고친 사람이 아니면 어디가 바뀌었는지 몰라요.

고치고 나서 바로 적는 게 제일 정확해요. 시간이 지나면 기억이 흐려져요.

오늘 내용 정리

1. 고치면 다른 화면이 깨지는 건 문서는 옛날 그대로라서예요.
2. 고친 화면을 설명한 문서를 찾아 지금과 같은지 봐요.
3. 다르면 코드보다 문서를 먼저 고쳐요.

고치는 순서를 이어서 봐요

코드보다 문서를 먼저 고치는 네 단계는 다음 글에서 이어져요. 고칠 때 문서도 함께 고치는 순서