К основному содержанию
скилл CX Codex

symmetric-dogfooding — скилл для Claude Code: обзор и установка

Скилл symmetric-dogfooding организует двустороннее интеграционное тестирование между двумя репозиториями перед релизом без использования моков.

MIT 112 установок ★ 3 обновлён 2026-10-25

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add terrylica/cc-skills --skill symmetric-dogfooding -a claude-code
Открыть на GitHub

Что делает symmetric-dogfooding

Скилл внедряет паттерн симметричной проверки для пар связанных проектов, где код или форматы данных одного репозитория зависят от другого. Вместо искусственных заглушек тесты на обеих сторонах прогоняются на реальных структурах данных и вызовах партнерского проекта.

Инструкции содержат готовые шаблоны настройки связей для Python через uv или pip, Rust с Cargo и Node.js, а также пример конфигурации таск-раннера moon.yml. В обоих проектах создается директория tests/integration/ с взаимными проверками и шагами перед публикацией в CLAUDE.md.

Зависимости строго фиксируются через теги или коммиты: ветки вроде main запрещены, иначе тесты начнут случайно падать из-за чужих незавершенных коммитов.

Какие задачи решает

  • настроить перекрестную проверку контрактов между двумя репозиториями
  • проверить совместимость изменений перед выпуском релиза
  • добавить интеграционные тесты на реальных данных без моков
  • согласовать процесс одновременного обновления ломающих изменений

Примеры запросов агенту

  • Настрой symmetric-dogfooding между текущим репозиторием и сервисом авторизации
  • Проверь интеграционные тесты перед релизом по чек-листу symmetric-dogfooding
  • Добавь новую точку интеграции для партнерского репозитория через шаблон скилла

Как установить symmetric-dogfooding

1Через Skills CLI (Vercel)

npx skills add terrylica/cc-skills --skill symmetric-dogfooding -a claude-code

2Вручную: положить файлы

~/.claude/skills/symmetric-dogfooding/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/symmetric-dogfooding/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о symmetric-dogfooding

Как установить symmetric-dogfooding в Claude Code?

Выполните в терминале команду npx skills add terrylica/cc-skills --skill symmetric-dogfooding -a claude-code.

Что делает этот скилл?

Он направляет агента по шагам взаимной интеграции двух кодовых баз: от прописывания зависимостей до запуска тестов на реальных данных перед выпуском версий.

Почему скилл запрещает указывать ветку main в зависимостях?

Привязка к ветке делает окружение нестабильным. Скилл требует фиксировать версии только через теги гита или конкретные хэши коммитов.

Исходный текст

SKILL.md · MIT
---
name: symmetric-dogfooding
description: Bidirectional integration validation where two repositories validate each other before release.
allowed-tools: Read, Bash, Write, Edit, Grep, Glob
---

# Symmetric Dogfooding

Bidirectional integration validation pattern where two repositories each consume the other for testing, ensuring both sides work correctly together before downstream adoption.

> **Self-Evolving Skill**: This skill improves through use. If instructions are wrong, parameters drifted, or a workaround was needed — fix this file immediately, don't defer. Only update for real, reproducible issues.

## Pattern Overview

```
┌─────────────────────────────────────────────────────────────────┐
│                    SYMMETRIC DOGFOODING                         │
│                                                                 │
│        Repo A ◄─────── mutual validation ───────► Repo B        │
│                                                                 │
│   EXPORTS:                              EXPORTS:                │
│   - Library/API                         - Library/API           │
│   - Data structures                     - Data structures       │
│                                                                 │
│   VALIDATES WITH:                       VALIDATES WITH:         │
│   - Repo B real outputs                 - Repo A real outputs   │
│   - Production-like data                - Production-like data  │
│                                                                 │
└─────────────────────────────────────────────────────────────────┘
```

## When to Use This Skill

Use this skill when:

- Two repos have a producer/consumer relationship
- APIs evolve independently and need integration testing
- Data formats may drift between repos
- Both repos are actively developed

---

## TodoWrite Task Templates

### Template A: Setup Symmetric Dogfooding Between Two Repos

```
1. Identify integration surface (exports from A consumed by B and vice versa)
2. Document data formats, schemas, API signatures at boundary
3. Configure cross-repo dev dependencies in both repos
4. Pin versions explicitly (tags or SHAs, never main)
5. Create integration/ test directory in both repos
6. Write bidirectional validation tests (A validates with B outputs, B validates with A outputs)
7. Add validation tasks to the repo's task runner (moon.yml where the repo uses moon)
8. Document pre-release protocol in both CLAUDE.md files
9. Run full symmetric validation to verify setup
10. Verify against Symmetric Dogfooding Checklist below
```

### Template B: Pre-Release Validation

```
1. Run the validate-symmetric task in releasing repo
2. Check if other repo has pending changes affecting integration
3. If yes, test against other repo's feature branch
4. Document any failures in validation log
5. Fix integration issues before release
6. Update version pins after successful validation
7. Coordinate if breaking changes require simultaneous release
8. Verify against Symmetric Dogfooding Checklist below
```

