You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: .github/AGENTS.md
+10-11Lines changed: 10 additions & 11 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -4,7 +4,7 @@
4
4
5
5
This file defines the **baseline standards, workflows, and structure** for *all contributors and AI agents* operating within this repository. It serves as the root authority for engineering conduct, coding conventions, and collaborative norms.
6
6
7
-
It is designed to help AI assistants (e.g., Codex, Claude, Cursor, Sweep AI) and human developers alike understand our practices, contribute clean and idiomatic code, and navigate the codebase confidently and effectively.
7
+
It is designed to help AI assistants (e.g., Codex, Claude, Gemini) and human developers alike understand our practices, contribute clean and idiomatic code, and navigate the codebase confidently and effectively.
8
8
9
9
> Whether reading, writing, testing, or committing code, **you must adhere to the rules in this document.**
10
10
@@ -28,23 +28,22 @@ Our technical standards are organized into focused, portable documents in the `.
28
28
29
29
### Project Management & Infrastructure
30
30
***[Labeling Conventions](tech-conventions/labeling-conventions.md)** - GitHub label system
31
-
***[CI & Validation](tech-conventions/ci-validation.md)** - Continuous integration and automated checks
32
31
***[Dependency Management](tech-conventions/dependency-management.md)** - Go modules and security
33
32
***[Security Practices](tech-conventions/security-practices.md)** - Vulnerability reporting and secure coding
34
33
***[GitHub Workflows Development](tech-conventions/github-workflows.md)** - Actions workflow best practices
35
34
36
-
### Build & Project Setup
37
-
***[Governance Documents](tech-conventions/governance-documents.md)** - Project governance and community standards
38
-
39
35
> 💡 **Start with [tech-conventions/README.md](tech-conventions/README.md)** for a complete index with descriptions.
> This directory contains modular, portable technical conventions that can be adopted across projects. Each file focuses on a specific aspect of software development.
Go modules management, security scanning, version control practices, and maintaining healthy dependencies.
49
48
@@ -61,59 +60,4 @@ Creating and maintaining GitHub Actions workflows with security, reliability, an
61
60
### 🏗️ Build & Project Setup
62
61
63
62
**[MAGE-X Build Automation](mage-x.md)**
64
-
Zero-boilerplate build automation system with 240+ built-in commands that replaces Makefiles. Includes installation, configuration, command reference, and migration guide.
These conventions evolve with best practices. To propose changes:
113
-
114
-
1. Fork the repository
115
-
2. Create a feature branch (`feat/improve-testing-standards`)
116
-
3. Make your changes with clear reasoning
117
-
4. Submit a PR with the "documentation" label
118
-
119
-
Remember: Good conventions are discovered through practice, not prescribed in theory.
63
+
Zero-boilerplate build automation system with 150+ built-in commands that replaces Makefiles. Includes installation, configuration, command reference, and migration guide.
0 commit comments