codex 프로젝트 문서 어떻게 운영하시나요?
안녕하세요
CODEX 사용자로써 이런 공간이 생기게 되어 반갑습니다.
앞으로 여러 사용 사례와 시행착오를 함께 나눌 수 있으면 좋겠습니다.
개인 프로젝트를 운영하면서 문서 구조를 조금씩 다듬어 사용하다 보니 아래와 같은 구조가 되었습니다.
AGENTS.md = AI/Codex가 일하는 전체 규칙
docs/ai/QUICK_REF.md = 세션 시작용 핵심 요약
docs/tasks/current-task.md = 현재 작업 상태
docs/master/ = 제품/프로젝트 기준의 원본
docs/wiki/ = 반복 참고용 지식 허브
docs/plans/ = 구현 전 계획
docs/decisions/ = 큰 결정과 판단 근거
docs/sessions/ = 날짜별 작업 기록
docs/changelog.md = 짧은 변경 이력
처음부터 정해진 방법론을 따른 건 아니고,
AI와 같이 개발하면서 맥락이 자주 섞이고, “왜 이렇게 결정했지?”를 다시 찾는 일이 많아서
필요할 때마다 구조를 나눠가며 만든 방식입니다.
이 방식으로 저장해 두니
어떤 근거로 기획을 했는지, 부족한 기획은 어느부분인지
날짜별로 어떤 작업을 했는지
앞으로 어떤 작업을 해야할지
등을 분석하기 쉬워졌고 코덱스에게 알려주기도 편해졌습니다.
다만 이건 제가 자체적으로 발전시킨 구조라서 실제 회사나 팀에서는 어떻게 운영하는지 궁금해 졌습니다.
실무에서 써보신 문서 운영 방식이나, 반대로 실패했던 방식이 있으면 들어보고 싶습니다.
