본문으로 건너뛰기

잇Stock AI-DLC: 각자의 AI를 하나의 흐름으로

잇스탁AIAI 에이전트AI-Driven
It Stock김종찬2026년 11월 10일

AI-DLC는 AI-Driven Development Life Cycle의 줄임말로, AWS가 2025년에 제안한 개발 방법론입니다. AWS의 설명을 네 가지로 추리면 이렇습니다.

  1. AI가 먼저 묻고 사람이 검증한다. 사람이 계획을 세우고 AI가 코드 조각을 거드는 대신, AI가 계획을 세우고 모르는 것을 사람에게 묻고 사람이 확인한 뒤에 구현한다. 사람은 질문에 답하고 중요한 결정을 내리고 결과를 검증한다.
  2. 앞 단계의 맥락이 다음 단계의 입력이 된다. 요구사항을 다듬는 단계, 구현하는 단계, 운영하는 단계가 있고 각 단계의 AI는 앞 단계가 확정한 것을 읽고 시작한다.
  3. 맥락은 저장소에 남긴다. 계획, 요구사항, 설계 산출물을 저장소에 두어 세션이 바뀌어도 AI가 이어서 읽는다.
  4. 주기는 짧다. 몇 주짜리 스프린트 대신 몇 시간이나 며칠 단위로 돈다.

이 글은 그 AI-DLC를 잇Stock(저희 창고관리시스템) 팀에서 어떻게 쓰고 있는지 적은 것입니다. AI가 먼저 묻고, 앞 단계의 맥락이 다음 단계로 쌓이고, 그 맥락이 파일로 남아 세션을 넘어 이어지고, 그래서 주기가 짧아졌습니다. 저희가 만든 것은 이 넷입니다.

다른 점은 하나입니다. AWS의 그림은 팀 전체가 한자리에 모여 AI의 질문에 실시간으로 답하는 모습인데, 저희는 기획자, 디자이너, 백엔드, 프론트, QA가 각자의 시간에 각자의 도구로 일합니다. 그래서 "한자리에 모인다"를 "같은 파일을 읽고 쓴다"로 바꿨습니다. 앞 단계의 맥락은 사람의 입이 아니라 파일을 거쳐 다음 직군의 AI에게 갑니다. 먼저 왜 그게 필요했는지부터 적겠습니다.

각자는 AI를 잘 씁니다. 문제는 그다음입니다​

기획자가 AI와 함께 다듬은 기획서가 있습니다. 개발자는 그 기획서를 자기 AI에 넣고 그대로 구현을 시작합니다. 여기까지는 됩니다.

넘어오지 않는 건 기획자가 기획하는 동안 했던 고민입니다. 왜 이 경우는 빼기로 했는지, 어떤 안을 버렸는지가 기획자의 세션에만 남습니다.

그사이 기획서는 회의에서, 슬랙에서, 디자인 리뷰에서 조금씩 바뀝니다. 개발자의 AI가 읽은 기획서는 이미 지난주 것입니다.

개인은 빨라졌는데 조직에는 쌓이는 게 없었습니다. AI를 들이고 나서 저희 팀이 가장 크게 느낀 문제였습니다.

그래서 기획·디자인·개발·QA가 각자 AI로 일하던 흐름을 하나의 프로세스로 이었습니다. AI-DLC의 네 가지를 기획자·디자이너·백엔드·프론트·QA가 따로 있는 보통의 개발팀에 맞게 옮긴 것입니다.

먼저 정한 네 가지​

도구를 붙이기 전에 원칙부터 정했습니다.

1. 원장은 하나다

  • 기능이 어떻게 동작해야 하는지, 무엇이 되면 끝인지는 상세 기획서 1_PLANNING.md 한 장에만 적는다. 장부처럼 기준이 되는 단 하나의 문서라는 뜻으로 이 문서를 원장이라고 부른다.
  • 회의에서 바꾼 결정도, 디자인 리뷰에서 나온 수정도 원장에 적히기 전까지는 결정이 아니다.

