Day 4 Data Structure Codex AI Architect

Codex Client Workspace ๊ธฐ๋ฐ˜ ๋ฐ์ดํ„ฐ ์„ค๊ณ„ Tasks

์Šคํƒ€ํŠธ์—…๋“ค์ด MVP ๊ฐœ๋ฐœ ๋‹จ๊ณ„์—์„œ ์ง๋ฉดํ•˜๋Š” ๋ฐ์ดํ„ฐ ๊ตฌ์กฐ ์ดํ•ด ์ฐจ์ด, ์šฉ์–ด ํŒŒํŽธํ™”, ๋ณ€๊ฒฝ ์˜ํ–ฅ ์ „ํŒŒ ๋ฌธ์ œ๋ฅผ
Codex๋ฅผ ํ™œ์šฉํ•ด ์ž๋™์œผ๋กœ ๋ถ„์„ํ•˜๊ณ  ํ•ด์†Œํ•˜๋Š” ์‹ค๋ฌด AI ํ˜‘์—… Task ๋ณด๋“œ์ž…๋‹ˆ๋‹ค.

Day 4 Startup MVP Tasks

๋ฐ์ดํ„ฐ ๊ตฌ์กฐ ์ •๋ ฌ๋ถ€ํ„ฐ ์šฉ์–ด ํ‘œ์ค€ํ™”, ๋ณ€๊ฒฝ ์˜ํ–ฅ ๊ณต์œ ๊นŒ์ง€ โ€” Codex๋ฅผ ๋ฐ์ดํ„ฐ ์„ค๊ณ„ ํŒŒํŠธ๋„ˆ๋กœ ํ™œ์šฉํ•˜๋Š” ํ•ต์‹ฌ ์›Œํฌํ”Œ๋กœ์šฐ๋ฅผ ๊ฒฝํ—˜ํ•ด๋ณด์„ธ์š”.

TASK 1
Task 1

Task 1. API ๊ณ„์•ฝ์„œ ์ƒ์„ฑ ์‹ค์Šต

Task 01: ๊ธฐํš ์š”๊ตฌ์‚ฌํ•ญ ๋ฐ ํ™”๋ฉด ์„ค๊ณ„๋ฅผ ๋ฐ”ํƒ•์œผ๋กœ API Contract ์ž๋™ ์ƒ์„ฑ

์ž์—ฐ์–ด๋กœ ์ž‘์„ฑ๋œ ๊ธฐํš ํšŒ์˜๋ก์—์„œ ํ•ต์‹ฌ ์—”ํ‹ฐํ‹ฐ์™€ ๊ด€๊ณ„(Mermaid ERD)๋ฅผ ๋„์ถœํ•˜์—ฌ, ๊ธฐํš์ž์™€ ๊ฐœ๋ฐœ์ž ๊ฐ„ ๋ฐ์ดํ„ฐ ๋ชจ๋ธ ์ดํ•ด ์ฐจ์ด๋ฅผ AI๋กœ ํ•ด์†Œํ•ฉ๋‹ˆ๋‹ค.

๋ชฉํ‘œ ์ˆ˜์น˜RESTful API ๊ณ„์•ฝ์„œ ์ŠคํŽ™ ๋„์ถœ
ํ•ต์‹ฌ ๋„๊ตฌCodex Client Workspace
์‹ค์Šต ๋ฒ”์œ„Data Structure Alignment
1๋‹จ๊ณ„ ๐Ÿ“‚ ํšŒ์˜๋ก ํŒŒ์ผ(day4_meeting_notes.md) ์ค€๋น„ ๋ฐ Codex ์—…๋กœ๋“œ
2๋‹จ๊ณ„ ๐Ÿ” Codex์— API ๋ชฉ๋ก ๋„์ถœ ๋ฐ Req/Res ๋ณ€์ˆ˜๋ช… ์ •์˜ ์˜๋ขฐ
ERD Req/Res Design RESTful
์˜ˆ์ƒ ์‚ฐ์ถœ๋ฌผ erd-schema.md (๋ฐ์ดํ„ฐ ๋ช…์„ธ ๋ฐ ERD)
Task 1 ์‹ค์Šต์‹ค ์ž…์žฅ
TASK 2
Task 2

Task 2. API ๋ถˆ์ผ์น˜ ๊ฒ€์ถœ ์‹ค์Šต

