standup

Standup에 대하여

Standup은 Claude-Mem 프로젝트에서 개발된 협업 기술로, 사용자의 Git 워크트리, 브랜치, 열린 PR들 간에 읽기 전용 형태의 “Standup” 회의를 진행함으로써 흩어져 있는 작업들을 하나의 통합 계획으로 정리하는 데 도움을 줍니다. 이 기술이 해결하려는 문제는 작업들이 여러 워크트리와 브랜치에 분산되어 있을 때 어떤 것을 목표로 삼고 어떤 순서로 병합할지 결정하기 어렵다는 점입니다. 이 기술은 각 워크트리나 PR을 공유된 Markdown 그룹 채팅의 참여자로 모델링하며, 호출하는 주체가 진행자 역할을 하여 회의를 소집하고 차례대로 의견을 수렴한 뒤 결과를 도출합니다.

작업 흐름은 매우 명확합니다. 최근에 커밋이 이루어졌거나 특정 시간 범위 내에 수정이 가해진 워크트리나, Git 및 gh CLI를 통해 확인된 특정 브랜치와 열린 PR들을 기준으로 회의 참가자를 선정합니다. 이때 Node 스크립트(standup.mjs)가 원자적 잠금 기능을 갖춘 공유 파일(기본값: ~/.claude-mem/STANDUP.md)을 통해 읽기/쓰기/열기/요약 명령어들을 제공합니다. 먼저 1라운드에서 참가자들의 소개가 이루어지고, 그 다음에는 각 브랜치 담당자들이 자신의 입장을 밝히고 계획에 동의하는 절차가 진행됩니다. 마지막으로 진행자가 평이한 문체로 요약문을 작성하여 사람이 이해할 수 있도록 설명합니다. 중요한 점은 회의 공간이 엄격히 읽기 전용이라는 것입니다. 참가자들은 Git log, git status, git diff, gh pr view/diff를 통해 상황을 파악하고 병합 방식을 결정할 뿐, 회의 공간 내에서는 누구도 커밋, 병합, 푸시, 배포와 같은 작업을 수행하지 않습니다. 실제 Git 작업은 사람의 감독 하에 /do 명령어를 통해 이후에 이루어집니다.

이 기술은 여러 브랜치나 워크트리를 동시에 관리해야 하는 개발자들이 작업을 체계적으로 통합할 수 있는 방법을 원할 때 유용합니다. 사용되는 Git 및 gh 명령어들은 모두 진단용이며 읽기 전용이며, 이 기술은 반복적으로 “결정만 하고 실행은 하지 말라”는 원칙을 강조합니다.

FAQ

Standup은 제 브랜치를 병합하거나 커밋하나요?

아닙니다. 회의 공간은 명시적으로 읽기 전용이므로, 참가자들은 상황을 파악하고 병합 방식을 결정할 뿐, 회의 공간 내에서는 누구도 커밋, 병합, 푸시, 배포와 같은 작업을 수행하지 않습니다. 실제 Git 작업은 사람의 감독 하에 /do 명령어를 통해 이후에 이루어집니다.

실행하려면 무엇이 필요한가요?

Node(standup.mjs 스크립트 실행용), 워크트리나 브랜치가 포함된 Git 저장소, 그리고 원할 경우 열린 PR들을 가져오기 위한 gh CLI가 필요합니다. gh가 사용 불가능하거나 저장소가 GitHub에 없는 경우에는 워크트리만을 기준으로 작업이 진행됩니다.

어떤 방식으로 포함할 브랜치를 선택하나요?

두 가지 방식이 있습니다. 최근 활동 기준(1시간/4시간/24시간/7일/전체 등의 기간 내에 활동 중인 워크트리)이나 수동 지정(특정 로컬 브랜치 및 열린 PR) 방식입니다. 시작하기 전에 참가자 명단을 확인합니다.

최종 결과물은 무엇인가요?

진행자가 작성한 평이한 문체의 요약문으로, 목표로 할 워크트리, 병합 순서, 그리고 사람이 처리해야 할 남은 결정 사항들이 명시되어 있습니다. 이후 이 요약문은 일상 언어로 번역된 간략한 보고서 형태로 제공됩니다.

이 기술은 어떤 도구들을 사용하나요?

Bash, Read, Edit, Task, AskUserQuestion 기능들을 사용하며, 읽기 전용 Git 및 gh 명령어와 공유 파일을 활용한 CLI를 통해 대화를 조율합니다.

All Files

3 filesagent-brief.md2.1 KBViewSKILL.md6.5 KBViewstandup.mjs21.6 KBView