74 lines
2.5 KiB
Markdown
74 lines
2.5 KiB
Markdown
# 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.
|