Boj-Agent

백준 알고리즘 문제 풀이를 **에이전트(AI)**와 함께 자동화하는 Python CLI. 문제 환경 생성, 로컬 테스트, 제출용 코드·리뷰까지 한 흐름으로 사용할 수 있고, 에이전트는 설정으로 갈아끼울 수 있습니다.

빠른 시작

pip install boj-agent        # PyPI 설치
boj setup                    # 초기 설정 (루트, 언어, 에이전트)
boj make 4949                # 환경 생성
boj open 4949                # 에디터로 풀기
boj run 4949                 # 테스트
boj submit 4949 --open       # Submit 파일 생성 + 제출 페이지 오픈
boj review 4949              # 코드 리뷰
boj commit 4949              # 커밋 (BOJ 통계 포함)

개발 모드 설치:

git clone <this-repo>
cd boj-agent
pip install -e ".[dev]"

명령어

주요 옵션 (전체 목록은 boj <명령> --help):

boj make   4949 --lang python       # 언어 지정
boj submit 4949 --open              # 제출 페이지 자동 오픈
boj submit 4949 --force             # 기존 Submit 파일 덮어쓰기
boj commit 4949 --no-stats          # BOJ 통계 없이 커밋
boj open   4949 --editor cursor     # 에디터 지정
boj setup  --check                  # 현재 설정 상태 확인

구조

boj-agent/
├── src/
│   ├── boj                 # CLI 진입점 (Bash 디스패처 → Python 라우팅)
│   ├── core/               # Python 핵심 로직 (순수 함수, CLI 없음)
│   ├── cli/                # CLI 래퍼 (core 위 얇은 레이어)
│   ├── commands/           # [legacy] Bash 서브커맨드 (fallback용)
│   └── lib/                # [legacy] Bash 공통 라이브러리
├── templates/              # 언어별 런타임 코드 (테스트 러너 + 계약)
├── prompts/                # 에이전트용 지시문
├── tests/                  # pytest 단위 + 통합 테스트
└── docs/                   # 문서

설정

~/.config/boj/ 에 파일별로 저장됩니다. 환경변수로 오버라이드 가능합니다.

boj setup          # 대화형 설정
boj setup --check  # 현재 설정 확인

지원 언어

워크플로우

boj setup           ← 최초 1회
    ↓
boj make 4949       ← 에이전트로 환경 생성 (README, Solution, test/)
    ↓
boj open 4949       ← 에디터로 풀기
    ↓
boj run 4949        ← 로컬 테스트
    ↓
boj submit 4949     ← Submit 파일 생성
    ↓
boj review 4949     ← (선택) 리뷰
    ↓
boj commit 4949     ← 커밋 (BOJ 통계 포함)

Claude Code 플러그인

boj-agent를 Claude Code에서 스킬로 사용할 수 있습니다. 자연어("백준 1000번 풀어줘")나 슬래시 커맨드(/boj-make 1000)로 호출 가능합니다.

# 플러그인 로드
claude --plugin-dir .claude-plugin

# 또는 마켓플레이스에서 설치
/plugin marketplace add sueelly/boj-agent
/plugin install boj-agent

자세한 내용은 .claude-plugin/README.md 참고.

테스트

./tests/run_tests.sh                    # 전체 (단위 + 통합)
./tests/run_tests.sh --unit             # 단위만
./tests/run_tests.sh --integration      # 통합만
python -m pytest tests/unit/            # pytest 직접 실행

문서

• 사용 가이드: docs/user-guide.md
• 아키텍처: docs/ARCHITECTURE.md
• 엣지 케이스: docs/dev/testing/edge-cases.md
• 개발 기록: docs/records/DEVLOG.md
• 에이전트 지시문: prompts/README.md

자세한 내용은 docs/user-guide.md 참고.