AI 에이전트를 통해 여러 프로젝트에서 리서치 및 개발 작업을 진행하면서 두 가지 문제를 반복해서 겪었습니다. 요구사항, 리서치한 자료, 결정 사항, 작업 계획이 서로 중복되거나 잘못된 폴더에 배치되는 등 체계적으로 관리되고 있지 않았습니다. 문서를 관리하기 위해 또 다른 문서를 작성하는 등 너무 많은 파일이 생겨나고 있었습니다. 마크다운 테이블로 각 문서를 관리하는 방식이 생각보다 좋지 않았습니다. 겉으로 보기에는 깔끔할지는 몰라도, 문법 때문에 코드 편집기에서 내용을 파악하기 어렵거나, 규격에 맞춰야 하기 때문에 수정하기 어려웠습니다. AI가 작성한 한국어 문서에 번역체와 AI 양산형 문구, 의미없는 반복적인 문장이 들어가고, 문장 자체는 자연스러워 보여도 앞뒤 관계나 책임 주체를 이해하기 어려운 경우가 있었습니다. 이 문제를 다루기 위해 docs-system을 만들고 있습니다. 이 프로젝트는 완성된 애플리케이션이나 모든 저장소에 그대로 적용하는 프레임워크는 아닙니다. 다만 AI 에이전트에게 어떻게 작업을 지시해야 할지에 대해서 리서치하고, 각 저장소에 맞게 고쳐 쓸 수 있도록 문서와 스킬을 세팅한 레포입니다. GitHub: https://github.com/nwleedev/docs-system use-design-docs로 요구사항과 조사 자료 관리하기 이 스킬은 AI 에이전트가 각 저장소의 docs/designs/README.md를 읽고 요구사항, 리서치한 외부 컨텐츠, 결정과 계획을 구분해 기록하도록 합니다. (없으면 스킬 내 폴더에서 복사합니다.) 요구사항은 작업자가 요구한 작업과 작업에 대한 완료 조건이 작성됩니다. 외부 자료에서 확인한 사실, AI의 분석과 제안은 별도 문서에 두고 요구사항처럼 취급하지 않습니다. 결정이 필요한 내용은 승인 전까지 제안으로 남기며, 실행 계획은 해결된 요구사항과 결정만 사용합니다. 테이블 및 고정된 문서 템플릿을 사용하는 방식이 아닙니다. 문서의 내용에 따라 소제목, 짧은 문단과 목록을 선택하고, 표 없이도 비교 순서와 근거를 따라갈 수 있게 작성합니다. 모든 작업에 조사 문서나 결정 기록을 미리 만들지 않고, 다음 작업에서도 다시 확인해야 할 정보가 있을 때만 추가합니다. 초기에는 각 문서마다 정해진 역할을 부여해야 한다는 강박감이 있었습니다. 그래서 작업이 완료되었는지 추적하기 위한 문서, 각 문서의 연결점을 따로 관리하는 문서, 그리고 여러 개의 템플릿을 두었...
Show GN: AI 에이전트가 요구사항과 조사 자료를 연결하고, 한국어 표현을 검토하도록 하는 방법에 대해서
3 weeks ago
41
Related
AI 시대에 가장 안전한 직업은 글쓰기일 수 있다
2 hours ago
2
Perplexity, 대량생산된 구매 가이드를 소프트웨어 추천의 근거로 제시
2 hours ago
3
Commodore 64, 1982년 9월 1일 출시
2 hours ago
2
Google, 광고 기술 독점 판결에도 사업 분할은 피하다
2 hours ago
2
Muse Spark 1.3 공개, 긴 에이전트 작업과 코딩 효율 개선
2 hours ago
2
Mistral, Enterprise 제외 사용자 입출력을 기본 학습에 활용
4 hours ago
3
Gemini 3.8 Flash와 보안 특화 모델 Flash Cyber 공개
6 hours ago
4
Tips
click
Trending
Popular
MiniMax H3, ComfyUI 출시 당일 지원 — 오픈 가중치·네이티브 오디오·2K 영상
4 weeks ago
81
임영웅, '차줌마' 차승원표 음식에 완밥.."최애 음식 바뀌었어"[산골총각 영웅][별별 TV]
4 weeks ago
75
“애런 저지와 한 팀, 너무 기대돼” 이제는 ‘이정후 前 동료’ 라모스의 기대 [현장인터뷰]
4 weeks ago
75
[TODAY엔비디아]다음주 실적 발표 앞둔 기대감…UBS "예상치 상회"
2 weeks ago
69
이란 페제시키안 대통령 “지금 최고지도자와 소통 매우 어려워”
4 weeks ago
68
데뷔 1년도 안 됐는데…코르티스가 써 내려간 ‘최초·최단’ 기록
3 weeks ago
57
서울과기대 예창패로 만난 옵티큐랩스·김세움 교수 “레이저 시스템 핵심 기술 내재화 협업”
4 weeks ago
55
Where does PDM end and PLM begin? 🤔
3 weeks ago
54
© Clint's Theme Park 2026. All rights are reserved

![“창원 더위가 그대로 서울로…” 3연속경기 폭염취소 경험한 NC 불펜투수 김진호도 혀를 내둘렀다 [SD 잠실 리포트]](https://dimg.donga.com/wps/SPORTS/IMAGE/2026/08/04/134419674.1.jpg)
![임영웅, '차줌마' 차승원표 음식에 완밥.."최애 음식 바뀌었어"[산골총각 영웅][별별 TV]](https://image.starnewskorea.com/21/2026/08/2026080421455216993_1.jpg)
![“애런 저지와 한 팀, 너무 기대돼” 이제는 ‘이정후 前 동료’ 라모스의 기대 [현장인터뷰]](https://pimg.mk.co.kr/news/cms/202608/04/news-p.v1.20260804.c6e84263ab564a53b34866c4f37f2d1c_R.jpg)
![[TODAY엔비디아]다음주 실적 발표 앞둔 기대감…UBS "예상치 상회"](https://image.edaily.co.kr/images/content/defaultimg.jpg)





English (US) ·