diff --git a/docs/.DS_Store b/docs/.DS_Store
new file mode 100644
index 000000000..edee1120b
Binary files /dev/null and b/docs/.DS_Store differ
diff --git a/docs/ARCHITECTURE.md b/docs/ARCHITECTURE.md
new file mode 100644
index 000000000..f2268eb7f
--- /dev/null
+++ b/docs/ARCHITECTURE.md
@@ -0,0 +1,16 @@
+# Architecture
+
+## Overview
+Placeholder for system overview and design goals.
+
+## Components
+Placeholder for major components and responsibilities.
+
+## Data Flow
+Placeholder for request lifecycle and data movement.
+
+## Dependencies
+Placeholder for internal and external dependencies.
+
+## Decision Records
+Placeholder for ADRs and rationale links.
diff --git a/docs/CONTRIBUTING.md b/docs/CONTRIBUTING.md
new file mode 100644
index 000000000..cf05fbf70
--- /dev/null
+++ b/docs/CONTRIBUTING.md
@@ -0,0 +1,16 @@
+# Contributing
+
+## Overview
+Placeholder for contribution guidelines and process.
+
+## Development Setup
+Placeholder for local setup steps and tooling.
+
+## Coding Standards
+Placeholder for style, linting, and formatting rules.
+
+## Testing
+Placeholder for test commands and expectations.
+
+## Pull Requests
+Placeholder for PR template and review process.
diff --git a/docs/DEPLOYMENT.md b/docs/DEPLOYMENT.md
new file mode 100644
index 000000000..82e6ea7d6
--- /dev/null
+++ b/docs/DEPLOYMENT.md
@@ -0,0 +1,16 @@
+# Deployment
+
+## Overview
+Placeholder for deployment environments and targets.
+
+## Prerequisites
+Placeholder for required tools, credentials, and access.
+
+## Steps
+Placeholder for deployment steps by environment.
+
+## Rollback
+Placeholder for rollback procedures and checks.
+
+## Verification
+Placeholder for post-deploy checks and monitoring.
diff --git a/docs/MCP_INTEGRATION.md b/docs/MCP_INTEGRATION.md
new file mode 100644
index 000000000..a2d3d12e7
--- /dev/null
+++ b/docs/MCP_INTEGRATION.md
@@ -0,0 +1,19 @@
+# MCP Integration
+
+## Overview
+Placeholder for MCP integration overview and goals.
+
+## Architecture
+Placeholder for components, data flow, and boundaries.
+
+## Configuration
+Placeholder for required config keys and examples.
+
+## Usage
+Placeholder for setup steps and example commands.
+
+## Security
+Placeholder for authentication, authorization, and secrets handling.
+
+## Troubleshooting
+Placeholder for common issues and resolutions.
diff --git a/docs/PLUGIN_DEVELOPMENT.md b/docs/PLUGIN_DEVELOPMENT.md
new file mode 100644
index 000000000..55fb8e361
--- /dev/null
+++ b/docs/PLUGIN_DEVELOPMENT.md
@@ -0,0 +1,19 @@
+# Plugin Development
+
+## Overview
+Placeholder for plugin development workflow and expectations.
+
+## Project Structure
+Placeholder for recommended folder layout and entry points.
+
+## API Surface
+Placeholder for SDK usage and versioning guidance.
+
+## Testing
+Placeholder for test strategy and tooling.
+
+## Publishing
+Placeholder for release steps and registry requirements.
+
+## Examples
+Placeholder for minimal plugin example.
diff --git a/docs/TROUBLESHOOTING.md b/docs/TROUBLESHOOTING.md
new file mode 100644
index 000000000..a970453c7
--- /dev/null
+++ b/docs/TROUBLESHOOTING.md
@@ -0,0 +1,13 @@
+# Troubleshooting
+
+## Overview
+Placeholder for common issues and support workflow.
+
+## Diagnostics
+Placeholder for logs, status checks, and commands.
+
+## Known Issues
+Placeholder for known issues and workarounds.
+
+## Escalation
+Placeholder for escalation criteria and contacts.
diff --git a/docs/platforms/.DS_Store b/docs/platforms/.DS_Store
new file mode 100644
index 000000000..b651d8c09
Binary files /dev/null and b/docs/platforms/.DS_Store differ
diff --git a/docs/reference/.DS_Store b/docs/reference/.DS_Store
new file mode 100644
index 000000000..a119e2353
Binary files /dev/null and b/docs/reference/.DS_Store differ