docs: add project architecture and planning documents

context/claude-context.md

@@ -0,0 +1,21 @@
+# Claude Code Integration
+
+Claude Code is the primary coding agent.
+
+ChatGPT acts as:
+
+- Reviewer
+- Architect
+- Advisor
+- Debugging assistant
+
+ChatGPT should not take control of task execution.
+
+Claude remains responsible for:
+
+- Coding
+- Testing
+- File changes
+- Git operations
+
+ChatGPT provides guidance only.

context/mcp-context.md

@@ -0,0 +1,24 @@
+# MCP Design Principles
+
+Tools should be focused.
+
+Prefer:
+
+- One question
+- One answer
+- Explicit context
+
+Avoid:
+
+- Automatically sending entire repositories
+- Automatically sending secrets
+- Large uncontrolled context windows
+
+All tools should support:
+
+- Question
+- Context
+- Constraints
+- Expected output format
+
+Responses should be concise and actionable.

context/openai-context.md

@@ -0,0 +1,26 @@
+# OpenAI Integration
+
+Provider:
+
+OpenAI
+
+Interface:
+
+Responses API
+
+Model Selection:
+
+Configurable
+
+Default Behaviour:
+
+- Low temperature
+- Deterministic outputs
+- Structured responses
+
+Requirements:
+
+- API key via environment variable
+- Rate limit awareness
+- Error handling
+- Retry logic

context/project-context.md

@@ -0,0 +1,28 @@
+# Project Context
+
+Project Name:
+ChatGPT MCP
+
+Purpose:
+
+Allow Claude Code to query ChatGPT through MCP tools.
+
+Primary Use Cases:
+
+- Architecture review
+- Plan review
+- Code review
+- Debugging assistance
+- Risk identification
+- Task decomposition
+
+Non-Goals:
+
+- Autonomous coding
+- Source control management
+- Deployment automation
+- Replacing Claude Code
+
+Success Criteria:
+
+Claude Code can invoke MCP tools and receive useful second-opinion responses from ChatGPT.

context/user-context.md

@@ -0,0 +1,29 @@
+# User Context
+
+Primary User:
+
+Rob
+
+Environment:
+
+- MacBook Pro
+- Claude Code
+- VS Code
+- Gitea
+- Jenkins
+- Docker
+- Ollama
+
+Preferences:
+
+- Self-hosted where practical
+- Small reviewable changes
+- Backlog-driven development
+- Clear documentation
+- Simple architecture
+
+Avoid:
+
+- Unnecessary complexity
+- Large rewrites
+- Vendor lock-in