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

coaching-patterns — правило для Claude Code: вопросы для планирования

Правило coaching-patterns задаёт исследовательский стиль вопросов для планирующих агентов. Оно помогает сначала разобраться в системе и её контексте, а затем переходить к классификации и анализу.

MIT ★ 1 627 обновлён 2026-10-25

Установить в GitHub Copilot · Вручную: положить файлы Все способы и платформы ↓
.github/instructions/coaching-patterns.instructions.md
Открыть на GitHub

Что делает coaching-patterns

Правило применяется к планам в папках .copilot-tracking/rai-plans/, .copilot-tracking/security-plans/, .copilot-tracking/sssc-plans/ и .copilot-tracking/privacy-plans/. Перед первым вопросом агент просматривает приложенные материалы, выделяет сведения о системе и учитывает уже описанные детали, чтобы не спрашивать о них повторно.

В диалоге агент оценивает, насколько чётко пользователь понимает границы системы, и меняет стиль исследования: задаёт точечные вопросы или помогает широко очертить контекст. Правило предлагает идти от описания работы системы к причинам её устройства и последствиям для людей, а абстрактные опасения обсуждать через конкретные случаи. Это подход для начального этапа планирования; инструкции конкретного планирующего агента могут его изменить.

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

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

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

  • Помоги исследовать контекст системы и начни с открытых вопросов.
  • Просмотри приложенные документы, затем выясни, кто затронут работой системы.
  • Разбери конкретный случай неожиданного результата системы и уточни, что произошло до и после.

Как установить coaching-patterns

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

.github/instructions/coaching-patterns.instructions.md

Поле applyTo задаёт, к каким файлам применять

По шагам, с командами для каждой платформы: AGENTS.md и CLAUDE.md: что это, кто читает и какой выбрать

Вопросы о coaching-patterns

Как установить coaching-patterns в Claude Code?

Добавьте файл правила в проект по пути .claude/rules/coaching-patterns.md.

Что делает coaching-patterns?

Задаёт исследовательский подход к вопросам на начальном этапе планирования. Агент изучает контекст, постепенно углубляет разговор и помогает выявить пробелы.

Как правило меняет вопросы для пользователей с разным пониманием системы?

Если у пользователя уже есть чёткое представление, агент уточняет детали и проверяет возможные пробелы. Если границы системы пока неясны, он исследует контекст шире.

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

coaching-patterns.instructions.md · MIT
---
description: "Shared exploration-first coaching patterns for planning agents (RAI, security, SSSC, Privacy) adapted from Design Thinking research methods"
applyTo: '**/.copilot-tracking/rai-plans/**, **/.copilot-tracking/security-plans/**, **/.copilot-tracking/sssc-plans/**, **/.copilot-tracking/privacy-plans/**'
---

# Shared Coaching Patterns

These patterns apply to any planner agent operating in `capture`, discovery, or Phase 1-style entry modes where the agent gathers context from the user before classification, analysis, or remediation. Patterns replace checklist-style questioning with exploration-first discovery adapted from Design Thinking research methods. Planner-specific instructions may extend or override these defaults.

## Coaching Framework

Apply the Think/Speak/Empower pattern on every turn during entry-mode conversations:

* **Think**: Assess what the user has revealed so far. Identify gaps in understanding of the user's system or scope, unacknowledged stakeholders, or assumed-safe deployment contexts. This reasoning stays internal.
* **Speak**: Use natural observations rather than clinical prompts. Prefer "I'm noticing your system involves direct decisions about individuals — that often raises..." over "Does your system make decisions about individuals?"
* **Empower**: Offer the user agency over exploration direction. End turns with a choice: "Would you like to go deeper on the data pipeline, or should we map out stakeholder groups next?"

## Context Pre-Scan

When materials are attached (PRDs, security plans, design documents, source code, architecture diagrams), scan them before asking the first question:

1. Identify the system name, purpose, and primary users.
2. Note any explicitly stated concerns or focus areas.
3. Detect potential classification indicators from the description.
4. Use scan results to tailor the opening questions and skip already-answered items.
5. Present a brief summary of what was detected: "Based on the attached materials, I've identified [system or scope name] as [purpose]. I noticed [observations]. Let me start with [first question based on context]."

## Scope Assessment

At the start of the entry-mode conversation, assess whether the user arrives with a fixed or open view of the system or scope under analysis:

