아기다리고기다리던 spec kit

이우철·2025년 10월 18일
post-thumbnail

spec kit : https://github.com/github/spec-kit
의도 중심 개발,
/specify로 무엇/왜를 기술하고, /plan으로 스택/아키텍처를 선언하며, /tasks로 작업 단위를 생성
명세 주도 방식을 통해 품질과 속도 모두를 끌어올리려는 실험적 프레임워크

결국, 느낌만으로 툭툭 던지던 ai 활용 개발에서, 체계화된 명세로 부터 산출물로 이어지는 일반적 개발 과정을 ai 를 이용하여 규격화 하는 프레임워크 (개인적인 생각...)

  • Spec Driven Dev - 체계적 접근
  1. 원칙 - constitution , 프로젝트 기본 원칙 설정
  2. 명세 - specify , 무엇을 만들지 상세하게 정의
  3. 명확화 - clarify, 불분명한 부분을 질문으로 해소
  4. 계획 - plan, 기술 스택과 아키첵처 결정
  5. 작업분해 - tasks , 실행 가능한 단위로 쪼개기
  6. 구현 - implement, 자동으로 코드 생성
  7. 검증 - analyze, 명세와 코드 일치 확인

  • init proj_name

TOOL을 gemini 로 설정해 주고...나면 폴더 생성과 파일들이 생성됨

  • gemini 실행
    cd tech_repo (프로젝트명) 한 후 gemini를 실행해보면 아래와 같이 실행되고 /speckit 관련 명령이 뜸을 알 수 있음

  1. 원칙 작성 (constitution)
    /speckit.constitution\
    \ 프로젝트 원칙 :
    코드 품질 : ~~
    테스트 : ~~
    사용자 경험 : ~
    성능 : ~

  2. 명세 작성 (specify)
    /spekit.specify\
    \ 무엇을 만들것이며.
    기능은 어떻고~~
    요구사항 :
    제약사항 :

    결국 기획 내용임

--> spec.md 확민 수정

3.명확화 (clarify) : ai 와 질의응답을 통해 작업을 구체화 함
/speckit.clarify

  1. 계획 (plan) : 기술스택, 아키텍처, 구조정의 >> 구현계획 수립
    /speckit.plan

-> plan.md 확인 및 수정

  1. 작업분해 (tasks)
    /speckit.tasks

-> tasks.md 확인 및 수정

  1. 구현 (implement) : 개발에 들어감
    /speckit.implement

--> tasks.md 내용대로 순서대로 실행

profile
개발 정리 공간 - 업무일때도 있고, 공부일때도 있고...

0개의 댓글