BBoilerplate

큐레이션

Super Simple Software Factory

Python 코드가 에이전트의 순서·재시도·검수 기준을 소유하도록 만드는 재현 가능한 코딩 에이전트 워크플로우

Python364+
Super Simple Software Factory 대표 이미지

요약

Super Simple Software Factory(SSSF)는 코딩 에이전트를 한 번 호출하고 끝내는 대신, Python이 단계·재시도·검수·추적을 관리하도록 만드는 저장소형 스킬입니다. 에이전트는 이름 있는 한 단계 안에서 일하고, 단계 사이의 문맥은 타입이 있는 JSON envelope로 넘기며, 실행 이벤트는 SQLite에 기록합니다.

도구 소개

공식 README의 핵심 원칙은 Agent proposes, code disposes입니다. 계획·빌드·리뷰 같은 단계는 에이전트가 맡지만, 테스트 실행·커밋·파일 존재 여부 같은 결정론적 작업은 코드 단계로 분리합니다. YAML 설정에서 에이전트별 모델·프롬프트·도구·쓰기 범위를 정하고, gates가 결과물·JSON·테스트·변경 범위를 검수합니다.

저장소에 있는 스킬을 다른 프로젝트에 복사해 스탬프하는 구조라 특정 프레임워크에 종속된 대형 플랫폼보다, 팀의 반복 코딩 업무를 관찰 가능하고 재현 가능한 흐름으로 바꾸는 교육 소재에 가깝습니다.

사용 포인트

  • 기획→구현→리뷰를 분리한 코딩 에이전트 파이프라인 만들기
  • 테스트·린트·커밋처럼 정해진 작업을 에이전트 호출에서 분리하기
  • 단계별 결과와 재작업 이유를 SQLite trace로 확인하기
  • 여러 프로젝트에 같은 에이전트 스킬과 검수 경계를 복사해 적용하기

설치와 시작

공식 README 기준으로 대상 저장소에 스킬을 복사한 뒤 설치 스크립트를 실행합니다.

mkdir -p .claude/skills
cp -r /path/to/super-simple-software-factory/.claude/skills/sssf .claude/skills/
uv run .claude/skills/sssf/scripts/install.py
cp .env.sample .env
just demo
just sessions

수동 설치에는 uv, pi, sqlite3, 사용할 모델 공급자의 API 키가 필요합니다. --force는 설정과 프롬프트를 덮어쓸 수 있으므로 기존 변경을 먼저 커밋해야 합니다.

선정 사유

GitHub API에서 364 stars와 2026-08-04 최신 push를 확인했고, 공식 README의 설치·구조·검수 흐름을 직접 검증했습니다. 500 stars 미만이지만 공식 저장소의 구체적인 설치 절차와 SQLite 추적·단계별 gates라는 실사용 설계가 분명해, AI 코딩 교육과 팀 자동화에 활용할 수 있는 예외 후보로 선정했습니다.

참고

  • GitHub 저장소
  • 공식 README
  • 이미지는 공식 저장소 README의 워크플로우 다이어그램을 사용했습니다.
  • Reddit과 국내 사용자·개발자 커뮤니티를 각각 실제 검색했으나 양쪽 모두 HTTP 202 챌린지와 0 링크로 후보 특정 반응을 검증하지 못했습니다. 익명 반응 요약은 생략했습니다. 정확한 쿼리와 응답은 internal/run-notes/2026-08-05-picks-curation-batch.md에 기록했습니다.