Skip to content

Latest commit

 

History

History
350 lines (285 loc) · 8.73 KB

demo_scenario.md

File metadata and controls

350 lines (285 loc) · 8.73 KB

AI 엔지니어링 데모 시나리오

이 문서는 AWS 한국 사용자 그룹 데모에서 진행한 AI 기반 개발 과정을 정리한 것입니다.

1. 프로젝트 초기 설정

1.1 프로젝트 생성

프론트엔드와 백엔드를 포함하는 TODO 애플리케이션을 만들어줘.
  • React + TypeScript + Vite 기반의 프론트엔드 설정
  • AWS CDK 기반의 백엔드 설정
  • 프로젝트 구조 설계

1.2 문서화

프로젝트 문서를 만들어줘. doc 디렉토리에 design.md와 todo.md를 만들어서 설계와 할일 목록을 정리해줘.
  • 프로젝트 설계 문서 작성
  • 할 일 목록 작성
  • 개발 단계 정의

2. 프론트엔드 개발

2.1 기본 기능 구현

프론트엔드부터 구현해줘. React Query를 사용해서 구현하고, 백엔드 연동은 나중에 하자.
  • TODO 목록 표시
  • TODO 추가/삭제 기능
  • 완료 상태 토글 기능

2.2 기능 개선

알아서 순서대로 다 만들어 줘.
  • TODO 수정 기능 추가
  • 검색 및 필터링 기능
  • 정렬 기능 구현
  • 다크 모드 지원

3. 백엔드 개발

3.1 인프라 설정

백엔드 구현 시작해줘.
  • CDK 프로젝트 초기화
  • DynamoDB 테이블 정의
  • Lambda 함수 설정
  • API Gateway 구성

3.2 API 구현

  • TODO CRUD API 구현
  • DynamoDB 연동
  • CORS 설정
  • 에러 처리

4. 보안 및 규정 준수

4.1 보안 분석

이 프로젝트가 K-ISMS를 충족시키는지 매핑 테이블을 만들어줘.
  • K-ISMS 요구사항 분석
  • 현재 구현 상태 매핑
  • 개선 필요 사항 도출

5. 주요 프롬프트 패턴

5.1 단계별 구현 요청

[기능]부터 구현해줘. [도구/기술]을 사용해서 구현하고, [작업]은 나중에 하자.
  • 명확한 우선순위 설정
  • 사용할 기술 스택 지정
  • 후순위 작업 명시

5.2 포괄적 구현 요청

알아서 순서대로 다 만들어 줘.
  • AI가 최적의 구현 순서 결정
  • 필요한 기능 자동 식별
  • 체계적인 구현 진행

5.3 문서화 요청

[주제]에 대해 [문서 형식]으로 정리해줘.
  • 명확한 문서화 대상 지정
  • 원하는 문서 형식 지정
  • 구체적인 내용 요청

6. 데모 결과

6.1 구현된 기능

  • 프론트엔드: TODO CRUD, 검색, 필터링, 정렬, 다크모드
  • 백엔드: 서버리스 아키텍처, REST API
  • 문서: 설계, 할일, 보안 규정 준수

6.2 시사점

  1. AI 도구를 활용한 개발 생산성 향상
  2. 체계적인 프로젝트 관리 가능
  3. 품질과 보안 고려한 개발 진행
  4. 효율적인 문서화 작업

7. 향후 개선 사항

7.1 기술적 개선

  • 테스트 코드 작성
  • CI/CD 파이프라인 구축
  • 성능 최적화

7.2 프로세스 개선

  • 자동화된 품질 검증
  • 보안 취약점 점검
  • 지속적인 문서 업데이트

8. 문서화 개선

8.1 문서 연결

프로젝트 내부의 마크다운 문서 링크를 README.md에 추가해줘.
  • 프로젝트 문서 섹션 추가
  • 각 문서의 목적 명시
  • 문서 간 연결성 강화

8.2 시각화 개선

README.md의 시스템 아키텍처를 mermaid로 바꿔줘.
  • ASCII 다이어그램을 mermaid로 변경
  • 컴포넌트 간 관계 상세화
  • 시각적 가독성 개선

9. 주요 시사점

9.1 AI 도구의 장점

  1. 빠른 프로토타이핑

    • 기본 기능 신속 구현
    • 반복적인 코드 작성 자동화

  2. 문서화 효율성

    • 상세한 문서 자동 생성
    • 일관된 형식 유지

  3. 아키텍처 시각화

    • 다이어그램 자동 생성
    • 다양한 표현 방식 지원

9.2 효과적인 프롬프트 전략

  1. 단계적 접근

    • 명확한 목표 설정
    • 순차적 작업 진행

  2. 문맥 유지

    • 이전 작업 참조
    • 일관성 유지

  3. 피드백 반영

    • 결과물 검토
    • 필요시 수정 요청

10. 마무리

10.1 완료된 작업

  • 프론트엔드 기능 구현
  • 백엔드 인프라 설계
  • 보안 요구사항 분석
  • 문서화 및 시각화

10.2 다음 단계

  • 백엔드 API 구현
  • 프론트엔드 연동
  • CI/CD 파이프라인 구축
  • 보안 개선사항 적용

11. AI와의 대화

