67 lines
2.7 KiB
Markdown
67 lines
2.7 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)
|
|
|
|
- Task 4.1 — ask_chatgpt handler (`src/tools/ask-chatgpt.js`, `test/tools/ask-chatgpt.test.js`) ✅
|
|
- Task 4.2 — review_plan handler (`src/tools/review-plan.js`, `test/tools/review-plan.test.js`) ✅
|
|
- Task 4.3 — review_code handler (`src/tools/review-code.js`, `test/tools/review-code.test.js`) ✅
|
|
- Task 4.4 — debug_issue tool handler (`src/tools/debug-issue.js`, `test/tools/debug-issue.test.js`) ✅
|
|
|
|
## Next Pending
|
|
|
|
### Task 4.4 - debug_issue tool handler ✅
|
|
|
|
Built `src/tools/debug-issue.js` with dependency-injected `handleDebugIssue(input, deps)` and 28 orchestration-only tests in `test/tools/debug-issue.test.js`. Followed the same pattern as 4.1, 4.2, and 4.3. All 28 tests pass.
|
|
|
|
### Next Pending
|
|
|
|
- Task 4.5 — architecture_review tool handler (`src/tools/architecture-review.js`, `test/tools/architecture-review.test.js`)
|
|
|
|
## 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.
|