ai(rules[AGENTS]) Require Attributes on classes with fields

why: autodoc renders every NamedTuple and dataclass field regardless of
whether it is described, so an undocumented field reaches the API docs
as "Alias for field number 0" or as a bare entry. Fourteen such stubs
are live on the published site today, and nothing in the gates catches
them.

what:
- Require an Attributes section covering every field, with an example
- Note that partial coverage still ships stubs for the rest

Author: tony

AGENTS.md

@@ -217,6 +217,27 @@ type
 """
 ```
 
+**Classes with fields** — `NamedTuple`, dataclasses — document every field in
+an `Attributes` section:
+
+```python
+class VCSLocation(t.NamedTuple):
+    """Generic VCS Location (URL and optional revision).
+
+    Attributes
+    ----------
+    url : str
+        Repository URL, with any revision suffix stripped.
+    rev : str | None
+        Revision to check out, or ``None`` when unspecified.
+    """
+```
+
+Autodoc renders every field whether or not you describe it, so an
+undocumented `NamedTuple` field ships to the API docs as "Alias for field
+number 0" and a dataclass field ships bare. Document all of them — a class
+with three fields and two documented still ships a stub for the third.
+
 ### Doctests
 
 **All functions and methods MUST have working doctests.** Doctests serve as both documentation and tests.