시작하기 전에
이 가이드에서는 Twitter 예제인 twitter-starter를 사용해 기능 하나를 만듭니다. 텍스트가 아래에 표시되는 거대한 이모지를 공유하는 기능입니다. 원하는 내용을 agent에게 직접 설명하고, 작업 과정을 지켜본 뒤, 완성된 결과를 검토합니다. 같은 워크플로를 다른 기능이나 고치고 싶은 버그에 그대로 적용할 수 있습니다.
- Panolayer를 설치하고 로그인한 뒤 Twitter Clone 예제를 엽니다. 아직 repository를 열지 않았다면 Panolayer 설치 및 설정을 참고하세요.
- 기본 제공되는 Panolayer Agent를 사용합니다. 사용 전에 설치해야 하는 다른 지원 agent를 사용할 수도 있습니다. 설정 방법은 지원되는 agent를 참고하세요.
마지막에는 검토를 마친 변경 사항이 로컬 Git 기록에 남습니다. 원격에 push하는 것은 별도의 단계입니다.
Panolayer Agent 시작하기
- 사이드바에서 My Agents를 엽니다.
- Monitor Agents 옆의 + 버튼을 클릭해 agent 메뉴를 엽니다.
- 이번 워크스루에서는 Panolayer Agent를 선택합니다.
메뉴에는 Panolayer Agent와 설치한 agent들이 표시됩니다. 버그를 고치거나 코드를 작성할 때 그중 아무거나 선택할 수 있습니다.
Panolayer Agent는 이미 사용 중인 코딩 agent와 같은 방식으로 동작합니다. 기능을 만들거나, 버그를 고치거나, 코드에 대해 질문할 때 사용하세요. **Chat with your codebase or build something…**에 요청을 입력하고 작업하면서 대화를 이어가면 됩니다.
이슈에서 시작하시나요? Issues에서 Fix를 선택한 다음 Panolayer Agent를 고르세요. Panolayer가 이슈의 컨텍스트를 작업에 함께 가져갑니다. 이 경로는 첫 버그 워크스루를 참고하세요.
결과가 명확한 작업을 맡기기
무엇이 잘못되었는지 또는 무엇을 만들고 싶은지, 제대로 동작할 때 어떤 일이 일어나야 하는지, agent가 유지해야 할 것이 있으면 함께 설명하세요. 파일이나 함수를 알고 있다면 이름을 밝히세요.
Twitter 예제에서는 스크린샷에 나온 것과 같은 요청을 사용합니다:
add a new feature where you can share a giant emoji with text underneath
메시지 상자에 요청을 입력한 다음 전송 화살표를 클릭하세요.
Panolayer Agent는 작업하면서 코드 맵을 활용해 관련 함수와 관계를 찾을 수 있습니다. 모든 파일 이름을 알지 못해도 신경 쓰는 동작을 언급하면 됩니다.
agent가 질문하면 같은 대화에서 답하세요. 작업 범위를 좁혀야 한다면 원하는 구체적인 결과를 말하세요.
워크스페이스를 유지하면서 작업 따라가기
Panolayer Agent가 코딩 실행을 시작하면 진행 상황이 대화에 표시됩니다. 코딩 작업은 격리된 Git worktree에서 이루어집니다. 즉, agent가 코드를 편집하고 테스트하는 동안 기본 워크스페이스는 계속 사용할 수 있는 별도의 체크아웃입니다.
대화에서 작업 확인하기
실행 카드에는 agent가 giant-emoji 기능을 만드는 동안 작업과 현재 활동이 표시됩니다. 진행 상황을 따라가고, 작업 중 사용하는 파일과 명령을 확인할 수 있습니다.
실행을 열어 자세히 보기
카드 오른쪽의 열기를 선택하면 실행 활동을 볼 수 있습니다. 스트림에서 활동을 선택하면 오른쪽 패널에서 명령과 해당 출력을 확인할 수 있습니다. 대화로 돌아가려면 agent로 돌아가기를 사용합니다.
실행 완료 확인
작업이 끝나면 카드가 Subagent 실행 완료로 업데이트됩니다. 완료 배너에는 검사 결과와 변경된 파일 수가 요약됩니다. 완료된 실행을 확인하려면 열기를 선택할 수 있습니다.
계속 작업하다가 나중에 실행으로 돌아올 수 있습니다. 둘 이상의 agent가 작업 중일 때 개요를 보려면 agent 모니터링을 사용합니다. 여러 agent가 동일한 repository에서 별도의 worktree로 작업할 수 있습니다. 병합하기 전에 변경 사항이 어떻게 맞물리는지 검토하세요.
후속 작업을 해당 작업에 연결해 두세요. 후속 메시지를 보낼 때 대화에 표시된 실행 참조를 사용하면 어떤 작업을 의미하는지 명확해집니다.
검증 결과 검토
병합하기 전에 변경된 코드를 검증 결과와 함께 검토하세요. agent의 변경 사항을 검토하는 전체 가이드는 변경 사항 검토 및 commit을 참고하세요.
agent가 병합을 요청하면 검증 요약을 읽으세요: 통과한 규칙, 검증 실행, 변경된 파일. 새로운 실패는 이미 존재하던 문제와 별도로 검토하세요.
이번 실행에서 요약에는 121개 규칙 중 110개 통과, 검증 실행 1회, 파일 16개 변경이 표시됩니다. 기존 실패 11건을 별도로 식별하며, 새로운 실패, 경고 또는 확인되지 않은 규칙은 보고하지 않습니다. 합계는 작업에 따라 달라집니다.
결과를 더 자세히 조사하려면 세부 정보를 여세요. 요약 필드와 상태는 검증 결과 이해를 참고하세요.
작업에서 요구하는 경우 실행 중인 앱에서 동작을 확인하세요. 이 예시에서는 거대 이모지와 그 아래 텍스트가 포함된 게시물을 만들어 본 다음, 일반 텍스트 게시물이 여전히 예상대로 작동하는지 확인하세요.
Merge when you’re ready
You decide what moves from the agent’s worktree into your branch. Choose Not now to keep reviewing. Once you’re satisfied with the changes and results, confirm the target branch and choose Merge into main for the Twitter sample.
The Merged into main confirmation shows a commit ID. This workflow records the change in local Git history, so you don’t need to commit that same change again.
Open Changes and find the commit in History. Check for unexpected uncommitted edits. If your repository has a remote and you want to share the commit, use Git → Push.
You’ve given an agent a task, followed its work, reviewed the result, and decided what reaches your branch.