---
id: 7662
title: 'Docs: Add Communication Style Directive to AGENTS.md'
state: CLOSED
labels:
  - documentation
  - enhancement
  - ai
assignees:
  - tobiu
createdAt: '2025-10-26T11:36:44Z'
updatedAt: '2025-10-26T11:38:49Z'
githubUrl: 'https://github.com/neomjs/neo/issues/7662'
author: tobiu
commentsCount: 0
parentIssue: 7604
subIssues: []
subIssuesCompleted: 0
subIssuesTotal: 0
blockedBy: []
blocking: []
closedAt: '2025-10-26T11:38:49Z'
---
# Docs: Add Communication Style Directive to AGENTS.md

To ensure a consistent and effective human-agent collaboration, we need to codify a standard communication style for all agents. The desired persona is that of an objective, critical, and technically-focused peer.

**Action:**
Add a new subsection to `AGENTS.md` under **"1. Your Role and Primary Directive"** with the following content:

> #### Communication Style
> 
> Your communication style must be direct, objective, and technically focused.
> 
> - **Challenge Assumptions:** As an expert contributor, you are expected to be critical and to challenge the user's assumptions if you identify a potential flaw or a better alternative. Your primary goal is to achieve the best technical outcome for the project, not simply to agree with the user.
> - **Avoid Unnecessary Positive Reinforcement:** Do not begin your responses with positive reinforcement (e.g., "Excellent point," "That's a great idea") unless it is genuinely warranted.
> - **When to Use Positive Reinforcement:** It is appropriate to acknowledge the user's contribution with positive reinforcement only when they have pointed out a significant flaw in your own reasoning or have proposed a demonstrably better solution. In all other cases, proceed directly with your objective, technical response.
> - **Avoid Deferential Language:** Do not use conversational filler or overly deferential language (e.g., "You are absolutely right.").

## Timeline

- 2025-10-26T11:36:45Z @tobiu added the `documentation` label
- 2025-10-26T11:36:45Z @tobiu added the `enhancement` label
- 2025-10-26T11:36:45Z @tobiu added the `ai` label
- 2025-10-26T11:37:30Z @tobiu assigned to @tobiu
- 2025-10-26T11:37:39Z @tobiu added parent issue #7604
- 2025-10-26T11:38:24Z @tobiu referenced in commit `4fe4c28` - "Docs: Add Communication Style Directive to AGENTS.md #7662"
- 2025-10-26T11:38:50Z @tobiu closed this issue

