Plan v2 — PADG

AutoGen 프로젝트 종합 통합 개발 기획서 v2

org: autogen-labs (GitHub) · Cloudflare prod-only account 1:1
workspace: /Users/marco/develop/autogen-labs
naming SSOT: docs/NAMING_AND_TOPOLOGY.md
base plan: plans/autogen-platform-plan-v1.md
source upgrade: AutoGen_PADG_통합기획서.md (Planning Stage 분리형 PADG 도입안)

0. 개정 목적

v1은 “20분 내 사업 기획부터 배포까지 완료하는 생성 엔진”을 목표로 한 통합안이었다.
이번 v2는 그 전제를 더 명확히 분리한다.

핵심 개정:

Planning Stage와 Generation Stage를 분리한다.
두 첨부 기획서의 핵심(Reference Research, IA Evaluation, Architecture 판단, Development Segmentation, Task Contract)은 전부 Planning Stage로 이동시킨다.
AutoGen의 20분 약속은 Confirm 이후의 순수 실행 구간에만 적용한다.
배포 이후 변경은 Growth Phase에서 재기획 후 다시 Freeze한다.

즉, v2의 목표는 “더 빨리 만들기”가 아니라, 무엇을 만들지 결정하는 구간과 실제로 만드는 구간을 분리하여 구조를 단순화하는 것이다.

1. 결론

Planning Stage (가변 소요시간, Human 또는 Agent) → Confirm(Freeze) → AutoGen Generation Engine (고정 ~20분, 실행 전담) → Growth Phase (배포 이후, 무제한)

이 구조로 재정의하면 다음이 가능해진다.

문서 ①·②의 기획/아키텍처/IA/세그먼트/컨트랙트 설계를 축소하지 않고 그대로 반영할 수 있다.
Generation Engine은 판단을 하지 않고, Freeze된 DevelopmentGraph를 실행만 한다.
Human 검토 경로와 Agent 자동확정 경로를 동일한 Frozen Spec 포맷으로 수렴시킬 수 있다.
Growth Phase는 별도 예산이므로 Control Tower, ADR, Impact Analysis, Cost Dashboard를 원안대로 확장할 수 있다.

2. v1 대비 v2 변경 요약

항목	v1	v2
20분 범위	Plan + Generate가 일부 섞인 형태	Generate만 20분
IA / Architecture 판단	생성 흐름 안의 일부	Planning Stage 전담
Confirm Gate	생성 파이프라인 중 일부	Freeze 경계선
Task Contract	실행용 상세 명세	Frozen Spec의 핵심 산출물
변경 요청 처리	재생성 흐름 내 혼재 가능	Growth Phase → Re-Planning → Re-Freeze
운영 안정성	생성 예산 압박 존재	판단과 실행 예산 분리로 단순화

3. 전체 운영 모델

3.1 3단계 구조

flowchart TD
    subgraph PLAN["① PLANNING STAGE (가변 소요시간)"]
        direction TB
        P1["Business Definition"] --> P2["Reference Research"]
        P2 --> P3["Product / Domain Architecture"]
        P3 --> P4["IA / User Flow"]
        P4 --> P5["IA Evaluation Agent"]
        P5 --> P6["Content Architecture / Design DNA"]
        P6 --> P7["Technical Architecture Mapping"]
        P7 --> P8["Development Segmentation<br/>(Task Contract 생성)"]
        P8 --> P9{"Confirm?"}
    end

    P9 -->|Human 검토| P9
    P9 -->|Agent 자동확정| P9
    P9 -->|CONFIRMED| FREEZE["Frozen Spec\n(IntentGraph + ArchitectureGraph + DevelopmentGraph)"]

    subgraph GEN["② AUTOGEN ENGINE (고정 ~20분, 실행 전담)"]
        direction TB
        G1["Task Contract 병렬 실행"] --> G2["Deterministic Validation"] --> G3["Completion Gate"] --> G4["배포"]
    end

    FREEZE --> G1

    subgraph GROWTH["③ GROWTH PHASE (배포 이후, 무제한)"]
        direction TB
        H1["Change / Marketing Proposal"] --> H2["Impact Analysis"] --> H3["Human Approval Gate"]
    end

    G4 --> GROWTH
    H3 -->|재확정| PLAN

