Devin.KR

AI 개발 · 실무

AI와 함께 만드는 웹 서비스 - 설계도에서 배포·운영까지

AI 와 일하는 순서 정하기 - 지침 파일·작업 단위·검증 기록

지침 파일(프로젝트 규칙·실행 명령·금지 사항), 작업을 반나절 단위로 쪼개기, 요청문 구조(목표·제약·완료 조건·확인 방법), AI 결과를 diff·실행·테스트로 확인하는 기록 양식, 완성 코드는 작업 기록 파일을 읽어 검증 안 된 작업을 찾아내는 도구

개발자KR · 원고 갱신

이 장에서 배우는 것

앞 장에서 동네 소모임 사이트의 한 장 설계도를 그렸다. 회원이 모임 공지를 읽고 참가를 신청한다는 흐름을 정했으니, 이제는 그 설계도를 AI 코딩 도구와 함께 한 작업씩 구현할 차례다. 이 장에서는 프로젝트 지침을 적고, 작업 범위를 정하고, 사람이 무엇을 확인했는지 남기는 순서를 익힌다. 마지막에는 작업 기록 파일을 읽어 검증이 끝나지 않은 작업을 찾는 도구를 만든다.

  • 프로젝트 규칙, 실행 명령, 금지 사항을 지침 파일에 적는다.
  • 반나절 안에 구현과 검증을 마칠 수 있도록 작업을 나눈다.
  • 목표, 제약, 완료 조건, 확인 방법을 갖춘 요청문을 작성한다.
  • 변경 내역 검토, 실행, 테스트의 결과를 기록하고 남은 검증을 찾는다.

문제 상황

소모임 운영자가 다음 토요일 모임을 공지하려 한다. 개발자는 AI에게 “모임 공지와 참가 신청을 만들어 줘”라고 요청한다. 결과에 공지 목록, 참가 양식, 신청 처리까지 들어 있다. 첫 화면은 열리지만, 마감된 모임에서 신청을 어떻게 다룰지는 설계도와 코드의 설명이 서로 다르다. 어느 파일에서 마감 여부를 판단하는지 찾기 전에 화면과 신청 처리 사이의 연결부터 읽어야 한다.

다음 날 다른 사람이 이어서 작업한다. 전날 기록에는 “AI 작성, 동작 확인”이라는 메모가 한 줄 남아 있다. 어떤 명령을 실행했는지, 어떤 입력을 사용했는지, 마감된 모임도 확인했는지는 알 수 없다. 설계도와 구현 사이에 차이가 있음을 알아도, 어디까지 다시 확인해야 할지 판단하기 어렵다.

이 장에서는 먼저 모임 공지 목록의 표시 순서처럼 작은 작업을 고른다. 공지가 없을 때 보여 줄 문구와 같은 날 열리는 모임의 순서까지 정하면, 사람이 예상 결과를 직접 써 둘 수 있다. 실행 결과가 예상과 다르면 어떤 조건이 어긋났는지도 설명할 수 있다. 이렇게 남긴 작업 기록은 다음 작업을 고를 때 다시 쓰인다.

프로젝트 지침과 반나절 작업

반복해서 적용할 규칙을 한곳에 둔다

프로젝트 최상위에 WORK_RULES.md라는 지침 파일을 둔다고 가정하자. 이 이름은 팀에서 정한 예시다. AI 도구가 자동으로 읽는 파일 이름은 도구마다 다를 수 있으므로, 요청문에서 파일을 직접 가리키거나 필요한 내용을 함께 전달한다. 지침을 수정할 때에는 현재 작업에도 새 규칙을 적용할지 정하고, 적용한다면 요청문과 확인 기준도 함께 고친다.

아래 초안은 지침에 넣을 문장을 목적별로 보여 준다. 실행 명령을 적을 때에는 명령이 실제로 사용할 수 있는지 확인한다. 새 명령이 필요한 작업이라면 그 명령을 만들고 처음 실행하는 일까지 작업 범위에 넣는다.