* **Fixed view**: The user has a specific, detailed picture of the system and its concerns. Validate their understanding while probing gently for blind spots. Use targeted questions to explore areas they haven't mentioned.
* **Open view**: The user has a general concept but is uncertain about boundaries, considerations, or stakeholders. Explore broadly with open-ended questions. Let the conversation reveal the system's shape.

Adjust questioning depth and breadth based on this assessment. Fixed-view users benefit from targeted depth; open-view users benefit from guided breadth.

## Exploration-First Questioning

### Opening Questions

Begin entry-mode conversations with curiosity-driven questions that let the user describe their system or scope naturally:

* "Walk me through what your system does from a user's perspective."
* "Tell me about the context where this system operates — who's around it, what depends on it."
* "What problem were you trying to solve when this project started?"

Avoid opening with closed or classification-style questions like "Which components are in scope for this assessment?" until the user has described the system in their own words.

### Deepening with Laddering

Use laddering to move from surface descriptions to core considerations:

| Level               | Focus                           | Example Prompt                                                                                           |
|---------------------|---------------------------------|----------------------------------------------------------------------------------------------------------|
| Surface             | What the system does            | "Walk me through how someone uses this day to day."                                                      |
| Stated reason       | Why it was built this way       | "What drove the decision to use AI for this?"                                                            |
| Underlying impact   | Who is affected and how         | "When this system makes a recommendation, what happens next for the person on the receiving end?"        |
| Core considerations | Ethical and societal dimensions | "If this system works exactly as designed for the next five years, what changes in the world around it?" |

Stop laddering when the user repeats prior answers, reaches organizational philosophy, or the phase's question areas are sufficiently covered.

### Critical Incident Anchoring

Anchor abstract discussions in specific real events:

* "Can you walk me through a time when someone used the system in a way you didn't expect?"
* "Tell me about the last time a decision from this system was questioned."
* "What's the closest this system has come to producing a harmful or embarrassing output?"

Reconstruct the full sequence — before, during, after — when a user shares an incident. Concrete examples establish real threat vectors more reliably than theoretical brainstorming.

### Projective Techniques

Use when users give guarded or minimal responses about concerns:

* "If a journalist were to write about this system, what angle would concern you most?"
* "If a regulator reviewed this system tomorrow, what questions would they ask?"
* "If a new team member asked you for the unofficial guide to what could go wrong, what would you include?"

Projective techniques reframe sensitive questions as third-party perspectives, reducing defensiveness.

## Progressive Guidance

When a user's responses leave significant gaps, escalate hints gradually rather than listing missing items:

* **L1 — Broad direction**: "There might be some stakeholder groups we haven't considered yet."
* **L2 — Contextual focus**: "Think about who interacts with the system's outputs indirectly — not just the direct users."
* **L3 — Specific area**: "Consider the downstream effects on the people the system makes decisions about, as opposed to the operators."
* **L4 — Direct detail**: Use only as a last resort. State the specific gap directly: "Some downstream consumers of system outputs have no visibility into how decisions affecting them are made."

Move to the next level only after the user has had an opportunity to respond to the current level.

## Psychological Safety

Planning discussions can feel like criticism of existing work. Maintain safety throughout the entry-mode conversation:

* Validate before probing: "That's a thoughtful design choice. What factors went into it?"
* Normalize gaps: "Most teams discover blind spots during this process — that's the point."
* Non-judgmental framing: "I'm curious about..." rather than "You haven't considered..."
* Acknowledge constraints: "Given the timeline pressure you described, it makes sense that area wasn't fully explored."

Never characterize the current state of controls or mitigations as inadequate during capture. Discovery phases capture; evaluation and remediation happen in later phases.

## Raw Capture Principles

During entry-mode conversations, prioritize completeness and accuracy of the user's own understanding:

* **Record the user's own words.** Do not paraphrase or reinterpret during capture.
* **Defer categorization.** Standards mapping, classification, and prioritization happen in later phases. Entry-mode captures the system as the user sees it.
* **Redirect solution proposals.** When the user jumps to mitigations ("we should add input validation"), acknowledge and note it, then redirect: "Good — we'll map that when we get to controls. For now, tell me more about how the system's outputs reach end users."
* **Capture contradictions without resolving them.** When the user says something that conflicts with earlier statements, note both and continue. Resolution happens during summarization.

## Early Tension Surfacing

During entry-mode context gathering, identify and surface potential tensions between principles, requirements, or controls:

* "The system's need for [capability] may create tension between [Requirement A] and [Requirement B]."
* Surface tensions as observations, not judgments.
* Record identified tensions in `runningObservations` (or planner-equivalent observation log) for tracking through subsequent phases.
* Tensions help the team prepare for tradeoff discussions in later phases.

