Markdown 문서
Markdown은 AiNecto 프로젝트의 현재 기준을 남기는 기본 문서입니다. Agent 작업을 시작하기 전 읽고, 사람이 검토한 결과를 다시 반영하는 프로젝트 기억의 중심입니다.
사용하기 좋은 내용
- 프로젝트 목표와 범위
- 요구사항과 정책
- 확정된 결정과 근거
- 열린 질문
- 회의와 검토 결과
- 운영 절차
- 현재 결과와 다음 작업
- 관련 산출물의 위치
만들기
웹에서 Markdown을 선택하거나 Agent에게 요청합니다.
[프로젝트 이름]에 프로젝트 기준이라는 Markdown 문서를 만들어줘.
워크스페이스와 프로젝트가 모호하면 위치를 함께 지정합니다. 같은 목적의 문서가 이미 있다면 새로 만들지 않고 기존 문서를 확인합니다.
읽기와 검색
프로젝트 기준 문서를 읽고 목표, 결정, 열린 질문과 다음 작업을 구분해줘.
제목과 본문으로 검색할 수 있습니다. 후보가 여러 개면 프로젝트·폴더 위치와 마지막 변경 시점을 비교합니다.
전체 갱신과 추가 작성
현재 기준을 바꿀 때는 기존 내용을 읽고 필요한 부분을 갱신합니다.
기존에 유효한 내용은 유지하고 확정된 결정, 열린 질문과 다음 작업을 갱신해줘.
회의 로그처럼 기존 본문 뒤에 기록을 남길 때는 추가 작성합니다.
기존 본문은 바꾸지 말고 오늘 검토 결과를 끝에 추가해줘.
현재 기준 문서에 내용을 계속 덧붙이기만 하면 오래된 판단이 남을 수 있으므로 두 방식을 구분합니다.
Markdown 생성 보조
Agent는 기존 Markdown과 제공된 문맥을 바탕으로 문서 초안을 생성할 수 있습니다. 생성 요청도 대상 문서를 명확히 지정하며, 결과는 사람이 검토한 뒤 현재 기준으로 사용합니다.
버전과 복원
저장된 변경은 버전에서 확인하고 이전 상태를 읽거나 복원할 수 있습니다. 복원 전에는 현재 버전과 대상 버전을 비교해 이후의 유효한 결정이 사라지지 않는지 확인합니다.
댓글과 검토
일반 의견은 댓글, 답이 필요한 항목은 질문으로 남깁니다. 합의된 내용은 댓글에만 두지 않고 본문에 반영합니다.
좋은 Markdown의 기준
- 현재 기준이 앞부분에 보입니다.
- 사실·결정·질문·작업이 구분됩니다.
- 근거와 관련 산출물을 찾을 수 있습니다.
- 오래된 내용이 현재 기준처럼 남아 있지 않습니다.
- 다음 사람과 Agent가 이전 대화 없이 이해할 수 있습니다.
다음 단계
화면으로 요구사항을 검토해야 한다면 HTML 문서로 이어가세요.