소모임 프로젝트의 지침 파일에 적을 내용
항목지침 초안사람이 확인할 것
프로젝트 규칙앞 장에서 합의한 설계도를 기준으로 삼는다. 작업 요청에 지정된 파일만 수정한다. 설계도에 없는 결정을 해야 하면 수정 전에 질문한다.바뀐 파일 목록과 변경 이유를 살핀다.
실행 명령프로젝트 최상위에서 python3 main.py를 실행한다. 작업별 테스트 명령과 기대 결과는 해당 요청문에 적는다.명령이 끝나는지 확인하고 출력과 종료 상태를 기록한다.
금지 사항외부 패키지를 설치하거나 네트워크를 호출하지 않는다. 실제 회원 정보나 인증 정보를 예제와 기록에 넣지 않는다.가져온 모듈과 예제 입력에 금지 사항을 어긴 부분이 있는지 살핀다.

작업 크기는 확인에 걸리는 시간까지 포함해 정한다

반나절은 구현을 시작한 뒤 변경 내역을 읽고, 실행하고, 테스트하고, 기록까지 마칠 수 있는 크기다. 반나절을 넘길 것 같다면 사용자에게 보이는 동작을 기준으로 나눈다. 예를 들어 공지 목록에서는 표시 순서를 먼저 확정하고, 공지 상세 화면은 별도 작업으로 둔다. 참가 신청의 마감 조건은 참가 신청을 다룰 때 입력과 예상 결과를 함께 정한다.

작업을 나눌 때에는 결과를 지켜볼 입력을 먼저 적어 본다. 공지 목록이라면 날짜가 서로 다른 공지, 날짜가 같은 공지, 공지가 없는 경우를 준비할 수 있다. 각각에서 무엇을 보여 줘야 하는지 한 문장으로 말하기 어렵다면 기준이 아직 덜 정해졌을 수 있다. 같은 날짜의 순서를 정하는 일처럼 작성 도중 드러난 결정은 그 작업 안에서 합의한다. 상세 화면에 어떤 항목을 추가할지처럼 다른 동작에 속한 결정은 다음 요청을 위해 남긴다.

반나절 작업은 요청의 범위를 정한 뒤 만들고 확인한 결과를 기록할 때 끝난다.

요청문에서 작업 기록까지

요청문에는 결과를 판정할 기준을 넣는다

목표는 사용자가 보게 될 결과를 말한다. 제약은 수정해도 되는 범위와 프로젝트가 지켜야 하는 규칙을 정한다. 완료 조건은 입력을 주었을 때 기대하는 동작을 적는다. 확인 방법은 그 조건을 사람이 어떻게 관찰할지 정한다. 완료 조건과 확인 방법을 나누어 쓰면 파일이 실행된 사실과 원하는 동작이 나온 사실을 각각 확인하기 쉽다.

목표 모임 공지를 열리는 날짜가 빠른 순서로 읽을 수 있게 한다.

제약 WORK_RULES.md에 적은 규칙을 적용한다. main.py에서 공지 목록을 만드는 부분만 수정한다. 예제 공지는 코드 안에 고정된 값으로 둔다.

완료 조건 공지는 날짜 오름차순으로 보인다. 날짜가 같으면 입력 순서를 유지한다. 공지가 없으면 “예정된 모임이 없다.”를 표시한다.

확인 방법 변경한 부분과 이유를 알려 준다. python3 main.py로 실행해 고정 예제의 출력을 확인한다. 날짜가 역순인 입력, 같은 날짜의 공지 두 건, 빈 목록에 대해 기대 결과와 실제 결과를 비교할 방법을 제시한다.

요청문은 변경을 검토할 때도 쓴다. AI가 날짜에 이어 제목을 두 번째 정렬 기준으로 넣었다면, 같은 날짜에 입력 순서를 유지한다는 조건과 비교할 수 있다. 이 차이는 날짜가 모두 다른 예제로 실행할 때는 나타나지 않는다. 같은 날 열리는 “저녁 산책”과 “아침 독서”를 그 순서로 넣어 보면 제목순으로 재배치되는지 확인할 수 있다.

확인한 근거를 작업별로 남긴다

변경 내역(diff) 검토에서는 수정된 파일과 코드를 읽어 요청 범위가 지켜졌는지 살핀다. 실행에서는 보통 사용자가 시작하는 명령으로 프로그램이 끝까지 동작하는지 확인한다. 테스트에서는 어떤 입력에서 어떤 결과가 나와야 하는지 정하고 실제 결과와 비교한다. 한 번의 실행에 테스트가 함께 들어 있다면 같은 명령을 기록할 수 있다. 실행 기록에는 프로그램이 보여 준 결과를, 테스트 기록에는 비교한 입력과 기대 결과를 남긴다.

아래 표는 작업 기록을 채운 예시다. AI가 제시한 결과에서 사람이 수정한 부분을 따로 적어 두면 다음 사람이 같은 결정을 다시 추적할 수 있다. 실행 출력이나 테스트가 길 때에는 전체를 옮기기보다 어떤 입력으로 어떤 결과를 얻었는지 찾을 수 있게 기록한다.

AI에게 요청한 내용과 사람이 확인한 결과를 담은 예시
작업AI에게 보낸 요청받은 결과에서 사람이 고친 부분확인 방법과 결과
W-01 공지 목록 정렬날짜 오름차순으로 표시하고 같은 날짜에는 입력 순서를 유지하라.날짜 다음에 제목을 비교하던 정렬 기준에서 제목을 뺐다.변경 내역에서 정렬 기준을 읽었다. 고정 공지로 실행했다. 같은 날짜의 두 공지에 대해 기대 순서와 실제 순서가 일치했다.
W-02 빈 공지 문구공지 목록이 비어 있을 때만 “예정된 모임이 없다.”를 표시하라.AI가 제안한 문구를 설계에서 합의한 문구로 맞췄다.빈 목록 분기의 변경을 읽고 빈 목록으로 실행했다. 공지가 한 건 있을 때 빈 목록 문구가 사라지는지 비교하는 테스트가 남았다.
W-03 참가 마감 안내마감된 모임의 상세 화면에 마감 안내를 표시하라.초안에서 기존에 문구를 표시하는 위치를 재사용했다.첫 검토에서 수정 범위를 벗어난 부분을 발견해 보완한 뒤 재검토했다. 보완한 버전으로 실행과 테스트를 다시 확인해야 한다.

완성 코드에서는 이 표의 확인 부분을 자바스크립트 객체 표기법(JSON)으로 기록한다. 작업마다 식별자와 제목을 적고 checks 안에 diff, run, test를 둔다. 각 확인 항목에는 상태를 나타내는 status와 근거를 담는 evidence가 있다. 상태는 passed, failed, pending 가운데 하나다. 확인 항목 자체가 빠져 있으면 누락으로 보고한다.

세 항목이 모두 passed이고 각각 공백 이외의 근거가 있어야 검증을 마친 것으로 집계한다. 이 기준은 기록이 채워졌는지 알려 준다. 근거가 실제 변경 내용에 해당하는지, 테스트가 완료 조건을 충분히 다루는지는 기록을 읽는 사람이 판단한다. 확인 이후 코드를 다시 고쳤다면 그 변경이 영향을 주는 항목을 pending으로 돌리고 다시 확인한다.

변경 내역, 실행, 테스트의 통과 상태와 근거가 모두 있어야 작업을 검증 완료로 기록한다.

완성 코드

main.py로 저장한다. 파일 경로를 생략하면 위 표를 바탕으로 만든 작업 기록을 임시 폴더에 쓰고, 그 파일을 읽어 미검증 항목을 출력한다. 임시 폴더는 실행이 끝날 때 정리된다. 경로를 넘기면 해당 기록 파일을 읽는다. 이 도구의 입력은 작업 기록 파일이므로 공지 화면이나 이전 장의 파일을 준비할 필요가 없다.

main.py

import argparse
import json
import sys
from pathlib import Path
from tempfile import TemporaryDirectory


CHECK_LABELS = {
    "diff": "변경 내역",
    "run": "실행",
    "test": "테스트",
}
STATUSES = {"passed", "failed", "pending"}


def text_required(value, field):
    if not isinstance(value, str) or not value.strip():
        raise ValueError(f"{field}에 비어 있지 않은 문자열이 필요하다.")
    return value.strip()


