Skip to content

[plan] Update agent communication template with research insights #12469

Description

@github-actions

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

Metadata

Metadata

Labels

Type

No type
No fields configured for issues without a type.

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions