사이트 플랜

PLAN.md는 프로젝트의 첫 빌드가 끝나는 순간 작성되며, 사이트가 지금 어떤 상태인지를 항상 설명하도록 만들어집니다. 사이트에 일어난 모든 일을 기록한 로그가 아닙니다(그 역할은 버전 탭과 변경 기록이 맡습니다). 사이트 플랜 화면은 이 마크다운을 실제 화면으로 바꿔 보여 줍니다. 페이지는 표로, 모듈은 목록으로, 열린 질문은 체크리스트로, 사업 정보, 브랜드, 결정 사항은 일반 문장으로 표시됩니다.

첫 빌드가 끝나기 전에는 읽을 내용이 없습니다. 화면에는 "아직 플랜이 없습니다"라고 표시되고, 플랜은 프로젝트의 첫 빌드 때 작성된다고 간단히 설명하며, 빈 표를 보여 주는 대신 프로젝트 페이지로 돌아가는 링크를 제공합니다.

다른 AI 도구에서 커넥터를 통해 게시되었거나, 가져왔거나, 업로드된 파일처럼 플랜 없이 들어온 사이트도 플랜을 갖게 됩니다. 화면은 프로젝트 브리프, 키트에서 고른 항목, 측정된 페이지를 바탕으로 플랜을 시작하며, "이 플랜은 고객님을 위해 시작되었습니다"라는 배너와 함께 "이 플랜 저장" 버튼을 보여 줍니다. 저장하면 이 플랜이 프로젝트의 실제 플랜이 되어 모든 섹션을 편집할 수 있습니다. "전체 사이트 플랜 읽기"는 플랜 및 브리프 탭의 플랜 문서로 이동합니다.

키트에서 나중에 추가한 도구(플랜에 추가)는 플랜 텍스트가 추가 전에 작성되었더라도 "계획됨" 상태로 모듈 목록에 들어가며, "키트에서 보기" 링크가 함께 표시됩니다.

제목 아래 한 줄에 플랜이 마지막으로 최신 상태가 된 시간이 표시됩니다. 예: "플랜 업데이트됨 10월 2일 오후 3:04". 이 시간은 aiKit이 사이트의 실제 파일을 마지막으로 측정한 시점이며, 변경이 있을 때마다(채팅 편집, 고정, 키트 추가, 복원, 플랜 직접 수정, 다른 AI 도구에서의 게시) 측정됩니다.

계획이 만들어지면 맨 위에 전체 완료율 막대와 그 아래 세 개의 타일이 표시됩니다. 타일은 계획된 페이지 중 만든 페이지 수(Pages built), 선택한 모듈 중 만든 모듈 수(Modules built), 계획의 미결 질문 중 답한 질문 수(Questions answered)를 보여 줍니다. 각 타일은 해당 내용을 세는 섹션으로 스크롤하는 버튼입니다. 이 수치는 계획 텍스트에 적힌 내용으로 계산되지 않습니다. 페이지는 aiKit이 사이트의 실제 파일에서 찾았을 때만 만들어진 것으로 집계되고, 모듈은 검증된 빌드 보고서나 파일에서 찾은 모듈일 때만 만들어진 것으로 집계됩니다. 질문은 계획에서 해당 줄이 체크되었거나 고객이 질문 페이지에서 답했을 때 답한 것으로 집계됩니다.

