LearnNewsExamplesServices
Frontmatter
id7662
titleDocs: Add Communication Style Directive to AGENTS.md
stateClosed
labels
documentationenhancementai
assigneestobiu
createdAtOct 26, 2025, 12:36 PM
updatedAtOct 26, 2025, 12:38 PM
githubUrlhttps://github.com/neomjs/neo/issues/7662
authortobiu
commentsCount0
parentIssue7604
subIssues[]
subIssuesCompleted0
subIssuesTotal0
blockedBy[]
blocking[]
closedAtOct 26, 2025, 12:38 PM

Docs: Add Communication Style Directive to AGENTS.md

Closed v11.0.0 documentationenhancementai
tobiu
tobiu commented on Oct 26, 2025, 12:36 PM

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.").
tobiu added the documentation label on Oct 26, 2025, 12:36 PM
tobiu added the enhancement label on Oct 26, 2025, 12:36 PM
tobiu added the ai label on Oct 26, 2025, 12:36 PM
tobiu assigned to @tobiu on Oct 26, 2025, 12:37 PM
tobiu added parent issue #7604 on Oct 26, 2025, 12:37 PM
tobiu referenced in commit 4fe4c28 - "Docs: Add Communication Style Directive to AGENTS.md #7662" on Oct 26, 2025, 12:38 PM
tobiu closed this issue on Oct 26, 2025, 12:38 PM