diff --git a/AGENTS.md b/AGENTS.md index 6b3587d5..5915582a 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -1,6 +1,6 @@ # AGENTS.md — 백엔드 템플릿의 정본 -Java 21 + Spring Boot Gradle 멀티모듈 Clean Architecture 템플릿이다(버전은 `src/gradle/libs.versions.toml`, 기본 패키지 `dev.caskeleton`). 서비스는 이 repo를 받아 도메인·유스케이스·adapter만 채운다. 모듈 경계와 의존 방향은 바꾸지 않고, 게이트가 그것을 증명한다. 업무 예제·배포 인프라는 두지 않는다. 속도보다 아키텍처 보존이 먼저다. +Java 21 + Spring Boot Gradle 멀티모듈 Clean Architecture 템플릿이다(버전은 `src/gradle/libs.versions.toml`, 기본 패키지 `dev.caskeleton`). 서비스는 이 repo를 받아 도메인·유스케이스·adapter만 채운다. 모듈 경계와 의존 방향은 바꾸지 않고, 게이트가 그것을 증명한다. 업무 예제·배포 인프라는 두지 않는다. 속도보다 아키텍처 보존이 먼저다. 비전 전문은 `docs/vision.md`(소유자가 쓴다), 문제 정의는 `docs/problem-statement.md`다. ## HARD-STOP — 하나라도 어기면 동작해도 완료가 아니다 diff --git a/docs/README.md b/docs/README.md index 21489589..4ba6ed42 100644 --- a/docs/README.md +++ b/docs/README.md @@ -100,6 +100,8 @@ capability(부가 기능) 하나의 지원 범위, 설정, 보안, 운영, 마 | --- | --- | | [capability-status.md](capability-status.md) | capability마다 코드가 있나·조립되나·실제 제공자로 검증됐나, 그리고 지운 코드의 표(「제거된 코드」) | | [storage-capability-boundary.md](storage-capability-boundary.md) | 파일 서버와 객체 저장소가 각각 맡는 경계 | +| [vision.md](vision.md) | 비전: 누구의 어떤 문제를 푸나, 성공하면 무엇이 달라지나, 속도보다 먼저 지킬 것(세 문장, 소유자가 쓴다. 에이전트는 읽기만 한다) | +| [problem-statement.md](problem-statement.md) | 문제 정의: 고객의 말 그대로, 지금 버티는 법, 하지 않는 것, 잴 수 있는 성공 기준 | ## 문서 수명과 언어 diff --git a/docs/problem-statement.md b/docs/problem-statement.md new file mode 100644 index 00000000..3889b7ac --- /dev/null +++ b/docs/problem-statement.md @@ -0,0 +1,34 @@ +# 문제 정의 — clean-architecture-backend-template + +> 아이디어가 아니라 고객의 문제에서 출발한다. 좋은 스펙은 헷갈리지 않게 하는 스펙이다. +> 바뀌면 고친다(살아 있는 문서). 왜 바꿨는지는 커밋 본문이나 결정 기록에 남긴다. + +## 고객의 말 그대로 + +- (채울 것: 고객이 실제로 한 말을 따옴표로. 해석하지 않는다) + +## 지금은 어떻게 버티나 + +- (채울 것: 고객이 지금 쓰는 우회 방법과 그 비용) + +## 하지 않는 것 + +- (채울 것: 이번에 일부러 풀지 않는 문제, 만들지 않는 기능) + +## 성공 기준 + +| 기준 | 구체적으로 | 어떻게 재나 | 목표 값 | 기한 | +|---|---|---|---|---| +| (채울 것) | | | | | + +## 세 관점 점검 + +| 관점 | 묻는 것 | 답 | +|---|---|---| +| 비즈니스 | 돈이 되나, 누가 대가를 치르나 | (채울 것) | +| 기술 | 만들 수 있나, 가장 위험한 가정은 | (채울 것) | +| 고객 | 쓸모 있나, 지금 방법보다 나은가 | (채울 것) | + +## 되돌릴 수 없는 결정 + +- (채울 것: 되돌리기 비싼 결정만 여기 적고 `docs/adr/`에 결정 기록을 남긴다. 되돌릴 수 있는 결정은 빨리 한다) diff --git a/docs/vision.md b/docs/vision.md new file mode 100644 index 00000000..4f1fa798 --- /dev/null +++ b/docs/vision.md @@ -0,0 +1,10 @@ +# 비전 — clean-architecture-backend-template + +> 소유자가 직접 쓴다. AI에게 맡기지 않는다. 방향·목적·철학만, 길어야 세 문장이다. +> 에이전트는 이 문서를 읽기만 한다. 고칠 일이 보이면 제안만 한다. + +1. 누구의 어떤 문제를 푸는가: (채울 것) +2. 성공하면 무엇이 달라지나(잴 수 있게): (채울 것) +3. 속도보다 먼저 지킬 것: (채울 것) + +점검 질문: 이 목표를 다 이뤘는데도 실패한다면 무엇 때문일까? 그 답이 빠진 목표다.