# AGENT_HANDOFF.md

## Completed

### Phase 0 — Repository Setup
- Repository skeleton (TASK 0.1)
- package.json with dependencies (TASK 0.2)

### Phase 1 — Core Utilities
- Configuration loader (`src/config/env.js`) — TASK 1.1
- Secret redaction utility (`src/utils/redact.js`) — TASK 1.2
- Context budget utility (`src/utils/context-budget.js`) — TASK 1.3
- Safe logging helper (`src/utils/logging.js`) — TASK 1.4

### Phase 2 — OpenAI Integration
- OpenAI client wrapper (`src/openai/client.js`) — TASK 2.1
- Response builder (`src/openai/responses.js`) — TASK 2.2
- Error handling and edge cases (tests) — TASK 2.3

### Phase 3 — Tool Inputs and Prompts
- Zod input validation schemas (`src/tools/schemas.js`, tests) — TASK 3.1
- Base prompt template (`src/prompts/base.js`, tests) — TASK 3.2
- ask_chatgpt prompt builder (`src/prompts/ask-chatgpt.js`, tests) — TASK 3.3
- review_plan prompt builder (`src/prompts/review-plan.js`, tests) — TASK 3.4
- review_code prompt builder (`src/prompts/review-code.js`, tests) — TASK 3.5
- debug_issue prompt builder (`src/prompts/debug-issue.js`, tests) — TASK 3.6
- architecture_review prompt builder (`src/prompts/architecture-review.js`, tests) — TASK 3.7

## Next Phase

### Phase 4 - Tool Handlers

Build the MCP tool handlers that:
1. Register each tool with the MCP server.
2. Validate input using `schemas.js`.
3. Call the appropriate prompt builder.
4. Send the prompt to OpenAI via `responses.js`.
5. Return structured advisory output to Claude Code.

## Completed (Phase 4)

All five MCP tool handlers are complete:

| Handler | File | Tests |
|---------|------|-------|
| handleAskChatGpt | `src/tools/ask-chatgpt.js` | ✅ 27 |
| handleReviewPlan | `src/tools/review-plan.js` | ✅ 28 |
| handleReviewCode | `src/tools/review-code.js` | ✅ 28 |
| handleDebugIssue | `src/tools/debug-issue.js` | ✅ 28 |
| handleArchitectureReview | `src/tools/architecture-review.js` | ✅ 28 |

Total: 139 orchestration-only tests, all passing.

## Completed (Phase 5)

### Task 5.1 - MCP server skeleton ✅

Minimal MCP stdio server in `src/server.js`. MCP initialize handshake succeeds. No tools registered yet.

## Next Pending

### Task 5.2 - Register ask_chatgpt MCP tool

## General Rules

- Read ARCHITECTURE.md before making changes.
- Work incrementally.
- Keep changes small.
- Do not implement multiple phases at once.
- Do not add features not described in ARCHITECTURE.md.
- Update documentation when appropriate.
- Claude Code is the implementation agent.
- ChatGPT MCP is advisory only.