claude-dev-env 8.64.0 → 8.65.1

package/hooks/session/test_working_style_prompt.py

@@ -15,9 +15,12 @@ for each_sys_path_entry in (str(_SESSION_DIR), str(_HOOKS_ROOT)):
 import working_style_prompt as starter
 
 from hooks_constants.working_style_prompt_constants import (
+    WORKING_STYLE_GUIDE_RELATIVE_PATH,
     WORKING_STYLE_PROMPT,
 )
 
+WORKING_STYLE_GUIDE_PATH = _HOOKS_ROOT.parent / WORKING_STYLE_GUIDE_RELATIVE_PATH
+
 
 def _run_main() -> str:
     """Return stdout produced by running the hook's main()."""
@@ -38,38 +41,22 @@ class TestWorkingStylePrompt:
         emitted = json.loads(_run_main())
         assert emitted["hookSpecificOutput"]["additionalContext"] == WORKING_STYLE_PROMPT
 
-    def test_emitted_prompt_contains_canonical_policy_and_scope_guidance(self) -> None:
-        emitted = json.loads(_run_main())
-        prompt_text = emitted["hookSpecificOutput"]["additionalContext"]
-        assert "Document each task in a location that remains easy to find later." in prompt_text
-        assert "Deliver the requested work at its intended scope." in prompt_text
-        assert "A request to remove something is complete once it is gone." in prompt_text
-        assert "pass a replacement idea to the requester as a question." in prompt_text
-        assert "Use ELI5 for beginner framing, large visuals, minimal text" in prompt_text
-        assert "one stable self-contained HTML artifact" in prompt_text
-        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 "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_prompt_points_at_the_working_style_guide(self) -> None:
+        assert f"~/.claude/{WORKING_STYLE_GUIDE_RELATIVE_PATH}" in WORKING_STYLE_PROMPT
+        assert WORKING_STYLE_GUIDE_PATH.is_file()
+
+    def test_prompt_stays_a_short_pointer(self) -> None:
+        assert len(WORKING_STYLE_PROMPT) < len(WORKING_STYLE_GUIDE_PATH.read_text(encoding="utf-8")) // 10
+
+    def test_guide_carries_the_policy_and_scope_guidance(self) -> None:
+        guide_text = WORKING_STYLE_GUIDE_PATH.read_text(encoding="utf-8")
+        assert "Document each task in a location that remains easy to find later." in guide_text
+        assert "Deliver the requested work at its intended scope." in guide_text
+        assert "A request to remove something is complete once it is gone." in guide_text
+        assert "Send the user only what they must act on or need to know." in guide_text
+        assert "starts a turn and nothing in it needs the user, end the turn with no text." in guide_text
+        assert "On a typed request, state your next action in one sentence" in guide_text
+        assert "Pause for the user's choice before making a high-impact decision." in guide_text
 
     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

@@ -1,12 +1,9 @@
 #!/usr/bin/env python3
 """SessionStart hook — inject working-style guidance into the session.
 
-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 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.
+At session start this hook emits an ``additionalContext`` line that points the
+session at ``docs/references/working-style.md``, the guide for task records,
+presentation, replies, scope, and questions.
 The hook writes nothing and runs no tools itself.
 """
 

package/package.json

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

package/scripts/tests/test_rule_load_scopes.py

@@ -8,8 +8,6 @@ SKILLS_DIRECTORY = PACKAGE_ROOT / ".agents" / "skills"
 
 ALWAYS_ON_RULE_NAMES = frozenset(
     {
-        "AGENTS.md",
-        "CLAUDE.md",
         "asd-ste100-language.md",
         "cleanup-temp-files.md",
         "correction-lens.md",

package/settings.json

@@ -2,7 +2,8 @@
   "agent": "dev-env-session",
   "permissions": {
     "allow": [
-      "WebFetch(domain:docs.github.com)"
+      "WebFetch(domain:docs.github.com)",
+      "Read(~/.claude/docs/**)"
     ]
   },
   "advisorModel": "fable",

package/.agents/skills/.claude/CLAUDE.md

@@ -1 +0,0 @@
-@../AGENTS.md

package/.agents/skills/AGENTS.md

@@ -1 +0,0 @@
-

package/.agents/skills/_shared/.claude/CLAUDE.md

@@ -1 +0,0 @@
-@../AGENTS.md

package/.agents/skills/_shared/AGENTS.md

@@ -1 +0,0 @@
-

package/.agents/skills/_shared/advisor/.claude/CLAUDE.md

@@ -1 +0,0 @@
-@../AGENTS.md

package/.agents/skills/_shared/advisor/AGENTS.md

@@ -1 +0,0 @@
-

package/.agents/skills/everything-search/.claude/CLAUDE.md

@@ -1 +0,0 @@
-@../AGENTS.md

package/.agents/skills/everything-search/AGENTS.md

@@ -1 +0,0 @@
-

package/.agents/skills/fresh-branch/.claude/CLAUDE.md

@@ -1 +0,0 @@
-@../AGENTS.md

package/.agents/skills/fresh-branch/AGENTS.md

@@ -1 +0,0 @@
-

package/.agents/skills/grok-spawn/.claude/CLAUDE.md

@@ -1 +0,0 @@
-@../AGENTS.md

package/.agents/skills/grok-spawn/AGENTS.md

@@ -1 +0,0 @@
-

package/.agents/skills/orchestrator/.claude/CLAUDE.md

@@ -1 +0,0 @@
-@../AGENTS.md

package/.agents/skills/orchestrator/AGENTS.md

@@ -1 +0,0 @@
-

package/.agents/skills/orchestrator/reference/.claude/CLAUDE.md

@@ -1 +0,0 @@
-@../AGENTS.md

package/.agents/skills/orchestrator/reference/AGENTS.md

@@ -1 +0,0 @@
-

package/.agents/skills/second-account-workers/.claude/CLAUDE.md

@@ -1 +0,0 @@
-@../AGENTS.md

package/.agents/skills/second-account-workers/AGENTS.md

@@ -1 +0,0 @@
-

package/.agents/skills/skill-builder/.claude/CLAUDE.md

@@ -1 +0,0 @@
-@../AGENTS.md

package/.agents/skills/skill-builder/AGENTS.md

@@ -1 +0,0 @@
-

package/.agents/skills/task-build/.claude/CLAUDE.md

@@ -1 +0,0 @@
-@../AGENTS.md

package/.agents/skills/task-build/AGENTS.md

@@ -1 +0,0 @@
-

package/.agents/skills-archived/AGENTS.md

@@ -1 +0,0 @@
-

package/.agents/skills-archived/anthropic-plan/.claude/CLAUDE.md

@@ -1 +0,0 @@
-@../AGENTS.md

package/.agents/skills-archived/anthropic-plan/AGENTS.md

@@ -1 +0,0 @@
-

package/.agents/skills-archived/anthropic-plan/scripts/.claude/CLAUDE.md

@@ -1 +0,0 @@
-@../AGENTS.md

package/.agents/skills-archived/anthropic-plan/scripts/AGENTS.md

@@ -1 +0,0 @@
-

package/.agents/skills-archived/anthropic-plan/scripts/anthropic_plan_scripts_constants/.claude/CLAUDE.md

@@ -1 +0,0 @@
-@../AGENTS.md

package/.agents/skills-archived/anthropic-plan/scripts/anthropic_plan_scripts_constants/AGENTS.md

@@ -1 +0,0 @@
-

package/.agents/skills-archived/anthropic-plan/templates/.claude/CLAUDE.md

@@ -1 +0,0 @@
-@../AGENTS.md

package/.agents/skills-archived/anthropic-plan/templates/AGENTS.md

@@ -1 +0,0 @@
-

package/.agents/skills-archived/anthropic-plan/workflow/.claude/CLAUDE.md

@@ -1 +0,0 @@
-@../AGENTS.md

package/.agents/skills-archived/anthropic-plan/workflow/AGENTS.md

@@ -1 +0,0 @@
-

package/.agents/skills-archived/auditing-claude-config/.claude/CLAUDE.md

@@ -1 +0,0 @@
-@../AGENTS.md

package/.agents/skills-archived/auditing-claude-config/AGENTS.md

@@ -1 +0,0 @@
-

package/.agents/skills-archived/bugteam/.claude/CLAUDE.md

@@ -1 +0,0 @@
-@../AGENTS.md

package/.agents/skills-archived/bugteam/AGENTS.md

@@ -1 +0,0 @@
-

package/.agents/skills-archived/bugteam/reference/.claude/CLAUDE.md

@@ -1 +0,0 @@
-@../AGENTS.md

package/.agents/skills-archived/bugteam/reference/AGENTS.md

@@ -1 +0,0 @@
-

package/.agents/skills-archived/bugteam/reference/obstacles/.claude/CLAUDE.md

@@ -1 +0,0 @@
-@../AGENTS.md

package/.agents/skills-archived/bugteam/reference/obstacles/AGENTS.md

@@ -1 +0,0 @@
-

package/.agents/skills-archived/bugteam/scripts/.claude/CLAUDE.md

@@ -1 +0,0 @@
-@../AGENTS.md

package/.agents/skills-archived/bugteam/scripts/AGENTS.md

@@ -1 +0,0 @@
-

package/.agents/skills-archived/bugteam/scripts/bugteam_scripts_constants/.claude/CLAUDE.md

@@ -1 +0,0 @@
-@../AGENTS.md

package/.agents/skills-archived/bugteam/scripts/bugteam_scripts_constants/AGENTS.md

@@ -1 +0,0 @@
-

package/.agents/skills-archived/codex-review/.claude/CLAUDE.md

@@ -1 +0,0 @@
-@../AGENTS.md

package/.agents/skills-archived/codex-review/AGENTS.md

@@ -1 +0,0 @@
-

package/.agents/skills-archived/codex-review/reference/.claude/CLAUDE.md

@@ -1 +0,0 @@
-@../AGENTS.md

package/.agents/skills-archived/codex-review/reference/AGENTS.md

@@ -1 +0,0 @@
-

package/.agents/skills-archived/codex-review/scripts/codex_review_scripts_constants/.claude/CLAUDE.md

@@ -1 +0,0 @@
-@../AGENTS.md

package/.agents/skills-archived/codex-review/scripts/codex_review_scripts_constants/AGENTS.md

@@ -1 +0,0 @@
-

package/.agents/skills-archived/copilot-review/.claude/CLAUDE.md

@@ -1 +0,0 @@
-@../AGENTS.md

package/.agents/skills-archived/copilot-review/AGENTS.md

@@ -1 +0,0 @@
-

package/.agents/skills-archived/pr-converge/.claude/CLAUDE.md

@@ -1 +0,0 @@
-@../AGENTS.md

package/.agents/skills-archived/pr-converge/AGENTS.md

@@ -1 +0,0 @@
-

package/.agents/skills-archived/pr-converge/pr_converge_skill_constants/.claude/CLAUDE.md

@@ -1 +0,0 @@
-@../AGENTS.md

package/.agents/skills-archived/pr-converge/pr_converge_skill_constants/AGENTS.md

@@ -1 +0,0 @@
-

package/.agents/skills-archived/pr-converge/reference/.claude/CLAUDE.md

@@ -1 +0,0 @@
-@../AGENTS.md

package/.agents/skills-archived/pr-converge/reference/AGENTS.md

@@ -1 +0,0 @@
-

package/.agents/skills-archived/pr-converge/reference/obstacles/.claude/CLAUDE.md

@@ -1 +0,0 @@
-@../AGENTS.md

package/.agents/skills-archived/pr-converge/reference/obstacles/AGENTS.md

@@ -1 +0,0 @@
-

package/.agents/skills-archived/pr-converge/scripts/.claude/CLAUDE.md

@@ -1 +0,0 @@
-@../AGENTS.md

package/.agents/skills-archived/pr-converge/scripts/AGENTS.md

@@ -1 +0,0 @@
-

package/.agents/skills-archived/pr-converge/scripts/pr_converge_scripts_constants/.claude/CLAUDE.md

@@ -1 +0,0 @@
-@../AGENTS.md

package/.agents/skills-archived/pr-converge/scripts/pr_converge_scripts_constants/AGENTS.md

@@ -1 +0,0 @@
-

package/.agents/skills-archived/pr-converge/workflows/.claude/CLAUDE.md

@@ -1 +0,0 @@
-@../AGENTS.md

package/.agents/skills-archived/pr-converge/workflows/AGENTS.md

@@ -1 +0,0 @@
-

package/.agents/skills-archived/recall/.claude/CLAUDE.md

@@ -1 +0,0 @@
-@../AGENTS.md

package/.agents/skills-archived/recall/AGENTS.md

@@ -1 +0,0 @@
-

package/.agents/skills-archived/remember/.claude/CLAUDE.md

@@ -1 +0,0 @@
-@../AGENTS.md

package/.agents/skills-archived/remember/AGENTS.md

@@ -1 +0,0 @@
-

package/_shared/AGENTS.md

@@ -1 +0,0 @@
-

package/_shared/CLAUDE.md

@@ -1 +0,0 @@
-@AGENTS.md

package/_shared/advisor/AGENTS.md

@@ -1 +0,0 @@
-

package/_shared/advisor/CLAUDE.md

@@ -1 +0,0 @@
-@AGENTS.md

package/_shared/pr-loop/scripts/AGENTS.md

@@ -1 +0,0 @@
-

package/_shared/pr-loop/scripts/CLAUDE.md

@@ -1 +0,0 @@
-@AGENTS.md

package/_shared/pr-loop/scripts/code_rules_gate_parts/AGENTS.md

@@ -1 +0,0 @@
-

package/_shared/pr-loop/scripts/code_rules_gate_parts/CLAUDE.md

@@ -1 +0,0 @@
-@AGENTS.md

package/_shared/pr-loop/scripts/codex_review_scripts_constants/.claude/CLAUDE.md

@@ -1 +0,0 @@
-@../AGENTS.md

package/_shared/pr-loop/scripts/codex_review_scripts_constants/AGENTS.md

@@ -1 +0,0 @@
-

package/_shared/pr-loop/scripts/pr_converge_scripts_constants/.claude/CLAUDE.md

@@ -1 +0,0 @@
-@../AGENTS.md

package/_shared/pr-loop/scripts/pr_converge_scripts_constants/AGENTS.md

@@ -1 +0,0 @@
-

package/_shared/pr-loop/scripts/pr_converge_skill_constants/.claude/CLAUDE.md

@@ -1 +0,0 @@
-@../AGENTS.md

package/_shared/pr-loop/scripts/pr_converge_skill_constants/AGENTS.md

@@ -1 +0,0 @@
-

package/_shared/pr-loop/scripts/pr_loop_shared_constants/AGENTS.md

@@ -1 +0,0 @@
-

package/_shared/pr-loop/scripts/pr_loop_shared_constants/CLAUDE.md

@@ -1 +0,0 @@
-@AGENTS.md

package/_shared/pr-loop/scripts/tests/AGENTS.md

@@ -1 +0,0 @@
-

package/_shared/pr-loop/scripts/tests/CLAUDE.md

@@ -1 +0,0 @@
-@AGENTS.md

package/_shared/process-tree/AGENTS.md

@@ -1 +0,0 @@
-

package/_shared/process-tree/CLAUDE.md

@@ -1 +0,0 @@
-@AGENTS.md

package/audit-rubrics/AGENTS.md

@@ -1 +0,0 @@
-

package/audit-rubrics/CLAUDE.md

@@ -1 +0,0 @@
-@AGENTS.md

package/audit-rubrics/category_rubrics/AGENTS.md

@@ -1 +0,0 @@
-

package/audit-rubrics/category_rubrics/CLAUDE.md

@@ -1 +0,0 @@
-@AGENTS.md

package/audit-rubrics/prompts/AGENTS.md

@@ -1 +0,0 @@
-

package/audit-rubrics/prompts/CLAUDE.md

@@ -1 +0,0 @@
-@AGENTS.md

package/bin/AGENTS.md

@@ -1 +0,0 @@
-

package/bin/CLAUDE.md

@@ -1 +0,0 @@
-@AGENTS.md

package/commands/AGENTS.md

@@ -1 +0,0 @@
-

package/commands/CLAUDE.md

@@ -1 +0,0 @@
-@AGENTS.md

package/docs/AGENTS.md

@@ -1 +0,0 @@
-

package/docs/CLAUDE.md

@@ -1 +0,0 @@
-@AGENTS.md

package/docs/references/AGENTS.md

@@ -1 +0,0 @@
-

package/docs/references/CLAUDE.md

@@ -1 +0,0 @@
-@AGENTS.md

package/hooks/advisory/AGENTS.md

@@ -1 +0,0 @@
-

package/hooks/advisory/CLAUDE.md

@@ -1 +0,0 @@
-@AGENTS.md

package/hooks/blocking/AGENTS.md

@@ -1 +0,0 @@
-

package/hooks/blocking/CLAUDE.md

@@ -1 +0,0 @@
-@AGENTS.md

package/hooks/blocking/claude_md_orphan_file_blocker_parts/AGENTS.md

@@ -1 +0,0 @@
-

package/hooks/blocking/claude_md_orphan_file_blocker_parts/CLAUDE.md

@@ -1 +0,0 @@
-@AGENTS.md

package/hooks/blocking/config/AGENTS.md

@@ -1 +0,0 @@
-

package/hooks/blocking/config/CLAUDE.md

@@ -1 +0,0 @@
-@AGENTS.md

package/hooks/blocking/inventory_intent_records/AGENTS.md

@@ -1 +0,0 @@
-

package/hooks/blocking/inventory_intent_records/CLAUDE.md

@@ -1 +0,0 @@
-@AGENTS.md

package/hooks/blocking/package_inventory_stale_blocker_parts/AGENTS.md

@@ -1 +0,0 @@
-

package/hooks/blocking/package_inventory_stale_blocker_parts/CLAUDE.md

@@ -1 +0,0 @@
-@AGENTS.md

package/hooks/blocking/pii_prevention_blocker_parts/AGENTS.md

@@ -1 +0,0 @@
-

package/hooks/blocking/pii_prevention_blocker_parts/CLAUDE.md

@@ -1 +0,0 @@
-@AGENTS.md

package/hooks/blocking/tdd_enforcer_parts/AGENTS.md

@@ -1 +0,0 @@
-

package/hooks/blocking/tdd_enforcer_parts/CLAUDE.md

@@ -1 +0,0 @@
-@AGENTS.md

package/hooks/git-hooks/AGENTS.md

@@ -1 +0,0 @@
-

package/hooks/git-hooks/CLAUDE.md

@@ -1 +0,0 @@
-@AGENTS.md

package/hooks/git-hooks/git_hooks_constants/AGENTS.md

@@ -1 +0,0 @@
-

package/hooks/git-hooks/git_hooks_constants/CLAUDE.md

@@ -1 +0,0 @@
-@AGENTS.md

package/hooks/hooks_constants/AGENTS.md

@@ -1 +0,0 @@
-

package/hooks/hooks_constants/CLAUDE.md

@@ -1 +0,0 @@
-@AGENTS.md

package/hooks/lifecycle/AGENTS.md

@@ -1 +0,0 @@
-

package/hooks/lifecycle/CLAUDE.md

@@ -1 +0,0 @@
-@AGENTS.md

package/hooks/observability/AGENTS.md

@@ -1 +0,0 @@
-

package/hooks/observability/CLAUDE.md

@@ -1 +0,0 @@
-@AGENTS.md

package/hooks/session/AGENTS.md

@@ -1 +0,0 @@
-

package/hooks/session/CLAUDE.md

@@ -1 +0,0 @@
-@AGENTS.md

package/hooks/validation/AGENTS.md

@@ -1 +0,0 @@
-

package/hooks/validation/CLAUDE.md

@@ -1 +0,0 @@
-@AGENTS.md

package/hooks/validators/AGENTS.md

@@ -1 +0,0 @@
-

package/hooks/validators/CLAUDE.md

@@ -1 +0,0 @@
-@AGENTS.md

package/hooks/workflow/AGENTS.md

@@ -1 +0,0 @@
-

package/hooks/workflow/CLAUDE.md

@@ -1 +0,0 @@
-@AGENTS.md

package/rules/AGENTS.md

@@ -1 +0,0 @@
-