2. 원장은 기획자만 고친다

  • 디자이너와 개발자는 고칠 문장을 제안하고 기획자가 받아들이면 원장 버전이 오른다.
  • 뒤 단계 문서는 자기가 읽은 원장 버전을 적는다. 원장이 더 높으면 그 문서는 낡은 것이고 검사가 인계를 막는다.

3. 티켓 하나에 폴더 하나

  • 원장, 디자인 검토, 개발 기록, 테스트케이스, 그리고 중간에 오간 질문과 답이 전부 같은 폴더에 쌓인다. 이 폴더들을 모은 Git 저장소가 사양 허브다.
  • 질문은 지우지 않는다. 결론과 거절한 이유까지 남긴다. 기획자가 고민한 내용은 이 질문 파일을 통해 다음 사람에게 넘어간다.

4. 앞 단계 결과가 다음 단계 입력이다

  • AWS가 말한 맥락 이어받기를 저희 식으로 적으면 이렇다. 완료 조건에는 원장이 번호를 붙이고 테스트와 테스트케이스는 그 번호를 가리킨다. 옮겨 적지 않는다.
  • 백엔드가 프론트와 QA에 넘기는 API 계약서도, AI가 읽는 디자인 시스템 문서도 사람이 쓰지 않고 코드에서 뽑는다.

도구는 모든 직군이 같은 AI 코딩 도구를 씁니다(지금은 Claude Code). 위 네 가지를 지키는 절차와 검수, 저장소 반영을 직군별 스킬(AI 도구에 넣어 두는 절차 묶음)에 담아 두었기 때문에 기획자와 디자이너는 Git을 몰라도 됩니다.

기획자는 상세 기획서를 관리하고 디자인·개발·QA는 각자 산출물을 티켓 폴더에 남기는 구조. Jira는 진행 상태와 문서 위치를 안내합니다.

각 단계의 문서는 담당자가 관리합니다. 함께 읽을 위치와 변경 이력은 사양 허브에 모읍니다. 그림을 누르면 크게 볼 수 있습니다.

기획에서 QA까지, 일하는 순서​

Jira 티켓 하나가 처음부터 끝까지 기준점입니다. 기획이 원장을 확정하면 디자인과 백엔드가 나란히 시작하고 프론트는 시안과 백엔드 인계 계약서를 받아 화면을 만들고 QA는 그 셋이 남긴 문서로 테스트케이스를 만듭니다. 각 단계는 앞 단계가 남긴 문서를 읽고 자기 문서를 같은 폴더에 남깁니다.

기획이 확정되면 디자인과 백엔드가 나란히 진행하고, 프론트는 시안과 백엔드 계약서를 받아 구현하며, 세 산출물로 QA 테스트케이스를 만들고 확정된 기획서로 챗봇 지식을 만드는 흐름

화살표는 산출물을 넘기는 흐름입니다. 작업 중 발견한 질문과 변경 사항은 어느 단계에서든 같은 폴더의 질문 파일로 남깁니다. 뒤에서 협의 원장이라고 부르는 것이 이것입니다.

아래는 이 순서를 작은 기획 건 하나로 따라간 것입니다. 주문 상세 화면에 담당자가 메모를 남기는 기능이라고 해 두겠습니다.

기획: AI가 코드를 먼저 읽고 빈칸을 캐묻습니다​

기획자가 AI 도구에 이렇게 말하는 데서 시작합니다.

기획자

WMS-1234 기획 시작

AI는 Jira 티켓을 읽고 나서 기획자에게 묻기 전에 코드부터 봅니다. 잇Stock 코드베이스 전체에 자연어로 물어볼 수 있는 MCP 서버(AI 도구가 외부 자료를 조회하는 표준 연결 방식)를 두었기 때문에 "이미 있는 기능인가", "지금은 어떻게 동작하나" 같은 것은 코드에서 답을 찾습니다. 코드로 확인되지 않는 정책 판단만 기획자에게 묻습니다. AI-DLC에서 말하는 묻고 답하기가 기획 단계에서는 이렇게 시작됩니다.

그다음에야 기획자에게 첫 질문이 옵니다.

