문서 유형
AiNecto 프로젝트에서는 현재 기준, 실행 업무, 원본 자료와 전문 산출물을 목적에 맞는 문서 유형으로 관리합니다. 처음에는 Markdown 하나로 시작하고 실제 업무에 필요한 유형만 추가합니다.
권장 순서
- Markdown으로 목표·범위·결정·질문을 정리합니다.
- Kanban으로 실행할 업무와 검토 흐름을 관리합니다.
- 필요할 때 HTML, 디자인 시안, Diagram, OpenAPI, File과 ERD를 만듭니다.
- 산출물에서 발견한 결정은 다시 Markdown에 반영합니다.
Markdown
목표, 요구사항, 결정, 열린 질문, 검토 결과와 다음 작업을 남기는 기본 프로젝트 기억입니다.
Kanban
카드 유형, 담당자, 우선순위, 기한, 완료 조건, 검토와 차단 상태를 관리합니다. 요구사항과 결과 문서를 카드에 연결할 수 있습니다.
HTML
브라우저에서 확인할 화면, 프로토타입과 렌더링 결과를 만듭니다. 프로젝트 기준을 실제 화면으로 검토할 때 사용합니다.
디자인 시안
여러 화면 시안을 한 캔버스에 펼쳐 비교하고, 하나를 열어 실제로 동작해 봅니다. 시안은 AI가 MCP로 만들고 고칩니다. create_documents(type design)로 문서를 만들고 design_apply_changes(baseRevision 필수)로 바꾸며, get_document와 design_get_boards로 읽습니다. 웹에서는 시안을 직접 만들거나 고칠 수 없고, 보기·댓글·공유·버전 복원·PNG 내려받기를 할 수 있습니다.
create_document_images는 디자인 시안을 지원하지 않습니다(UNSUPPORTED_TYPE). 이미지는 웹이나 공개 주소에서 내려받습니다(로그인 필요). 디자인 시안의 get_document는 관계 개수만 돌려줍니다. 문서마다 버전을 100개까지 보관하고, 넘으면 가장 오래된 것부터 지웁니다.
Diagram
노드, 연결과 그룹으로 업무 흐름, 시스템 구조, 상태 변화와 개념 관계를 표현합니다.
OpenAPI
API 경로, 요청·응답, 인증과 오류 계약을 구조화된 명세로 관리합니다.
File
이미지, PDF, 영상, 오디오, 텍스트·코드와 CSV 등 원본 자료와 결과 파일을 프로젝트 트리에 보관합니다.
ERD
테이블, 컬럼, 인덱스, Enum과 관계를 구조적으로 설계합니다. 요구사항과 도메인 결정을 데이터 구조로 구체화할 때 사용합니다.
File과 첨부의 차이
File은 프로젝트 트리의 독립 문서입니다. 첨부는 특정 문서에 연결해 함께 보는 파일입니다. 중요한 내용은 파일에만 두지 말고 Markdown에 요약과 근거를 남깁니다.
유형을 선택하는 질문
- 현재 기준을 남기는가 → Markdown
- 담당자와 상태가 필요한가 → Kanban
- 화면으로 확인해야 하는가 → HTML
- 화면 시안을 나란히 비교하는가 → 디자인 시안
- 흐름이나 관계를 보여주는가 → Diagram
- API 계약인가 → OpenAPI
- 원본 또는 결과 파일인가 → File
- 데이터베이스 구조인가 → ERD
문서 유형이 달라도 모두 같은 워크스페이스와 프로젝트의 권한과 문맥을 따릅니다.
다음 단계
Markdown 문서에서 프로젝트의 현재 기준을 만드는 방법을 확인하세요.