From fd2f0d3d09d035b59e3ac1b5d2fba099b98e5e11 Mon Sep 17 00:00:00 2001 From: Richard Levasseur Date: Mon, 10 Aug 2026 05:38:27 +0000 Subject: [PATCH] agents(rules): document git push -u guardrail and delegating function docstrings Using `git push -u` or `--set-upstream` disrupts triangle branch tracking by repointing the local tracking branch away from upstream. Additionally, delegating helper functions need consistent docstring references to their underlying implementations. Update workspace and Python agent rules to prohibit setting upstream on push and establish a docstring reference convention for delegating functions. --- .agents/rules/python.md | 5 +++++ .agents/rules/workspace.md | 2 ++ 2 files changed, 7 insertions(+) diff --git a/.agents/rules/python.md b/.agents/rules/python.md index 200295e650..d683152814 100644 --- a/.agents/rules/python.md +++ b/.agents/rules/python.md @@ -13,3 +13,8 @@ * **External Objects**: When defining a `TypedDict` for an external object, link to its definition in the docstring. +## Delegating Functions +* Module-level functions delegating to class methods should have a docstring + referring to the class method (e.g. `"""Refer to \`Class.method\`."""`). + + diff --git a/.agents/rules/workspace.md b/.agents/rules/workspace.md index b819925f83..bc64d4779c 100644 --- a/.agents/rules/workspace.md +++ b/.agents/rules/workspace.md @@ -16,3 +16,5 @@ basis: ```bash .agents/scripts/setup_triangle_branch.sh ``` +* Never use `git push -u` or `--set-upstream` (it breaks upstream tracking). +