Claude Skills를 활용한 Starlette 1.0 실험 및 AI 코딩 에이전트 활용기

섹션별 상세

Starlette 1.0은 FastAPI의 기반이 되는 ASGI 프레임워크로, 이번 릴리스에서 lifespan 메커니즘을 도입하며 기존 시작/종료 핸들러 방식을 대체했다. 비동기 컨텍스트 매니저를 사용하는 이 방식은 리소스 관리를 더욱 직관적이고 안전하게 만들어주지만, 이전 버전과의 하위 호환성이 깨지는 변경 사항을 포함한다.

python

@contextlib.asynccontextmanager
async def lifespan(app):
    async with some_async_resource():
        print("Run at startup!")
        yield
        print("Run on shutdown!")

app = Starlette(
    routes=routes,
    lifespan=lifespan
)

Starlette 1.0에서 새롭게 도입된 lifespan 메커니즘을 사용한 앱 시작 및 종료 로직 구현 예시

LLM의 학습 데이터 컷오프 문제를 해결하기 위해 Claude의 'skill-creator'를 사용하여 Starlette 1.0 전용 스킬을 구축했다. Claude는 직접 GitHub 저장소를 클론하고 소스 코드를 분석하여 최신 API 사양과 코드 예시가 담긴 마크다운 문서를 생성했으며, 이를 사용자 계정의 스킬로 즉시 등록할 수 있었다.

Claude 인터페이스에서 Starlette 1.0 스킬을 생성하고 등록하는 과정을 보여주는 스크린샷이다. — Screenshot사용자가 Starlette 1.0 저장소를 클론하여 스킬 문서를 만들도록 요청한 결과, Claude가 단계별 전략을 수립하고 'Copy to your skills' 버튼을 통해 사용자 환경에 기능을 추가하는 과정을 시각적으로 증명한다.

새롭게 학습된 스킬을 바탕으로 Claude는 프로젝트, 작업, 댓글 기능을 갖춘 복잡한 작업 관리 애플리케이션인 'TaskFlow'를 단일 프롬프트로 구현했다. 이 과정에서 SQLite와 Jinja2 템플릿을 결합한 완전한 스택을 구성했으며, Starlette 1.0의 새로운 문법을 정확하게 적용했다.

Claude가 생성한 Starlette 기반 작업 관리 앱 'TaskFlow'의 칸반 보드 UI이다. — Screenshot단일 프롬프트로 생성된 애플리케이션이 실제 작동 가능한 수준의 UI와 프로젝트 관리 기능을 갖추고 있음을 보여준다. 이는 AI가 복잡한 요구사항을 실제 동작하는 소프트웨어로 구현할 수 있음을 입증하는 사례이다.

Claude는 코드 작성에 그치지 않고 TestClient와 httpx를 활용한 테스트 스크립트를 스스로 작성하고 실행하여 애플리케이션의 정상 작동 여부를 검증했다. 이는 Claude가 단순한 챗봇을 넘어 코드를 작성, 실행, 디버깅하는 통합적인 코딩 에이전트로서 동작할 수 있음을 입증한다.

python

from starlette.testclient import TestClient
from main import app
client = TestClient(app)
r = client.get('/api/stats')
print('Stats:', r.json())
// ...(중략)
r = client.post('/api/tasks', json={'title':'Test task','project_id':1,'priority':'high','label_ids':[1,2]})
print('Created task:', r.status_code, r.json()['title'])
print('
All tests passed!')

Claude가 생성한 코드를 검증하기 위해 스스로 작성하고 실행한 테스트 스크립트

용어 해설

비동기 서버 게이트웨이 인터페이스(ASGI): — Python 비동기 웹 애플리케이션과 서버 간의 표준 인터페이스이다. WSGI의 후속 사양으로, HTTP뿐만 아니라 WebSocket과 같은 양방향 프로토콜을 지원하며 높은 동시성 처리가 필요한 현대적 웹 환경에서 필수적이다.
라이프스팬 프로토콜(Lifespan Protocol): — 애플리케이션의 시작과 종료 시점에 실행될 로직을 관리하는 규약이다. Starlette 1.0에서는 기존의 개별 핸들러 방식 대신 비동기 컨텍스트 매니저를 사용하여 리소스의 할당과 해제를 단일 흐름 내에서 안전하게 처리한다.
스킬 크리에이터(Skill Creator): — Claude.ai 인터페이스 내에서 특정 도구나 라이브러리에 대한 전문 지식을 문서화하여 모델의 기능을 확장하는 도구이다. 모델이 최신 라이브러리 사양을 스스로 학습하고 이를 기반으로 코드를 생성하도록 유도하는 데 사용된다.

기술

Starlette 1.0
Claude 3.5 Sonnet
Python
SQLite
Jinja2
httpx

활용 사례

최신 라이브러리 기반 웹 애플리케이션 자동 생성
AI 에이전트를 활용한 자율적 코드 테스트 및 검증
LLM 지식 확장을 위한 커스텀 스킬 구축

언급된 리소스

GitHubStarlette GitHub Repository

GitHubSimon Willison's Research Repository