claude-dev-env 8.30.1 → 8.31.1

package/AGENTS.md

@@ -10,6 +10,10 @@ Verdicts
 
 One line. Read files first. Quote file:line. Code beats brief. No flip-flops.
 
+Evidence
+
+Act and state only on what you or your workers saw, ran, or tested. Unsure → run the check first. Can't run the check → say "I don't know" and name the check that would settle it.
+
 Writes
 
 Write/Edit only. LF. After: git diff --check, file <path>. ASCII unless the file already isn't.

package/hooks/hooks_constants/working_style_prompt_constants.py

@@ -16,10 +16,15 @@ WORKING_STYLE_PROMPT = (
     "Keep disclaimers and caveats short while giving "
     "the main answer most of the response. Give a high-level explanation by default "
     "and provide depth when the request calls for it. "
-    "Before your first tool call, state your next action in one sentence. While "
-    "working, give brief updates when you find important information or change "
-    "direction. Finish with the outcome in the first sentence, then provide "
-    "supporting detail for readers who want it. "
+    "On a typed request, state your next action in one sentence before the first "
+    "tool call. "
+    "Finish with the outcome in the first sentence. "
+    "Send the user only what they must act on or need to know. When a background "
+    "event, such as a task notification, an agent message, or a scheduled wake, "
+    "starts a turn and nothing in it needs the user, end the turn with no text. A "
+    "report that a fix is done carries three lines: the fix acknowledged, what "
+    "changed, and the proof that it works. Put the rest of the detail in the pull "
+    "request or a linked file. "
     "Match written-document length to the task. Cover the substance and keep every "
     "section, summary, and phrase useful. "
     "Deliver the requested work at its intended scope. Make routine judgment calls "
@@ -34,7 +39,7 @@ WORKING_STYLE_PROMPT = (
     "when the ambiguity changes the outcome, scope, audience, format, or risk. Use a "
     "clearly stated low-risk assumption when the intended result remains stable. "
     "Pause for the user's choice before making a high-impact decision. "
-    "Use current, immediately relevant context. Name each action, fact, reason, "
-    "and outcome. Use full terms and specific names for repository work. Keep all "
+    "Use current, immediately relevant context. "
+    "Use full terms and specific names for repository work. Keep all "
     "text concise, clear, direct, and useful."
 )

package/hooks/session/test_working_style_prompt.py

@@ -50,11 +50,26 @@ class TestWorkingStylePrompt:
         assert "update-in-place continuity, and sharing" in prompt_text
         assert "Apply ~/.claude/rules/asd-ste100-language.md for user-facing word choice" in prompt_text
         assert "Use current, immediately relevant context." in prompt_text
-        assert "Name each action, fact, reason, and outcome." in prompt_text
         assert "Use full terms and specific names for repository work." in prompt_text
         assert "When a request has multiple reasonable interpretations" in prompt_text
         assert "Ask one focused clarification question" in prompt_text
         assert "Pause for the user's choice before making a high-impact decision." in prompt_text
 
+    def test_prompt_limits_replies_to_what_the_user_must_act_on_or_know(self) -> None:
+        assert "Send the user only what they must act on or need to know." in WORKING_STYLE_PROMPT
+        assert "starts a turn and nothing in it needs the user, end the turn with no text." in WORKING_STYLE_PROMPT
+        assert "On a typed request, state your next action in one sentence" in WORKING_STYLE_PROMPT
+        assert "Before your first tool call, state your next action" not in WORKING_STYLE_PROMPT
+        assert (
+            "A report that a fix is done carries three lines: the fix acknowledged, "
+            "what changed, and the proof that it works."
+        ) in WORKING_STYLE_PROMPT
+        assert "Put the rest of the detail in the pull request or a linked file." in WORKING_STYLE_PROMPT
+
+    def test_prompt_drops_the_clauses_that_invite_surplus_detail(self) -> None:
+        assert "supporting detail for readers who want it" not in WORKING_STYLE_PROMPT
+        assert "give brief updates when you find important information" not in WORKING_STYLE_PROMPT
+        assert "Name each action, fact, reason, and outcome." not in WORKING_STYLE_PROMPT
+
     def test_build_session_directive_returns_the_shared_constant(self) -> None:
         assert starter.build_session_directive() == WORKING_STYLE_PROMPT

package/hooks/session/working_style_prompt.py

@@ -4,8 +4,9 @@
 At session start this hook emits an ``additionalContext`` block carrying a fixed
 working-style prompt: use ELI5 for the beginner presentation envelope, follow
 ``~/.claude/rules/asd-ste100-language.md`` for sentence prose, keep a running
-ledger, narrate before the first tool call, lead with the outcome, and stay at
-the asked scope.
+ledger, narrate before the first tool call on a typed request, lead with the
+outcome, send only what the user must act on or know, stay silent on a
+background-event turn that needs nothing, and stay at the asked scope.
 The hook writes nothing and runs no tools itself.
 """
 

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "claude-dev-env",
-    "version": "8.30.1",
+    "version": "8.31.1",
     "description": "Claude Code development standards — rules, hooks, agents, commands, and skills",
     "type": "module",
     "bin": {