### Template C: Add New Integration Point

```
1. Identify new export/import being added
2. Update integration surface documentation
3. Add tests in both repos for new integration point
4. Run symmetric validation in both directions
5. Update version pins if needed
6. Verify against Symmetric Dogfooding Checklist below
```

### Symmetric Dogfooding Checklist

After ANY symmetric dogfooding work, verify:

- [ ] Both repos have integration tests that import the other
- [ ] Version pins are explicit (tags or commit SHAs)
- [ ] Pre-release checklist includes cross-repo validation
- [ ] Integration tests use real data (not mocks of the other repo)
- [ ] Breaking changes coordination documented
- [ ] Validation task runnable via single command

---

## Post-Change Checklist (Self-Maintenance)

After modifying THIS skill:

1. [ ] Templates cover common symmetric dogfooding scenarios
2. [ ] Checklist reflects current best practices
3. [ ] Example in references/ still accurate
4. [ ] Append changes to [evolution-log.md](./references/evolution-log.md)

---

## Implementation Guide

### Phase 1: Discovery and Mapping

**Identify the integration surface:**

- List all exports from Repo A consumed by Repo B
- List all exports from Repo B consumed by Repo A
- Document data formats, schemas, API signatures

**Map validation scenarios:**

- What real-world data from B can validate A outputs?
- What real-world data from A can validate B outputs?
- Identify edge cases that only appear in production usage

### Phase 2: Dependency Configuration

Configure cross-repo dev dependencies:

**Python (uv/pip):**

```toml
# Repo A pyproject.toml
[project.optional-dependencies]
validation = ["repo-b"]

[tool.uv.sources]
repo-b = { git = "https://github.com/org/repo-b", tag = "<tag>" }  # SSoT-OK
```

```toml
# Repo B pyproject.toml
[project.optional-dependencies]
validation = ["repo-a"]

[tool.uv.sources]
repo-a = { git = "https://github.com/org/repo-a", tag = "<tag>" }  # SSoT-OK
```

**Rust (Cargo):**

```toml
[dev-dependencies]
repo-b = { git = "https://github.com/org/repo-b", tag = "<tag>" }  # SSoT-OK
```

**Node.js:**

```json
{
  "devDependencies": {
    "repo-b": "github:org/repo-b#<tag>"
  }
}
```

**Critical**: Pin to tags or commit SHAs. Never use main/master branches.

### Phase 3: Test Infrastructure

**Directory structure in both repos:**

```
repo-a/
└── tests/
    ├── unit/              # Internal tests
    └── integration/       # Tests using repo-b real outputs
        └── test_with_repo_b.py

repo-b/
└── tests/
    ├── unit/              # Internal tests
    └── integration/       # Tests using repo-a real outputs
        └── test_with_repo_a.py
```

**Bidirectional validation test pattern:**

```python
# repo-a/tests/integration/test_with_repo_b.py
"""Validate Repo A outputs work correctly with Repo B inputs."""

def test_a_output_consumed_by_b():
    # Generate output using Repo A
    a_output = repo_a.generate_data()

    # Feed to Repo B - should work without errors
    b_result = repo_b.process(a_output)

    # Validate the round-trip
    assert b_result.is_valid()
```

### Phase 4: Task Automation

**moon.yml example** (task IDs use `-` because moon reserves `:` as the project/task separator):

```yaml
tasks:
  validate-symmetric:
    description: "Validate against partner repo"
    script: "uv sync --extra validation && uv run pytest tests/integration/ -v"

  validate-pre-release:
    description: "Full validation before release"
    deps: ["~:test-unit", "~:validate-symmetric"]
```

### Phase 5: Pre-Release Protocol

**Before releasing Repo A:**

1. Run `moon run :validate-symmetric` in Repo A (tests against current Repo B)
2. If Repo B has pending changes, test against Repo B branch too
3. Update version pins after successful validation

**Before releasing Repo B:**

1. Run `moon run :validate-symmetric` in Repo B (tests against current Repo A)
2. If Repo A has pending changes, test against Repo A branch too
3. Update version pins after successful validation

**Coordinating breaking changes:**

- If A needs to break compatibility, update B first
- If B needs to break compatibility, update A first
- Consider simultaneous releases for tightly coupled changes

---

## Anti-Patterns

| Anti-Pattern               | Problem                        | Solution                      |
| -------------------------- | ------------------------------ | ----------------------------- |
| One-direction only         | Misses half the bugs           | Always test both directions   |
| Using main branch          | Unstable, breaks randomly      | Pin to tags or SHAs           |
| Skipping for small changes | Small changes cause big breaks | Always run full validation    |
| Mocking partner repo       | Defeats the purpose            | Use real imports              |
| Ignoring version matrix    | Silent production failures     | Maintain compatibility matrix |

---

## References

- [example-setup.md](./references/example-setup.md) - Real-world trading-fitness/rangebar-py example
- [evolution-log.md](./references/evolution-log.md) - Skill change history

**External:**

