Wellactually

AI와 함께 개발하면서 자신의 공학적 판단을 만들어 가는 VS Code 페어 프로그래밍 플러그인입니다. Pair와 생각을 나누고, Driver에게 직접 구현을 요청합니다.

이 문서는 플러그인에 함께 포함되는 한국어 사용 설명서입니다. 설치 후 Extensions → Agent Plugins - Installed → wellactually를 선택하면 플러그인 상세 화면에서 읽을 수 있습니다. 설치 후에도 온라인 사용 설명서에서 다시 볼 수 있습니다.

설치 후 시작하기

1. 개발할 프로젝트 폴더를 VS Code로 엽니다.
2. 기본 Chat View에서 Copilot Agent Host 세션을 열고 Agent 선택기에서 Wellactually Easy를 선택합니다. 더 구체적인 설명이 필요하면 Beginner로 시작해도 됩니다.
3. 만들고 싶은 것, 현재 문제, 고민 중인 선택을 자신의 말로 이야기합니다.
4. 구현할 범위를 정했으면 Pair에게 **"이 범위로 구현할게. Driver 세션을 만들어줘."**라고 요청합니다.
5. 기본 Chat View의 Sessions 목록에서 생성된 Wellactually Driver 세션을 선택합니다.
6. 그 세션의 Agent를 Wellactually Driver로 직접 선택한 뒤 구현을 요청합니다. 세션 이름만으로 Agent가 자동 선택되지는 않습니다.
7. 변경된 코드와 Driver의 검증 결과를 직접 살펴보고, 기존 Pair 세션으로 돌아와 대화를 이어 갑니다.

Pair와 Driver는 같은 프로젝트 파일을 사용하지만 대화는 별도 세션에 남습니다. 별도 창이나 두 채팅의 동시 표시가 필요하지 않습니다. 기본 Chat View에서 세션을 번갈아 선택하면 코드를 보면서 작업할 수 있습니다.

누가 무엇을 하나요?

Pair는 완성된 설계나 Driver 프롬프트를 대신 작성하지 않습니다. 코드를 수정하거나 검증을 실행하지도 않습니다. 사용자를 시험하거나 Driver의 결과를 채점·승인하는 역할이 아니라, 새로 드러난 사실을 놓고 다시 생각하는 동료입니다.

Pair 모드 선택

모드는 실력 등급이나 통과해야 할 단계가 아닙니다. 지금 작업에서 원하는 지원의 정도에 맞춰 선택합니다. 익숙한 분야와 낯선 분야에서 다른 모드를 써도 됩니다.

네 모드는 같은 여섯 가지 방식을 사용합니다. 능동적 공동 탐색, 위험 기반 개입, 미러링, 반례와 안티 케이스, 느슨한 체크포인트, 맥락에 맞는 지식 제공입니다. 방식의 정의나 지식 수준이 달라지는 것이 아니라 우선순위, 빈도, 구체성과 개입 기준이 달라집니다. Pair 세션에서 모드를 바꿔도 구현은 별도 Driver 세션에서 진행합니다.

어디서 시작할지 물으면 Easy는 함께 판단할 출발점과 필요한 설명·예시를 제공하고, Advanced는 판단을 바꾸는 핵심 조건과 근거를 선별합니다. Advanced에서도 요청한 설명은 받을 수 있습니다. 모드는 단순한 답변 길이 설정이 아닙니다.

한 작업 안에서 반복하기

Pair 대화는 구현 전 한 번만 거치는 절차가 아닙니다. 구현 중 새로운 제약이 생기거나 예상과 다른 결과가 나오면 같은 Pair와 Driver 세션을 오가며 이어 갑니다.

Pair에서 시작할 때

상품 목록이 느린데 캐시가 필요한지, 쿼리부터 봐야 할지 모르겠어.

관찰한 문제와 원하는 결과부터 이야기하면 됩니다. 아직 선택지나 기술 용어를 정리하지 못했어도 괜찮습니다. 이미 정한 범위나 바꾸지 않을 조건은 함께 알려 줍니다.

