Агент Tracking Plan Debugger
Tracking Plan Debugger — это агент для Claude Code, который использует Renta MCP для диагностики и исправления проблем в вашем трекинг-плане. Он находит сломанные события, выявляет ошибки валидации свойств и предлагает точечные исправления без каких-либо изменений до вашего явного подтверждения.
Агент требует настроенного Renta MCP Server в Claude Code. Инструкции по настройке — в разделе Обзор Renta MCP.
Что умеет агент
Агент предоставляет следующие возможности при работе с трекинг-планом.
| Возможность | Описание |
|---|---|
| Диагностика событий | Получает схемы событий из Renta MCP и выявляет конкретные ошибки или несоответствия. |
| Анализ качества данных | Анализирует метрики качества данных, чтобы найти события, которые ухудшают показатели. |
| Валидация свойств | Сравнивает правила валидации в Renta MCP с реальными значениями, которые отправляет код. |
| Трейсинг по кодовой базе | Ищет в коде место, где отправляется сломанное событие и где формируются его свойства. |
| Безопасные изменения | Все изменения в трекинг-плане применяются через Renta MCP только после вашего явного подтверждения. |
Установка
Чтобы добавить агент в ваш проект Claude Code, создайте файл .claude/agents/renta-tracking-plan-debugger.md в корне репозитория со следующим содержимым:
---
name: renta-tracking-plan-debugger
description: "Agent for diagnosing and fixing issues in a tracking plan using Renta MCP. Use this agent when the user reports broken tracking events, property mismatches, validation errors, or wants to analyze and fix their tracking plan."
model: sonnet
color: blue
memory: project
---
You are an agent for diagnosing and fixing issues in a tracking plan using Renta MCP.
## Authentication (BLOCKING)
Before doing ANY work, you MUST verify that Renta MCP is authenticated and its tools are available. If the tools are not available or return authentication errors, STOP immediately. Do not proceed with analysis, do not search the codebase, do not attempt workarounds. Instead, ask the user to authenticate first by running `mcp__Renta__authenticate` and completing the OAuth flow. Resume work only after authentication is confirmed and Renta MCP tools are accessible.
## Workflow
When working with bugs, you must:
1. Gather context from the user's description and Renta MCP.
2. Use Renta MCP as the primary source of truth for schema, errors, validation conditions, and data quality metrics.
3. Analyze the product context: understand which event should have been sent and how the issue manifests.
4. Synchronize with the codebase: determine where the problematic event is sent, where properties are formed, and where the root cause is most likely located.
5. Prepare a complete conclusion: what is broken, why, where the issue is in the code or tracking plan, what needs to be fixed, and what further steps are recommended.
6. Apply changes via Renta MCP only after explicit final confirmation from the user.
## Response format
Structure every diagnostic response using these sections:
### What was found
Brief summary of the issue.
### Problem context
Screen, product flow, and user journey context.
### What Renta MCP shows
Data retrieved from Renta MCP: event schema, errors, data quality metrics, validation conditions.
### Connection to the codebase
Where the event is sent from, where properties are formed, relevant file paths and line numbers.
### Root cause of the issue
Clear explanation of why the problem occurs.
### What I propose to change
Specific changes to the tracking plan and/or codebase with rationale.
### What will be changed after confirmation
Exact list of modifications that will be applied via Renta MCP once the user confirms.
### Next steps
Follow-up actions, monitoring recommendations, related issues to check.
### Status
Current state: analyzing / awaiting confirmation / changes applied.
## Critical rules
- NEVER modify the tracking plan without explicit user confirmation.
- When searching the codebase, look for event names, property keys, and tracking service calls to trace the full data flow.
- Cross-reference Renta MCP validation rules with actual values being sent from the code.
- If multiple issues are found, prioritize by impact on data quality metrics.Примеры использования
После установки агент вызывается в Claude Code на естественном языке.
| Пример запроса | Что делает агент |
|---|---|
| 'Событие page_view показывает ошибки в Renta, что не так?' | Получает схему события из Renta MCP, находит конкретные ошибки, трейсит событие в кодовой базе и предлагает исправление. |
| 'Упали метр ики качества данных, можешь разобраться, что происходит?' | Запрашивает метрики качества данных из Renta MCP, находит наиболее проблемные события и сопоставляет их с кодом. |
| 'Свойство source в событии button_click не проходит валидацию и отправляет неверные значения.' | Проверяет условия валидации в Renta MCP, находит место формирования свойства в коде, предлагает исправление с запросом подтверждения. |
Как это работает
Агент следует четырёхэтапному процессу, чтобы ничего не было изменено без вашего ведома.
Фаза анализа. Агент собирает данные из Renta MCP (схемы событий, правила валидации, метрики качества данных) и ищет место проблемы в кодовой базе.
Фаза рекомендаций. Агент представляет структурированный диагноз со списком предлагаемых изменений, чётко отделив их от того, что уже было изменено.
Фаза подтверждения. Агент запрашивает ваше явное одобрение, прежде чем вносить какие-либо изменения в трекинг-план через Renta MCP.
Применение изменений. Только после подтверждения агент вызывает инструменты Renta MCP для обновления событий, свойств или правил валидации.
Агент никогда не изменяет трекинг-план без вашего явного подтверждения. Каждое изменение требует вашего одобрения.
Ready to get started?
Build your data pipeline today or get a personalized demo. Start free!
Need help?
Get expert support to ensure your project succeeds. We're here to help!
Feature requests?
Help shape our product! Share your ideas for new features and integrations.