disler/super-simple-software-factory

해결하는 문제

Super Simple Software Factory (SSSF)는 AI 기반 소프트웨어 개발에서의 일관성 부족과 가시성 부족을 해결합니다. 단일 에이전트 루프가 예측 불가능하고 명확한 단계 경계가 없으며 디버깅이 어려운 '균열 없는 기계' 문제를 방지합니다. 제어 플레인을 프롬프트에서 결정론적인 Python 코드로 이동함으로써 소프트웨어 생성이 반복 가능하고, 게이트가 있으며, 가시성이 확보되도록 보장합니다.

작동 방식

SSSF는 코드가 루프를 소유한다는 원칙에 기반합니다. 에이전트는 그 루프 내의 제한된 노드로 작동합니다. AI 개발자 워크플로우(ADW) 스크립트를 사용하여 시퀀싱, 재시도, 수용 기준을 관리합니다.

• 단계: 모든 실행은 단계의 시퀀스입니다. 이는 특정 에이전트가 호출되는 agent 단계 또는 테스트 실행이나 Git 커밋과 같은 결정론적인 Python/bash 단계인 code 단계일 수 있습니다.
• 에이전트 로스터: YAML 구성 파일은 각 에이전트의 정체성(모델, 프롬프트, 도구, 경계)을 정의합니다. 이를 통해 다양한 작업에 다른 모델을 사용할 수 있습니다(예: 계획에는 프론티어 모델, 구축에는 저렴한 모델).
• 엔벨로프와 게이트: 에이전트는 타입 지정된 JSON 엔벨로프를 통해 통신합니다. 에이전트가 완료된 후 '게이트'(자동 검사)가 에이전트의 주장(예: 파일이 실제로 존재하는지, 테스트가 통과하는지)을 검증합니다. 게이트가 실패하면 시스템은 전체 프로세스를 다시 시작하지 않고, 동일한 세션 내에서 에이전트에 재프롬프트를 보내 수정을 유도합니다.
• 가시성: 모든 이벤트(도구 호출 포함)가 실시간으로 SQLite 데이터베이스로 스트리밍됩니다. 제공되는 Vue/Vite 시각화 도구를 통해 트레이스 워터폴을 통해 실행 중인 상태를 실시간으로 모니터링할 수 있습니다.

대상 사용자

간단한 프롬프팅을 넘어서, 에이전트와 코드의 구조화된 시스템으로 전환하여 반복 가능하고 전문적인 수준의 AI 에이전트 워크플로우를 코딩 작업에 구축하고자 하는 소프트웨어 엔지니어.

주요 특징

• 결정론적 제어 플레인: 시퀀싱 및 시퀀싱 로직을 프롬프트에서 Python으로 이동.
• 에이전트-코드 하이브리드: 에이전트의 의사결정과 결정론적 코드 실행을 명시적으로 분리합니다(예: bun test는 에이전트 작업이 아니라 코드 단계).
• 사용자 정의 로스터: 각 에이전트에 대해 모델, 사고 수준, 도구 접근 권한을 사용자 정의 가능.
• 엄격한 경계: 에이전트가 리포지토리 변경을 무단으로 수행하지 못하도록 읽기 전용 또는 쓰기 제한 접근 권한을 강제.
• 실시간 트레이스 UI: SQLite 데이터베이스를 폴링하여 에이전트 활동을 모니터링할 수 있는 전용 시각화 도구.
• 수정 루프: 세션 기반 수정을 통해 컨텍스트를 잃지 않고, 콜드 리스타트의 비용 없이 오류를 수정.