def read_tasks(path):
    tasks = json.loads(path.read_text(encoding="utf-8"))
    if not isinstance(tasks, list):
        raise ValueError("기록의 최상위 값은 작업 목록이어야 한다.")

    seen = set()
    for index, task in enumerate(tasks, start=1):
        if not isinstance(task, dict):
            raise ValueError(f"{index}번째 작업은 객체여야 한다.")
        task_id = text_required(task.get("id"), f"{index}번째 작업의 id")
        if task_id in seen:
            raise ValueError(f"작업 ID가 중복된다 ({task_id}).")
        seen.add(task_id)
        text_required(task.get("title"), f"{task_id}의 title")

        checks = task.get("checks", {})
        if not isinstance(checks, dict):
            raise ValueError(f"{task_id}의 checks는 객체여야 한다.")
        for key, entry in checks.items():
            if key not in CHECK_LABELS or not isinstance(entry, dict):
                raise ValueError(f"{task_id}의 확인 항목이 올바르지 않다 ({key}).")
            status = entry.get("status")
            if not isinstance(status, str) or status not in STATUSES:
                raise ValueError(f"{task_id}의 확인 상태가 올바르지 않다 ({key}).")
            if not isinstance(entry.get("evidence", ""), str):
                raise ValueError(f"{task_id}의 근거는 문자열이어야 한다 ({key}).")

    return tasks


def unfinished_checks(checks):
    reasons = []
    for key, label in CHECK_LABELS.items():
        entry = checks.get(key)
        if entry is None:
            reasons.append(f"{label} 기록 누락")
        elif entry["status"] == "pending":
            reasons.append(f"{label} 보류")
        elif entry["status"] == "failed":
            reasons.append(f"{label} 실패")
        elif not entry.get("evidence", "").strip():
            reasons.append(f"{label} 통과 근거 없음")
    return reasons


def report(tasks):
    unfinished = []
    for task in tasks:
        reasons = unfinished_checks(task.get("checks", {}))
        if reasons:
            unfinished.append((task, reasons))

    print(f"전체 작업 {len(tasks)}건")
    print(f"검증 완료 {len(tasks) - len(unfinished)}건")
    print(f"미검증 {len(unfinished)}건")
    for task, reasons in unfinished:
        task_id = task["id"].strip()
        title = task["title"].strip()
        print(f"- {task_id} {title} ({', '.join(reasons)})")


def check_entry(status, evidence=""):
    return {"status": status, "evidence": evidence}


def sample_tasks():
    return [
        {
            "id": "W-01",
            "title": "공지 목록 정렬",
            "checks": {
                "diff": check_entry("passed", "날짜만 비교하는 정렬을 검토했다."),
                "run": check_entry("passed", "고정 공지 3건이 출력됐다."),
                "test": check_entry("passed", "같은 날짜의 입력 순서를 비교했다."),
            },
        },
        {
            "id": "W-02",
            "title": "빈 공지 문구",
            "checks": {
                "diff": check_entry("passed", "빈 목록 분기의 문구를 검토했다."),
                "run": check_entry("passed", "빈 목록 문구가 출력됐다."),
                "test": check_entry("pending", "공지 한 건의 출력 비교가 남았다."),
            },
        },
        {
            "id": "W-03",
            "title": "참가 마감 안내",
            "checks": {
                "diff": check_entry("passed", "보완한 변경 내역을 다시 읽었다."),
                "run": check_entry("passed", " "),
            },
        },
    ]


def self_test():
    cases = [
        ({}, ["변경 내역 기록 누락", "실행 기록 누락", "테스트 기록 누락"]),
        (sample_tasks()[0]["checks"], []),
        (sample_tasks()[1]["checks"], ["테스트 보류"]),
        (sample_tasks()[2]["checks"], ["실행 통과 근거 없음", "테스트 기록 누락"]),
        (
            {"diff": check_entry("failed", "수정 범위 초과")},
            ["변경 내역 실패", "실행 기록 누락", "테스트 기록 누락"],
        ),
    ]
    for index, (checks, expected) in enumerate(cases, start=1):
        actual = unfinished_checks(checks)
        if actual != expected:
            raise AssertionError(f"검사 {index}의 결과가 다르다 ({actual!r}).")

    with TemporaryDirectory() as directory:
        path = Path(directory) / "worklog.json"
        path.write_text('{"id": "W-01"}', encoding="utf-8")
        try:
            read_tasks(path)
        except ValueError as error:
            expected_error = "기록의 최상위 값은 작업 목록이어야 한다."
            if str(error) != expected_error:
                raise
        else:
            raise AssertionError("작업 목록이 아닌 입력을 받아들였다.")
    print(f"도구 자체 검사 {len(cases) + 1}건 통과")


