SRS(Software Requirements Specification) 작성기

SRS는 죽지 않았다. AI 제품 시대에 맞게 진화했을 뿐이다

Software Requirements Specification은 평판 문제를 안고 있습니다. 많은 프로덕트 매니저와 엔지니어에게 SRS라는 약어는 워터폴 시대에 쓰이던 200페이지 문서를 떠올리게 합니다. 실제 제품은 사방으로 달라지고 있는데 SharePoint 폴더 안에서 먼지만 쌓이는 문서 말이죠. 애자일 운동은 포괄적 문서보다 작동하는 소프트웨어를 우선하라고 가르쳤고, 그 과정에서 SRS는 희생양이 됐습니다.

하지만 SRS가 해결하려던 문제는 사라지지 않았습니다. 오히려 더 강해졌습니다. 제품에 머신러닝 모델, 서드파티 AI 서비스, 점점 더 복잡한 데이터 파이프라인이 들어오면서 이해관계자가 기대하는 것과 엔지니어가 실제로 만드는 것 사이의 간극은 더 벌어졌습니다. Project Management Institute의 2023 보고서에 따르면 프로젝트의 39%는 부정확한 요구사항 때문에 실패합니다. 별도로 Geneca 연구는 비즈니스와 IT 임원의 75%가 소프트웨어 프로젝트가 시작되기도 전에 실패할 것이라 예상한다고 밝혔는데, 그 큰 이유가 바로 요구사항의 모호성입니다.

문제

애자일 사용자 스토리(user story)는 점진적인 기능 개발에는 잘 맞습니다. 하지만 아래와 같은 내용을 명세해야 할 때는 한계가 드러납니다.

• AI 모델 동작 경계(AI model behavior boundaries) — 허용 가능한 오류율, 편향 임계값(bias threshold), fallback 동작
• 데이터 계약(Data contracts) — 여러 팀이 의존하는 서비스 간 규약
• 컴플라이언스 및 규제 요구사항 — 두 줄짜리 스토리로 담을 수 없는 요구
• 시스템 통합 명세(System integration specifications) — 엔터프라이즈 인프라와 연결되는 제품의 경우

user story 형식은 애초에 이 무게를 감당하도록 설계되지 않았습니다. 지금 팀에 필요한 것은 예전식 워터폴 SRS가 아니라, 프로젝트를 죽이는 모호성을 막을 만큼 충분히 구조화되어 있으면서도 살아 있고 협업 가능한 현대적 요구사항 문서입니다.

이 프롬프트의 작동 방식

SRS 작성기(SRS Generator) 프롬프트는 제품에 맞춘 현대적인 Software Requirements Specification을 생성합니다. 제품 맥락, 핵심 기능, 기술적 제약을 입력하면 다음을 만들어줍니다.

• 기능 요구사항(Functional requirements) — 기능 영역별 정리와 acceptance criteria 포함
• 비기능 요구사항(Non-functional requirements) — 성능, 보안, 확장성, 접근성 포함
• AI 특화 요구사항(AI-specific requirements) — 모델 동작 명세, 데이터 요구사항, 윤리적 가드레일
• 통합 명세(Integration specifications) — API, 데이터 플로우, 서드파티 의존성
• 추적성 매트릭스(Traceability matrix) — 요구사항과 비즈니스 목표 연결

언제 사용할까

• 여러 엔지니어링 팀이 관여하는 대형 제품 이니셔티브를 시작할 때
• 명시적인 동작 명세가 필요한 AI 기능을 만들 때
• 모호하지 않은 scope 정의가 필요한 외부 벤더 또는 계약자를 참여시키기 전
• 규제 준수상 문서화되고 추적 가능한 요구사항이 필요한 경우

흔한 함정

• SRS를 일회성 산출물로 취급하기. 현대적인 SRS는 versioning, review, update가 계속 이뤄져야 합니다.
• 구현 세부사항을 과하게 명시하기. 요구사항은 무엇과 왜를 정의해야지, 어떻게를 규정해서는 안 됩니다. 아키텍처 결정은 엔지니어링 팀에 맡기세요.
• 비기능 요구사항을 무시하기. 성능, 보안, 접근성은 나중에 붙이는 옵션이 아닙니다. 그것도 요구사항입니다.
• 고립된 상태에서 요구사항 작성하기. 최고의 SRS는 제품, 엔지니어링, 디자인이 함께 작성해 실현 가능성과 완결성을 동시에 확보합니다.

참고 자료

• IEEE 830 Standard for SRS provides the foundational structure that modern SRS documents adapt.
• PMI Pulse of the Profession 2023 documents the ongoing impact of requirements failures on project success.
• Martin Fowler: Is Design Dead? explores the tension between upfront specification and evolutionary design in agile environments.