문서화 도구 조합으로 용도별 구분
노션, Mermaid, OpenAPI, Figma를 용도별로 나눠 사용한다.
기술 스택승인결정일 2026년 5월 7일
배경
프로젝트 문서화에서 구조 문서, 다이어그램, API 명세, 화면 설계가 모두 필요했다.
결정
텍스트/구조 문서는 Notion, 다이어그램은 Mermaid/Excalidraw, API 명세는 OpenAPI, 화면 설계는 Figma로 관리한다.
근거
각 도구가 잘하는 일을 맡기면 API 문서는 코드와 동기화되고, 결정 기록은 Notion에서 탐색하기 쉬워진다.
결과
링크 탐색 단계가 늘어나는 대신 메인 페이지와 Workroom에 기준 문서를 명확히 연결한다.
상세 기록
맥락
프로젝트 문서화에 노션, 다이어그램, API 문서 도구 조합이 필요했다. 한 도구에 모든 것을 몰아넣을지, 용도별로 도구를 구분할지 선택해야 했다.
결정
- 텍스트/구조 문서: Notion
- 다이어그램: Mermaid 코드 블록과 Excalidraw
- API 명세: OpenAPI/Swagger
- 화면 설계: Figma
근거
API 문서는 코드에서 자동 생성되는 OpenAPI를 기준으로 삼고, 결정 기록과 기획 문맥은 Notion에서 탐색 가능하게 유지한다.
결과
도구가 여러 개라 링크 탐색 단계는 늘지만, Agent Workroom과 핵심 문서 링크를 통해 운영 부담을 낮춘다.