3.2 해석

Planning Stage: 무엇을 어떤 구조로 만들지 결정하는 구간
Freeze: 버전이 고정된 스펙을 생성하는 경계선
Generation Engine: Freeze된 스펙을 정확히 실행하는 구간
Growth Phase: 배포 이후 개선과 변경을 다시 기획하는 구간

4. Planning Stage 상세

4.1 역할

Planning Stage는 다음 질문에 답한다.

무엇을 만들 것인가?
어떤 IA와 흐름으로 구성할 것인가?
어떤 기술 구조와 세그먼트로 분해할 것인가?
어떤 Task Contract가 실행 단위가 될 것인가?

4.2 포함 범위

두 첨부 기획서의 핵심은 다음과 같이 재배치한다.

Planning 요소	포함 내용
Business Definition	사업 목적, 고객군, 가치제안, 범위 정의
Reference Research	경쟁/참고 조사, 벤치마크, 차별점 파악
Product / Domain Architecture	제품 도메인 구조, 핵심 유스케이스, 시스템 경계
IA / User Flow	정보구조, 페이지 트리, 사용자 여정
IA Evaluation Agent	IA 품질 평가, 개선 루프, 확정 기준 산정
Content Architecture / Design DNA	콘텐츠 구조, 톤앤매너, 디자인 방향성
Technical Architecture Mapping	프런트/백엔드/인프라/데이터 매핑
Development Segmentation	실제 구현 단위(Task Contract)로 분해
Confirm Gate	Human 경로 또는 Agent 자동경로로 Freeze

4.3 Planning Stage 산출물

Planning Stage의 최종 산출물은 Frozen Spec이다.

{
  "specVersion": 4,
  "confirmedBy": "agent_auto | human",
  "confirmedAt": "2026-08-26T09:00:00Z",
  "intentGraph": {},
  "architectureGraph": {},
  "developmentGraph": {
    "tasks": []
  }
}

Frozen Spec은 읽기 전용이며, Generation Engine은 이 스펙을 수정할 수 없다.

5. Confirm Gate 설계

5.1 이원화 경로

Confirm Gate는 두 가지 방식으로 동작한다.

Human Review 경로
- 사용자가 직접 검토하고 수정한다.
- Version / Diff / Rollback을 허용한다.
- 시간 제한이 없다.
Agent 자동확정 경로
- Planning Agent가 IA 평가, 아키텍처 매핑, 세그먼트 정합성을 점검한다.
- 신뢰도 임계값을 넘으면 자동 Confirm한다.
- 빠른 경우 수십 초~수 분 내에 완료될 수 있다.

5.2 자동확정 기준

평가 항목 예시:

Business alignment
UX clarity
Security readiness
Scalability fit
Implementation completeness
Dependency consistency

자동확정은 “기계적으로 항상 허용”이 아니라, 평가 점수와 신뢰도 임계값을 만족할 때만 수행한다.

6. Generation Engine 상세

6.1 역할

Generation Engine은 오직 하나의 일만 한다.

Freeze된 DevelopmentGraph(Task Contract 전체)를 병렬로 실행한다.

이 구간에서는 “무엇을 만들지” 판단하지 않는다.
판단이 필요하면 그것은 Planning Stage로 되돌려야 한다.

6.2 실행 원칙

Task Contract 기반 병렬 실행
Deterministic Validation
Completion Gate 통과 후 배포
실행 중 스펙 변경 금지

6.3 Category 10 확장

기존 Category 10의 병렬 페이지/IA 오케스트레이션은 v2에서 Planning Stage 내부 하위 워크플로우로 재배치된다.
Generation Engine은 Category 10을 포함한 결과물을 실행할 뿐이다.

7. 신규 Category 11 — PADG Planning Engine

v2에서는 Category 11을 신설한다.

Category 11 — PADG Planning Engine
├── 11.1 Business Definition Agent
├── 11.2 Reference Research Agent
├── 11.3 Product/Domain Architecture Agent
├── 11.4 IA & Design Orchestration (기존 Category 10 포함)
├── 11.5 IA Evaluation Agent
├── 11.6 Technical Architecture Mapper
├── 11.7 Development Segmentation Engine
└── 11.8 Confirm Gate (Human / Agent)

