Table of Contents
한국어 문서와 Markdown 정리 · 2026-10-12
원인
공개 저장소의 문서에는 긴 문장, 반복되는 강조와 압축된 표현이 섞여 있었습니다. 여러 행동이 한 단계에 들어가거나 문단 사이의 간격이 부족해, 설치 순서와 확인할 조건을 찾기 어려웠습니다.
사용자는 모든 Markdown 문서를 자연스럽고 친절한 한국어로 다듬고 줄바꿈을 정리하도록 요청했습니다.
해결 방법
기존 Markdown 파일 37개를 모두 점검하고 수정했습니다. 이 보고서를 추가하여 저장소의 Markdown 파일은 38개입니다.
- README를 제품 소개, 다운로드, 사용 흐름과 설치 순서 중심으로 다시 구성했습니다.
- 설치 절차에서 여러 행동이 섞인 단계를 나눴습니다. 설명과 예외 조건은 별도 문단에 배치했습니다.
- 문단마다 하나의 주제를 담고, 제목·목록·표·코드 블록 사이에 빈 줄을 넣었습니다.
- 반복되는 강조를 줄이고, 명사만 나열한 표현을 자연스러운 문장으로 바꿨습니다.
agent-go/README.md의 오래된 버전 안내를 공개 에이전트 0.2.40으로 바로잡았습니다.- 과거 보고서는 당시 날짜와 시험 결과를 유지했습니다. 이후 릴리즈 안내는 별도 문단으로 연결했습니다.
- 외부 라이브러리 문서에는 한국어 안내를 추가했습니다. 원본 영어 설명, 예제 명령과 라이선스 고지는 보존했습니다.
AGENTS.md와 기여 안내에 문장·문단·줄바꿈의 작성 기준을 기록했습니다.
확인한 내용
문서의 내부 링크와 제목 연결, 문단 간격을 검사했습니다. 명령어가 담긴 기존 코드 블록, 원문 커밋과 체크섬, 과거 보고서의 수치가 유지되는지도 대조했습니다.
전체 문서를 실제 Gitea Markdown 렌더러로 변환해 제목과 표 구조를 확인했습니다. README는 Gitea의 실제 화면 스타일에서 PC와 모바일 표시를 확인했습니다.
공개 파일 검사와 변경 파일 검토도 수행했습니다. 수정 범위는 Markdown 문서이며, 제품 실행 코드나 에이전트 버전·기존 릴리즈 파일을 바꾸는 작업은 아닙니다. 문장 정리를 새로운 기능 시험이나 OS 설치 검증으로 기록하지 않습니다.
문서 원본과 위키 본문은 함께 관리합니다. 과거 보고서의 원문 커밋과 작성 시점도 계속 확인할 수 있습니다.
제안사항
새 문서도 같은 기준으로 작성합니다. 먼저 읽는 사람에게 필요한 안내를 제시하고, 자세한 조건과 검증 기록을 이어서 설명합니다. 게시 전에 링크와 PC·모바일 표시를 확인합니다.
원문: 공개 소스 cedbd06. 문서 갱신일 2026-10-12.