AI의 역질문

이 방향이 맞나요? 추가하거나 고칠 컨텍스트가 있나요?

첫 질문은 늘 방향 확인입니다. 기획 문서는 두 장인데 왜 만드는지와 범위를 적는 0_PRD.md를 먼저 확정하고 어떻게 동작하는지를 적는 1_PLANNING.md로 넘어갑니다. 두 번째 문서가 원장입니다.

원장을 쓰는 동안 AI는 예외, 상태 변화, 동시 작업, 권한, 성능 같은 열 가지 관점으로 빠진 조건을 찾습니다. 코드에 답이 있는 건 직접 조사하고 정책 판단이 필요한 것만 묻는데 한 번에 하나씩, 지금 어떻게 동작하는지를 장면으로 먼저 보여 주고 추천안을 붙이는 식입니다. 주문 메모 기능이라면 이런 질문이 옵니다.

AI의 역질문

메모를 누가 고칠 수 있을까요?

담당자 A가 "오후에 출고"라고 적었습니다. 다음 날 담당자 B가 보니 상황이 바뀌어 고치고 싶습니다. 지금 코드의 주문 수정 권한은 주문 조회 권한이 있는 사람 모두에게 열려 있습니다.

  • A. 주문을 볼 수 있는 사람은 누구나 고칠 수 있다 (추천). 메모는 인수인계용이라 작성자가 휴가면 막힙니다
  • B. 작성자만 고칠 수 있다

기획자는 선택지를 누르거나 다른 답을 적고 AI는 답을 받는 즉시 원장에 반영하고 다음 관점으로 넘어갑니다. 메모는 몇 자까지인지, 고치면 이전 내용을 남길지, 목록에서도 보일지가 이어서 나옵니다.

기획자가 기획하는 동안 한 고민은 이렇게 결정과 근거로 원장에 남습니다. 뒤에 오는 사람은 결론과 함께 버린 선택지와 그 이유까지 보게 됩니다.

원장: 완료 조건에 번호가 붙습니다​

질문이 한 바퀴 돌면 원장의 기능 블록 하나가 채워집니다. 동작 정의 표에는 정상 케이스와 예외 케이스가 번호를 달고 들어가고 저장 검증 표에는 사용자에게 보일 에러 메시지가 그대로 적힙니다.

저장 검증

case조건처리에러 메시지
1메모가 200자를 넘음저장 거부메모는 200자까지 입력할 수 있습니다

블록 끝에는 완료 조건이 옵니다.

완료 조건 (수락 기준)

  • AC-01 주문 조회 권한이 있는 담당자는 누구나 메모를 저장·수정할 수 있다
  • AC-02 메모는 200자까지 저장되고 201자부터 거부된다
  • AC-03 메모를 수정하면 이전 내용이 주문 변경 이력에 남는다

이 목록이 원장의 핵심입니다. 백엔드가 이 체크리스트를 테스트로 옮기고 QA가 테스트케이스로 옮기기 때문에 "정상 처리된다" 같은 문장은 쓸 수 없습니다. AC는 수락 기준(acceptance criteria)의 머리글자이고 번호는 문서 전체 연번으로 매깁니다. 블록 안의 순번으로 하면 블록을 재편할 때 번호가 같이 깨지고 그 번호를 가리키던 테스트와 테스트케이스가 전부 어긋나는데 실제로 한 번 겪고 나서 최근에 전체 연번으로 정했습니다.

아직 답을 못 받은 자리는 [열린 질문: …]으로 남겨 둡니다. 빈칸을 그럴듯한 문장으로 메워 두면 백엔드는 그것을 확정된 정책으로 알고 구현해 버립니다.

프로토타입: 글로 읽을 때는 안 보이던 것이 화면에서 보입니다​

기획 도중에 "내가 생각한 대로 가고 있나"를 확인하고 싶을 때가 옵니다. 그때 이렇게 말합니다.

기획자

WMS-1234 지금까지 기획한 거 화면으로 보자