Task 02: ๊ธฐํš ๋ฌธ์„œ์™€ API ๋ช…์„ธ๋ฅผ ๋น„๊ตํ•˜์—ฌ ๋ถˆ์ผ์น˜ ํ•ญ๋ชฉ ๊ฒ€์ถœ

์š”๊ตฌ์‚ฌํ•ญ ์ •์˜์„œ, ํ™”๋ฉด ์ •์˜์„œ, ๊ทธ๋ฆฌ๊ณ  API ๋ช…์„ธ์„œ ์ดˆ์•ˆ์„ ๊ต์ฐจ ๋Œ€์กฐํ•˜์—ฌ ๊ธฐํš ์š”๊ตฌ์‚ฌํ•ญ์ด๋‚˜ ํ™”๋ฉด UI ์„ค๊ณ„์™€ ๋ถˆ์ผ์น˜ํ•˜๊ฑฐ๋‚˜ ๋ˆ„๋ฝ๋œ API ์—”๋“œํฌ์ธํŠธ ๋ฐ ํ•„๋“œ๋ฅผ ์ฐพ์•„ ๊ฒ€ํ†  ๋ณด๊ณ ์„œ๋ฅผ ์ž‘์„ฑํ•ฉ๋‹ˆ๋‹ค.

๋ชฉํ‘œ ์ˆ˜์น˜API ์ •ํ•ฉ์„ฑ ๊ฒ€ํ†  ๋ณด๊ณ ์„œ ์™„์„ฑ
ํ•ต์‹ฌ ๋„๊ตฌCodex Client Workspace
์‹ค์Šต ๋ฒ”์œ„Spec Auditing Standardization
1๋‹จ๊ณ„ ๐Ÿ“ ๊ธฐํš ๋ฌธ์„œ 2์ข… ๋ฐ API ๋ช…์„ธ์„œ ์ดˆ์•ˆ ์ค€๋น„
2๋‹จ๊ณ„ ๐Ÿ“‹ Codex๋กœ ๋ฌธ์„œ ๊ฐ„ ๋ถˆ์ผ์น˜ ๋ฐ ๊ธฐ๋Šฅ ๋ˆ„๋ฝ ์ •ํ•ฉ์„ฑ ๊ฒ€ํ†  ์˜๋ขฐ
Consistency Check Spec Auditing Validation
์˜ˆ์ƒ ์‚ฐ์ถœ๋ฌผ project-glossary.md (ํ‘œ์ค€ ์šฉ์–ด ์‚ฌ์ „)
Task 2 ์‹ค์Šต์‹ค ์ž…์žฅ
TASK 3
Task 3

Task 3. API ๋ณ€๊ฒฝ ์˜ํ–ฅ ๋ถ„์„ ์‹ค์Šต

Task 03: API ๋ณ€๊ฒฝ ์‹œ ์˜ํ–ฅ์„ ๋ฐ›๋Š” ๊ธฐ๋Šฅ, ๋ฌธ์„œ, ์ธํ„ฐํŽ˜์ด์Šค ๋ถ„์„

๋น„์ฆˆ๋‹ˆ์Šค ์ŠคํŽ™ ๋ณ€๊ฒฝ์— ๋”ฐ๋ผ API ํŒŒ๋ผ๋ฏธํ„ฐ๋‚˜ ์ƒํƒœ ๋ณ€๊ฒฝ ์‹œ ์—ฐ์‡„์ ์œผ๋กœ ์ˆ˜์ •์ด ์š”๊ตฌ๋˜๋Š” DB ์Šคํ‚ค๋งˆ, ํ”„๋ก ํŠธ์—”๋“œ UI ํ™”๋ฉด, API ๋ช…์„ธ์„œ ๋ชฉ๋ก์„ ์˜ํ–ฅ๋„ ๋ถ„์„ ๋ฆฌํฌํŠธ๋กœ ์ž‘์„ฑํ•ฉ๋‹ˆ๋‹ค.

