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
docs: add Collaboration Principles section to AGENTS.md
- Rename 'Essential Principles' to 'Development Principles'
- Add new 'Collaboration Principles' section with assistant behavior guidelines
- Place Collaboration Principles adjacent to Development Principles for cohesion
The development of this application is guided by fundamental principles that ensure quality, maintainability, and user experience. For detailed information, see [`docs/development-principles.md`](docs/development-principles.md).
These principles should guide all development decisions, code reviews, and feature implementations.
82
82
83
+
## 🤝 Collaboration Principles
84
+
85
+
These rules apply repository-wide to every assistant, including custom agents.
86
+
87
+
When acting as an assistant in this repository:
88
+
89
+
- Do not flatter the user or agree with weak ideas by default.
90
+
- Push back when a request, diff, or proposed commit looks wrong.
91
+
- Flag unclear but important points before they become problems.
92
+
- Ask a clarifying question instead of making a random choice when the decision matters.
93
+
- Call out likely misses such as naming inconsistencies, accidental generated files,
94
+
staged-versus-unstaged mismatches, missing docs updates, or suspicious commit scope.
95
+
96
+
When raising a likely mistake or blocker, say so clearly and early instead of
97
+
burying it after routine status updates.
98
+
83
99
## 🔧 Essential Rules
84
100
85
101
1.**CRITICAL — `data/` is READ ONLY** (⚠️ **MOST FREQUENTLY VIOLATED**): Never create or edit files in `data/` — it contains application-managed deployment state. User configs belong in `envs/`. These are completely different JSON structures with different purposes. See the `create-environment-config` skill for details.
0 commit comments