Repository navigation
v0.1.0 — lg init
labgate의 첫 버전입니다. 사람이 task 경계의 승인 게이트마다 판정하고 AI 에이전트가 그 사이를 수행하는 연구 프로젝트의 작업 공간을 lg init 한 번으로 만듭니다.
포함된 것
lg init
- 대화형으로 입력하거나 설정 파일(
--config)로 입력 --dry-run(생성될 트리만 출력),--force(비어 있지 않은 폴더 허용, 기존 파일은 덮어쓰지 않음),--no-git,--yes- 실패 지점에 따라 종료 코드가 다름 (설정 오류 2, 폴더 충돌 3, Git 오류 4, 사용자 중단 130)
생성되는 작업 공간
- 루트 문서:
README.md,FILEMAP.md,AGENTS.md,STATUS.md - 계획:
plan/roadmap.md, 마일스톤별milestone.md와 첫 task 카드(T0) - 참고문헌:
references/catalog.md,references/task-map.md, 원본 저장용references/library/ - 결정 기록:
decisions/ - 문서 사양
specs/- 완성본 5종:
conventions,workflow,git-commit,task-card,review - stub 11종: 공통 구조만 있고 내용은 M0에서 채움 (
roadmap,milestone,task-map,catalog,decision,experiment-readme,run-record,task-result,milestone-report,worklog,status)
- 완성본 5종:
사람/에이전트 구분 강제
- 커밋 작성자 신원을 사람과 에이전트로 분리
- 사람 전용 커밋 타입(
gate,decide,plan,spec,respond) commit-msghook이 신원·타입·trailer의 일치를 검사 (hook은 Python ≥ 3.9 표준 라이브러리만 사용)- 에이전트 커밋용
scripts/agent-commit - 사람 신원으로 남기는 초기
init커밋
Claude Code 연결 (선택)
CLAUDE.md,.claude/settings.json- 슬래시 명령:
/session-start,/session-close,/task-start,/task-gate,/escalate - 규칙의 원본은 도구 중립 문서(
AGENTS.md,specs/)이고, Claude Code 파일은 연결 계층입니다.
지원 환경
- Python 3.10–3.14 (각 버전에서 최신 의존성과 최소 의존성 두 조합으로 테스트)
- macOS, Linux (Windows는 Git Bash에서 최선 노력, 공식 지원 아님)
git필요 (--no-git이면 불필요)
설치
pipx install git+https://github.com/qazcdesnu/labgate.git@v0.1.0
lg --versionclone 후 설치하는 방법은 README를 참고하세요.
아직 없는 것
lg gate,lg status,lg validate,lg upgrade,lg doctor- 기존 계획서 자동 가져오기 (v1에서는
M0-T0task에서 에이전트가 옮김) - Claude Code 외 다른 에이전트 도구 연결, 원격 저장소 설정, 다국어 템플릿
문서
- 설계: labgate-design.md
- 사용 시나리오: Coconut을 읽고 CODI를 시작하는 연구자