<!-- aterm:initial — This is an auto-generated template. Customize for your project or run /init to auto-analyze. -->

# Session Communication / 세션 통신

## Internal Sessions / 내부 세션

| English action | 한국어 동작 | Command |
|----------------|------------|---------|
| List sessions | 세션 목록 보기 | `aterm list` |
| Send to session | 세션에 메시지 보내기 | `aterm inject <workspace> 'message'` |
| Check session status | 세션 상태 확인 | `aterm status <workspace>` |
| Create session | 세션 생성 | `aterm create <name> --cli <cli> --cwd <path>` |
| Restart session | 세션 재시작 | `aterm restart <workspace>` |
| Kill session | 세션 종료 | `aterm kill <workspace>` |
| Restart all dead sessions | 죽은 세션 전체 재시작 | `aterm restart-all` |
| Show tasks | 태스크 보기 | `aterm tasks` |
| Add task | 태스크 추가 | `aterm tasks add 'description'` |
| Complete task | 태스크 완료 | `aterm tasks done <id>` |
| Show lessons | 레슨 보기 | `aterm lessons` |
| Add lesson | 레슨 추가 | `aterm lessons add 'lesson'` |
| Dispatch task | 태스크 디스패치 | `aterm dispatch <task-id>` |
| Dispatch free-text task | 자유 텍스트 태스크 디스패치 | `aterm dispatch --plan 'description'` |
| Show help | 도움말 보기 | `aterm help` |

## External Sessions / 외부 세션

| English action | 한국어 동작 | Command |
|----------------|------------|---------|
| List sessions | 세션 목록 보기 | `telepty list` |
| Send to session | 세션에 메시지 보내기 | `telepty inject <session> 'message'` |

## Natural Language -> Command / 자연어 -> 명령어

| English request | 한국어 요청 | Command |
|----------------|------------|---------|
| `list sessions` | `세션 목록 보여줘` | `aterm list` |
| `send to workspace` | `워크스페이스에 메시지 보내줘` | `aterm inject <ws> 'msg'` |
| `check status` | `상태 확인해줘` | `aterm status <ws>` |
| `create session` | `세션 만들어줘` | `aterm create <name> --cli <cli> --cwd <path>` |
| `restart session` | `세션 재시작해줘` | `aterm restart <ws>` |
| `kill session` | `세션 종료해줘` | `aterm kill <ws>` |
| `show tasks` | `태스크 목록 보여줘` | `aterm tasks` |
| `add task` | `태스크 추가해줘` | `aterm tasks add 'desc'` |
| `task done` | `태스크 완료` | `aterm tasks done <id>` |
| `show lessons` | `레슨 보여줘` | `aterm lessons` |
| `add lesson` | `레슨 추가해줘` | `aterm lessons add 'lesson'` |
| `dispatch task` | `태스크 분배해줘` | `aterm dispatch <task-id>` |
| `help` | `도움말` | `aterm help` |

## Rules / 규칙

- If `$ATERM_IPC_SOCKET` exists, use `aterm` commands. / `$ATERM_IPC_SOCKET` 이 있으면 `aterm` 명령을 사용합니다.
- If `$ATERM_IPC_SOCKET` is absent, use `telepty` commands. / `$ATERM_IPC_SOCKET` 이 없으면 `telepty` 명령을 사용합니다.
- Detect all AI CLIs: `claude`, `codex`, `gemini`, `ollama`, `aider`. / 모든 AI CLI를 감지합니다.

## Principles / 원칙

- Critical: point out weaknesses. / 약점을 분명히 짚습니다.
- Constructive: provide alternatives. / 대안을 함께 제시합니다.
- Objective: balanced analysis. / 균형 잡힌 분석을 유지합니다.

## Session Communication Rules / 세션 통신 규칙

- **respond/reply** = answer in current conversation. Default action. / 현재 대화에서 응답. 기본 동작.
- **inject** = send text to ANOTHER session. Only when explicitly requested. / 다른 세션에 텍스트 전송. 명시적 요청 시에만.
- **broadcast** = send to ALL sessions. Only when explicitly requested. / 모든 세션에 전송. 명시적 요청 시에만.