별도로 받은 과제 설명이 있으면 함께 제공해 주세요. 로컬 파일이 없어도 대화에 제공한 원문을 사용할 수 있습니다. 판단에 꼭 필요한 요구사항이 빠졌다면 Pair는 그 이유를 짚고 확인하며, 이미 정해진 조건을 자유롭게 바꿀 수 있다고 가정하지 않습니다.

Driver로 이동할 때

Pair 대화가 Driver에게 자동 전달되지는 않습니다. 무엇을 바꿀지, 유지할 조건, 확인하고 싶은 동작을 사용자가 직접 전달합니다. Driver는 구현 중 제품 방향이나 범위를 바꾸는 판단이 필요하면 사용자에게 돌아옵니다.

Pair로 돌아왔을 때

Driver 대화를 읽고 이어서 얘기하자. 조회는 빨라졌는데 변경 직후 값이 늦게 보이는 게 마음에 걸려.

Pair는 연결된 Driver 세션의 사용자 지시, 응답과 도구 활동을 읽어 새 맥락을 이해합니다. 결과를 승인받는 과정이 아니라, 드러난 제약과 다음 선택을 논의하는 과정입니다. 추가 구현은 기존 Driver 세션에서 다시 직접 요청합니다.

필요한 공학 지식

네 공학 Skill과 열두 Reference가 포함되어 있습니다. Pair는 대화 주제에 맞는 자료를 필요할 때 읽습니다. 별도 Slash command를 실행하거나 자료 전체를 미리 읽을 필요는 없습니다.

자료는 접근 방법, 불변식, 대안, 실패 메커니즘, 안티패턴과 조건·예외가 있는 실전 휴리스틱을 다룹니다. 네 모드가 같은 지식을 사용하며, 자료를 읽어도 역할과 도구 권한은 바뀌지 않습니다. Chat: Configure Skills에서 설치된 Skill을 확인할 수 있습니다.

세션 지식 정리하기 (Save Tool Preview)

같은 Pair 대화에서 다음과 같이 명시적으로 요청합니다.

이번 작업에서 배운 내용을 공학 문서로 저장해 줘.

knowledge-compile Skill은 현재 대화와, 관련된 경우 이미 연결된 Driver 맥락을 바탕으로 독립적으로 읽을 수 있는 글을 작성합니다. 번들된 saveKnowledge 도구는 현재 세션의 정확한 Workspace 아래 .wellactually/knowledge/에 새 Markdown 파일을 만들고 링크를 반환합니다. MCP host가 양식 확인을 지원하면 저장 위치를 확인한 뒤 Save this article을 선택합니다. 거절하거나 취소하면 파일을 만들지 않습니다. Agent Host에서는 중첩된 양식 확인을 지원하지 않으므로 사용자의 명시적인 지식 정리 요청 한 번이 새 파일 한 개의 저장 승인으로 사용됩니다. 대화 원문을 다시 입력하거나 별도 인터뷰·Compiler Agent를 실행할 필요가 없습니다.

문서는 실제 문제와 선택, 감수한 비용, 동작 원리와 확인된 결과를 설명합니다. 누락된 대화와 검증하지 않은 결과는 그대로 명시하며, 전체 대화 내보내기나 사용자의 능력 평가로 취급하지 않습니다.

네 Pair 모드에는 기존 읽기·세션 도구와 정확히 wellactually-knowledge/saveKnowledge 저장 기능만 제공됩니다. 일반 편집·실행 권한은 추가되지 않으며 Driver 권한도 바뀌지 않습니다. 런타임과 의존성 고지는 플러그인에 포함되므로 사용자가 npm install을 실행할 필요가 없습니다.

서버는 get_current_session이 반환한 정확한 Workspace file URI를 요구합니다. MCP host가 root를 제공하면 URI가 그 목록과 일치하는지 검증합니다. Agent Host처럼 root를 제공하지 않는 환경에서는 기존 실제 디렉터리인지 확인하고 플러그인 설치 경로와의 중첩을 거부합니다. 이 fallback의 Workspace 결합은 host가 증명하는 보안 경계가 아니라 Pair 정책에 의존합니다. UTC 날짜와 YAML title/date/tags를 포함한 YYYY-MM-DD-ascii-slug-uuid.md 파일을 만들며, 연결된 대상 디렉터리를 거부하고 기존 파일을 덮어쓰지 않습니다. 일반 쓰기 권한으로 우회하지 않습니다.

