project-tracker

project-tracker

이 스킬은 의도만 안내한다 — 결정적 기록은 훅이 보장한다(빼먹어도 훅이 잡는다).

• Ground rule: 세션은 프로젝트 루트에서. 커밋/기록은 그 시점의 cwd 레포에 앵커되므로, 다른 레포의 작업을 지시받으면 원격 실행(git -C) 대신 cd 후 작업한다. 여러 프로젝트를 만들 때만 ensure_project(path=…)를 명시.

• 새 작업 대화가 시작되면: recall(주제)로 과거 결정을 먼저 확인한다.

• 접근/방향이 정해지면 remember(project, text)로 결정을 기록한다 (refs에 관련 티켓/태스크 id를 넣어 그래프에 연결).

• 사용자가 외부 참조자료(공식 문서 export, PDF 등)를 지식에 넣자고 하면 ingest_document(path) — 디렉토리 통째도 됨. 공용 library에 쌓여 모든 프로젝트의 recall에 뜬다.

• 코드 작업이면: git 분기는 네(에이전트)가 한다 — 사용자에게 브랜치를 파달라고 하지 말 것. create_ticket(project, title, intent, branch="feature/<슬러그>") → git switch -c feature/<슬러그> 순서로 직접 실행한다. (티켓 없이 feature 브랜치에서 커밋해도 훅이 브랜치명으로 티켓을 자동 생성하지만, intent가 비므로 가능하면 선-생성.) 사용자가 main에서 계속 가길 원하면 set_active_ticket으로 명시 — 이 오버라이드는 브랜치와 무관하게 최우선 앵커다.

• 작업을 add_task로 쪼개고, 착수 시 set_task_status(task, "in_progress").

• 구현/커밋은 평소대로 한다. 커밋 기록·코드 링크는 훅이 자동으로 한다 — 중복 호출하지 말 것.

• 막히면 set_task_status(task, "blocked")(+사유는 대화로), 사람 확인이 필요하면 "review".

• 1 태스크 = 1 커밋 컨벤션: 커밋 전에 활성 태스크를 in_progress로 두면 훅이 그 태스크에 커밋을 매핑한다.

상위 워크플로우

• 사용자가 기획(braindump)을 던지면 → /agent-brain:pipeline (결정 루프 → 아키텍처/이점 → 상세 기획 → 티켓 자동 분해).
• 백로그를 자율 실행하라고 하면 → /agent-brain:drive (정지 조건 명확한 auto-drive 루프).