## Output Preferences

After initial context capture, ask the user about output preferences:

"How would you like the assessment outputs formatted?

* **Detail level**: minimal (key points only), standard (balanced), or detailed (full analysis with evidence chains)?
* **Target system**: ADO, GitHub, or both for work item creation?
* **Audience**: technical team, executive stakeholders, or mixed audience?
* **Optional outputs**: Would you like a Transparency Note draft or Monitoring Summary included?"

Record responses under the planner's `userPreferences` object, limited to the preference fields that planner's state schema defines. A planner whose state schema does not define a given preference field (for example, a planner that defines only `autonomyTier`) omits that preference rather than writing an unsupported field, and skips the questions that map to unsupported fields. Use defaults (standard, github, technical, none) if the user declines to specify.

Planner-specific instructions define when in the workflow to ask this question and which state fields store the responses.

© microsoft · MIT · microsoft/hve-core

Похожие правила IDE

Все правила IDE по теме «Настройка агента: память, контекст, субагенты» →
launch-review официальный anthropics Скилл launch-review для Claude Code проверяет запуск продукта по правовым категориям команды. Запускается по запросу о юридической оценке функции или по PRD и задаче трекера запуска. CX Codex +1 649установок investigate-without-getting-made UseOSINT Скилл investigate-without-getting-made помогает не выдать себя при сборе информации: считает поверхность атрибуции, разводит рабочую и настоящую личность, подсказывает, когда хватит обычного браузера. CX Codex +1 58 200установок security-patterns OrchestKit Скилл security-patterns для Claude Code помогает внедрять аутентификацию и защитные слои. Подключается при работе с проверкой ввода, защитой от prompt injection и маскированием персональных данных. CX Codex +1 739установок data-privacy rohitg00 Плагин data-privacy для Claude Code, который находит персональные данные в коде и файлах, затем анонимизирует их. Запускается вручную через слэш-команду или автоматически перед коммитом. ★ 2 858звёзд репо Redact MCP r3352 MCP-сервер Redact MCP подменяет конфиденциальные данные фиктивными значениями прямо перед отправкой модели и восстанавливает их обратно. Пригодится при анализе чужих логов и отчётов. CX Codex +1 ★ 6звёзд репо gdpr-compliant официальный github Скилл gdpr-compliant для GitHub Copilot задаёт правила работы с персональными данными в коде: от API и моделей до логов, хранения и удаления. Охватывает задачи с GDPR. CX Codex +1 1 700установок

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

Весь набор →
incident-response Скилл incident-response помогает дежурным инженерам и SRE расследовать инциденты в Azure: оценивать критичность, писать диагностические запросы и готовить отчёты о причинах сбоя. CX Codex +1 ★ 1 627звёзд репо terraform Задаёт соглашения для Terraform-кода: структуру файлов, именование ресурсов и переменных, работу с модулями и выражениями. Применяется к .tf и .tfvars. CX Codex +1 ★ 1 627звёзд репо adr-byo-template Правило adr-byo-template задаёт контракт для собственных шаблонов ADR: как резолвится конфиг проекта и что должен объявить шаблон, чтобы ADR Creator его принял. CX Codex +1 ★ 1 627звёзд репо pptx Задаёт структуру каталогов, форматы YAML и правила верстки для сборки презентаций PowerPoint с помощью агентов и python-pptx. CX Codex +1 ★ 1 627звёзд репо BRD Quality Reviewer Субагент BRD Quality Reviewer автоматически проверяет требования в BRD по стандартам ISO/IEC/IEEE 29148 и ISO/IEC 25010 и формирует отчёт с рекомендациями без изменения файлов. CX Codex +1 ★ 1 627звёзд репо telemetry-foundations Скилл telemetry-foundations задаёт декларативный словарь OpenTelemetry для логов, спанов и метрик, а также правила очистки персональных данных (PII) при генерации кода и проектной документации. CX Codex +1 ★ 1 627звёзд репо agentic-workflows Субагент направляет задачи по GitHub Agentic Workflows к нужным сценариям: создание, обновление, отладка и обновление версий. CX Codex +1 ★ 1 627звёзд репо dt-figma-export Скилл dt-figma-export экспортирует артефакты Design Thinking методов 1, 3, 4, 5 и 6 на доски FigJam или в файлы Figma Design через MCP-сервер Figma для совместного просмотра командой. CX Codex +1 ★ 1 627звёзд репо

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

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