이 기능은 제한된 로컬 파일 작성기이지 악의적인 로컬 프로세스의 동시 디렉터리 교체를 막는 OS Sandbox나 결정론적 Secret Scanner가 아닙니다. 신뢰할 수 없는 프로세스가 제어하는 디렉터리에서는 사용하지 마세요. I/O 실패 시 일부 내용이 담긴 새 파일이 남을 수 있으며 도구가 이를 수정하거나 삭제하지 않습니다. 지식 정리는 항상 명시적 요청이 있을 때만 실행되고 일반 Pair 작업은 계속 비구현 역할을 유지합니다.

파일시스템, MCP 프로토콜, 번들·패키징 자동 검증은 포함되어 있지만 Windows VS Code Local 및 Agent Host에서 실제 검색, 도구 선택기 해석과 확인 UX는 별도 실사용 검증이 필요합니다. 2026-09-18 기준 Windows VS Code 1.138.0 LocalProcess는 표준 플러그인 MCP 설정을 찾지만 ${PLUGIN_ROOT}를 Node에 문자 그대로 전달해 번들 서버가 시작되지 않습니다. 절대 번들 경로를 사용한 사용자 수준 MCP 등록은 시작과 도구 검색을 통과했지만 개발용 우회 방법일 뿐 이식 가능한 배포 해결책은 아닙니다.

설치와 업데이트

Agent Plugins를 지원하는 최신 VS Code, GitHub Copilot 사용 권한, Copilot Agent Host의 세션 관리 기능이 필요합니다. 조직 정책에 따라 플러그인이나 도구 사용이 제한될 수 있습니다. Knowledge 저장에는 MCP 호스트의 PATH에서 실행할 수 있는 Node.js 22 이상, 번들 stdio MCP 지원과 현재 세션 Workspace 조회 기능이 추가로 필요합니다.

처음 설치할 때는 Command Palette에서 Chat: Install Plugin From Source를 실행하고 다음 URL을 입력합니다. 별도 clone이나 조직의 저장소 읽기 권한 요청은 필요하지 않습니다.

https://github.com/microsoft-2026-hackathon/wellactually.git

설치 상태는 Chat의 설정 메뉴에서 Plugins, 또는 Extensions의 Agent Plugins - Installed에서 확인합니다. wellactually가 현재 Workspace에서 활성화되어 있어야 합니다.

업데이트 확인은 Command Palette의 Extensions: Check for Extension Updates로 실행합니다. 업데이트 후에도 이전 설정이 보이면 새 Chat 세션에서 확인합니다. VS Code 버전에 따라 메뉴와 표시 방식이 다를 수 있습니다.

문제가 생겼을 때

해결되지 않으면 이슈에 VS Code 버전, Plugin 버전, 선택한 Agent, 재현 과정과 민감정보를 제거한 오류를 남겨 주세요. 비밀번호, 토큰이나 비공개 대화 전체를 게시하지 마세요.

알아둘 경계

Pair가 읽는 Driver 대화에는 사용자가 직접 작성한 구현 지시도 포함됩니다. 이는 의도와 범위를 이해하기 위한 맥락이지 프롬프트 품질을 채점하는 기능이 아닙니다. Driver에는 다른 세션의 조회·제어 도구가 없고 다른 Chat에 접근하지 않도록 지시되어 있지만, 이러한 역할·도구 제한이 운영체제 수준의 격리를 보장하지는 않습니다.

AI 응답은 틀릴 수 있습니다. 중요한 데이터·보안·외부 계약 관련 판단과 변경된 코드는 직접 확인하고, 실행한 검증과 아직 확인하지 않은 부분을 구분하세요.

개발과 참고

이 저장소는 설치용 생성 패키지입니다. 개발 정본은 wellactually-dev에 있습니다. 사용자는 프로젝트에 Agent 파일을 복사하거나 배포본을 직접 수정할 필요가 없습니다. 설치·관리 기능의 최신 안내는 VS Code Agent Plugins 문서를 참고하세요.