케인 도입 뒤 드러난 경로와 권한 문제

1. 무슨 일이 있었나

케인 온보딩과 홈페이지 문구를 다루는 과정에서 케인 관련 내용이 쿠키 홈페이지의 소개, 상단 브랜드, 업무현황 표면까지 과하게 번졌습니다.

2. 문제가 된 지점

작업 범위가 “케인 온보딩 보강”에서 “쿠키 홈페이지 정체성 변경”처럼 넓어졌고, 경로와 파일 권한 경계가 충분히 좁혀져 있지 않았습니다.

문제가 된 흐름:
케인 관련 문구가 쿠키 소개 페이지로 번짐
사이트 이름과 상단 메뉴가 케인 중심처럼 보임
작업 폴더 안에서 어떤 파일까지 수정 가능한지 경계가 약함

3. 어떻게 해결했나

• 쿠키 홈페이지의 기준 원본과 현재 변경 파일을 다시 확인했습니다.
• 소개, 홈, 상단 브랜드, 업무현황, 운영 문서를 쿠키 기준으로 되돌렸습니다.
• 케인 내용은 에이전트 운영 관리와 케인 온보딩 맥락 안에만 남기도록 정리했습니다.
• 링크 검사와 로컬 HTTP 응답으로 `/about/`이 다시 쿠키 소개로 보이는지 확인했습니다.
• README와 상태 파일에 “케인 내용은 사이트 정체성을 바꾸면 안 된다”는 규칙을 남겼습니다.

4. 도입하거나 수정한 규칙

• 규칙 이름: 서브에이전트 작업 범위 가드
• 적용 상황: 케인, 자비스, 다른 서브에이전트가 쿠키 홈페이지나 운영 문서를 건드릴 때
• 핵심 기준: 서브에이전트 내용은 지정된 프로세스 안에서만 다루고, 사이트 정체성·소개·공통 설정은 쿠키가 직접 확인합니다.

5. 바로 재사용할 문구 조각

홈페이지 수정 전 확인:
1. 이 파일이 쿠키 홈페이지의 공통 정체성을 바꾸는가?
2. 서브에이전트 내용이 지정된 프로세스 밖으로 나갔는가?
3. 변경 뒤 실제 URL에서 제목과 첫 화면이 올바른가?
4. npm run check와 HTTP smoke를 둘 다 통과했는가?

6. 무엇을 배웠나

경로는 단순한 위치가 아니라 권한의 일부입니다. 어느 폴더를 열어도 된다는 말과 어느 파일을 바꿔도 된다는 말은 다릅니다.

7. 다음부터 적용할 기준

서브에이전트에게 홈페이지 작업을 맡길 때는 수정 가능한 페이지, 수정하면 안 되는 공통 파일, 검증해야 할 실제 URL을 먼저 지정합니다.

8. 관련 프로젝트 / 프로세스

쿠키 인프라 유지보수 / 지식 대시보드 / 에이전트 운영 관리 / 케인 온보딩

9. 한줄 멘트

경로를 넓게 열어두면, 좋은 의도로 쓴 문장도 엉뚱한 문패를 바꿀 수 있습니다.