11.1 개발자 분석 요청

지금까지 나랑 일해보니까 나는 어떤 개발자 인것 같아?
  • 체계적인 접근 방식 분석
  • 품질 중심 개발 스타일 파악
  • AWS 전문성 확인

11.2 개선점 도출

내가 더 나은 개발자가 되려면 어떻게 해야 할까 조언 해줘.
  • TDD 도입 제안
  • DevOps 프로세스 강화
  • 성능 최적화 방안
  • 새로운 기술 도전 권장
  • 지식 공유 확대 제안

11.3 리더십 평가

아마존 리더십 프시리펄에 비추어서 나의 장점과 단점 세 가지를 알려줘.
  • 고객 집착, 결과 도출, 혁신과 단순화 측면의 강점
  • 최고 수준 고집, 크게 생각하기, 학습과 호기심 측면의 개선점

11.4 피어 리뷰 문서화

니가 나에게 해 준 피어 리뷰 내용을 정리해서 문서화해서 doc폴더에 저장해줘.
  • 개발자 특성 분석 정리
  • 구체적인 개선 제안
  • 리더십 원칙 기반 평가
  • 발전 방향 제시

12. AI 페어 프로그래밍의 효과

12.1 즉각적 피드백

  • 코드 품질 개선
  • 설계 검증
  • 문서화 강화

12.2 개발자 성장

  • 객관적 평가 제공
  • 구체적 개선점 파악
  • 발전 방향 수립

12.3 생산성 향상

  • 신속한 프로토타이핑
  • 효율적 문서화
  • 자동화된 코드 생성

13. 결론

13.1 AI 도구의 가치

  • 개발 생산성 향상
  • 품질 관리 지원
  • 객관적 피드백 제공

13.2 효과적인 활용 방안

  • 명확한 목표 설정
  • 단계적 작업 진행
  • 지속적 피드백 활용

13.3 향후 발전 방향

  • AI 도구 활용 확대
  • 자동화 수준 향상
  • 개발 프로세스 최적화

14. CI/CD 구축

14.1 GitHub Actions 설정

프론트를 github actions를 이용해서 frontend 업데이트가 일어날때마다 github pages에 배포하고 싶어.
  • GitHub Actions 워크플로우 생성
  • 프론트엔드 자동 배포 파이프라인 구축
  • Vite 설정 업데이트

14.2 주요 구성 요소

  1. 트리거 설정

    • main 브랜치 푸시
    • frontend 디렉토리 변경

  2. 작업 단계

    • 코드 체크아웃
    • Node.js 환경 설정
    • 의존성 설치
    • 프로덕션 빌드
    • GitHub Pages 배포

  3. 환경 변수

    • API 엔드포인트 설정
    • GitHub 토큰 관리

14.3 GitHub Pages 설정

깃헙 cli로 설정을 진행해줘.

  1. GitHub CLI 설정 시도

    # API를 통한 Pages 설정 시도
gh api \
  -H "Accept: application/vnd.github+json" \
  -H "X-GitHub-Api-Version: 2022-11-28" \
  repos/awskrug/aiengineering-demo/pages \
  -f source='{"branch":"gh-pages"}'
    • API 베타 상태로 인한 제한사항 확인
    • CLI를 통한 직접 설정 불가 확인

  2. 대안 설정 진행

    # 저장소를 public으로 설정
gh repo edit awskrug/aiengineering-demo --visibility public --accept-visibility-change-consequences

# API 엔드포인트 시크릿 설정
gh secret set VITE_API_ENDPOINT --body "https://api.todo.awskrug.dev"

  3. 수동 설정 필요 사항

    • GitHub 웹 인터페이스에서 Settings > Pages로 이동
    • Source를 'GitHub Actions'로 설정

  4. 배포 URL

14.4 설정 시 참고 사항

  • GitHub Pages API는 아직 베타 상태
  • CLI를 통한 직접 설정은 현재 미지원
  • 저장소는 반드시 public이어야 함
  • GitHub Actions 워크플로우가 배포를 담당
  • 웹 인터페이스 설정은 최초 1회만 필요

15. AI와의 대화

15.1 개발자 분석 요청

지금까지 나랑 일해보니까 나는 어떤 개발자 인것 같아?
  • 체계적인 접근 방식 분석
  • 품질 중심 개발 스타일 파악
  • AWS 전문성 확인

15.2 개선점 도출

내가 더 나은 개발자가 되려면 어떻게 해야 할까 조언 해줘.
  • TDD 도입 제안
  • DevOps 프로세스 강화
  • 성능 최적화 방안
  • 새로운 기술 도전 권장
  • 지식 공유 확대 제안

15.3 리더십 평가

아마존 리더십 프시리펄에 비추어서 나의 장점과 단점 세 가지를 알려줘.
  • 고객 집착, 결과 도출, 혁신과 단순화 측면의 강점
  • 최고 수준 고집, 크게 생각하기, 학습과 호기심 측면의 개선점

15.4 피어 리뷰 문서화

니가 나에게 해 준 피어 리뷰 내용을 정리해서 문서화해서 doc폴더에 저장해줘.
  • 개발자 특성 분석 정리
  • 구체적인 개선 제안
  • 리더십 원칙 기반 평가
  • 발전 방향 제시