원장에서 클릭할 수 있는 웹 프로토타입이 나옵니다. 기획이 끝날 때까지 기다릴 필요가 없고 몇 번이든 다시 만듭니다.

상세 기획에서 프로토타입을 생성하고 화면에서 발견한 빈 조건을 기획서에 반영한 뒤 다시 생성하는 반복 과정

고치는 대상은 기획서입니다. 프로토타입은 그 기획서에서 다시 만듭니다.

프로토타입은 원장에 없는 정책을 지어내지 않고 원장이 정하지 않은 자리를 화면에 [미정: …]으로 그대로 찍습니다. 기획자는 그 화면을 보고 정하고 결정을 원장에 적고 프로토타입을 다시 만듭니다. 프로토타입을 직접 고치면 그 순간부터 원장과 화면이 다른 말을 하게 됩니다.

확정: 명령 한 줄, 그리고 Jira​

기획이 채워졌으면 확정을 요청합니다.

기획자

WMS-1234 기획 마무리하자

AI가 필수 섹션이 비었는지, 완료 조건이 검증 가능한지, 두 문서가 같은 말을 반복하는지 검수합니다. 통과하면 원장이 status: 확정, version: v1.0이 되고 사양 허브에 올라갑니다. Jira 상태는 기획자에게 물어보고 동의할 때만 바꿉니다. 이 순간부터 디자이너와 백엔드 개발자가 이 문서를 읽고 일을 시작합니다.

디자인: 시안을 그리다 생긴 질문은 파일로 남깁니다​

디자이너는 확정된 원장과 프로토타입을 들고 Figma에서 화면을 설계합니다.

디자이너

WMS-1234 디자인 시작

시안은 링크만 남기는 대신 페이지 구조와 화면 이미지를 저장한 Figma 맵으로 만들어 티켓 폴더에 연결합니다. AI가 이 맵을 원장과 대조해 빠진 화면이나 상태를 찾아 디자이너와 확인합니다.

그리다 보면 원장이 정하지 않은 것이 나옵니다. 디자이너는 슬랙 대신 AI에게 묻습니다.

디자이너

WMS-1234 긴 메모는 상세 화면에서 몇 줄까지 보여 주면 돼?

AI는 원장을 먼저 찾아봅니다. 답이 있으면 어느 절에 있는지와 함께 알려 주고 없으면 그 자리에서 티켓 폴더의 qna/에 질문 파일 하나를 만듭니다. 어떤 상황에서 막혔는지, 디자이너가 무엇을 제안하는지, 이 답을 못 받으면 어떤 작업이 멈추는지가 파일에 적힙니다.

질문 파일 등록, Jira 멘션 알림, 기획자 답변, 원장 재확정, 뒤 단계 갱신으로 이어지는 협의 루프와 잠정 적용 규칙

답변만으로 해결되는 질문은 결론을 기록해 닫습니다. 정책을 바꿔야 할 때 기획서를 수정하고 다시 확정합니다. 그림 아래의 잠정 적용은 백엔드 소절에서 설명합니다.

파일을 올리면 Jira 코멘트 첫 줄에서 기획자가 실제로 멘션되어 알림이 갑니다. 기획자가 제안을 받아들이면 원장에 "AC-04 상세 화면에서 메모는 3줄까지 보이고 그 뒤는 펼쳐서 본다"가 한 줄 늘고 버전이 v1.1로 오릅니다. 질문 파일에는 결론과 반영 위치가 적히고 상태가 해소로 바뀝니다.

이 질문 파일 체계를 저희는 협의 원장이라고 부릅니다. 디자이너, 백엔드, 프론트, QA 누구의 질문이든 같은 자리에 파일 하나로 쌓이고 대면으로 답을 정했어도 결론은 파일에 옮깁니다.

디자인 시스템 문서도 코드에서 뽑습니다​

화면마다 공통으로 쓰는 디자인 시스템은 한 층 위에서 같은 원칙으로 다룹니다. AI가 읽는 디자인 시스템 문서를 사람이 쓰지 않고 프론트의 UI 킷 코드에서 생성합니다. 색 토큰과 CSS 규칙이 코드와 같은지 검사해 통과한 것만 게시하고 어느 커밋 기준인지 기록을 남깁니다. Figma, 코드, AI가 읽는 문서 세 곳이 서로 다른 디자인 시스템을 말하는 일을 막기 위해서입니다.

다음은 그리는 쪽입니다​

디자인 시스템이 코드와 맞춰지고 Figma 시안도 쌓였습니다. 디자이너가 기획서를 놓고 AI와 시안을 고르는 워크플로우를 만들었고, 지금은 시범 적용 단계입니다.

백엔드 시작: 코드부터 실측합니다​

백엔드는 원장이 확정되면 디자인과 나란히 시작합니다. 개발자는 자기 코드 저장소에서 말합니다.

백엔드 개발자

WMS-1234 백엔드 시작

코드 저장소에 설치한 플러그인이 사양 허브에서 그 티켓 폴더만 받아 오기 때문에 개발자가 문서 저장소를 따로 열 일은 없습니다.

AI는 원장을 읽고 나서 개발자에게 말을 걸기 전에 코드부터 봅니다. 주문 테이블에 메모를 담을 자리가 있는지, 주문 수정 API가 지금 어떤 필드를 받는지, 변경 이력은 어떤 구조로 쌓이는지를 파일과 줄 번호로 확인합니다. 그 뒤에 기획을 요약해 브리핑하고 어떻게 접근할지 개발자와 합의합니다.

합의가 되면 AI가 구현 메모를 씁니다. 신설하거나 고칠 API, 스키마 초안, 트랜잭션 경계, 구현 순서가 들어가고, 설계 결정에는 근거와 함께 기각한 대안도 적습니다. 설계가 갈리는 자리는 기획 단계에서 기획자에게 하던 것처럼 개발자에게 묻습니다.

AI의 역질문

메모 수정 이력을 어디에 남길까요?

지금 주문 변경 이력은 상태 전이만 기록하고 필드 값 변경은 남기지 않습니다. 완료 조건 AC-03은 이전 메모 내용이 이력에 남아야 한다고 적었습니다.

  • A. 기존 변경 이력 테이블에 메모 변경 유형을 추가한다 (추천). 화면이 이미 이 이력을 보여 주고 있습니다
  • B. 메모 전용 이력 테이블을 새로 만든다

구현 메모 끝에는 완료 조건 번호마다 어느 테스트가 그것을 증명하는지 적는 표가 붙습니다. AC-02에는 200자 저장과 201자 거부 테스트가 붙어서, 어느 조건이 백엔드 테스트로 이미 증명됐는지가 여기서 보입니다.

백엔드 구현: 원장이 침묵하면 잠정 적용​

구현은 조각으로 나눕니다. 조각마다 범위, 손댈 파일, 검증 방법을 적은 착수 계획을 만들고, 갈리는 결정은 개발자가 고른 뒤 AI가 구현하고 테스트합니다. 큰 티켓에서는 계획을 세우는 세션과 구현하는 세션을 나누고 결과를 감사하는 방식도 써 보고 있습니다.

구현 중에 원장이 정하지 않은 것을 만나는 일이 꽤 있습니다. 그때마다 멈추면 기획자가 하루 종일 답만 하게 되어서, 개발자는 권장안대로 먼저 구현하고 원장에 넣을 문장을 제안으로 남깁니다. 저희는 이걸 잠정 적용이라고 부릅니다. 원장에 적힌 문장을 뒤집어야 할 때만 멈추고 답을 기다립니다. 대신 승인되지 않은 제안이 남아 있으면 다음 단계로 넘기는 인계가 막힙니다.

백엔드 인계: 계약서는 코드에서 뽑습니다​

구현이 끝나면 인계를 요청합니다.

백엔드 개발자

WMS-1234 백엔드 인계

프론트와 QA가 읽을 인계 계약서가 만들어집니다. 사람이 쓰는 문서가 아닙니다. 코드에서 읽어 오는 스크립트(추출기)가 실제 컨트롤러와 DTO, 예외 정의에서 엔드포인트, 필드 제약, 열거형 값, 에러 코드를 뽑고, 로컬 서버의 OpenAPI 스냅샷을 옆에 저장합니다. 주문 메모라면 계약서에 이런 줄이 생깁니다.

1.1 엔드포인트

메서드경로설명
PATCH/orders/v1/{orderId}/memo주문 메모 저장·수정

1.4 필드 제약

필드타입필수제약
memostringN최대 200자

1.7 에러 계약

returnCode발생 조건사용자 문구
OR012메모가 200자를 넘음메모는 200자까지 입력할 수 있습니다

에러 문구는 원장의 에러 메시지 열에서 그대로 가져옵니다. 원장이 정본이라 디자이너와 백엔드가 각자 문구를 짓는 일이 없습니다.

개발자가 쓰는 것은 스크립트가 모르는 부분입니다. 화면이 먼저 불러야 하는 API, 선택지 데이터의 출처, 동시 편집 규칙, 기존 화면에 미치는 영향 같은 것들입니다.

인계 검사는 계약서와 코드를 다시 대조합니다. 계약서에 적힌 에러 코드가 코드에 없거나 열거형 값이 다르면 인계가 실패합니다. 계약서 맨 위에는 어느 원장 버전을 읽었는지가 source_planning_version으로 적히는데, 원장이 그보다 높아져 있으면 중간 저장 때 경고가 뜨고 인계 때 막힙니다. 원칙 2의 버전 검사가 여기서 작동합니다.

스크립트로 뽑게 된 것은 첫 인계의 경험 때문입니다. 그때는 AI가 구현 메모를 읽고 계약서를 썼는데, 프론트 쪽 검토에서 오류 12건이 나왔고 그 가운데 7건이 코드에 있는 사실을 잘못 옮긴 것이었습니다. 지금도 계약서는 프론트 개발자의 검토를 한 번 거쳐야 넘어갑니다.

프론트 시작: 화면은 시안으로, API는 계약서로​

프론트는 시안과 백엔드 계약서가 나온 뒤에 시작합니다. 백엔드가 기능 일부만 먼저 끝냈을 때는 그 범위만 담은 부분 인계로 넘겨서 프론트가 오래 기다리지 않게 합니다.

프론트 개발자

WMS-1234 프론트 시작

프론트 저장소에는 디자인 확인부터 명세, 계획, 구현, 테스트까지 이어지는 자체 워크플로우가 이미 있습니다. 플러그인은 그 흐름을 바꾸지 않고 티켓 폴더를 받아 오고, 질문을 협의 원장으로 보내고, 끝에서 검사하는 일만 보탭니다.

화면 표현은 Figma 맵에서 보고, 호출 순서와 화면 조건은 계약서에서 읽습니다. API 타입은 계약서에 딸린 OpenAPI 스냅샷으로 만들 수 있어서 백엔드가 통합 테스트 환경(INT)에 배포되기 전에도 붙일 수 있습니다. 예전에는 기획서를 읽고 API 형태를 추정했다가 틀려서 다시 맞추는 일이 흔했는데, 계약서가 코드에서 나오면서 그런 일이 줄었습니다.

명세를 쓰다 생긴 질문 가운데 프론트 안에서 닫히는 것은 워크플로우가 처리하고, 기획, 백엔드, 디자인이 답할 것만 개발자가 승인한 뒤 협의 원장에 파일로 올라갑니다.

AI의 역질문

메모 입력란에 글자 수 카운터를 보여 줄까요?

원장은 200자 제한만 정했고 시안에는 카운터가 없습니다. 프론트에서 정할 수 없는 화면 표현이라 디자이너에게 질문 파일로 보내려고 합니다.

  • A. 디자이너에게 질문 파일로 올린다 (추천)
  • B. 카운터 없이 진행한다

백엔드에 바꿔 달라고 할 것이 생기면 같은 자리에 변경 요청으로 올리고, 백엔드가 받아 구현하고 계약서를 갱신합니다. 원장을 바꾸는 요청이 아니면 기획자는 멈추지 않습니다.

구현에서 지킬 것은 둘입니다. 빈 화면, 에러, 권한 없음 상태가 정의돼 있어야 하고, 색은 디자인 시스템 토큰에서만 가져옵니다. 인계 문서에 색상 값을 직접 적으면 중간 저장 때 막힙니다.

프론트 인계: 화면 문구를 시안과 대조합니다​

프론트 개발자

WMS-1234 프론트 인계

프론트도 코드에서 계약서를 뽑습니다. 스크립트가 파일 기반 라우트, 실제 API 호출 경로, 번역 카탈로그에 든 화면 문구, 권한 가드, 테스트용 셀렉터를 읽어 옵니다.

화면 문구는 Figma 맵의 문자열과 대조합니다. 주문 메모라면 이런 결과가 나옵니다.

4.1 화면 문구 대조

화면시안코드판정
주문 상세메모 저장저장편차 후보

편차 후보가 나오면 개발자가 코드를 고치거나, 일부러 다르게 한 것이면 의도적 편차로 선언해 둡니다. QA가 찾던 결함 가운데 가장 많았던 "기획과 상이"가 QA 전에 걸러지는 셈입니다.

계약서 끝에는 QA 인계 메모가 붙습니다. 어느 환경의 어느 빌드인지, 미리 넣어 둘 데이터와 테스트 계정 역할이 무엇인지, 영향받은 기존 화면이 어디인지가 적히고, 완료 조건 번호마다 어느 화면에서 확인하는지도 같이 갑니다.

QA: 완료 조건이 테스트케이스가 됩니다​

QA는 기준을 물어보러 다니지 않고 원장의 완료 조건을 그대로 읽습니다.

QA

WMS-1234 테스트케이스 뽑아줘

AI가 원장의 완료 조건과 동작 정의, 백엔드·프론트 계약서, Figma 맵을 읽어 QA팀 양식의 테스트케이스를 만듭니다. 정본은 qa/tc.yaml이고 QA가 쓰는 엑셀은 여기서 생성합니다. 아래는 QA팀 양식 가운데 핵심 열만 보인 것입니다.

TC IDAC IDStep기대 결과
TC-013AC-02 (경계)메모에 201자 입력 후 저장저장 거부. 문구 "메모는 200자까지 입력할 수 있습니다"

이 한 줄은 원장 완료 조건 AC-02가 "201자부터 거부"라고 적었기 때문에 생겼습니다. 기획 단계의 결정 하나가 테스트 한 줄로 그대로 내려온 것이고 AC ID 열이 원장 번호를 가리키고 있어서 원장이 바뀌면 어느 테스트를 고쳐야 하는지도 따라갑니다.

테스트케이스에는 자동과 수동 표시가 붙습니다. 화면에서 입력하고 문구와 상태를 확인하는 종류는 자동으로 분류되고 프론트 인계가 끝나 라우트와 문구가 코드로 확인된 뒤에 돌립니다.

QA

WMS-1234 TC 자동 실행

AI가 테스트 환경에서 브라우저를 열고 자동 항목을 시트 순서대로 실행합니다. 위 TC-013이면 주문 상세를 열어 메모에 201자를 넣고 저장을 누른 뒤 거부 문구가 화면에 찍히는지 확인합니다.

합격과 불합격은 AI가 판단하지 않습니다. AI가 하는 일은 테스트케이스 문장을 실행 스크립트로 옮기는 것까지이고 판정은 스크립트의 단언이 내립니다. 문구가 포함됐는지, 요소 상태가 맞는지, API 응답이 기대값인지를 기계가 비교합니다. AI가 화면을 보고 "맞는 것 같다"고 적으면 같은 테스트를 두 번 돌릴 때 결과가 갈리기 때문입니다. 시안 배치처럼 기계로 잴 수 없는 항목만 예외로 시각 판정 표시를 달아 둡니다.

결과는 테스트케이스 정본의 같은 항목에 적히고 단계마다 찍은 화면과 API 요청·응답이 증거로 티켓 폴더에 남습니다. QA가 쓰는 엑셀의 결과 열은 여기서 다시 생성합니다. 테스트케이스 자체가 틀린 경우도 나오는데 그런 항목은 피드백 파일에 쌓여 다음 테스트케이스 갱신 때 반영됩니다. 사람이 하는 QA는 자동 항목이 통과한 뒤 수동 항목에 집중합니다.

챗봇: 매뉴얼도 원장에서 나옵니다​

잇Stock에는 사용자가 화면 사용법과 규칙을 묻는 운영 챗봇이 있습니다. 기획이 확정되면 그 챗봇이 읽는 지식 문서 초안을 원장에서 만들어 기능이 나가는 릴리스에 함께 싣습니다. 사람은 처음부터 쓰지 않고 초안을 검토합니다.

완료 조건 AC-01은 "주문을 볼 수 있는 담당자는 누구나 메모를 고칠 수 있다"는 동작 설명으로 바뀌어 들어갑니다. 담당자가 챗봇에 "주문 메모를 다른 사람이 고칠 수 있나요"라고 물으면 이 문장으로 답합니다.

이 과정에서 남는 파일들​

티켓 하나를 끝까지 따라가면 폴더에 이렇게 남습니다.

plans/<티켓>-<슬러그>/
├ 0_PRD.md 배경·목적·범위
├ 1_PLANNING.md 동작·정책·완료 조건을 담은 원장
├ prototype/ 기획서에서 생성한 프로토타입
├ design/ Figma 맵 연결과 디자인 검토
├ 2_BACKEND.md 백엔드 설계·구현 메모
├ backend/ 작업 조각별 착수 계획
├ 2_BACKEND_CONTRACT.md 백엔드 인계 계약 (코드에서 추출)
├ api/ OpenAPI 스냅샷과 추출 결과
├ 3_FRONTEND.md 프론트 구현 메모
├ 3_FRONTEND_CONTRACT.md 프론트 인계 계약 (코드에서 추출)
├ frontend/ 프론트 추출 결과
├ qa/tc.yaml 테스트케이스 원본
├ qa/evidence/ 자동 실행 증거 (화면·API 응답)
├ qa/tc-feedback.md 테스트케이스 자체의 수정 요청
└ qna/ 질문·답변·변경 제안

담당자가 바뀌어도 같은 자리에서 기획과 구현 근거, 질문의 결론을 찾을 수 있고 다음 사람의 AI에게도 이 폴더를 넘깁니다.

그리고 있는 하루​

저희가 가려는 곳은 낮에 사람이 결정하고 밤에 AI가 구현하고 아침에 사람이 검토해 승인하는 하루입니다. AWS가 말한 몇 시간이나 며칠 단위의 짧은 주기를 저희는 이 하루로 그리고 있습니다.

최종 목표: 낮에 사람이 범위와 검증 기준을 확정하고 밤에 AI가 구현·테스트한 뒤 아침에 사람이 결과를 검토하고 승인하는 하루

밤의 AI는 확정된 범위 안에서만 움직이고 원장은 아예 고칠 수 없으며 새로운 정책 판단이 필요하거나 허용한 범위를 벗어나면 멈춰야 합니다. 아침의 사람은 결과와 검증 근거, 미해결 질문을 보고 승인 여부를 정합니다. 백엔드 소절에서 말한 계획 세션과 구현 세션을 나누는 방식이 이 밤 버전의 연습입니다.

디자인도 같은 자리를 향합니다. 단순하고 반복되는 화면은 AI가 디자인 시스템으로 초안을 그리고 디자이너는 아침에 그 초안을 승인하거나 고칩니다. 디자이너의 손은 새로운 화면과 판단이 필요한 자리에만 갑니다. 시범 적용 중인 그 워크플로우가 낮 버전입니다.

사람이 자리를 비운 동안에도 작업을 맡기려면 AI가 참조할 기준, 스스로 결정할 수 있는 범위, 멈춰야 할 조건이 남아 있어야 합니다. 이 글에 적은 절차는 그 기준과 범위와 멈춤 조건을 파일로 남기는 연습이고 아직 낮 버전까지 와 있습니다.