Skip to content

Commit ca63c6c

Browse files
committed
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
1 parent 0de64ab commit ca63c6c

1 file changed

Lines changed: 17 additions & 1 deletion

File tree

AGENTS.md

Lines changed: 17 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -44,7 +44,7 @@ This is a deployment infrastructure proof-of-concept for the Torrust ecosystem.
4444
- `cspell.json` - Spell checking configuration
4545
- `project-words.txt` - Project-specific dictionary
4646

47-
## Essential Principles
47+
## 🧭 Development Principles
4848

4949
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).
5050

@@ -80,6 +80,22 @@ Reference: [Beck Design Rules](https://martinfowler.com/bliki/BeckDesignRules.ht
8080

8181
These principles should guide all development decisions, code reviews, and feature implementations.
8282

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+
8399
## 🔧 Essential Rules
84100

85101
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

Comments
 (0)