계획이 뒤처지는 원인은 두 가지이며, 화면에 어느 쪽인지 표시됩니다. 변경 후 계획 문서를 다시 쓰는 AI 작업이 끝나지 않았거나("마지막 변경 후 작성된 계획이 업데이트되지 않았습니다"와 이유), 계획을 마지막으로 측정한 뒤 사이트에 더 새로운 버전이 생겼거나("이 계획을 마지막으로 업데이트한 후 사이트가 변경되었습니다")입니다. 어느 경우든 "계획 새로고침" 버튼이 나타납니다. 이 페이지는 열릴 때 자동으로 실행되지 않습니다(페이지를 열어도 AI를 사용하지 않습니다). 엔진이 각 변경 사항을 백그라운드에서 계획에 이미 반영하며, 이 버튼은 그 작업이 뒤처졌을 때 사용하는 것입니다. 계획 새로고침은 가장 최근 변경 사항을 작성된 계획에 반영하고 사이트를 다시 측정합니다. 그래도 완료되지 않으면 배너에 문제의 원인이 계속 표시되며, 계획 새로고침을 다시 누르거나 계획을 직접 수정할 수 있습니다.

상태 카드는 AI의 의견이 아니라 aiKit이 실제 파일에서 확인한 규칙을 바탕으로 사이트를 100점 만점으로 평가합니다. 확인 항목은 페이지 제목이나 검색 설명이 없거나 중복된 경우, 기본 제목이 없거나 여러 개인 페이지, 존재하지 않는 페이지로 연결되는 링크, 아무도 링크하지 않고 메뉴에도 없는 페이지, 스크린 리더용 설명이 없는 이미지, 매우 짧은 페이지, 전송 위치가 없는 양식, 브리프에서 요청했지만 사이트에 없는 모듈입니다. 각 문제는 해당 페이지와 중요한 이유를 알려 주고, 수정 버튼이 있습니다. 수정 버튼을 누르면 문제의 준비된 지침이 요청으로 등록되어 AI에 전달되며, 작업 중에는 버튼에 "수정 요청됨"이 표시되고, 변경이 적용되면 점수가 다시 측정됩니다. 높음, 중간, 낮음 개수로 심각도별 필터링을 할 수 있으며, "모두 보기"를 누르면 필터가 해제됩니다.

사이트맵은 사이트를 트리 구조로 보여 줍니다. 맨 위에는 홈, 그 아래에는 순서대로 메뉴, 그리고 그 페이지들에서 연결되는 페이지가 나옵니다. 아무도 링크하지 않는 페이지는 별도 그룹에 표시되고, 계획에 있지만 아직 만들어지지 않은 페이지는 점선으로 그려지며 "계획됨" 표시가 붙습니다. 계획에 언급되지 않은 만들어진 페이지에는 "계획에 없음" 표시와 "계획에 추가" 버튼이 나타나며, 이 버튼을 누르면 해당 페이지가 페이지 섹션에 추가됩니다.

페이지(사이트맵 또는 페이지 목록)를 누르면 계획 옆에 상세 정보가 열립니다. 주소창은 ?page=/about 형태로 바뀌므로, 이 링크를 팀원 누구에게 보내도 같은 페이지가 열립니다. 상세 정보에는 구글 검색 결과에서 보이는 모습(제목, 주소, 설명), 섹션과 주요 제목, 단어 수, 이미지 수와 설명이 없는 이미지 수, 양식과 이를 처리하는 키트 모듈, 고객 승인 여부, 그리고 마지막 변경 내용(언제, 누가 요청했는지, 무엇을 요청했는지)이 표시됩니다.

기록에는 aiKit이 보관하는 버전(원본과 최신 10개)이 최신순으로 나열됩니다. 각 항목에는 번호, 변경 유형(최초 빌드, 채팅, 고정, 키트, 게시, 복원, 계획 편집), 변경 시점, 요청 내용, 요청자, 변경된 페이지가 표시됩니다. 페이지를 누르면 상세 정보가 열립니다. 가장 최근 버전에는 "현재 버전" 표시가 붙고, 이전 버전에는 "이 버전 복원" 버튼이 있습니다. 이 버튼은 먼저 확인을 요청하고, 사이트를 되돌리기 전에 현재 상태를 저장하므로 복원도 실행 취소할 수 있습니다. 처음 세 개만 표시되며, "모두 보기"를 누르면 나머지가 모두 나타납니다.