7.1 Category 11의 책임

Plan의 품질과 정합성 확보
Execution 전에 모든 구조를 Freeze 가능 상태로 정리
Generated output이 아닌 운영 가능한 명세를 만든다

7.2 하위 결과물

IntentGraph
ArchitectureGraph
DevelopmentGraph
Task Contract
Confirm metadata

8. Frozen Spec → AutoGen Engine 인터페이스

AutoGen Engine의 입력은 오직 Frozen Spec이다.

{
  "specVersion": 4,
  "confirmedBy": "agent_auto",
  "confirmedAt": "2026-08-26T09:00:00Z",
  "tasks": [
    {
      "taskId": "AUTH-01-API",
      "objective": "로그인 API 구현",
      "dependsOn": ["DB-USER-01"],
      "allowedFiles": ["src/routes/auth.ts"],
      "protectedFiles": ["wrangler.toml"],
      "acceptanceCriteria": ["..."],
      "completionGate": ["lint", "typecheck", "unit_test"]
    }
  ]
}

8.1 규칙

읽기 전용
Execution 중 편집 금지
구조 변경이 필요하면 Planning Stage로 복귀
patch는 새로운 Freeze 버전으로 다시 승인되어야 함

9. 실행 중 예외 처리

Generation 도중 검증 실패가 발생하면 다음 순서로 처리한다.

해당 Task를 isolate 한다.
나머지 병렬 Task는 계속 실행한다.
문제는 즉시 경량 Planning 재평가 루프로 보낸다.
Planning Agent가 patch된 Contract를 반환한다.
해당 Task만 다시 실행한다.

이때 핵심은, 예외가 발생해도 Generation Engine이 스스로 판단을 확장하지 않는 것이다.
판단은 항상 Planning Stage의 영역으로 되돌린다.

10. Growth Phase

Growth Phase는 배포 이후의 확장과 변경을 다룬다.

10.1 포함 기능

Marketing Agent 제안
Change Agent 제안
Impact Analysis
Human Approval Gate
ADR / Control Tower / Cost Dashboard

10.2 순환 구조

Growth Phase에서 승인된 변경은 다시 Planning Stage로 들어간다.
그 후 새로운 버전의 Frozen Spec이 생성되고, Generation Engine이 patch를 실행한다.

11. v1 문서와의 통합 관계

v2는 v1을 대체하기보다, v1의 구조를 더 명확한 시간 분리 모델로 재정렬한 상위 기획이다.

11.1 v1 유지 영역

multi-repo / naming SSOT
Cloudflare / GitHub org 구조
기존 기술 스택
배포 및 CI/CD 원칙
법무/보안/거버넌스의 필요성

11.2 v2에서 재정의하는 영역

20분 타임라인의 범위
Planning vs Generation 분리
Confirm Gate 위치
Category 11 신설
Frozen Spec 인터페이스

11.3 통합 원칙

v1은 플랫폼/사업 구조의 기준 문서, v2는 실행 예산과 결정 경계를 재정의하는 운영 문서다.

두 문서는 충돌하지 않으며, v2가 v1의 생성 파이프라인 해석을 정리한다.

12. 구현 로드맵

Phase	범위	목표
Phase 1	Category 11 신설 및 Planning Stage 명시화	Planning 산출물과 실행 산출물 분리
Phase 2	Confirm Gate 이원화	Human 경로 / Agent 자동경로 둘 다 지원
Phase 3	Frozen Spec 표준화	AutoGen Engine 입력 포맷 고정
Phase 4	Generation Engine 정합성 강화	Task isolate, partial retry, deterministic validation
Phase 5	Growth tooling	Control Tower / ADR / Cost Dashboard / Impact Analysis

13. 최종 결론

이번 v2 개정의 핵심은 단순하다.

Planning과 Generation은 서로 다른 시간 예산을 가진 별개의 단계이며, 그 경계는 Confirm(Freeze)이다.

따라서 첨부된 PADG 기획은 AutoGen의 20분 엔진 안으로 억지로 넣는 것이 아니라, 20분 엔진 이전의 Planning Stage로 이동시켜야 한다.
그 결과 AutoGen은 더 단순하고, 더 안정적이며, 더 확장 가능한 구조가 된다.