프로젝트 기억 작성하고 갱신하기
프로젝트의 목표, 결정과 다음 작업은 Markdown 기준 문서에 남깁니다. 새 결과가 생길 때마다 문서를 늘리기보다 같은 기준 문서를 갱신해 현재 기준을 한곳에서 찾게 합니다.
기준 문서의 기본 구조
- 프로젝트 목표와 대상 사용자
- 현재 범위와 제외 범위
- 시작 자료와 근거
- 확정된 결정과 이유
- 열린 질문
- 현재 결과
- 다음 작업
- 관련 문서와 산출물
- 마지막 검토일
확인되지 않은 내용은 사실처럼 쓰지 않고 열린 질문으로 남깁니다.
첫 문서 만들기
이 프로젝트에 프로젝트 기준이라는 Markdown 문서를 만들어줘. 확인되지 않은 내용은 열린 질문으로 남겨줘.
생성 후 제목, 워크스페이스·프로젝트와 폴더 위치를 확인합니다.
교체와 추가를 구분하기
현재 기준 전체를 고칠 때는 문서 내용을 갱신하고, 기존 기록 뒤에 회의 결과나 새 로그를 덧붙일 때는 추가 작성합니다.
기존에 유효한 내용은 유지하고, 확정된 결정과 열린 질문과 다음 작업만 갱신해줘.
기존 본문은 바꾸지 말고 오늘 검토 기록을 문서 끝에 추가해줘.
무조건 뒤에 덧붙이면 오래된 기준과 새 기준이 섞일 수 있습니다. 현재 상태를 보여주는 문서는 필요한 부분을 정리해 갱신하세요.
변경 전에 확인하기
중요한 문서는 수정안을 먼저 봅니다.
현재 내용과 수정안을 비교해 보여줘. 아직 저장하지 마.
대상 문서가 모호하면 후보를 확인하고, 다른 워크스페이스나 프로젝트의 동명 문서를 변경하지 않게 합니다.
결정·질문·작업 구분하기
- 확정된 결정 — 사람이 검토해 현재 기준으로 채택한 내용
- 열린 질문 — 답이나 승인이 필요한 내용
- 다음 작업 — 담당자와 실행이 필요한 행동
- 참고 자료 — 판단의 근거지만 그 자체가 결정은 아닌 내용
실행이 필요한 항목은 Kanban 카드로 연결하고, 결정은 Markdown에 남깁니다.
관련 산출물 연결하기
HTML, Diagram, OpenAPI, File과 ERD를 만들었다면 기준 문서에 목적과 위치를 남깁니다. 산출물에서 새 결정이 생기면 Markdown도 함께 갱신합니다.
저장 후 확인하기
저장한 문서의 위치와 바뀐 내용을 요약해줘.
필요하면 버전과 최근 활동을 확인합니다. 수정안을 검토했다면 결과를 검토하고 이어서 일하기로 이동하세요.