# trendyol/trendyol-integration-developer-tool architecture

> Architecture diagram of the GitHub repository trendyol/trendyol-integration-developer-tool, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-03). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/trendyol/trendyol-integration-developer-tool
- Repository: https://github.com/trendyol/trendyol-integration-developer-tool

## Overview

This is a Claude Code plugin for planning and implementing Trendyol product integrations, using a managed MCP server for API contracts and validation. Its main workflow goes from integration planning and endpoint discovery through request generation, validation, and implementation guidance. The production-call guard is a separate safety path. MCP configuration and skill files are represented from the tree and README; their contents were not sampled, so those links reflect documented behavior rather than inspected wiring.

Main entry points: [`skills/trendyol-integration-developer-tool/SKILL.md`](https://github.com/trendyol/trendyol-integration-developer-tool/blob/master/skills/trendyol-integration-developer-tool/SKILL.md) (Integration workflow), [`hooks/pretool-guard.mjs`](https://github.com/trendyol/trendyol-integration-developer-tool/blob/master/hooks/pretool-guard.mjs) (Production call guard), [`skills/trendyol-integration-developer-tool/references/validation.md`](https://github.com/trendyol/trendyol-integration-developer-tool/blob/master/skills/trendyol-integration-developer-tool/references/validation.md) (Payload validation), [`.mcp.json`](https://github.com/trendyol/trendyol-integration-developer-tool/blob/master/.mcp.json) (MCP connection config)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_guidance["Integration guidance"]
  node_workflow["Integration workflow<br/>[SKILL.md]"]
  node_planning["Integration planning<br/>[workflow.md]"]
  node_endpoint["Endpoint discovery<br/>[modules.md]"]
  node_validation["Payload validation<br/>[validation.md]"]
  node_implementation["Code guidance<br/>[code-patterns.md]"]
  node_response["Response strategy"]
end

subgraph group_mcp["Developer tools MCP"]
  node_mcpconfig["MCP connection config<br/>[.mcp.json]"]
  node_mcpserver["Trendyol MCP server"]
  node_contracts["API contracts"]
  node_requestgen["Request generation"]
  node_fixtures["Test fixtures"]
  node_batch["Batch polling strategy"]
end

subgraph group_safety["Production safety"]
  node_guard["Production call guard<br/>[pretool-guard.mjs]"]
end

node_seller(("Integration developer"))
node_claude["Claude Code"]
node_toolcall(("Tool call"))

node_seller -->|"requests guidance"| node_claude
node_claude -->|"uses plugin"| node_workflow
node_workflow -->|"plans integration"| node_planning
node_workflow -->|"finds endpoints"| node_endpoint
node_workflow -->|"validates requests"| node_validation
node_workflow -->|"guides implementation"| node_implementation
node_claude -->|"calls tools"| node_mcpserver
node_mcpconfig -->|"configures connection"| node_mcpserver
node_mcpserver -->|"provides contracts"| node_contracts
node_mcpserver -->|"generates requests"| node_requestgen
node_mcpserver -->|"validates payloads"| node_validation
node_mcpserver -->|"generates fixtures"| node_fixtures
node_mcpserver -->|"provides strategy"| node_batch
node_toolcall -->|"checks target"| node_guard
node_guard -->|"denies unconfirmed"| node_toolcall

click node_workflow "https://github.com/trendyol/trendyol-integration-developer-tool/blob/master/skills/trendyol-integration-developer-tool/SKILL.md"
click node_planning "https://github.com/trendyol/trendyol-integration-developer-tool/blob/master/skills/trendyol-integration-developer-tool/references/workflow.md"
click node_endpoint "https://github.com/trendyol/trendyol-integration-developer-tool/blob/master/skills/trendyol-integration-developer-tool/references/modules.md"
click node_validation "https://github.com/trendyol/trendyol-integration-developer-tool/blob/master/skills/trendyol-integration-developer-tool/references/validation.md"
click node_implementation "https://github.com/trendyol/trendyol-integration-developer-tool/blob/master/skills/trendyol-integration-developer-tool/references/code-patterns.md"
click node_response "https://github.com/trendyol/trendyol-integration-developer-tool/blob/master/skills/trendyol-integration-developer-tool/references/response-strategy.md"
click node_mcpconfig "https://github.com/trendyol/trendyol-integration-developer-tool/blob/master/.mcp.json"
click node_guard "https://github.com/trendyol/trendyol-integration-developer-tool/blob/master/hooks/pretool-guard.mjs"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_workflow,node_planning,node_endpoint,node_validation,node_implementation,node_response toneBlue
class node_mcpconfig,node_mcpserver,node_contracts,node_requestgen,node_fixtures,node_batch toneAmber
class node_guard toneMint
class node_seller,node_claude,node_toolcall toneIndigo
```

## Components

### Integration guidance

- [Integration workflow](https://github.com/trendyol/trendyol-integration-developer-tool/blob/master/skills/trendyol-integration-developer-tool/SKILL.md): `skills/trendyol-integration-developer-tool/SKILL.md`
- [Integration planning](https://github.com/trendyol/trendyol-integration-developer-tool/blob/master/skills/trendyol-integration-developer-tool/references/workflow.md): `skills/trendyol-integration-developer-tool/references/workflow.md`
- [Endpoint discovery](https://github.com/trendyol/trendyol-integration-developer-tool/blob/master/skills/trendyol-integration-developer-tool/references/modules.md): `skills/trendyol-integration-developer-tool/references/modules.md`
- [Payload validation](https://github.com/trendyol/trendyol-integration-developer-tool/blob/master/skills/trendyol-integration-developer-tool/references/validation.md): `skills/trendyol-integration-developer-tool/references/validation.md`
- [Code guidance](https://github.com/trendyol/trendyol-integration-developer-tool/blob/master/skills/trendyol-integration-developer-tool/references/code-patterns.md): `skills/trendyol-integration-developer-tool/references/code-patterns.md`
- [Response strategy](https://github.com/trendyol/trendyol-integration-developer-tool/blob/master/skills/trendyol-integration-developer-tool/references/response-strategy.md): `skills/trendyol-integration-developer-tool/references/response-strategy.md`

### Developer tools MCP

- [MCP connection config](https://github.com/trendyol/trendyol-integration-developer-tool/blob/master/.mcp.json): `.mcp.json`
- **Trendyol MCP server**
- **API contracts**
- **Request generation**
- **Test fixtures**
- **Batch polling strategy**

### Production safety

- [Production call guard](https://github.com/trendyol/trendyol-integration-developer-tool/blob/master/hooks/pretool-guard.mjs): `hooks/pretool-guard.mjs`

### Other components

- **Integration developer**
- **Claude Code**
- **Tool call**

## Connections

- Integration developer → Claude Code: requests guidance (evidence: `README.md`)
- Claude Code → Integration workflow: uses plugin (evidence: `README.md`)
- Integration workflow → Integration planning: plans integration (evidence: `README.md`)
- Integration workflow → Endpoint discovery: finds endpoints (evidence: `README.md`)
- Integration workflow → Payload validation: validates requests (evidence: `README.md`)
- Integration workflow → Code guidance: guides implementation (evidence: `README.md`)
- Claude Code → Trendyol MCP server: calls tools (evidence: `README.md`)
- MCP connection config → Trendyol MCP server: configures connection (evidence: `README.md`)
- Trendyol MCP server → API contracts: provides contracts (evidence: `README.md`)
- Trendyol MCP server → Request generation: generates requests (evidence: `README.md`)
- Trendyol MCP server → Payload validation: validates payloads (evidence: `README.md`)
- Trendyol MCP server → Test fixtures: generates fixtures (evidence: `README.md`)
- Trendyol MCP server → Batch polling strategy: provides strategy (evidence: `README.md`)
- Tool call → Production call guard: checks target (evidence: `hooks/pretool-guard.mjs`)
- Production call guard → Tool call: denies unconfirmed (evidence: `hooks/pretool-guard.mjs`)
