개요
Scripter는 개발 프로세스의 자율화(Development Process Autonomy)를 목적으로 설계된 AI 에이전트 운영 체계입니다. 기존의 일회성 코드 생성 방식에서 벗어나, 에이전트가 스스로 로드맵을 탐색하고, 테스트를 통해 구현 내용을 검증하며, 다음 단계로 스스로 이행하는 ‘개발 과정의 자동화’에 집중합니다.
저장소 정보
개발 배경 (Why Scripter?)
일상을 편리하게 만드는 다양한 자동화 스크립트(로또 자동 구매, 라디오 녹음 등)는 환경 변화에 따라 지속적인 유지보수가 필요합니다. 하지만 매번 수동으로 코드를 수정하고 테스트하는 과정은 번거롭고 비효율적입니다.
Scripter는 다음과 같은 고민에서 시작되었습니다.
- “반복적인 개발-테스트-수정 과정을 에이전트가 스스로 완수할 순 없을까?”
- “사용자의 지시를 기다리지 않고, 정의된 로드맵을 따라 자율적으로 개발을 진행할 순 없을까?”
주요 기능
- 프로젝트 자동 초기화:
BOOTSTRAP.md에 정의된 표준 절차에 따라 새 프로젝트 시작 시 Python 가상 환경(venv) 생성, pip 패키지 설치,/scripts디렉토리 구성, systemd 설정 등 기본 환경을 자동으로 구축합니다. - 자율 반복 개발: 사용자의 승인을 일일이 기다리지 않고, 검증된 작업은 즉시 다음 로드맵 단계로 이행합니다.
- 검증 기반 구현: 모든 코드는 테스트 코드와 로컬 검증 절차를 거쳐야만 완성된 것으로 간주합니다. (Verification First)
- 지속적 정교화(Autonomous Refinement): 기능 구현 후 에지 케이스 예외 처리, 로깅 강화, 문서 동기화 등을 자동으로 수행합니다.
- 세션 간 컨텍스트 유지: 에이전트의 ‘의식’을 파일(
MEMORY.md)에 저장하여 세션이 끊겨도 이전에 하던 작업을 정확히 이어받습니다.
핵심 메커니즘
Scripter는 네 가지 핵심 파일을 통해 에이전트의 행동을 규정하고 상태를 관리합니다.
AGENTS.md(운영 지침서): 에이전트가 따라야 할 핵심 원칙과 표준 작업 절차(SOP)를 정의합니다.MEMORY.md(영구 메모리): 현재 진행 중인 작업 큐, 장기 로드맵, 그리고 과거의 학습 내용을 기록합니다. 에이전트가 세션을 넘나들며 작업 맥락을 유지할 수 있게 해주는 핵심 저장소입니다.HEARTBEAT.md(진행 보고): 현재 에이전트가 어떤 생각을 하고 있고, 어떤 작업을 수행 중인지 투명하게 기록하여 사용자에게 진행 상황을 공유합니다.BOOTSTRAP.md(프로젝트 초기화 가이드): 새 프로젝트 시작 시 표준 디렉토리 구조, Python 가상 환경(venv) 설정, pip 패키지 설치,/scripts디렉토리 구성, systemd 타이머 설정 등 기본 환경을 구축하는 절차를 정의합니다.
또한 .agent/ 디렉토리 하위에 에이전트의 정체성(IDENTITY), 핵심 가치(SOUL), 외부 도구 가이드(TOOLS), 사용자 정보(USER) 등을 정의한 추가 구성 파일들이 있습니다.
기대 효과
Scripter를 통해 개발자는 복잡한 구현 세부 사항보다는 “무엇을 자동화할 것인가"에 집중할 수 있게 됩니다.
- 개발 가속화: 에이전트가 로드맵의 다음 단계를 스스로 판단하고 실행하므로, 개발자는 상위 수준의 기획에만 집중할 수 있습니다.
- 품질의 상향 평준화: 모든 개발 단계에서 강제되는 자율 검증(Verification) 루프를 통해 일정 수준 이상의 코드 품질을 보장합니다.
- 확장성: 동일한 프레임워크 내에서 새로운 자동화 아이디어를 빠르게 구현하고 배포할 수 있습니다.