claude-dev-env 8.30.0 → 8.31.0

package/.agents/skills/windows-scheduled-task/SKILL.md

@@ -39,6 +39,7 @@ prove the task by the artifact it changes.
 - `LastTaskResult: 0` from a run that took the idle branch says nothing about the branch that acts.
 - A `#Requires -RunAsAdministrator` line pasted at a prompt checks nothing. It applies only to a script file.
 - An elevated window opens in `C:\WINDOWS\system32`. A prompt in the user's home folder is usually unelevated.
+- An Interactive task that starts `pwsh.exe -WindowStyle Hidden` still flashes a console window on the signed-in desktop. Windows draws the console before PowerShell reads the flag. `conhost.exe --headless` in front of the executable starts it with no window.
 
 ## When this applies
 
@@ -49,7 +50,7 @@ module. Register the task in an elevated shell when the task must run while the
 
 1. Resolve every executable in the action with `Get-Command <name>` and read `.Source`.
 2. Read `files[]` in `~/.claude/.claude-dev-env-manifest.json` and pick a directory that list omits.
-3. Build the action with the absolute executable path and `-WindowStyle Hidden` inside the argument string.
+3. Build the action with `conhost.exe --headless` as the executable, followed by the absolute path of the program it starts.
 4. Build a `-Once` trigger with a repetition interval and no duration, then clear the duration on the trigger object.
 5. Build the settings set.
 6. Register with an S4U principal, catch the registration failure, and register with an Interactive principal.
@@ -83,18 +84,21 @@ try {
 ```
 
 S4U runs the task with no window whether or not the user is signed in, and its registration needs an
-elevated shell. The Interactive principal with `-WindowStyle Hidden` in the action runs windowless
-while the user is signed in. Report `$PrincipalKind` so the operator knows which one the task holds.
+elevated shell. The Interactive principal runs the task on the signed-in desktop, so its action goes
+through `conhost.exe --headless` to stay windowless. Report `$PrincipalKind` so the operator knows
+which one the task holds.
 
 ## Absolute paths in the action
 
 ```powershell
+$ConhostPath = Join-Path -Path $env:SystemRoot -ChildPath 'System32\conhost.exe'
 $PwshPath = (Get-Command pwsh).Source
-$Action = New-ScheduledTaskAction -Execute $PwshPath -Argument "-NoProfile -WindowStyle Hidden -File ""$ScriptPath"""
+$Action = New-ScheduledTaskAction -Execute $ConhostPath -Argument "--headless ""$PwshPath"" -NoProfile -File ""$ScriptPath"""
 ```
 
 Resolve each executable at registration time and store the absolute path in the action. Give the
-script an absolute path too.
+script an absolute path too. The same `--headless` front works for any console program, such as
+`python.exe` or `cmd.exe`.
 
 ## Settings
 

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.0",
+    "version": "8.31.0",
     "description": "Claude Code development standards — rules, hooks, agents, commands, and skills",
     "type": "module",
     "bin": {

package/scripts/Install-SweepEmptyDirs.ps1

@@ -99,7 +99,8 @@ if (-not $?) {
 $Target = (Resolve-Path $Target).Path
 $Target = [System.IO.Path]::TrimEndingDirectorySeparator($Target)
 
-$Action = New-ScheduledTaskAction -Execute $PythonPath -Argument """$ScriptPath"" --once --age $AgeSeconds ""$Target"""
+$ConhostPath = Join-Path -Path $env:SystemRoot -ChildPath 'System32\conhost.exe'
+$Action = New-ScheduledTaskAction -Execute $ConhostPath -Argument "--headless ""$PythonPath"" ""$ScriptPath"" --once --age $AgeSeconds ""$Target"""
 $Trigger = New-ScheduledTaskTrigger -Once -At $StartAt -RepetitionInterval (New-TimeSpan -Minutes $IntervalMinutes) -RepetitionDuration (New-TimeSpan -Days 31)
 $Settings = New-ScheduledTaskSettingsSet -AllowStartIfOnBatteries -DontStopIfGoingOnBatteries -StartWhenAvailable
 

package/scripts/tests/test_install_sweep_empty_dirs.py

@@ -0,0 +1,42 @@
+"""Specifications for the scheduled task Install-SweepEmptyDirs.ps1 registers.
+
+A task that starts a console program straight from Task Scheduler draws a
+console window on the signed-in desktop at every run. The registered action
+starts the program through conhost.exe --headless so no window appears.
+"""
+
+from __future__ import annotations
+
+import re
+from pathlib import Path
+
+_INSTALLER_PATH = Path(__file__).resolve().parents[1] / "Install-SweepEmptyDirs.ps1"
+_UTF8_ENCODING = "utf-8"
+_ACTION_PATTERN = re.compile(
+    r"^\$Action = New-ScheduledTaskAction -Execute (\$\w+) -Argument (.+)$",
+    re.MULTILINE,
+)
+_CONHOST_ASSIGNMENT = (
+    "$ConhostPath = Join-Path -Path $env:SystemRoot -ChildPath 'System32\\conhost.exe'"
+)
+
+
+def _registered_action() -> tuple[str, str]:
+    installer_text = _INSTALLER_PATH.read_text(encoding=_UTF8_ENCODING)
+    all_actions = _ACTION_PATTERN.findall(installer_text)
+    assert len(all_actions) == 1, all_actions
+    return all_actions[0]
+
+
+def test_should_start_the_task_through_conhost() -> None:
+    installer_text = _INSTALLER_PATH.read_text(encoding=_UTF8_ENCODING)
+    executable_variable, _ = _registered_action()
+
+    assert executable_variable == "$ConhostPath"
+    assert _CONHOST_ASSIGNMENT in installer_text
+
+
+def test_should_pass_headless_before_the_python_program() -> None:
+    _, argument_text = _registered_action()
+
+    assert argument_text.startswith('"--headless ""$PythonPath"" ""$ScriptPath""')