def main():
    parser = argparse.ArgumentParser(description="작업 기록의 미검증 항목을 찾는다.")
    options = parser.add_mutually_exclusive_group()
    options.add_argument("--file", type=Path, help="읽을 작업 기록 파일 경로")
    options.add_argument("--self-test", action="store_true", help="도구 자체 검사")
    args = parser.parse_args()

    try:
        if args.self_test:
            self_test()
        elif args.file is not None:
            report(read_tasks(args.file))
        else:
            with TemporaryDirectory() as directory:
                path = Path(directory) / "worklog.json"
                data = json.dumps(sample_tasks(), ensure_ascii=False, indent=2)
                path.write_text(data + "\n", encoding="utf-8")
                report(read_tasks(path))
    except (OSError, ValueError) as error:
        print(f"기록 처리 오류 ({error})", file=sys.stderr)
        return 2
    return 0


if __name__ == "__main__":
    raise SystemExit(main())

줄별 해설

  1. CHECK_LABELS에는 파일에서 읽을 키와 화면에 표시할 이름이 들어 있다. 딕셔너리에 적힌 순서대로 변경 내역, 실행, 테스트를 검사하므로 파일에서 세 항목의 순서를 바꿔도 출력 순서는 같다.

  2. text_required()는 작업 ID와 제목에 공백 이외의 문자가 있는지 확인한다. 앞뒤 공백을 제거한 ID를 seen에 저장하므로 W-01과 앞에 공백을 붙인 W-01을 같은 작업으로 처리한다. 제목과 ID를 화면에 표시할 때에도 앞뒤 공백을 제거한다.

  3. read_tasks()는 지정된 경로에서 UTF-8 텍스트를 읽고 목록으로 해석한다. 작업의 모양, ID의 중복, 확인 항목의 키와 상태를 검사한다. 확인 내용이 빠진 경우는 미검증 목록에서 찾아야 하므로 빈 checks도 받아들인다. 철자가 틀린 키나 허용되지 않은 상태를 만나면 어느 작업에서 문제가 생겼는지 알려 준다.

  4. unfinished_checks()에서 entry is None인 분기는 확인 기록의 누락을 찾는다. 이어서 보류와 실패를 확인한다. 파일을 읽을 때 상태를 이미 검사했으므로 마지막 분기에 도달한 항목의 상태는 passed다. 여기서 strip()을 적용해 공백만 적힌 근거도 찾아낸다.

  5. report()는 미검증 사유가 한 개 이상인 작업을 모은다. 전체 작업 수에서 그 수를 빼면 검증 완료 건수가 된다. 미검증 작업은 입력 목록에 있던 순서대로 출력하며, 한 작업에 사유가 여러 개 있으면 한 줄에 모두 표시한다. 빈 목록을 읽으면 세 건수 모두 0이다.

  6. sample_tasks()는 사람이 확인한 작업, 테스트를 보류한 작업, 확인 근거가 비어 있는 작업을 예제로 만든다. W-03에서 실행 상태에 passed를 먼저 써 둔 상황을 재현한다. 근거에는 공백만 들어 있으므로 도구는 이 항목을 완료로 집계하지 않는다.

  7. self_test()는 작업 분류 함수에 입력과 기대 결과를 직접 대입한다. 이어서 목록 대신 객체를 담은 파일을 만들어 read_tasks()가 약속한 오류를 내는지 확인한다. 조건이 어긋나면 예외를 발생시키므로 성공 문구까지 도달하려면 모든 비교를 통과해야 한다.

  8. main()은 명령줄에 지정된 실행 방식을 고른다. 기본 실행과 --file은 같은 읽기 함수와 보고 함수를 거친다. 미검증 작업이 있는 보고서도 정상적으로 작성된 결과이므로 종료 상태는 0이다. 파일을 열 수 없거나 기록 형식이 잘못된 경우에는 표준 오류에 메시지를 쓰고 종료 상태 2를 반환한다.

실행 결과

파일을 저장한 디렉터리에서 다음 명령을 실행한다. 첫 명령은 경고를 오류로 다루도록 설정해 파일을 컴파일한다. 성공하면 콘솔에 출력이 없다. 둘째 명령은 예제 기록 파일을 만들고 읽어 보고서를 출력한다. 셋째 명령은 도구 자체 검사를 실행한다.

