요구사항에서 검증까지

무엇을 만들지 정하는 순간부터 변경 후 무엇이 지켜졌는지 판단할 때까지 필요한 노트를 잇는다. 요구의 도출, 표현, 구현의 책임, 검증의 증거를 순서대로 읽는다.

어떤 문제를 해결할 것인가

• 실제 업무와 문서의 차이, 예외·임시 처리: 현행 업무 분석에는 예외와 임시 처리까지 포함한다
• 사용자 목적을 잃지 않는 구체화와 판정 조건: 요구사항을 구체화할 때 사용자 목적과 판정 조건을 함께 보존한다
• 근거·설계·구현·검증의 연결과 변경 영향: 요구사항의 변경 영향은 설계·구현·검증 연결로 추적한다

어떤 관계를 드러낼 것인가

• 구조·흐름 등 질문에 맞는 표현: 다이어그램 유형은 보여줄 관계에 맞춰 고른다
• 역할·순서·분기·경계를 남기는 축약: 다이어그램을 축약할 때는 핵심 관계를 보존하고 생략을 기록한다

구현 구조에 무엇을 보존할 것인가

• 서로 다른 개념을 억지로 공유한 경계의 재검토: 서로 다른 변경 이유를 억지로 묶은 추상화는 분리해 다시 찾는다
• 입력 검사에서 얻은 조건을 후속 코드에 전달하기: 후속 코드가 의존할 입력 조건은 자료형과 구조에 보존한다
• 두 주장의 원문과 적용 조건: 잘못된 추상화와 입력 조건 보존 - 개발 글 검토

어디에서 무엇으로 검증할 것인가

• 시나리오·오라클·범위·위험과 커버리지의 구분: 테스트 설계는 시나리오 오라클 범위와 위험을 별도 축으로 다룬다
• 규칙의 책임 경계와 실제 의존성: 규칙은 소유한 가장 좁고 안정적인 공개 경계에서 깊게 테스트한다
• 구현과 독립적인 기대값: Golden 기대값은 구현과 독립적으로 도출하고 계약상 의미만 고정한다
• 로컬 통과 뒤 남는 실환경 증거: 로컬 에뮬레이터 한계는 별도 검증 게이트가 된다
• 규칙 전달·위반 판정·진행 차단의 구분: 규칙을 다시 전달하는 것과 위반을 판정하는 것은 다르다
• 기존 위반을 남겨 둔 검사의 통과 의미와 개선 추적: 규칙 검사를 점진적으로 도입할 때 기존 위반의 기준선을 관리한다

에이전트가 구현과 검증을 수행할 때

• 사람의 목적·주요 결정, 모델의 생성, 실행 엔진의 진행 제어를 나눈 사례: AI-DLC의 책임 분리와 작업 맥락 - 권동인
• 파일·터미널 직접 접근과 개발자의 판단 변화: 에이전틱 개발 환경과 개발자의 판단 - SK AX
• 도구 연결 이후의 선행 조건·실행 순서·결과 수용: 도구·에이전트 연결과 작업 흐름 제어는 별도로 설계한다
• 테스트 실행 완료와 대상 동작의 통과: 테스트 수행 완료와 대상 동작의 통과 여부를 별도로 판정한다

검사 실행을 위임할 때도 위 「어디에서 무엇으로 검증할 것인가」의 시나리오·오라클·범위를 적용한다. 필요한 절차의 깊이는 현재 요청과 변경의 실패 비용에 맞춘다.

AI 과업의 평가 기준을 정할 때

• 실제 서비스의 수용 조건부터 정하기: 모델 성능과 AI 서비스의 도입 적합성은 별도로 평가한다
• 형식과 판단을 나눠 확인하기: 출력 형식 준수와 업무 규칙에 따른 판단은 별도로 평가한다
• 평가 자료의 구성과 독립 대조: 업무용 벤치마크는 구성에 쓰지 않은 실제 과업과 대조한다
• 재측정의 원인을 설명할 조건 기록: AI 품질 비교에는 생성 조건과 채점 조건을 함께 보존한다
• 테스트의 변경 제약과 결함 탐색을 함께 읽기: 테스트의 회귀 보호와 결함 탐색 - Yosef K

변경 후 어떤 결론을 낼 것인가

• 구조 정리와 의도한 동작 변경: 외부 동작을 바꾸는 개선은 리팩토링과 구분한다
• 근거가 서로 다른 판정들을 비교: 보장 수준과 판정 경계

원천과 적용 맥락

• Motifcode의 저장소 구조와 이슈·PR 운영 — 공개 팀 프로젝트와의 비교: 외부 기여를 받는 프로젝트의 이슈·PR 작성 패턴, 라벨·브랜치, 검토·배포 연결을 공개 팀 프로젝트와 비교한 사례.

• 문서로만 지키던 아키텍처 규칙, 테스트 코드로 강제하기 - 박공손: 구조 계약의 실행 검사와 기존 위반의 단계적 해소 사례.

• AI는 개발자의 역할을 어떻게 바꾸고 있나 - Matej Bukovinski: 목표 정의·에이전트 실행·검증을 연결하는 외부 조직 사례. 기업 내부의 운영 선택과 일반적인 전망을 구분한다.

• 소프트웨어 분석설계 - WikiDocs: 공개 목차 전체의 확인 범위, 기존 개인·로컬 프로젝트 노트 대조, 원문의 교정·보류 항목.

• 프로젝트 도메인 탐색: 구체적인 프로젝트의 적용 원천으로 이동한다.

• Maps