비즈니스 정보 섹션은 고객 파일의 전화번호, 이메일, 주소, 영업시간을 만들어진 페이지(홈과 연락처 페이지 우선)의 텍스트와 비교합니다. 각 정보에는 "사이트에 있음" 또는 "사이트에서 찾을 수 없음"이 표시되며, 확인한 페이지 수도 함께 나타납니다(사이트에 이전 값이 남아 있을 수 있기 때문입니다). "고객 파일에서 수정" 링크를 통해 고객 파일을 기준 정보로 계속 관리할 수 있습니다.

• 페이지 — 페이지, 경로, 목적, 상태(만들어짐 또는 계획됨)를 보여 주는 표입니다. 페이지가 만들어졌고 사이트가 공개된 후에는 실제 페이지로 이동하는 "보기" 링크가 나타납니다.
• 모듈 및 도구 — 계획에 있는 모든 모듈이 각각 "만들어짐" 또는 "계획됨" 표시와 자체 메모와 함께 나열됩니다.
• 비즈니스 정보 — 영업시간, 주소, 서비스, 가격 등 비즈니스에 관한 사실 정보를 일반 텍스트로 정리한 내용입니다.
• 브랜드 — 계획에 기록된 색상 팔레트, 톤, 스타일 메모입니다.
• 결정 사항 — 이미 내려져서 다음 수정 때 다시 논의하지 않아야 할 실제 결정 사항입니다.
• 미결 질문 — 아직 정해지지 않은 사항의 체크리스트로, 각 항목에 답변됨 또는 미결 상태가 표시됩니다.

모든 섹션 카드에는 같은 두 개의 버튼이 있습니다. "편집"을 누르면 해당 섹션의 원본 마크다운이 간단한 입력란에 열리고, 저장하면 PLAN.md에 바로 기록됩니다. 이는 프로젝트의 PUT 엔드포인트를 통한 실제 즉시 저장이지만, 의도적으로 빌드나 배포를 실행하지 않습니다. 계획 문서의 내용만 바뀌며, 다른 메모를 수정하는 것과 같습니다.

"Ask for a change"은 의도적으로 다릅니다. 작은 양식("<section>에서 무엇을 바꾸고 싶으신가요?")을 열며, 이를 보내면 프로젝트의 Feedback 탭에 실제 요청이 등록됩니다. 등록되는 요청에는 "Site plan — <Section>: …"이라는 이름이 붙고, 모든 핀이나 Quick edit 요청과 똑같이 자체 상태 단계가 있으며, 전송된 후에는 "View the request" 링크가 표시됩니다. 계획서 자체의 텍스트를 직접 고치거나 다시 쓰고 싶을 때는 Edit를 사용하세요. 실제 웹사이트(그리고 그에 따라 계획서)를 맞춰서 업데이트하고 싶을 때는 Ask for a change를 사용하세요.

이 계획은 두 개의 층으로 구성됩니다. 측정 항목(페이지, 제목, 섹션, 링크, 양식, 모듈, 상태)은 변경할 때마다 실제 파일에서 코드가 직접 수집하므로 어긋날 수 없습니다. 글로 작성된 계획(목표, 사업 정보, 브랜드, 결정 사항, 미해결 질문)은 변경 후마다 실행되는 AI 작업이 최신 상태로 유지하며, 변경으로 영향을 받은 부분만 다시 작성합니다. 변경 기록이나 날짜별 항목은 추가하지 않습니다. 변경 내역은 History에 있습니다.

AI 작업이 실패하면 글로 된 계획은 반만 다시 쓰이지 않고 이전 상태 그대로 남으며, 실패 사실이 기록됩니다. 화면에는 오래된 계획을 조용히 보여주는 대신 계획 새로고침(위 참조) 버튼이 표시됩니다.