- [Dogfooding (DevIQ)](https://deviq.com/practices/dogfooding/)
- [CDC Testing (Microsoft)](https://microsoft.github.io/code-with-engineering-playbook/automated-testing/cdc-testing/)

---

## Troubleshooting

| Issue                       | Cause                          | Solution                                         |
| --------------------------- | ------------------------------ | ------------------------------------------------ |
| Dependency resolution fails | Version pin outdated           | Update tag/SHA pin to latest stable version      |
| Tests pass locally fail CI  | Different partner repo version | Pin exact same version in both environments      |
| Breaking change not caught  | One-direction testing only     | Run validate-symmetric in BOTH repos             |
| Integration surface unclear | Undocumented exports           | Map all imports/exports before setting up tests  |
| Too many parts moving       | Uncoordinated releases         | Coordinate breaking changes, test branches first |
| Mock data hiding bugs       | Using stubs instead of real    | Always import real partner repo for integration  |
| Version matrix explosion    | Too many combinations          | Limit support to N-1 versions, document clearly  |
| Circular dependency         | Both repos require each other  | Use optional-dependencies for validation only    |

## Post-Execution Reflection

After this skill completes, reflect before closing the task:

0. **Locate yourself.** — Find this SKILL.md's canonical path before editing.
1. **What failed?** — Fix the instruction that caused it.
2. **What worked better than expected?** — Promote to recommended practice.
3. **What drifted?** — Fix any script, reference, or dependency that no longer matches reality.
4. **Log it.** — Evolution-log entry with trigger, fix, and evidence.

Do NOT defer. The next invocation inherits whatever you leave behind.

© terrylica · MIT · terrylica/cc-skills

Похожие скиллы

Все скиллы по теме «Тесты и QA» →
symmetric-cipher-attacks yaklang Скилл symmetric-cipher-attacks для Claude Code разбирает атаки на симметричное шифрование: padding oracle в CBC, ECB cut-and-paste и повтор ключа потока. Для CTF и легального пентеста. CX Codex +1 3 900установок ceo-skill guo-yu Скилл ceo-skill сканирует репозитории, оценивает бизнес-потенциал кода и собирает дашборд проектов с точки зрения фаундера. CX Codex +1 1установок testing_plan_integration davila7 Команда testing_plan_integration формирует план интеграционных тестов для целевого кода. Она находит узкие места в архитектуре и предлагает рефакторинг с внедрением зависимостей. CX Codex +1 221установок iii-error-handling iii-hq Скилл iii-error-handling для Claude Code распознаёт коды ошибок iii-движка и SDK, различает сетевые сбои и отказы в доступе. Определяет, безопасно ли повторять вызов при работе с удалёнными функциями. CX Codex +1 5 000установок iii-sdk-reference iii-hq Скилл iii-sdk-reference для Claude Code: справочник iii SDK для Node.js, Python, Rust, Go и браузера. Регистрация воркеров, вызов функций, наблюдатели, каналы, логирование, OpenTelemetry с примерами для каждого языка. CX Codex +1 4 900установок agent-desktop-ffi vercel-labs Скилл agent-desktop-ffi для Claude Code предоставляет C-ABI привязки к PlatformAdapter из agent-desktop. Он позволяет напрямую вызывать функции ad_* без запуска отдельного CLI-бинарника при каждом обращении. CX Codex +1 614установок

Из того же набора79

Весь набор →
infra-deploy Скилл infra-deploy разворачивает self-hosted Cal.com в GCP Cloud Run с базой Supabase PostgreSQL или поднимает его локально через Docker Compose. CX Codex +1 119установок email-triage Скилл email-triage для Claude Code сортирует недавние письма Gmail по трём категориям и уровням срочности. Разбирает входящие по запросу через команду бота /digest. CX Codex +1 117установок bot-process-control Скилл bot-process-control регламентирует мониторинг процессов Gmail Commander и защищает от запуска конфликтующих локальных поллеров Telegram на рабочей станции. CX Codex +1 117установок interactive-bot Скилл interactive-bot объясняет устройство Telegram-бота Gmail Commander: слэш-команды для почты, ИИ-роутинг свободного текста через MCP, сессии compose/reply. CX Codex +1 114установок calcom-access Скилл calcom-access для Claude Code и пяти других платформ даёт агенту доступ к Cal.com API для работы с бронированиями, типами событий, расписаниями и доступностью слотов. Ключ API берётся из 1Password через CALCOM_OP_UUID. CX Codex +1 107установок claude-code-proxy-patterns Скилл claude-code-proxy-patterns описывает схемы прокси для маршрутизации моделей Claude Code к разным провайдерам. Пригодится при настройке OAuth и разборе ошибок авторизации. CX Codex +1 106установок summarize Скилл summarize разбирает многогигабайтные текстовые файлы и записи сессий пошагово, не загружая их целиком в контекст. Помогает понять, что произошло в длинной сессии разработки, когда файл слишком большой для обычного чтения. CX Codex +1 103установок booking-config Скилл booking-config для Claude Code настраивает типы встреч, расписания доступности и вебхуки Cal.com через интерфейс агента. Редактирует страницы бронирования без веб-панели. CX Codex +1 103установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой