기능을 더하는 것보다 먼저, 시작 순서를 바꿨습니다
안녕하세요. 업무 아이디어를 제작 요청문으로 정리하는 ‘내편정보’를 만들고 있는 이호진입니다. 코딩 에이전트로 업무 도구를 만들어 보고 싶어도, 처음부터 무엇을 입력하고 무엇을 확인해야 할지 막막할 수 있습니다.
초기 화면에는 여러 기능을 한꺼번에 보여주려 했습니다. 그런데 시작부터 복잡하게 느껴져, 프로그램 이름부터 한 번에 한 질문씩 답하는 10단계 흐름으로 다시 구성했습니다. 이 글은 도구 소개와 함께, 만들면서 적용한 요구사항 정리 방법을 공유하는 글입니다.
적용한 방법: 질문 → 제작 요청문 → 사람의 확인
개발에는 Codex를 활용했습니다. 내편정보에서는 프로그램 이름, 사용자, 해결할 문제, 핵심 기능 등 10개 답변을 정리하고, 요구사항·예외 처리·보안·시험 기준을 포함한 제작 프롬프트를 만듭니다. 아직 아이디어가 없다면 ‘예제 기획으로 체험하기’로 가상의 ‘부서 제출자료 누락 점검기’를 살펴볼 수 있습니다.
프롬프트를 만들 때는 기능 이름만 나열하지 않고 다음 네 가지를 함께 적도록 구성했습니다.
입력: 어떤 자료를 받고, 어떤 열이나 값이 필요한가?
처리: 중복·누락·잘못된 값을 어떻게 구분하는가?
출력: 담당자가 무엇을 확인하고 내려받는가?
완료 기준: 어떤 가상 입력에서 어떤 결과가 나와야 하는가?
직접 따라 해볼 수 있는 요청문
아래는 위 예제를 설명하기 위해 재구성한 연습용 프롬프트 전문입니다. 실제 기관 자료나 운영 실적이 아닙니다. 내편정보 없이도 자신의 업무에 맞게 바꿔볼 수 있습니다.
부서 제출자료 누락 점검기를 만드는 계획과 실행 가능한 초안을 작성해 주세요.
목적: 담당자가 제출 대상과 제출 현황을 비교해 미제출·중복·확인 필요 항목을 구분한다.
입력: 가상의 CSV 두 개. 대상 목록은 부서코드, 부서명, 제출항목을 포함하고, 제출 현황은 부서코드, 제출항목, 제출일을 포함한다.
처리: 부서코드와 제출항목을 기준으로 비교한다. 값이 비어 있거나 대상 목록에 없는 코드는 임의 보정하지 말고 확인 필요로 표시한다. 같은 키가 여러 번 있으면 중복으로 표시하고, 미제출과 구분한다.
출력: 전체 대상 수, 제출·미제출·중복·확인 필요 목록과 CSV 다운로드. 원본 파일은 수정하지 않는다.
개인정보: 실제 이름·연락처·내부 문서는 사용하지 않는다. 입력 파일은 브라우저 안에서 처리하고 외부 서버로 보내지 않는다.
검증: 정상 제출, 미제출, 중복 제출, 잘못된 열 이름, 빈 파일을 각각 시험한다. 결과와 남은 제한을 설명한다.
진행: 모호한 판단 기준은 먼저 질문한다. 불필요한 로그인·결제·클라우드 저장을 추가하지 않는다. 완성했다고 말하기 전에 실행 방법과 시험 결과를 제공한다.이번 구현에서 바꾼 점과 남은 한계
시작 화면의 정보량을 줄이고, 설치 없이 예제로 들어갈 수 있는 진입점을 넣었습니다.
기획 이어쓰기와 JSON 백업·복원을 넣었습니다. 다만 현재 브라우저 저장이며 PC 간 자동 동기화는 아닙니다.
소스·ZIP 간이 분석은 브라우저의 별도 작업 스레드에서 처리하고, 진행 상태와 취소를 제공합니다.
현재 프롬프트 작성은 규칙·템플릿 기반입니다. 사이트 안에서 외부 생성형 AI가 코드를 실행·수정하지 않습니다. 실제 제작은 별도 개발 도구에서 진행하며 해당 도구의 인증·비용·기관 이용 정책을 확인해야 합니다.
코드 검사는 간이 패턴 점검이고, 정보화사업 검토와 FP 산정은 참고용입니다. 보안 인증·공식 판단·확정 견적을 대신하지 않습니다. 이 도구는 개인 프로젝트이며 기관의 공식 서비스가 아닙니다. 아직 사용자 규모나 시간 절감 효과를 검증했다고 주장할 단계는 아닙니다.
어떤 질문에서 가장 막히시나요?
예제를 한 번 살펴보고, ‘사용자 정의’, ‘필요한 기능’, ‘시험 기준’ 중 어떤 부분이 가장 설명하기 어려운지 알려주시면 도움이 됩니다. 댓글과 체험 입력에는 개인정보·비공개 업무자료를 넣지 말아주세요.
내편정보 바로 체험하기
코드·사용 안내 보기 — 전체 소스는 저장소에 안내된 ZIP 배포본을 사용합니다.
사람을 위한 기술, 언제나 당신 편.
아래 이미지는 실제 화면 캡처가 아니라 사용 순서를 설명한 안내 이미지입니다. 글과 안내 이미지 제작에는 AI를 활용했습니다.
