QuickEngineering 사용 설명서
QuickEngineering은 목표를 명시적인 작업, 지시, 워커, 입력, 결과, 검토, 게시 가능한 아티팩트로 이어지는 흐름으로 바꿔 줍니다.
시작하기
- 프로젝트를 만들고, 흐름에 파일이나 코드가 필요할 때만 워크스페이스를 선택하세요.
- Flow를 만든 다음 명확한 Instructions와 Result 이름을 가진 작업을 추가하세요.
- 각 작업에 Agent를 선택하고, 앞선 결과를 이후 입력으로 연결하세요.
- 영향이 큰 지점에는 검토, 사람, 데이터 전송, 예산, 게시 게이트를 추가하세요.
- 흐름을 실행하고 Runs와 Agent Queue를 따라간 다음 Artifacts와 History를 확인하세요.
팁: 이후의 연결이 이해하기 쉽도록 모든 Result에 명확한 이름을 붙이세요.
인터페이스 개요
| 영역 | 용도 |
|---|---|
| 프로젝트 | 흐름, 아티팩트, 스냅샷, 가져온 항목, 휴지통을 담는 .qeng 소스 컨테이너입니다. |
| Flow Editor | 작업 그래프, 매핑, 조건, 계약, 게이트, 예산, 실행 진입점. |
| Prompt Workspace | 프롬프트, 변수, 변형, 매트릭스, 평가, 재사용 가능한 자산. |
| Runs 및 Agent Queue | 실행, 승인, 점유된 작업, 진행 상황, 재시도, 검토, 최종 상태. |
| Artifacts 및 History | 유형화된 출력, 버전, 계보, 코멘트, 차이 비교, 롤백, 내보내기, 게시, 감사. |
Task → Instructions → Agent → Result
Flow Editor는 오케스트레이션을 하나의 채팅에 묻어 두는 대신, 각 작업의 목적, 프롬프트, 워커, 입력 계약, 출력 계약, 검토 경계를 계속 눈에 보이게 유지합니다.
- Flow Editor: 작업, 입력, 결과, 매핑, 계약, 조건, 예산, 게이트를 연결하세요.
- Prompt Workspace: 재사용 가능한 프롬프트, 변수, 변형, 매트릭스, 평가, 버전 관리된 프롬프트 자산을 관리하세요.
- Agent 라우팅: System AI, 로컬 모델, MCP 에이전트, 설정된 클라우드 프로바이더 또는 사람 단계를 사용하세요.
- 지속형 Run: 재시도 경계와 함께 대기, 진행, 일시 중지, 대기 중, 실패, 검토됨, 완료 상태의 작업을 추적하세요.
- Agent Queue 및 MCP: 범위가 지정된 외부 에이전트가 작업을 점유하고 컨텍스트를 받아 진행 상황과 결과를 반환하도록 하세요.
- Artifacts 및 검토: 유형화된 출력, 계보, 버전, 코멘트, 차이 비교, 롤백, 내보내기, 게시, 감사 기록을 보관하세요.
참고: 외부 에이전트, 프로바이더, 명령, 연결된 서비스는 파일과 시스템에 영향을 줄 수 있습니다. 승인하기 전에 범위, 목적지, 출력을 검토하세요.
설정
설정을 열어 다음과 같은 앱 전용 항목을 확인하세요:
- Agent, AI 프로바이더, 연결, MCP Host, 워크스페이스 권한
- 승인, 데이터 전송, 예산, 검토, 게시 정책
- 키보드 단축키, 외관, 진단, 복구
- 프로젝트, 아티팩트, 트리거, Knowledge, Agent Memory 동작
체험판, 무료, Pro는 동일한 기능을 사용합니다. Pro는 모바일 광고와 데스크톱의 일일 후원 알림을 없앱니다.
키보드 단축키
Apple 플랫폼에서는 화면에 Ctrl로 표시된 단축키가 플랫폼 기본 보조키에 매핑되므로 Command를 사용하세요. 앱 안의 단축키 페이지가 최종 기준입니다.
| 단축키 | 동작 |
|---|---|
| F2 / Enter | 선택한 프롬프트 변수 항목의 이름 변경 또는 편집 |
| F4 | 선택한 프롬프트 변수의 경로 모드 전환 |
| Tab / 오른쪽 화살표 | 다음 프롬프트 변수 구간으로 이동 |
| 왼쪽 화살표 | 이전 프롬프트 변수 구간으로 이동 |
| Escape | 인라인 프롬프트 편집 취소 |
| Settings > Keyboard Shortcuts | 현재 등록된 전역 동작을 확인하세요 |
팁 & 활용법
이후의 연결이 이해하기 쉽도록 모든 Result에 명확한 이름을 붙이세요.
외부 Agent나 트리거를 추가하기 전에 System AI와 짧은 수동 흐름으로 시작하세요.
에이전트의 워크스페이스 직접 접근이 검사를 통과하지 못하면 VFS 경유 또는 Patch 전용 접근을 사용하세요.
비밀 정보는 참조 형태로 보관하고, 외부로 전송하기 전에 데이터 전송 미리보기를 확인하세요.
문제 해결
| 증상 | 확인할 것 |
|---|---|
| Agent를 사용할 수 없음 | Agents와 Connections를 열고 설치, 로그인, 전달 모드, 리스너, 워크스페이스, 프로브 상태를 확인하세요. |
| Run이 대기 중임 | 작업 상태, 승인, 데이터 전송 검토, 사람 게이트, 예산, 누락된 입력을 확인하세요. |
| 결과를 적용할 수 없음 | 아티팩트 계약, 원본 리비전, 워크스페이스 기능, 검토/게이트 결정을 확인하세요. |
| 백그라운드 리스너가 작업을 가져가지 않음 | MCP Host, 프로젝트 라우팅, 리스너 프로세스, 정확한 Agent, 현재 워크스페이스 경로를 확인하세요. |
개인정보 보호
- 비밀 정보는 프로젝트 텍스트로 펼쳐지지 않고 참조 형태로 유지됩니다.
- 데이터 전송 미리보기는 외부로 전송하기 전에 목적지와 선택된 페이로드를 보여줍니다.
- Agent 및 MCP 접근은 범위가 지정되고 기능 검사를 거치며 검토 경계를 통해 라우팅됩니다.
- 감사 기록은 원시 자격 증명을 의도적으로 노출하지 않으면서 결정과 결과를 기록합니다.
사용자의 책임: 승인된 프로바이더, 워크스페이스, 호스트, 계정, 도구만 사용하고 승인·감사·안전 제어를 우회하지 마세요.