려 작업 실수와 재발방지 원칙

려 작업 실수와 재발방지 원칙

이 문서는 현과 함께 일하는 개인 에이전트 려가 실제 작업 중 저지른 실수와, 같은 실수를 반복하지 않기 위한 운영 원칙을 기록한다.

2026-06-27 충북교구레드플레그 /cbred 관리자 페이지 분리 누락

상황

현은 `충북교구레드플레그` 관리자 화면을 요일별·단계별로 나누어 운영하도록 요청했다.

요구된 흐름은 다음과 같았다.

• 전주 결과
• 이번주 출결
• 목회자 발송현황
• 응답현황
• 발송현황

이 흐름은 단순한 한 화면 안의 요약 섹션이 아니라, 실제 관리자 업무가 단계별로 전환되는 별도 페이지 구조로 이해해야 했다.

실제 실수

려는 요구를 충분히 확인하지 않고 `/cbred` 한 페이지 안에 `#prev`, `#attendance`, `#pastor`, `#response`, `#delivery` 같은 앵커 섹션으로만 나누었다.

그 결과 겉으로는 항목이 나뉘어 보였지만, 현이 요구한 "페이지 분리"는 구현되지 않았다.

원인

• "요일별로 달라져야 한다"는 말을 화면 구성의 강조 순서로만 해석했다.
• "페이지를 나누라"는 요구를 실제 라우트와 URL 단위 분리로 고정하지 않았다.
• 작업 완료 보고 전에 URL 단위로 페이지가 분리되었는지 직접 확인하지 않았다.
• 사용자의 불만이 나온 뒤에도 처음에는 코드 위치 확인만 하고 실제 수정 전에 진행 상황을 길게 설명했다.

재발 방지 원칙

앞으로 현이 "페이지를 나누라", "화면을 분리하라", "단계별 페이지"라고 말하면 다음을 기본값으로 한다.

• 앵커 링크가 아니라 실제 URL 라우트를 만든다.
• 사이드 메뉴와 상단 이동 버튼도 `#id`가 아니라 별도 경로를 가리키게 한다.
• 각 페이지는 독립 제목, 독립 본문, 독립 처리 흐름을 가져야 한다.
• 완료 보고 전에는 최소한 각 URL이 실제로 열리는지 확인한다.
• "수정 완료"라고 말하기 전에 사용자의 표현을 기준으로 수용 조건을 다시 대조한다.

/cbred 페이지 분리 기준

`/cbred` 계열 화면은 다음 구조를 기준으로 한다.

• `/cbred` - 주간 운영 개요
• `/cbred/prev` - 전주 결과
• `/cbred/attendance` - 이번주 출결
• `/cbred/pastor` - 목회자 발송현황
• `/cbred/response` - 응답현황
• `/cbred/delivery` - 발송현황
• `/cbred/settings` - 수집 설정

설정 저장 같은 POST 동작은 기존 호환성을 위해 `/cbred/settings`에서 처리하되, 저장 후 설정 페이지로 돌아가게 한다.

작업 태도 원칙

• 현이 화를 낼 만한 지점에서는 변명보다 바로 원인, 현재 상태, 다음 조치를 말한다.
• 이미 지적받은 요구사항은 구현 전까지 "완료"라고 표현하지 않는다.
• 중간 보고는 짧게 하되, 실제 작업을 멈추지 않는다.
• 한 번 틀린 해석은 로컬 메모리와 위키 기록 양쪽에 남긴다.