에이전틱 시대의 문서화 혁신

에이전틱 시대의 문서화 혁신

AI와 협업하는 새로운 문서 작성법 — 모든 문서 작성자를 위한 실전 가이드

AI 에이전트가 코드와 문서를 읽고 쓰는 시대입니다. 이 핸드북은 기존 문서화 패러다임을 넘어, AI와 협업하여 문서를 설계·작성·검증·유지하는 새로운 프로세스를 제시합니다.

대상 독자

개발자, PM, 테크니컬 라이터 등 AI 시대에 문서를 쓰는 모든 사람. 기본지식은 AI에게 물어보면 되는 시대, 핵심만 남기는 문서를 어떻게 만들지 다룹니다.

관련 읽기

문서가 하네스 안에서 어떤 역할을 하는지까지 보려면 하네스 엔지니어링을 함께 읽는 편이 좋습니다.

핵심 전제

기본지식은 AI에게 물어보면 된다 — 문서에 모든 것을 담을 필요가 없다
AI가 읽는 문서가 필요하다 — 구조화·선언적·파싱 가능한 포맷
사람과 AI가 협업하여 문서를 만든다 — 설계→생성→검증→유지의 새 프로세스
문서화 ROI가 폭증한다 — AI가 읽으면 투자 대비 효과가 극대화

핸드북 구조

목차

왜 문서화가 변해야 하는가

사람→사람에서 AI↔사람으로, 문서화 패러다임의 전환

AI-readable 문서 설계 원칙

구조화된 포맷, 핵심 우선 밀도, 선언적 서술

AI와 협업하는 문서 작성 프로세스

설계→생성→검증→발행의 새로운 워크플로우

프로젝트 규칙 문서

CLAUDE.md, AGENTS.md, .cursorrules 작성법