Skip to content

Add Response Structure Guidelines to agent instructions#12476

Closed
pelikhan with Copilot wants to merge 2 commits into
mainfrom
copilot/update-agent-communication-template
Closed

Add Response Structure Guidelines to agent instructions#12476
pelikhan with Copilot wants to merge 2 commits into
mainfrom
copilot/update-agent-communication-template

Conversation

Copilot AI commented Jan 29, 2026

Copy link
Copy Markdown
Contributor

Codifies the 7-part communication structure identified through agent persona exploration research (discussion #12461) that consistently produced high-quality workflow responses.

Changes

New Section: Response Structure Guidelines

Added comprehensive documentation to .github/agents/developer.instructions.md covering:

The 7-Part Structure:

  1. Success announcement with contextual emoji (🎉 general, 🚀 deployment, ✨ features, etc.)
  2. Deliverables summary with file sizes and descriptions
  3. Quick start commands (copy-paste ready, 100% adoption in successful workflows)
  4. Key features (4-7 items with checkmarks)
  5. Customization options (framework-specific with before/after examples)
  6. Pro tips (3-5 actionable insights addressing common pitfalls)
  7. Next steps (logical progression: test → deploy → enhance)

Supporting Content:

  • Complete template showing all parts flowing together
  • 3 real-world examples from high-scoring personas (FE: 4.8/5.0, DevOps: 4.6/5.0, QA: 4.7/5.0)
  • Key success factors analysis
  • Guidance on when to adapt structure for simple fixes or quick responses

Example Structure

🎉 Successfully created your PR schema review automation workflow!

## What Was Created
- `.github/workflows/pr-schema-reviewer.md` (145 lines) - Main workflow
- `.github/workflows/pr-schema-reviewer.lock.yml` (342 lines) - Compiled workflow

## Quick Start
\`\`\`bash
gh aw compile .github/workflows/pr-schema-reviewer.md
gh aw run pr-schema-reviewer --pr 123
\`\`\`

## Key Features
✅ Validates migration safety (no destructive operations)
✅ Checks for proper indexing on new columns
✅ Comments detailed analysis directly on PR

[... customization, tips, next steps ...]

This formalizes patterns that empirically produce better learning outcomes and user satisfaction.

Original prompt

This section details on the original issue you should resolve

<issue_title>[plan] Update agent communication template with research insights</issue_title>
<issue_description>## Objective

Formalize the successful communication structure observed in persona exploration research into the agent instructions.

Context

From discussion #12461: Agent responses consistently followed a successful 7-part structure: success announcement, deliverables summary, quick start commands, key features, customization options, pro tips, and next steps. This structure aids learning and consistency.

Approach

  1. Add "Response Structure Guidelines" section to .github/instructions/developer.instructions.md

  2. Document the 7-part structure observed in successful workflows:

    • Success announcement with emoji (🎉, 🚀, ✨)
    • Deliverables summary (files created with sizes)
    • Quick start commands (copy-paste ready)
    • Key features with checkmarks
    • Customization options (framework-specific)
    • Pro tips section (best practices)
    • Next steps (testing, deployment)
  3. Include examples from high-scoring workflows (FE-1, DO-1, QA-1)

  4. Specify emoji usage patterns for different contexts

Files to Modify

  • Update: .github/instructions/developer.instructions.md
    • Add "Response Structure Guidelines" section
    • Include template with all 7 parts
    • Provide examples from successful workflow responses
    • Add emoji usage recommendations

Acceptance Criteria

  • Section documents the complete 7-part structure
  • Template shows exact formatting for each section
  • 2-3 real examples included from high-scoring workflows
  • Emoji usage guidance is clear and context-appropriate
  • Template emphasizes copy-paste ready commands (100% adoption rate)

AI generated by Plan Command for discussion #12461

Comments on the Issue (you are @copilot in this section)


💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.

- Add comprehensive 7-part communication structure section
- Document all 7 parts with examples and best practices
- Include 3 real-world examples (FE, DevOps, QA personas)
- Add emoji usage guidelines with context-appropriate patterns
- Include complete template showing all parts together
- Add guidance on when to deviate from the structure
- Update last modified date to 2026-01-29

Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>
Copilot AI changed the title [WIP] Update agent communication template with research insights Add Response Structure Guidelines to agent instructions Jan 29, 2026
Copilot AI requested a review from pelikhan January 29, 2026 07:19
@pelikhan pelikhan closed this Jan 29, 2026
@github-actions
github-actions Bot deleted the copilot/update-agent-communication-template branch April 2, 2026 13:13
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[plan] Update agent communication template with research insights

2 participants