BattlePlan은(는) 무엇을 하나요?
작업 추적기에서 모든 열린 작업을 읽고, 마지막 계획 이후 실제로 발생한 일과 비교하여 조정한 후, 각각 새로운 에이전트 세션에서 바로 사용할 수 있는 시작 프롬프트를 포함한 짧은 병렬 작업 스레드 목록으로 변환합니다.
0단계 — 모든 호출은 여기서 시작
BP="${SKILLS_HOME:-$HOME/.claude/skills}/BattlePlan/Tools"
uv run --script "$BP/setup_tracker.py" check
success: false또는 설정 없음 → Workflows/Setup.md를 먼저 실행하세요. 추적기, 탭 이름 또는 컨텍스트를 임의로 만들지 마십시오.- 설정 파일 위치는
$BATTLEPLAN_CONFIG환경 변수에 저장되며, 그렇지 않은 경우${AGENT_SKILLS_CONFIG:-~/.config/agent-skills}/BattlePlan/config.json에 있습니다. 설정 파일은 소유자, 추적기 백엔드, 계획 디렉터리 및 컨텍스트 계층 구조를 보관합니다. 스킬 디렉터리에는 개인 데이터가 절대 저장되지 않으므로 자유롭게 공유하고 업데이트할 수 있습니다.
라우팅
| 호출 | 워크플로우 |
|---|---|
| "배틀플랜 설정", 설정 없음, 새 추적기, 새 컨텍스트 | Workflows/Setup.md |
/BattlePlan [컨텍스트] [--mine] [--skip-audit] [--launch], --audit | Workflows/Plan.md |
/BattlePlan --close | Workflows/Close.md |
/BattlePlan --draft (무인), 초안 예약 | Workflows/Draft.md |
--add, --done, --cancel, --restore, --sweep, batch-add, 티켓 또는 회의에서 작업 가져오기 | Workflows/Tasks.md |
하루 루프
저녁 예약 (평일) 아침
/BattlePlan --close ──▶ /BattlePlan --draft ──▶ /BattlePlan
완료, 스레드별 다음 단계, 추적기 + 핸드오프 + 초안을 열고; 예외 사항만
재개 명령어 세션 읽기; 초안 작성 확인한 후 진행
각 단계는 이전 단계가 건너뛰어도 작동합니다: 핸드오프 없음 → 요약이 이전 근무일로 대체됨; 초안 없음 → /BattlePlan이 실시간으로 계획을 수립합니다. 파일은 plans_dir 디렉터리에 저장됩니다:
| 파일 | 작성자 | 내용 |
|---|---|---|
YYYY-MM-DD-handoff-<호스트>.md | --close | 첫 줄 Closed: <ISO 8601 오프셋 포함> on <호스트>, 그 다음 완료, 진행 중(다음 단계 + 재개 명령어), 이월 항목 |
YYYY-MM-DD-draft-<호스트>.md | --draft | 계획 및 미리 채워진 감사 제안; 추적기에는 아무것도 기록되지 않음 |
YYYY-MM-DD-plan.md | /BattlePlan | 확정된 계획으로, --close가 계획과 실제 결과를 비교할 수 있게 함 |
<호스트>는 별칭(mac, wsl, linux 또는 $BATTLEPLAN_HOST_ALIAS)이며, 호스트 이름이 아닙니다. 이러한 파일은 여러 머신에서 공유될 수 있기 때문입니다. 세션 ID는 해당 세션을 생성한 머신에서만 재개됩니다: 다른 호스트의 다음 단계는 표시하되, 재개 명령어는 절대 표시하지 마십시오.
다중 머신: plans_git_sync: true를 설정하고 plans_dir을 Git 저장소 안에 배치하십시오. 커밋은 방금 작성된 파일만 수정합니다(git commit -- <경로>). fetch + merge --ff-only 후에 실행합니다. stash, reset 또는 clean을 절대 사용하지 마십시오: 다른 세션이 해당 저장소에서 커밋되지 않은 작업을 보유할 수 있습니다. fast-forward가 실패하면 로컬에서 커밋하고 푸시가 보류 중이라고 알리십시오.
도구
| 스크립트 | 역할 |
|---|---|
| `setup_tracker.py check | init` |
pull_tasks.py [컨텍스트] [--mine] | 계산된 긴급도, 마감일, 소유자 유형, 종속성, 티켓과 함께 JSON 형식의 열린 작업 |
recap_sessions.py --tasks pull.json [--since auto] [--context X] | 마지막 핸드오프 이후의 에이전트 세션 + Git 커밋을 티켓 ID별로 작업에 연결 |
| `manage_tasks.py add | batch-add |
| `run_draft.sh --install | --check |
tracker.py | 스토리지 백엔드(csv, xlsx, gsheets) 및 설정 로딩; 다른 스크립트에서 임포트됨 |
모든 스크립트는 uv run --script 파일이며 인라인 종속성(PEP 723)을 포함합니다: 관리할 virtualenv가 없습니다. 테스트: uv run --with pytest --with openpyxl pytest tests/.
필수 준수 사항
- 요약은 제안하며, 사람이 확인합니다. 증거만으로 완료로 표시되는 작업은 없습니다.
- 쓰기 작업에 정확한 행 참조 사용. 가져오기 후에는
Tab!row참조를 사용하여 하나의batch-done호출로 보관; 행을 알고 있을 때 부분 문자열 검색으로 대체하지 마십시오. - 기밀 컨텍스트 (
"confidential": true)는 추적기와 핸드오프 모두에서 티켓 ID와 짧은 일반 요약만 포함합니다.manage_tasks.py는 IP, URL 및 컨텍스트의forbidden_patterns를 거부합니다. - 명시적 확인 없이 스레드를 시작하지 마십시오.
- 추적기 명령은 순차적으로 실행 — Google Sheets는 분당 약 60회 읽기를 허용하며 각 명령은 모든 탭을 읽습니다.
종속성
uv (brew install uv, 또는 curl -LsSf https://astral.sh/uv/install.sh | sh). 요약의 커밋 스캔을 위한 git. Google Sheets 백엔드 전용: 시트에 대한 편집자 액세스 권한이 있는 서비스 계정 JSON 키. 세션 요약은 Claude Code 트랜스크립트(~/.claude*/projects)를 읽습니다; 다른 에이전트의 경우 Git 활동 및 핸드오프만 보고합니다.