에이전트

Linear

Linear 이슈를 Comma에 할당하거나 댓글에서 @Comma를 멘션하세요. Comma는 이슈 안에서 답하고, 작업을 내 워크스페이스의 태스크로 실행하며, 진행 상황과 결과를 이슈에 다시 게시합니다.

시작하기 전에

• Comma 워크스페이스(데스크톱 앱 또는 app.comma.surf).
• Comma를 쓸 Linear 워크스페이스의 계정. 해당 Linear 워크스페이스에서 처음 연결하는 사람이 Comma를 설치하며, 이때 Linear 워크스페이스 관리자 권한이 필요합니다. 그 뒤의 사람은 자기 계정만 연결하면 됩니다.
• 작업을 실행할 수단: Comma에 연결한 내 Codex 또는 Claude Code, 혹은 클라우드 Worker용 Comma 크레딧. 이슈 안에서 답만 받는 데는 Worker가 필요 없습니다.

Linear 연결하기

1. Comma에서 설정을 열고 채널로 이동한 뒤 Linear 카드에서 연결을 누릅니다.
2. Linear가 내 권한으로 워크스페이스를 읽도록 Comma를 승인해 달라고 요청합니다. 이것으로 Comma는 내가 어떤 Linear 사용자인지 알게 됩니다.
3. 해당 Linear 워크스페이스에 Comma가 아직 설치되지 않았다면 Linear가 한 번 더 묻습니다. 이 단계에서 Comma가 선택한 팀의 에이전트로 설치됩니다.
4. Comma로 돌아오면 카드에 연결됨이 표시되고 Linear 조직과 내 계정이 보입니다.

이슈 실행 방식 선택

• 태스크 완료 시. 이슈를 그대로 두거나, 팀에 해당 상태가 있으면 In Review로 옮기거나, Done으로 옮깁니다.

이슈 위임하기

1. Linear에서 이슈를 Comma에 할당하거나, 댓글에 @Comma와 함께 원하는 내용을 적습니다.
2. Comma는 몇 초 안에 이슈의 에이전트 세션에서 답합니다. 질문, 분류, 계획은 태스크 없이 그 자리에서 답합니다.
3. 실제 작업이 필요하면 Comma가 태스크를 시작합니다. 이슈는 팀의 첫 번째 ‘시작됨’ 상태(대부분 In Progress)로 이동하며, 이미 시작되었거나 닫힌 이슈는 그대로 둡니다. 세션에 Task in Comma 링크가 생기고, Worker의 진행 상황과 결과가 세션에 게시됩니다. Worker가 연 pull request도 링크됩니다.
4. 세션에서 답글을 달아 방향을 조정하거나 추가 작업을 요청하세요. 현재 태스크가 끝난 뒤에야 Comma가 다음 태스크를 시작합니다.

중지 또는 종료

• 세션에서 Stop을 누르면 실행 중인 태스크가 끝납니다. 이미 끝난 작업은 남습니다.
• 이슈를 Done 또는 Canceled로 표시하거나 Comma가 아닌 사람에게 재할당하면 실행 중인 태스크가 끝나고 Comma가 세션에서 알려 줍니다. 이미 결과를 전달한 태스크는 그대로 둡니다.
• 이슈를 삭제하면 실행 중인 태스크가 끝나고, 그 안내는 Comma 안의 태스크에만 남습니다. 세션은 이슈와 함께 사라지므로 그곳에는 아무것도 게시되지 않습니다.

Comma에서 이어서 작업하기

모든 세션에는 Open in Comma 링크가, 위임된 모든 태스크에는 Task in Comma 링크가 있습니다. Comma에서 전체 기록을 읽고, 작업을 이어 가고, 결과를 검토해 승인할 수 있습니다. Comma에 쓴 내용은 Comma에만 남고, Linear에서 물은 것에 대한 Comma의 답만 이슈로 돌아갑니다.

관리 또는 연결 해제

• 아래 작업은 모두 Linear 카드의 ‘관리’ 메뉴에 있습니다.
• Linear 로그인이 바뀌었다면 ‘다시 연결’하세요. 먼저 확인을 묻습니다.
• ‘연결 해제’는 내 계정 연결만 풉니다. 동료의 연결은 그대로입니다.
• ‘조직에서 제거’는 Comma를 설치한 Comma 워크스페이스에만 표시됩니다. Linear 관리자도 Linear의 Settings › Applications에서 제거할 수 있습니다.