๋ชฉํ‘œ ์ˆ˜์น˜API ๋ณ€๊ฒฝ ์˜ํ–ฅ ๋ถ„์„์„œ ์™„์„ฑ
ํ•ต์‹ฌ ๋„๊ตฌCodex Client Workspace
์‹ค์Šต ๋ฒ”์œ„Change Impact Analysis
1๋‹จ๊ณ„ ๐Ÿ“‚ API ๋ณ€๊ฒฝ ์š”์ฒญ์„œ ํŒŒ์ผ ์ค€๋น„
2๋‹จ๊ณ„ ๐Ÿ”„ Codex๋กœ UI ๋ฐ DB ์ŠคํŽ™ ์—ฐ์‡„ ์˜ํ–ฅ ๋ฒ”์œ„ ๋ถ„์„ ์˜๋ขฐ
Change Management Impact Analysis UI/API Sync
์˜ˆ์ƒ ์‚ฐ์ถœ๋ฌผ change-impact-report.md (๋ณ€๊ฒฝ ์˜ํ–ฅ๋„ ๋ถ„์„์„œ)
์‹ค์Šต์‹ค ์ž…์žฅ
SKILL 1
Skill Task 1

Skill Task 1. Domain Boundary ๊ธฐ๋ฐ˜ Endpoint ์„ค๊ณ„

ADD-D04-T01: 4๋Œ€ Domain๋ณ„ Resource & URI ๋ช…์„ธ

Video, Playback, Campaign, Ad Serving Domain์˜ Endpoint์™€ ์‚ฌ์šฉ ์‹œ๋‚˜๋ฆฌ์˜ค๋ฅผ ์„ค๊ณ„ํ•˜๊ณ  ๊ฒฝ๊ณ„๋ฅผ ์ ๊ฒ€ํ•ฉ๋‹ˆ๋‹ค.

๋ชฉํ‘œ ์ˆ˜์น˜Domain๋ณ„ Endpoint ๋ช…์„ธ ์™„๋ฃŒ
ํ•ต์‹ฌ ๋„๊ตฌCodex Client
์‹ค์Šต ๋ฒ”์œ„Skill Task (TECH)
1๋‹จ๊ณ„ ๐Ÿ“ Domain Map ๊ธฐ๋ฐ˜ ๋ฆฌ์†Œ์Šค ๋ช…์‚ฌํ˜• URI ๋„์ถœ
2๋‹จ๊ณ„ โš™๏ธ Method(GET/POST/PUT/DELETE) ๋ฐ ์‹œ๋‚˜๋ฆฌ์˜ค ์—ฐ๊ฒฐ
Skill Task Endpoint Domain Boundary
์˜ˆ์ƒ ์‚ฐ์ถœ๋ฌผ 07_ENDPOINTS.md
์‹ค์Šต์‹ค ์ž…์žฅ
SKILL 2
Skill Task 2

Skill Task 2. RequestยทResponseยทError Contract ์ž‘์„ฑ

ADD-D04-T02: OpenAPI 3.0 ๋ช…์„ธ์„œ ๋ฐ ์—๋Ÿฌ ๊ทœ๊ฒฉ ์ˆ˜๋ฆฝ

์ž…์ถœ๋ ฅ Schema, Status Code, Error Contract๋ฅผ ์ •์˜ํ•˜๊ณ  OpenAPI 3.0 ๋ช…์„ธ๋ฅผ ์ž‘์„ฑํ•ฉ๋‹ˆ๋‹ค.

๋ชฉํ‘œ ์ˆ˜์น˜OpenAPI 3.0 Spec ์ž‘์„ฑ ์™„๋ฃŒ
ํ•ต์‹ฌ ๋„๊ตฌCodex Client
์‹ค์Šต ๋ฒ”์œ„Skill Task (HYBRID)
1๋‹จ๊ณ„ ๐Ÿ“ ERD์™€ API ํ•„๋“œ๋ช…/ํƒ€์ž… ๊ต์ฐจ ๊ฒ€์ฆ
2๋‹จ๊ณ„ โš™๏ธ RFC 7807 ์—๋Ÿฌ ์‘๋‹ต ๊ตฌ์กฐ ๋ฐ HTTP Status ์„ค์ •
Skill Task OpenAPI 3.0 Error Contract
์˜ˆ์ƒ ์‚ฐ์ถœ๋ฌผ 07_API_SPEC.yaml
์‹ค์Šต์‹ค ์ž…์žฅ
SKILL 3
Skill Task 3

Skill Task 3. API Contract Consistency Review

ADD-D04-T03: Breaking Change ๋ฐ ์ •ํ•ฉ์„ฑ ๊ฒ€ํ† 

API๊ฐ€ Sequence/ERD์™€ ์ผ์น˜ํ•˜๋Š”์ง€ ์˜ค๋””ํŒ…ํ•˜๊ณ  ํ˜ธํ™˜์„ฑ ์œ„ํ˜‘ ๋ฐ ๋ถ€์ • ํ…Œ์ŠคํŠธ ์‹œ๋‚˜๋ฆฌ์˜ค๋ฅผ ๋„์ถœํ•ฉ๋‹ˆ๋‹ค.

