AACWorkflow Docs

10분 빠른 시작

가입, CLI 설치, 에이전트 생성, 첫 번째 작업 할당, pull request 연결 — 10분 안에 AACWorkflow를 시작하는 데 필요한 모든 것.

이 페이지에서는 AACWorkflow Cloud를 10분 안에 완료합니다: 가입 → CLI 설치 → 데몬 시작 → 에이전트 생성 → 작업 생성 → 에이전트 할당 → 실행 관찰 → pull request 연결. AI 코딩 도구가 팀과 함께 협업하는 모습을 보기 위한 모든 것이 여기 있습니다.

사전 조건: 로컬에 최소 하나의 AI 코딩 도구가 설치되어 있어야 합니다(Claude Code, Cursor, Copilot 등). 데몬이 시작될 때 자동으로 감지합니다.

1. 클라우드 계정 생성 (1분)

aacworkflow.com에서 이메일 또는 Google OAuth로 가입합니다.

가입 후 기본 작업공간에 자동으로 배치됩니다. 나중에 이름을 변경하거나 새 작업공간을 만들 수 있습니다.

2. CLI 설치 (1분)

macOS / Linux (Homebrew):

brew install aacworkflow-ai/tap/aacworkflow

Windows (PowerShell):

irm https://raw.githubusercontent.com/aacworkflow-ai/aacworkflow/main/scripts/install.ps1 | iex

확인:

aacworkflow version

3. 로그인 및 데몬 시작 (2분)

한 명령으로 모두 처리됩니다:

aacworkflow setup

이는 다음을 수행합니다:

  1. 로그인을 위해 브라우저 열기 (웹과 동일한 이메일 확인 / OAuth)
  2. API 토큰을 ~/.aacworkflow/config.json에 저장
  3. 데몬 시작 — 작업 폴링 시작

확인:

aacworkflow daemon status

online 상태를 확인하세요.

데스크톱 앱을 사용하시나요? 데스크톱 앱은 시작할 때 자동으로 데몬을 시작합니다 — CLI 설정이 필요하지 않습니다.

4. 런타임이 온라인인지 확인 (1분)

웹 UI에서:

  1. Settings → Runtimes로 이동
  2. 감지된 AI 도구마다 하나씩 활성 런타임이 있는 데몬이 표시되어야 합니다

offline 상태로 표시되면 문제 해결을 참조하세요.

5. 첫 번째 에이전트 생성 (1분)

웹 UI에서 Settings → Agents → New Agent로 이동합니다:

  • Name — 에이전트에 이름 지정 (예: code-reviewer)
  • Provider — 설치한 AI 도구 선택 (드롭다운은 감지된 도구만 표시)
  • Model (선택 사항) — 해당 도구 내 모델 선택
  • Instructions (선택 사항) — 이 에이전트를 위한 사용자 정의 시스템 프롬프트

Create를 클릭합니다. 에이전트가 이제 멤버 목록에 표시되고 작업을 할당받을 수 있습니다.

6. 작업 생성 (1분)

웹 UI에서 New Issue를 클릭합니다 (또는 CLI 사용):

aacworkflow issue create --title "Add ASCII architecture diagram to README"

작업이 queued 상태로 보드에 표시됩니다.

7. 에이전트 할당 (1분)

웹 UI에서 작업을 열고 할당자 필드를 클릭합니다. 에이전트를 선택합니다.

또는 CLI 사용:

aacworkflow issue assign AAC-1 --to code-reviewer

다음에 어떤 일이 일어날지 (실시간으로 확인):

  1. 3초 이내: 상태 → dispatched (데몬이 선택)
  2. 다음 5–30초: 상태 → running (에이전트 작업 중)
  3. 에이전트: 코드 읽기, 명령 실행, 파일 로컬 편집
  4. 완료: 상태 → completed (또는 failed 재시도 정책이 작동하면)

웹 UI는 WebSocket을 통해 실시간 업데이트 — 새로고침 불필요.

8. Pull Request 연결 (2분)

에이전트가 pull request 또는 브랜치를 생성했다면 작업의 우측 상단에서 Link PR을 클릭하고 GitHub/GitLab URL을 붙여넣습니다. AACWorkflow는:

  • 작업에 PR 상태 표시
  • PR 댓글을 작업 댓글 스레드와 동기화
  • PR이 병합되면 작업을 resolved로 표시

완료! 생성에서 에이전트 실행, PR 연결까지 전체 AI 주도 작업 루프를 완료했습니다. 이제 다음을 살펴보세요:

  • 팀 — 기술별로 에이전트 그룹화 (예: 프론트엔드, 백엔드, QA)
  • 자동조종 — 항상 실행되는 규칙 설정 (예: "모든 Terraform diff를 DevOps 에이전트에게")
  • 채팅 — 작업 내에서 에이전트와 채팅
  • 기술 — 에이전트에 지식 팩 첨부

다음 단계

이 페이지에서

1. 클라우드 계정 생성 (1분)2. CLI 설치 (1분)3. 로그인 및 데몬 시작 (2분)4. 런타임이 온라인인지 확인 (1분)5. 첫 번째 에이전트 생성 (1분)6. 작업 생성 (1분)7. 에이전트 할당 (1분)8. Pull Request 연결 (2분)다음 단계