Skip to content

docs: streamline agent conventions and add workflow constraints#130

Merged
rawvoid merged 1 commit into
mainfrom
dev
Jul 24, 2026
Merged

docs: streamline agent conventions and add workflow constraints#130
rawvoid merged 1 commit into
mainfrom
dev

Conversation

@rawvoid

@rawvoid rawvoid commented Jul 24, 2026

Copy link
Copy Markdown
Owner

Summary of Changes

This PR updates AGENTS.md to streamline agent conventions and establish clear workflow boundaries:

  1. Workflow & Planning:

    • Added explicit plan requirement (Plan First) and task breakdown (Task Breakdown) for complex tasks.
    • Added strict user approval gate (Approval Gate) requiring explicit user approval on plans before code implementation starts.
  2. Code & Research:

    • Added preference for inspecting local Maven repository (~/.m2/repository) source JARs and using mvn dependency:sources over web search (Local Source Inspection).
    • Standardized Java 21+ usage, code hygiene, and English-only comments/Javadoc.
    • Removed framework-specific XJC rules.
  3. Testing & Verification:

    • Mandatory execution of minimal test suite (mvn test).
    • Strict prohibition against deleting failing tests or commenting out assertions.
  4. Git & Remote Actions:

    • Enforced fine-grained, atomic local commits (Atomic Local Commits) and accurate commit messages (Accurate Commit Messages).
  5. Communication:

    • Standardized user interaction language matching user prompt language while keeping PRs, commits, comments, and Javadoc in English.

@github-actions github-actions Bot added the docs label Jul 24, 2026
@sonarqubecloud

Copy link
Copy Markdown

@rawvoid
rawvoid merged commit ac57a73 into main Jul 24, 2026
4 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant