개발 요청서는 AI 시대에 어떻게 바뀌어야 할까?
AI가 업무지시를 읽고 코드까지 수정하는 시대에는 개발 요청서도 달라져야 합니다. 구현 방법보다 문제, 범위, 제약, 완료 기준을 명확히 하는 쪽으로 요구사항의 역할을 다시 생각해봤습니다.
개발 요청서를 쓸 때 예전에는 주로 개발자에게 어떻게 설명할 것인가를 고민했습니다.
어떤 화면인지, 어떤 기능이 필요한지, 현재 무엇이 불편한지, 어떻게 바뀌었으면 하는지.
그리고 그 문서를 사람이 읽고, 질문하고, 개발하고, 다시 결과를 보여주는 흐름이 자연스러웠습니다.
그런데 AI가 실제 프로젝트를 읽고, 업무지시를 확인하고, 관련 코드를 찾아 수정하고, 테스트까지 수행할 수 있게 되면서 개발 요청서를 보는 관점이 조금 달라졌습니다.
이제 개발 요청서는 사람에게 전달하는 문서만은 아닐 수 있다.
AI도 읽고 실행할 수 있는 입력이 된다면 요구사항은 어떻게 달라져야 할까요?
짧은 지시가 좋은 요구사항은 아니다
AI에게 일을 맡기다 보면 짧은 문장 하나로도 수정이 되는 경험을 자주 합니다.
버튼을 오른쪽으로 옮겨줘.
이 화면에 검색을 추가해줘.
모바일에서 여백을 줄여줘.
작은 수정이라면 이 정도로 충분할 때도 있습니다.
하지만 기능의 범위가 조금만 커지면 문장의 길이보다 빈칸의 개수가 더 중요해집니다.
“검색을 추가해줘”라는 요청에는 생각보다 많은 빈칸이 있습니다.
무엇을 검색하는가?
누가 사용하는가?
기존 필터와 어떤 관계인가?
검색 결과가 없으면 어떻게 보이는가?
권한에 따라 결과가 달라지는가?
사람끼리는 회의나 대화에서 이 빈칸을 자연스럽게 채울 수 있습니다.
AI는 요청서와 현재 시스템을 바탕으로 스스로 추론하게 됩니다.
문제는 그 추론이 PM이 생각한 기준과 같다는 보장이 없다는 것입니다.
그래서 좋은 요구사항은 길게 쓰는 문서라기보다
AI와 사람이 서로 다르게 해석할 수 있는 빈칸을 줄이는 문서
에 가깝다고 생각합니다.
해결 방법보다 문제를 먼저 적는다
개발 요청서를 쓰다 보면 문제보다 해결 방법을 먼저 적는 경우가 많습니다.
버튼을 하나 추가한다.
팝업을 띄운다.
엑셀 다운로드 기능을 넣는다.
이 위치에 탭을 만든다.
요청하는 입장에서는 구체적이라 좋습니다.
하지만 이렇게 시작하면 실제로 해결해야 하는 문제가 뒤로 밀릴 수 있습니다.
예를 들어:
요청
"엑셀 다운로드 버튼을 추가해주세요."
실제 문제
"사용자가 매주 같은 데이터를 복사해서 보고서를 만들고 있다."
이 둘은 같은 이야기가 아닙니다.
엑셀 다운로드가 정답일 수도 있지만, 정기 보고서를 자동으로 생성하는 편이 더 나을 수도 있습니다.
AI가 구현을 쉽게 해줄수록 처음 떠오른 해결책을 그대로 만드는 것도 쉬워집니다.
그래서 더 먼저 적어야 할 것은 어떻게 만들 것인가보다 왜 필요한가라고 생각합니다.
AI가 읽기 좋은 요청서는 사람에게도 읽기 좋았다
실제로 업무지시를 AI가 읽게 해보면 좋은 요청서의 조건이 꽤 선명해집니다.
제가 중요하다고 느낀 것은 대략 다섯 가지입니다.
1. 문제
2. 기대 결과
3. 범위
4. 제약
5. 완료 기준
복잡한 양식이라기보다 AI와 사람이 같은 그림을 보기 위한 최소한의 구조입니다.
1. 무엇이 문제인가
가장 먼저 필요한 건 기능명이 아니라 현재 문제입니다.
예를 들어:
나쁜 시작
"담당자 자동지정 기능 추가"
더 나은 시작
"업무 등록 때마다 담당자를 수동으로 선택하고 있다.
반복되는 선택이 많고 잘못 지정되는 경우가 있다."
두 번째 문장을 보면 자동지정이 정말 필요한지, 기본값만 있으면 되는지, 추천만 해주면 되는지까지 생각할 수 있습니다.
AI에게도 마찬가지입니다.
문제를 알면 현재 코드를 살펴보면서 다른 해결 방법을 제안할 수 있습니다.
2. 어떤 상태가 되면 좋은가
문제만 적으면 해결 방향이 너무 넓어질 수 있습니다.
그래서 기대 결과가 필요합니다.
"업무 등록 시 프로젝트의 기본 담당자가 자동으로 선택되고,
사용자는 필요한 경우에만 변경할 수 있다."
이 정도면 구현 방법을 지나치게 고정하지 않으면서도 도착점은 분명합니다.
여기서 중요한 건 화면 모양보다 사용자의 행동이 어떻게 달라지는가입니다.
현재
매번 담당자를 찾고 선택
변경 후
기본 담당자가 이미 선택되어 있고
예외일 때만 수정
이렇게 쓰면 기능이 아니라 업무 흐름의 변화를 설명할 수 있습니다.
3. 어디까지 만들 것인가
AI 개발에서 특히 중요한 부분이 범위라고 느꼈습니다.
AI는 요청받은 일을 빠르게 확장할 수 있습니다.
그런데 우리가 원하는 것은 항상 가장 큰 구현이 아닙니다.
예를 들어:
이번 범위
- 신규 등록 화면에서만 적용
- 기존 데이터는 변경하지 않음
- 관리자 설정 화면은 만들지 않음
이런 내용이 있으면 불필요한 개발을 막을 수 있습니다.
반대로 이것이 없으면 AI가 친절하게 주변 기능까지 수정하면서 작업 범위가 커질 수도 있습니다.
무엇을 하는가만큼 무엇을 하지 않는가도 요구사항입니다.
4. 건드리면 안 되는 것은 무엇인가
기존 시스템을 수정할 때는 새 기능보다 제약 조건이 더 중요할 때가 있습니다.
기존 권한 체계는 유지
기존 API 응답 구조는 변경 금지
모바일 화면에서도 동작해야 함
기존 데이터 마이그레이션은 하지 않음
사람 개발자라면 경험을 통해 이런 부분을 먼저 물어볼 수도 있습니다.
AI는 현재 코드를 분석해서 어느 정도 추론할 수 있지만, 중요한 제약은 명시하는 편이 안전합니다.
특히 AI가 코드를 수정할 수 있는 범위가 넓어질수록 변경하지 말아야 할 경계를 알려주는 것이 중요해집니다.
5. 언제 끝난 것으로 볼 것인가
제가 가장 중요하게 보게 된 부분입니다.
기존 요청에서는 “기능 추가해주세요”로 끝나는 경우가 많았습니다.
그런데 AI에게 실행까지 맡기려면 완료 상태가 필요합니다.
완료 기준
- 신규 업무 등록 시 기본 담당자가 자동 선택된다.
- 사용자가 다른 담당자로 변경할 수 있다.
- 담당자 정보가 없는 경우 기존 방식으로 동작한다.
- PC와 모바일에서 동일하게 동작한다.
- 기존 등록 데이터에는 영향이 없다.
이 기준이 있으면 AI도 구현 이후 무엇을 확인해야 하는지 알 수 있습니다.
사람도 결과를 볼 때 느낌이 아니라 기준으로 판단할 수 있습니다.
즉 요구사항이 설명 문서에서 검증 기준으로 확장됩니다.
그래서 요청서가 테스트의 시작점이 된다
이전에는 요구사항과 테스트가 분리되어 있는 경우가 많았습니다.
요구사항 작성
→ 개발
→ 테스트할 항목 다시 정리
하지만 완료 기준이 명확하면 처음부터 테스트 항목이 보입니다.
요구사항
→ 완료 기준
→ 구현
→ 기준대로 테스트
→ 결과 확인
AI가 테스트 코드나 검증 절차까지 작성할 수 있다면 이 연결은 더 강해질 수 있습니다.
좋은 요구사항은 개발 시작 문서이면서 동시에 테스트의 초안이 되는 셈입니다.
개발 요청서와 프롬프트의 경계도 흐려진다
AI 개발 도구를 쓰다 보면 개발 요청서와 프롬프트가 점점 비슷해집니다.
하지만 저는 둘이 완전히 같아져서는 안 된다고 생각합니다.
프롬프트는 그 순간 AI에게 내리는 실행 지시일 수 있지만, 업무 요청은 나중에도 남아야 하는 기록입니다.
왜 이 기능을 만들었는가
누가 요청했는가
어떤 판단을 했는가
어디까지 만들기로 했는가
완료 기준은 무엇이었는가
이 정보는 기능이 완성된 뒤에도 가치가 있습니다.
그래서 업무 시스템에 남는 요구사항은 AI에게 실행시키기 위한 명령보다 더 오래 살아남아야 합니다.
“자세히 쓰기”와 “길게 쓰기”는 다르다
여기서 요구사항을 더 길게 써야 한다는 뜻은 아닙니다.
오히려 AI 시대에는 불필요한 설명을 길게 쓰는 것보다 구조가 명확한 짧은 요청이 더 좋을 수 있습니다.
예를 들어:
문제
업무 등록 때 담당자를 매번 수동 선택하고 있음.
기대 결과
프로젝트 기본 담당자가 자동 선택됨.
범위
신규 업무 등록에만 적용.
제약
기존 데이터와 권한 구조는 변경하지 않음.
완료 기준
기본값 자동 적용 / 수동 변경 가능 / 기본값 없으면 기존 방식 유지.
이 정도만 있어도 상당히 많은 대화가 줄어듭니다.
중요한 건 문서의 분량이 아니라 판단에 필요한 정보가 빠져 있지 않은가입니다.
AI가 질문하도록 만드는 것도 방법이다
모든 요구사항을 처음부터 완벽하게 쓸 수는 없습니다.
오히려 그렇게 하려고 하면 요구사항 문서 자체가 지나치게 무거워집니다.
그래서 저는 앞으로 이런 흐름도 자연스럽다고 생각합니다.
사람이 문제와 목표를 작성
→ AI가 현재 시스템 확인
→ 모호한 부분 질문
→ 사람이 판단
→ 범위 확정
→ AI가 구현
AI가 단순히 명령을 받는 존재가 아니라 요구사항의 빈칸을 찾아주는 역할도 하는 것입니다.
이때 사람이 해야 하는 일은 모든 기술 내용을 미리 아는 것이 아니라 AI가 던진 질문에 대해 제품과 업무 관점에서 판단하는 것입니다.
’하지 않을 것’도 요구사항이다
개발 요청서에는 무엇을 만들 것인지만 적는 경우가 많습니다.
그런데 AI가 현재 코드를 읽고 주변 기능까지 함께 해석하기 시작하면 이번 작업에서 건드리지 않을 범위도 중요해집니다.
이번 작업에 포함
- 프로젝트명 검색
- 상태 필터
이번 작업에서 제외
- 통합 검색
- 자동완성
- 검색 결과 다운로드
이렇게 적어두면 작업이 옆으로 번지는 것을 막을 수 있습니다.
완료 기준도 같은 역할을 합니다.
검색어 입력
→ 해당 항목만 표시
→ 결과 없음 상태 확인
→ 기존 필터와 함께 동작
이 기준이 있으면 AI도 어디까지 확인해야 하는지 알 수 있고, 사람도 결과를 같은 기준으로 검토할 수 있습니다.
좋은 요구사항은 AI에게 많은 일을 시키는 문서가 아니라
이번에 해야 할 일과 하지 않을 일을 동시에 정하는 문서
에 가깝습니다.
개발 요청서는 실행 명세에 가까워질 수 있다
기존 개발 요청서는 사람과 사람 사이의 전달 문서에 가까웠습니다.
앞으로는 조금 다를 수 있습니다.
업무 요청
→ AI가 읽음
→ 현재 시스템 분석
→ 필요한 질문
→ 사람 판단
→ 구현
→ 테스트
→ 결과
이 흐름에서는 요구사항이 단순한 설명을 넘어 실제 실행을 시작시키는 입력이 됩니다.
그래서 저는 앞으로 좋은 개발 요청서가 이런 형태에 가까워질 것이라고 생각합니다.
사람에게는 판단의 근거가 되고,
AI에게는 실행의 기준이 되는 문서.
AI 시대의 요구사항은 개발자에게 기능을 전달하는 문서에서 사람과 AI가 같은 문제를 이해하기 위한 실행 명세로 조금씩 바뀌고 있는 것 같습니다.