NTDevLops 发布 UNIVERSAL-AGENTS.md：面向 AI 编程智能体的通用指令集

A universal set of instructions for AI coding agents to ensure consistent, predictable, and minimal-impact changes across software projects.

Purpose

This repository provides a technology-agnostic AGENTS.md that defines how an AI agent should analyze, plan, modify, and document software projects while preserving existing architecture and minimizing unnecessary changes.

Goals

• Execute only explicitly requested changes.
• Preserve existing project structure and architecture.
• Minimize modifications to the smallest possible scope.
• Reuse existing implementations whenever possible.
• Keep project documentation synchronized with code changes.
• Follow official documentation and best practices.
• Maintain repository cleanliness and security.
• Protect version control, secrets, and the working tree.

Contents

The AGENTS.md includes guidance for:

• Core operating principles
• Project analysis
• Implementation planning
• Existing code reuse
• Minimal-change policy
• Documentation maintenance
• Dependency management
• Best practices
• File system rules
• Repository hygiene
• Bug detection
• UI modification guidelines
• Performance considerations
• Security requirements
• Testing expectations
• Official documentation usage
• Communication guidelines
• Output rules
• Scope protection

Original rules (Sections 1–26 and Final Rule)

Same rules, same numbering, same order. The wording was polished for clarity and consistency, and no rule was added to, removed from, or changed in purpose.

Additional rules (Sections 27–36)

New sections that supplement the original rules without modifying them:

Sections 27, 28, 29, and 33 are safety rules. Only an explicit, specific instruction from the user can override them; project-specific rules cannot.

Intended Usage

1. Copy AGENTS.md into the root of your repository.
2. Allow AI coding assistants to read the file before making changes.
3. Update the file as your project's standards evolve.
4. Keep the instructions concise, explicit, and project-specific when necessary.

Project-specific rules

Copy templates/AGENTS.project.template.md to AGENTS.project.md and fill in your commands, conventions, and protected areas. Under Section 23 (Conflict Resolution), project-specific rules rank above this document and below the user's explicit instructions in the current request. Section 34.1 designates AGENTS.project.md as their location.

Tool adapters

If your tool does not read AGENTS.md natively, copy the matching pointer file from adapters/:

Many tools read AGENTS.md directly. Check your tool's documentation to see whether an adapter is needed.

Design Principles

The rules prioritize:

• Predictability
• Safety
• Maintainability
• Documentation accuracy
• Minimal code changes
• Existing architecture preservation
• Officially supported implementations

Compatibility

The guidelines are designed to work with software projects across multiple ecosystems, including but not limited to:

• Android
• iOS
• Web
• Backend
• Desktop
• Game development
• Cross-platform applications
• Libraries and SDKs

Philosophy

The agent should behave like a disciplined software engineer:

• Understand before changing.
• Reuse before creating.
• Modify only what is necessary.
• Never assume missing requirements.
• Document every meaningful project change.
• Leave the repository in a clean and consistent state.

Repository Layout

.
├── AGENTS.md                       # The universal rules
├── README.md
├── LICENSE
├── adapters/                       # Pointer files for specific tools
└── templates/
    └── AGENTS.project.template.md  # Project-specific rules

License

Released under the MIT License. Use, modify, and adapt these guidelines to fit your project's workflow and development standards.