feature_list.json이란 무엇인가
feature_list.json은 AI 에이전트와 사람이 동시에 읽고 갱신하는 할 일 데이터 포맷입니다. id·behavior·verification·state 4칸으로, "AI가 됐다고 말하는 것"과 "실제로 검증된 것"을 구분합니다.
// 01 · why왜 노션·Trello가 아니라 feature_list.json인가
노션·Trello·종이 다이어리는 사람 뇌에는 훌륭한 도구입니다. 카드를 드래그하고 색깔로 라벨을 붙이면 사람에게는 자연스럽게 읽힙니다. 문제는 AI가 그 상태를 스스로 갱신할 자리가 없다는 점입니다. AI는 자기가 무엇을 끝냈는지 기록할 칸이 없어, 같은 작업을 두 번 하거나 매번 처음부터 전체를 다시 훑습니다.
feature_list.json은 각 항목에 verification(검증 명령)이 박혀 있어, AI가 그 한 줄을 직접 실행해 통과 여부를 스스로 확인하고 기록합니다.
같은 파일을 사람이 열어 수정하고 AI가 다음 세션에서 그 변경을 읽는, 단일 진실의 원천이 됩니다.
// 02 · schema4칸 스키마
| 칸 | 무엇 | 예시 |
|---|---|---|
id | 고유 번호 | F-003 |
behavior | 한 줄로 무엇을 하는가 | 결제 성공 시 사용자에게 영수증 이메일이 발송됩니다. |
verification | 어떻게 확인하는가 | 테스트 결제 후 메일함에서 영수증 도착 여부 확인 |
state | 지금 살아 있는 상태 | todo / active / passing / failing / blocked |
{
"id": "F-003",
"behavior": "결제 성공 시 사용자에게 영수증 이메일이 발송됩니다.",
"verification": "테스트 결제 후 메일함에서 영수증 도착 여부와 금액 표기를 확인합니다.",
"state": "failing",
"owner": "agent",
"notes": "발신 도메인 인증 미완료로 스팸함으로 분류됨."
}
네 칸이면 충분합니다. owner·notes는 익숙해진 뒤 추가하면 됩니다.
state가 active에서 passing으로 바뀌는 유일한 방법은 verification 명령이 실제로 성공하는 것 —
AI가 "다 된 것 같다"고 답해도 검증 전이면 여전히 active입니다.
// 03 · use cases실제 적용 사례 3개
- 1인 빌더 — 노션에 흩어져 있던 feature 30개를 옮기고
verification칸을 채우자, 다음 세션부터 AI가 "오늘 활성 항목 5개 중 3개를 끝냈고, 1개는 F-005에 막혀 있습니다"로 시작. 우선순위 회의가 사라짐. - PM — 매주 월요일 직접 만들던 진행 리포트를, "지난주 state 변화를 표로 요약해줘" 한 줄로 초안 생성. 검토·의사결정에만 시간을 씀.
- 마케터 — 콘텐츠 발행 워크플로에 "실제 채널에 게시됨" 검증을 박자,
passing이 되어야만 다음 콘텐츠로 넘어가는 구조가 생겨 중복 발행·누락이 동시에 사라짐.
// 04 · faq자주 묻는 질문
feature_list.json과 노션·Trello 같은 할일 관리 도구는 뭐가 다른가?
state가 거짓으로 passing이 되는 걸 어떻게 막는가?
PM 출신인데 개발 지식 없이 feature_list.json을 쓸 수 있나?
feature_list.json은 어디서 배울 수 있나?
지금 활성 작업 5개부터 옮겨보세요
30개는 처음부터 하지 마세요. 지금 살아 있는 작업 5개만 옮기고, verification 한 줄씩 채우는 것부터 시작합니다.