๋ชฉํ‘œ ์ˆ˜์น˜Breaking Change & Review Report ๋„์ถœ
ํ•ต์‹ฌ ๋„๊ตฌCodex Client
์‹ค์Šต ๋ฒ”์œ„Skill Task (AI)
1๋‹จ๊ณ„ ๐Ÿ“ API-Sequence-ERD ์ •ํ•ฉ์„ฑ ์˜ค๋””ํŒ…
2๋‹จ๊ณ„ ๐Ÿ›ก๏ธ ํ•˜์œ„ ํ˜ธํ™˜์„ฑ Breaking Change ํ•ญ๋ชฉ ๋„์ถœ
Skill Task Breaking Change API Audit
์˜ˆ์ƒ ์‚ฐ์ถœ๋ฌผ api-review-report.md
์‹ค์Šต์‹ค ์ž…์žฅ
๐Ÿš€ ์‹ฌํ™” Mission โ€” ๋ฐ์ดํ„ฐ ์„ค๊ณ„ ๋งˆ์Šคํ„ฐ ๊ณผ์ •
MISSION 1
Mission 1

Mission 1. API ๋ฆฌ๋ทฐ ๋ฐ ๊ฐœ์„  ์‹ค์Šต

Mission 01: API ํ’ˆ์งˆ ๊ฒ€ํ†  ๋ฐ ๊ฐœ์„  ์ œ์•ˆ

REST API ์„ค๊ณ„ ํ‘œ์ค€๊ณผ ์ผ๊ด€๋œ ์—๋Ÿฌ ์ฒ˜๋ฆฌ ๊ทœ๊ฒฉ(RFC ํ‘œ์ค€ ์—๋Ÿฌ ์Šคํ‚ค๋งˆ)์„ ๊ธฐ์ค€์œผ๋กœ ๊ธฐ์กด API ์„ค๊ณ„์•ˆ์˜ ํ’ˆ์งˆ์„ ๋ฆฌ๋ทฐํ•ฉ๋‹ˆ๋‹ค.

๋ชฉํ‘œ ์ˆ˜์น˜API ๋ฆฌ๋ทฐ ๋ณด๊ณ ์„œ ์™„์„ฑ
ํ•ต์‹ฌ ๋„๊ตฌCodex Client Workspace
์‹ค์Šต ๋ฒ”์œ„Design API Review
1๋‹จ๊ณ„ ๐Ÿ“‚ API ๋ช…์„ธ์„œ ๋ฐ ๋ฆฌ๋ทฐ ํšŒ์˜ ๋Œ€ํ™” ๊ธฐ๋ก ์ค€๋น„
2๋‹จ๊ณ„ ๐Ÿ” Codex์— REST ํ‘œ์ค€ ์ค€์ˆ˜ ๊ฒ€ํ†  ์š”์ฒญ
API Review Standards
์˜ˆ์ƒ ์‚ฐ์ถœ๋ฌผ api-review-log.md
๊ณผ์ œ์‹ค ์ž…์žฅ
MISSION 2
Mission 2

Mission 2. API ํ…Œ์ŠคํŠธ ์‹œ๋‚˜๋ฆฌ์˜ค ์ƒ์„ฑ ์‹ค์Šต

Mission 02: ์ •์ƒยท์˜ˆ์™ธ ํ…Œ์ŠคํŠธ ์‹œ๋‚˜๋ฆฌ์˜ค ๋„์ถœ

์™„์„ฑ๋œ API ๊ณ„์•ฝ์„œ๋ฅผ ๋ฐ”ํƒ•์œผ๋กœ Happy Path ๋ฐ ๊ฒฝ๊ณ„๊ฐ’ ์˜ˆ์™ธ Sad Path ํ…Œ์ŠคํŠธ ์ผ€์ด์Šค๋ฅผ ์ƒ์„ฑํ•ฉ๋‹ˆ๋‹ค.