계획 옆의 레일에는 작업 버튼들이 있습니다(휴대폰에서는 레일이 진행 상황 띠 바로 아래에 전체 너비의 "고객 링크 복사" 버튼이 되고, 나머지는 "더 많은 작업 (3)" 아래에 접혀 있습니다). "고객과 공유"는 읽기 전용 링크(aikit.ai/p/<project>/plan)를 복사합니다. 직원용 도구나 편집 버튼, 내부 정보는 포함되지 않습니다. "실제 사이트 열기"는 라이브 사이트로 바로 연결되며, 아직 공개되지 않았다면 레일에 "아직 공개되지 않음"이라고 표시됩니다. "파일"에는 실제 파일 개수가 표시되고, 펼치면 각 파일의 경로와 크기 목록을 볼 수 있습니다. "계획 다운로드"는 현재 화면이 읽고 있는 실제 PLAN.md 파일을 실제 .md 파일로 내려받습니다. 요약본을 새로 생성한 것이 아니라 내용이 한 바이트도 다르지 않습니다.

고객 페이지는 계획 탭으로 열립니다. 직원이 Plan & brief 탭에서 보는 것과 같은 사이트 계획 문서입니다(개요와 목표, 대상 고객, 전략, 사이트맵, 각 도구와 그 도구가 사업에 주는 효과 및 상태, 콘텐츠 계획, 일정, 결정 사항, 미해결 질문). 단, 직원 전용 내용은 빠집니다. 도구를 추가할 때 입력한 메모, 누가 무엇을 추가했는지에 대한 이름, aiKit Kit으로 연결되는 링크, 그리고 Write the plan 버튼이 없습니다. 두 번째 탭인 Pages & approvals에는 아래의 페이지별 보기가 있습니다.

Pages & approvals에서는 고객이 피드백을 남길 때 이미 쓰는 것과 같은 접근 코드로 보호되며(별도 로그인 없음), 같은 진행 상황 띠, 고객 페이지의 사이트맵, "View" 링크가 있는 페이지 목록, 모듈, 사업 정보, 브랜드, 결정 사항, 미해결 질문, 그리고 "Plan updated" 줄을 봅니다. 고객은 상태 점검, 수정 안내, 기록(History), 누가 무엇을 요청했는지, 파일 목록, 그리고 어떤 편집 또는 Ask-for-a-change 버튼도 볼 수 없습니다.

직원이 자신만을 위해 표시한 내용은 모든 섹션에서 페이지가 전송되기 전에 서버에서 제거됩니다. "(internal)", "[internal]" 또는 "(staff only)"가 포함된 줄, "Internal:" 또는 "Staff only:"로 시작하는 줄, 제목에 Internal 또는 Staff only라고 적힌 모든 섹션, 그리고 숨겨진 주석이 여기에 해당합니다. 이런 내용은 페이지의 네트워크 데이터에서도 포함되지 않아, 고객의 브라우저에 전혀 전달되지 않습니다.

완성된 각 페이지에는 승인 버튼이 있습니다. 고객은 이름(그리고 선택적으로 메모)을 입력해 승인합니다. 승인은 해당 페이지의 정확한 내용에 연결되므로, 나중에 페이지가 바뀌면 "승인 후 변경됨"이 표시되고 다시 승인을 요청합니다. 승인은 고객의 접근 코드를 사용하는 사람만 할 수 있습니다. 직원 계정으로 로그인한 상태에서 고객 링크를 열면 각 페이지의 승인 상태는 보이지만 승인 버튼은 나타나지 않으므로, 아무도 고객을 대신해 승인할 수 없습니다. 직원용 사이트 계획에서는 승인된 페이지에 "고객 승인"이, 변경된 페이지에는 "승인 후 변경됨"이 표시됩니다.

페이지 하단에는 "피드백 보내기" 버튼이 있습니다. 사이트가 공개되어 있으면 고객 본인의 접근 코드로 피드백 오버레이가 켜진 실제 라이브 사이트가 열립니다. 아직 공개되지 않았다면 대신 최근 업데이트 페이지로 이동합니다.