| User says / 사용자 요청 | Action / 동작 |
|--------------------------|---------------|
| "respond", "reply", "answer", "ACK" (no target) | Reply in current session / 현재 세션에서 응답 |
| "inject <target>", "send to <target>" | `aterm inject` / `telepty inject` |
| "broadcast" | `aterm broadcast` / `telepty broadcast` |
| Ambiguous / 모호한 경우 | Ask for clarification. Do NOT assume inject. / 확인 요청. inject 추정 금지. |

- NEVER inject unless cross-session intent is explicit. / 크로스 세션 의도가 명시적이지 않으면 절대 inject 금지.
- NEVER inject into your own session. / 자기 세션에 inject 금지.
- If `$ATERM_IPC_SOCKET` set: use `aterm inject` for internal, `telepty inject` for external. / 내부는 aterm, 외부는 telepty.
- If `$ATERM_IPC_SOCKET` unset: use `telepty inject`. / aterm 없으면 telepty 사용.

## Reporting / 보고

- Reporting vs discussion / 보고 vs 자유 토론:
  - Orchestrator-delegated task → report to orchestrator: `aterm inject "$ATERM_ORCHESTRATOR_SESSION" 'REPORT: summary'`. / 오케스트레이터가 위임한 태스크 → 오케스트레이터에 보고.
  - Free discussion / messaging / ACK between sessions → no reporting line. / 세션 간 자유 토론/메시징/ACK → 보고 라인 없음.
  - Mandatory reporting applies ONLY to orchestrator-delegated tasks. / mandatory reporting은 오케스트레이터 위임 시에만 적용.
  - If sender is specified by user, ACK goes to that sender. / 사용자가 sender를 지정한 경우 ACK는 해당 sender에게.

## Task Execution Protocol (SAWP) / 태스크 실행 프로토콜

When receiving a task, execute ALL phases without stopping: / 태스크를 받으면 모든 단계를 멈추지 않고 실행합니다:

1. **Implement** — write the code / 코드를 작성합니다
2. **Build** — run: `{{BUILD_CMD}}` (npm run build / cargo build / make) / 빌드 실행
3. **Auto-fix** — if build fails, read error, fix, retry (max 3) / 빌드 실패 시 에러 읽고 수정 재시도 (최대 3회)
4. **Test** — run: `{{TEST_CMD}}` (npm test / cargo test / pytest) / 테스트 실행
5. **Auto-fix** — if tests fail, read error, fix, retry (max 3) / 테스트 실패 시 에러 읽고 수정 재시도 (최대 3회)
6. **Report** — include build exit code + test results as evidence / 빌드 종료 코드 + 테스트 결과를 증거로 포함

Rules / 규칙:
- NEVER stop between phases. / 단계 사이에 멈추지 않습니다.
- NEVER claim "done" without build+test evidence. / 빌드+테스트 증거 없이 "완료" 금지.
- NEVER idle on error — auto-fix up to 3 attempts, then report failure. / 에러에 멈추지 않고 최대 3회 자동 수정 후 실패 보고.
- 3 consecutive failures on same phase = circuit breaker → report STUCK with full error. / 같은 단계 3회 연속 실패 = 서킷 브레이커 → STUCK 보고.
- No "should work" or "probably fixed" — evidence only. / "아마 됐을 것" 금지 — 증거만.

Autonomy / 자율성:
- NEVER pause for user interaction. NEVER ask questions. / 사용자 상호작용을 위해 멈추지 않습니다. 질문하지 않습니다.
- Make ALL decisions autonomously. / 모든 결정을 자율적으로 내립니다.
- Technical decisions are autonomous. Business decisions default to best judgment. / 기술 결정은 자율. 비즈니스 결정은 최선의 판단으로 기본 처리.
- If truly stuck after 3 failures, report to orchestrator via inject — do NOT wait for user input. / 3회 실패 후 진짜 막히면 inject로 오케스트레이터에 보고 — 사용자 입력을 기다리지 않습니다.