๋ชฉํ‘œ ์ˆ˜์น˜API ํ…Œ์ŠคํŠธ ์‹œ๋‚˜๋ฆฌ์˜ค ์™„์„ฑ
ํ•ต์‹ฌ ๋„๊ตฌCodex Client Workspace
์‹ค์Šต ๋ฒ”์œ„API Test Scenarios
1๋‹จ๊ณ„ ๐Ÿ“‚ API ๊ณ„์•ฝ์„œ ์ŠคํŽ™ ์ค€๋น„
2๋‹จ๊ณ„ ๐Ÿ›ก๏ธ Codex๋กœ ์ •์ƒ/์˜ˆ์™ธ ์ผ€์ด์Šค ๋„์ถœ
Test Scenarios Quality Guard
์˜ˆ์ƒ ์‚ฐ์ถœ๋ฌผ api-test-scenarios.md
๊ณผ์ œ์‹ค ์ž…์žฅ
MISSION 3
Mission 3

[๊ณผ์ œ] Mission 3. ํ•€ํ…Œํฌ ์˜คํ”ˆ๋ฑ…ํ‚น API ๋ช…์„ธ

Skill Mission 1: ๊ณ„์ขŒ ์กฐํšŒ/์ด์ฒด OpenAPI 3.0 & Error ์ŠคํŽ™

์˜คํ”ˆ๋ฑ…ํ‚น ์†ก๊ธˆ, ๊ณ„์ขŒ ์ž”์•ก ์กฐํšŒ, ๊ฑฐ๋ž˜ ๋‚ด์—ญ API์˜ OpenAPI 3.0 YAML ๋ช…์„ธ ๋ฐ OAuth2 ์—๋Ÿฌ ๊ทœ๊ฒฉ์„ ์ž‘์„ฑํ•ฉ๋‹ˆ๋‹ค.

๋ชฉํ‘œ ์ˆ˜์น˜OpenAPI 3.0 YAML ์ŠคํŽ™ ์ž‘์„ฑ ์™„๋ฃŒ
ํ•ต์‹ฌ ๋„๊ตฌCodex Client
์‹ค์Šต ๋ฒ”์œ„Skill Task Mission (Level 1)
1๋‹จ๊ณ„ ๐Ÿ“ ์˜คํ”ˆ๋ฑ…ํ‚น ์—”๋“œํฌ์ธํŠธ ๋ฐ ์ธ์ฆ ํ—ค๋” ํŒŒ์‹ฑ
2๋‹จ๊ณ„ โš™๏ธ 401/403/422 ์—๋Ÿฌ ์‘๋‹ต ํ‘œ์ค€ํ™” ์ŠคํŽ™ ๋„์ถœ
Skill Mission OpenBanking OpenAPI 3.0
์˜ˆ์ƒ ์‚ฐ์ถœ๋ฌผ fintech-openapi-specification.yaml
๊ณผ์ œ์‹ค ์ž…์žฅ
MISSION 4
Mission 4

[๊ณผ์ œ] Mission 4. ๋ฐฐ๋‹ฌ ์ฃผ๋ฌธ-๋ผ์ด๋” API Audit

Skill Mission 2: ์‹ค์‹œ๊ฐ„ ์œ„์น˜์ถ”์  API ์ •ํ•ฉ์„ฑ & Breaking Change

์‹ค์‹œ๊ฐ„ ๋ฐฐ๋‹ฌ ์ฃผ๋ฌธ ์ƒ์„ฑ, ๋ผ์ด๋” ๋งค์นญ, ์œ„์น˜ ์ถ”์  API์˜ Sequence-ERD ์ •ํ•ฉ์„ฑ ๋ฐ ํ˜ธํ™˜์„ฑ์„ ์˜ค๋””ํŒ…ํ•ฉ๋‹ˆ๋‹ค.

๋ชฉํ‘œ ์ˆ˜์น˜API Audit ํ‘œ & Breaking Change ๋ณด๊ณ ์„œ ๋„์ถœ
ํ•ต์‹ฌ ๋„๊ตฌCodex Client
์‹ค์Šต ๋ฒ”์œ„Skill Task Mission (Level 2)
1๋‹จ๊ณ„ ๐Ÿ“ ๋ผ์ด๋” ๋งค์นญ API์™€ Sequence/ERD ๋Œ€์กฐ
2๋‹จ๊ณ„ ๐Ÿ›ก๏ธ v1-v2 ๋ฒ„์ „ ํ˜ธํ™˜ ์œ„ํ˜‘ ๋ฐ ๋ถ€์ • ํ…Œ์ŠคํŠธ ๋„์ถœ
Skill Mission Delivery API Breaking Change
์˜ˆ์ƒ ์‚ฐ์ถœ๋ฌผ delivery-api-audit-report.md
๊ณผ์ œ์‹ค ์ž…์žฅ