AI-Native 소프트웨어 개발: GitHub Spec Kit을 활용한 Spec-Driven Development

 

 

출처: 임정환 교수님

 

AI Native

 

AI Engineering (AE)
Agentic AI System (AS)
AI Native (AN)

 

팀리더

팀원

 

역할의 이동

개발자의 구현 -> AI

 

AI 폭주

-> 리더에 통제의 기술 필요

 

행위와 평가를 분리

 

프롬프트 엔지니어링

Skills

 

바이브코딩 / 문서가 없음 -> AI코딩 / 규칙 필요

 

3-File System

PRD (Product Requirements Document)

요구사항 / 분석 / 구현

 

Ralph Loop

 

Spec Kit

 

명세

executable PRD (Product Requirements Document) -> Tasks

AI가 읽어서 실행 가능한 PRD

Spec 

Spec Kit ToolKit

 

하네스 엔지니어링

 

Transformer (2017)

 

Transformer (2017) -> GPT (2022) -> VLM (2024) -> VLA (2026)

 

ViT (Vision Transformer)

text -> VLM (vision-language models) -> text

 

text, image -> VLA (Vision Language Action) (deepmind Robotics, nvidia GR00T, Physical Intelligence π) -> action

 

 

 

 

 

ctrl + shift + v

 

그린필드 소프트웨어 개발은 개발자들이 기존 시스템, 프레임워크, 또는 제약에 의존하지 않고 프로젝트를 처음부터 시작하는 것

브라운필드 소프트웨어 개발은 기존 시스템을 개선, 업그레이드 또는 확장해야 할 때 가장 적합

 

Constitution, Spec, Clarify, Analyze, Plan, Tasks, Implement

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

스펙은 명확한 경계가 필요 -> 그래야 구현이 가능

 

 

 

 

.github <- copilot

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

728x90

Vibe Coding Risk -> 문서 X

 

Test First

-> TDD

 

Test First -> Test Driven Development

-> AI 폭주 <- 목표 , SC , AC

-> 설계자, 기준을 만들고 기준을 통과하게 하는 테스트 시나리오를 만들고, 시나리오를 통과하는 코드를 AI 가 만듬

 

MVP 까지는 되는데, 서비스까지는 어렵다.

-> 규칙필요

 

규칙 -> 요구사항 -> 설계 -> 작업 -> 구현
constitution
Specify
Plan
Tasks
Implement

 

‍Smoke tests
E2E test 

 

 

 

 

 

Callback

https://code.visualstudio.com/docs/copilot/customization/hooks

Agent hooks in Visual Studio Code (Preview)

 

 

.specify/memory/constitution.md

-> 직접수정은 금지

 

Clean Architecture

 

 

 

 

plan -> task 

plan 이 불분명하면, task 도 불분명해짐 -> clarify

 

 

 

 

 

Select-String -Path specs/001-todo-cli/spec.md -Pattern "NEEDS CLARIFICATION"

 

 

 

Speckit toolkit (SDD)

 

constitution -> specify 사용자문제정의 SC, AC -> ( clarify ) -> plan -> task -> ( analyze ) -> implement

 

 

 

task -> implement, phase 1~N 

 

 

 

 

 

uv run pytest -v

 

 

 

 

 

 

GreenField vs BrownField

신규 vs legacy, 회귀문제, TDD , spec / 순서-기능명세, specify 로 시작 ( branch )

 

spec.md 는 AC, SC 가 바뀌면 new branch 로

 

 

 

 

 

-> Spec
-> Plan / Tasks ( 대부분의 BUG ) / Analyze / Implement

 

Cascade 진행은 비권장

 

 

 

 

 

speckit init

AI coding Agent <-> LLM

( Github Copilot : .github , copilot-instructions.md ) 

- .github -> promps ( slash command ) , agent , copilot-instructions.md ( rule )
- .specify -> memory\constitution.md ( public rule , TDD AI 폭주 방지 ) 
- specs -> feature branch -> spec.md ( 사용자 시나리오 , 비즈니스 로직 , AC 와 SC 의 명확한 완료 기준 ) , clarify 는 spec 수정 , plan.md ( 기술스택 , 구현버전정보 , 클린아키텍처 , 물리적구조 ) , task.md ( 너무 크거나 작지 않게 분리 ) , 재귀적 analyze 진행 , Implement 구현

그린필드 -> 코드수정 X