소개

q란

q는 워크스페이스 중심 코딩 환경입니다. 로컬 Studio는 대화, 파일 도구, 셸 명령, 모델 공급자, 직업형 서브에이전트, 저장소 검토와 영구 기록을 하나의 Go 바이너리로 제공합니다.

워크스페이스는 q 파일 도구의 작업 경계입니다. 셸 명령도 그 위치에서 시작하지만 운영체제 샌드박스는 아닙니다. 로컬 개발 셸과 같은 주의로 명령과 승인을 검토하세요.

워크플로 선택

q가 조사하거나 수정하거나 작업을 조율할 저장소를 Studio 세션으로 만들거나 등록하세요.

일반 채팅은 workspace 도구를 직접 사용하면서 직업형 서브에이전트를 조율할 수 있습니다. manager는 PM으로서 계획을 맡고 senior developer는 직접 구현하거나 구현을 배정하고 검토합니다.

하나의 제한된 작업을 전문가에게 맡길 때는 메인 에이전트에게 위임을 요청하세요. bare q 호환 채팅에서는 /subagent로 역할을 직접 선택할 수도 있습니다.

q가 보존하는 것

각 워크스페이스는 여러 영구 세션을 가질 수 있고 Studio는 서로 다른 저장소에서 등록한 루트 세션을 함께 보여줍니다. 보이는 대화 기록, 압축된 모델 컨텍스트, 작업 생명주기, 위임 상태, 검색 가능한 워크스페이스 기록은 서로 분리해 저장됩니다. 덕분에 긴 작업에서도 전체 과거를 매 턴 전송하지 않고 상태를 살펴볼 수 있습니다.

q는 Agent Skills도 지원합니다. 스킬 메타데이터는 필요할 때 검색하고, 전체 SKILL.md는 에이전트가 적용 가능한 스킬을 불러온 뒤에만 모델 컨텍스트에 들어갑니다.

다음 단계

go install 또는 소스 체크아웃으로 q를 설치하고 q studio를 실행한 뒤, q가 이해해야 할 저장소를 등록하세요.