python3 -W error -m py_compile main.py
python3 main.py
python3 main.py --self-test
전체 작업 3건
검증 완료 1건
미검증 2건
- W-02 빈 공지 문구 (테스트 보류)
- W-03 참가 마감 안내 (실행 통과 근거 없음, 테스트 기록 누락)
도구 자체 검사 6건 통과

출력에서 W-02와 W-03을 비교한다. W-02는 테스트가 남아 있다는 사실을 기록했다. W-03에는 실행을 통과했다고 적혀 있지만 근거를 읽을 수 없고 테스트 항목도 빠져 있다. 다음에 W-03을 이어받으면 보완한 버전에서 실행과 테스트를 수행한 뒤 각각의 관찰 결과를 적을 수 있다. 팀의 기록 파일을 준비했다면 python3 main.py --file worklog.json으로 같은 보고서를 얻는다.

실무에서 자주 틀리는 것

상태 필드가 있다는 사실만 확인한다

다음 코드는 pending도 비어 있지 않은 문자열이므로 참으로 출력한다. 작업 기록을 읽는 코드에서는 통과라는 값과 근거를 각각 확인해야 한다.

entry = {"status": "pending", "evidence": "다음 작업에서 확인한다."}
print(bool(entry["status"]))

상태가 통과이고 근거가 채워졌을 때 참이 되도록 조건을 적는다.

entry = {"status": "pending", "evidence": "다음 작업에서 확인한다."}
print(entry["status"] == "passed" and bool(entry["evidence"].strip()))

필수 항목의 누락을 통과로 집계한다

기록에 들어 있는 항목만 순회하면 실행과 테스트가 빠져도 변경 내역 항목 하나로 전체가 통과할 수 있다. 아래 코드는 그 상황에서 참을 출력한다.

checks = {"diff": {"status": "passed", "evidence": "정렬 기준을 읽었다."}}
print(all(item["status"] == "passed" for item in checks.values()))

순회할 기준을 기록의 키에서 필수 항목 목록으로 옮긴다. 이 예시의 각 항목은 완성 코드의 읽기 함수와 같은 형식 검사를 거쳤다고 가정한다.

checks = {"diff": {"status": "passed", "evidence": "정렬 기준을 읽었다."}}
required = ("diff", "run", "test")
print(all(
    key in checks
    and checks[key]["status"] == "passed"
    and bool(checks[key].get("evidence", "").strip())
    for key in required
))

수정한 코드에 이전 실행 결과를 붙여 둔다

공지 정렬 기준을 바꾼 뒤 변경 내역을 다시 검토했다. 다음 코드처럼 이전 기록의 변경 내역 항목만 갱신하면, 독자는 실행과 테스트가 수정한 코드에서 끝난 것으로 읽을 수 있다.

checks = {
    "diff": {"status": "passed", "evidence": "이전 정렬 기준을 검토했다."},
    "run": {"status": "passed", "evidence": "이전 코드로 실행했다."},
    "test": {"status": "passed", "evidence": "이전 순서를 비교했다."},
}
checks["diff"] = {"status": "passed", "evidence": "바꾼 정렬 기준을 검토했다."}
print(checks["run"]["status"], checks["test"]["status"])

변경의 영향을 받는 실행과 테스트를 보류로 되돌린다. 다시 확인할 때에는 수정한 코드에서 관찰한 결과를 근거로 적는다.

checks = {
    "diff": {"status": "passed", "evidence": "바꾼 정렬 기준을 검토했다."},
    "run": {"status": "passed", "evidence": "이전 코드로 실행했다."},
    "test": {"status": "passed", "evidence": "이전 순서를 비교했다."},
}
for key in ("run", "test"):
    checks[key] = {"status": "pending", "evidence": "정렬 수정 후 다시 확인한다."}
print(checks["run"]["status"], checks["test"]["status"])

한눈에 보기

설계도에서 작업 기록까지 판단하는 기준
단계남길 내용판단 기준
지침 작성프로젝트 규칙, 실행 명령, 금지 사항여러 작업에서 반복해서 적용할 수 있다.
작업 나누기동작 하나와 해당 입력 사례반나절 안에 변경을 읽고 결과를 확인해 기록할 수 있다.
요청 작성목표, 제약, 완료 조건, 확인 방법변경할 범위와 예상 결과를 각각 말할 수 있다.
변경 확인변경 내역, 실행, 테스트의 상태와 근거세 항목을 확인한 사람이 무엇을 보았는지 기록에서 읽을 수 있다.
남은 일 찾기미검증 작업 ID와 사유다음 사람이 어떤 확인부터 할지 고를 수 있다.

다음에는 참가 신청을 저장하기 위한 데이터의 구조를 정한다. 그 과정에서도 테이블이나 제약 조건 하나를 작업 범위로 잡고, 어떤 입력을 허용하고 어떤 입력에서 저장을 멈춰야 하는지 요청과 확인 기록에 남길 수 있다.

연습 문제

  1. “공지 상세 화면, 참가 신청, 마감 안내를 오늘 구현해 줘”라는 요청에서 첫 반나절에 맡길 작업 하나를 고른다. 목표, 제약, 완료 조건, 확인 방법을 한 문장씩 쓴다.

  2. sample_tasks()의 W-02에서 테스트 상태를 passed로 바꾸고 근거는 빈 문자열로 둔다. 기본 실행에서 W-02의 출력이 어떻게 달라질지 쓰고 확인한다.

  3. 작업 두 건의 ID가 각각 W-01과 W-01 인 기록을 읽으면 어떻게 되는지 설명한다. 두 번째 ID의 앞뒤 공백을 제거하는 코드가 어디에서 적용되는지도 찾는다.

  4. W-01의 날짜 정렬 기준을 다시 바꿨다. 실행 결과에는 여전히 공지 세 건이 보였지만 같은 날짜의 공지 두 건의 순서는 아직 비교하지 않았다. 어떤 항목에 어떤 상태와 근거를 적을지 설명한다.

정답과 해설

  1. 첫 작업으로 공지 상세 화면을 고를 수 있다. 목표는 “회원이 선택한 공지의 제목과 일시를 볼 수 있다”로 적는다. 제약은 “고정된 공지 예제를 사용하며 상세 표시 부분만 수정한다”로 둔다. 완료 조건은 “선택한 공지의 제목과 일시가 표시되고 다른 공지의 제목은 표시되지 않는다”로 정한다. 확인 방법에는 “공지 두 건 중 하나를 고정 입력으로 전달해 표시 내용을 기대 결과와 비교한다”라고 적는다. 참가 신청과 마감 안내는 상세 화면을 확인한 뒤 각각 요청할 수 있다.

  2. W-02의 줄은 - W-02 빈 공지 문구 (테스트 통과 근거 없음)으로 바뀐다. 미검증 작업은 여전히 2건이다. W-02에서 테스트를 실행한 뒤 실제 결과를 적으면 그때 검증 완료 수가 2건으로 늘어난다. 예제를 고쳐 실험했다면 원래 값으로 복원하고 자체 검사를 실행해 예제와 기대 결과가 다시 맞는지 확인한다.

  3. read_tasks()는 두 번째 작업을 읽을 때 중복 오류를 발생시킨다. 중복을 찾기 전에 text_required()의 반환값에 strip()이 적용되어 두 ID가 모두 W-01이 된다. 파일 경로를 지정해 실행할 경우 오류 메시지는 표준 오류에 출력되고 종료 상태는 2다.

  4. 새 정렬 기준을 읽어 요청 범위와 조건에 맞음을 확인했다면 변경 내역은 passed로 적고 그 기준을 근거에 남긴다. 새 코드로 실행해 공지 세 건이 출력된 실행 항목에도 passed와 관찰 결과를 적는다. 테스트는 pending으로 두고 “같은 날짜의 공지 두 건에 대해 입력 순서와 출력 순서를 비교할 예정”이라고 쓴다. 그 비교를 마치기 전까지는 작업 전체가 미검증으로 집계된다.

오탈자·오류 제보 비공개로 접수되어 원고 수정에 반영됩니다

이메일 등 개인정보는 받지 않습니다. 답변이 필요한 질문은 아래 댓글을 이용해 주세요.

READER FEEDBACK

질문·의견

내용에 관한 질문이나 더 나은 설명을 위한 의견을 남겨 주세요. 오탈자는 위의 제보 양식이 더 빨리 반영됩니다. 이 댓글은 원래 게시글과 같은 자리에 쌓입니다.

댓글 0

아직 댓글이 없습니다. 첫 댓글을 남겨 보세요.

댓글을 남기려면 로그인이 필요합니다.