# 코딩 에이전트 위임 브리프

AI Usage Playbook / Studio Nani

목적: Claude Code, Codex, ChatGPT 같은 코딩 에이전트에게 “알아서 고쳐줘”가 아니라, 범위·제약·검증 기준이 있는 작업 단위를 준다.

## 사용법

- 기능 추가, 버그 수정, UI 수정, 리팩터링을 맡길 때 먼저 이 브리프를 채운다.
- 작업 범위를 작게 유지한다.
- 허용 파일과 금지 파일을 명확히 적는다.
- 완료 기준에는 반드시 실제 검증 명령을 넣는다.

## Delegation Brief Template

```text
# Coding Agent Delegation Brief

## Task
[한 문장으로 작업을 정의]

## Goal
사용자/제품 관점에서 이 작업이 해결해야 하는 문제:
- [목표]

## Scope
Allowed files or folders:
- [수정 가능 경로 1]
- [수정 가능 경로 2]

Do not touch:
- [금지 경로/영역]
- [민감 파일/설정]

## Current problem
Observed behavior:
- [현재 문제]

Expected behavior:
- [원하는 동작]

Reproduction / entry point:
- [URL, 명령, 화면, 테스트, 로그]

## Constraints
- Keep changes minimal and focused.
- Do not introduce paid services, new cloud resources, secrets, or destructive commands.
- Do not rewrite unrelated architecture.
- Preserve existing public URLs and content unless explicitly required.
- If the task is ambiguous, state assumptions before editing.

## Acceptance criteria
- [수용 기준 1]
- [수용 기준 2]
- [수용 기준 3]

## Verification commands
Run:
```bash
[build/test/lint command]
```

If this is UI work, also verify:
- desktop browser render
- mobile width [예: 390px]
- console errors
- horizontal overflow

## Required final report
Return:
- files changed
- what changed
- exact verification commands and results
- screenshot or URL if UI changed
- remaining risks
```

## 예시: UI overflow 수정

```text
# Coding Agent Delegation Brief

## Task
Fix mobile horizontal overflow on the Korean home page.

## Goal
Users should be able to read the home page on 390px mobile width without sideways scrolling.

## Scope
Allowed files:
- src/pages/[lang]/index.astro
- src/components/PatternCard.astro

Do not touch:
- data content files
- deployment config
- analytics/ads files

## Current problem
Observed behavior:
- /ko/ has horizontal overflow on mobile.

Expected behavior:
- documentElement.scrollWidth equals clientWidth at 390px.

## Constraints
- Do not remove content.
- Preserve desktop layout.
- Prefer wrapping and width constraints over hiding important text.

## Acceptance criteria
- npm run build passes.
- /ko/ has no horizontal overflow at 390px.
- Browser console has no JS errors.

## Verification commands
Run:
```bash
npm run build
```

UI verify:
- open /ko/
- probe scrollWidth/clientWidth at 390px
- capture screenshot if available
```

## 위임 전 체크리스트

- [ ] 작업이 한 번에 끝낼 수 있는 작은 단위인가?
- [ ] 수정 가능 파일이 제한됐는가?
- [ ] 금지 범위가 적혀 있는가?
- [ ] 수용 기준이 사용자 관점으로 적혀 있는가?
- [ ] 실제 검증 명령이 있는가?
- [ ] 완료 보고 형식이 정해져 있는가?

## 한계

코딩 에이전트에게 비밀, 결제, 배포, 삭제, 공개 발행, 제품 전략 결정을 위임하지 마세요. 그런 작업은 사람의 명시 승인 후 진행해야 합니다.