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: AGENTS.md
-52Lines changed: 0 additions & 52 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -107,55 +107,3 @@ Documentation lives in `doc/` and is built with Sphinx.
107
107
### Tone of voice
108
108
109
109
Write documentation that is helpful, supportive, and positive. Assume the reader is capable — guide them forward rather than warning them away. Prefer "you can" over "you must", favour concrete examples over abstract rules, and end explanations on what the user can now do rather than what might go wrong.
110
-
111
-
---
112
-
113
-
## CodeScene MCP
114
-
115
-
### Agent TL;DR
116
-
117
-
-**Code Health is authoritative.** Treat it as the single source of truth for maintainability.
118
-
-**Target Code Health 10.0.** This is the standard for AI-friendly code. 9+ is not "good enough."
119
-
-**Safeguard all AI-touched code** before suggesting a commit.
120
-
- If Code Health regresses or violates goals, **refactor — don't declare done.**
121
-
- Use Code Health to guide **incremental, high-impact refactorings.**
122
-
- When in doubt, **call the appropriate CodeScene MCP tool — don't guess.**
123
-
124
-
### Safeguard All AI-Generated or Modified Code (Mandatory)
125
-
126
-
Two tools enforce Code Health at different scopes:
127
-
128
-
-**`pre_commit_code_health_safeguard`** — uncommitted/staged files only. Run before each commit.
129
-
-**`analyze_change_set`** — full branch vs base ref (PR pre-flight). Run before opening a PR.
130
-
131
-
If either reports a regression:
132
-
133
-
1. Run `code_health_review` for details.
134
-
2. Refactor until Code Health is restored.
135
-
3. Do **not** mark changes as ready unless risks are explicitly accepted.
136
-
137
-
### Guide Refactoring with Code Health
138
-
139
-
When refactoring or improving code:
140
-
141
-
1. Inspect with `code_health_review`.
142
-
2. Identify complexity, size, coupling, or other code health issues.
143
-
3. Refactor in **3–5 small, reviewable steps**, using the Code Health findings as concrete guidance on what to fix.
0 commit comments