claude-dev-env 8.44.0 → 8.44.1

package/package.json

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

package/rules/bdd.md

@@ -9,6 +9,8 @@ paths:
 
 # BDD (discovery-driven development)
 
+**When:** Starting a non-trivial feature.
+
 For every non-trivial feature, discover what you do not know, illustrate it with concrete examples in chat, formulate each behavior as a narrow "should ..." specification, then build each one through the TDD loop (CODE_RULES §8). Name developer-facing specs and tests as should sentences.
 
 **Full text:** [`docs/rule-guides/bdd.md`](../docs/rule-guides/bdd.md), with the long-form BDD references.

package/rules/code-standards.md

@@ -10,6 +10,8 @@ paths:
 
 # Code Standards
 
+**When:** Writing, reviewing, or generating code.
+
 [`CODE_RULES.md`](../docs/CODE_RULES.md) is the review contract for code quality. Load it when you review a pull request, resolve a policy conflict, or generate code. Red, green, refactor is the default loop (CODE_RULES §8). Keep engineering right-sized (CODE_RULES §7).
 
 **Enforcement:** the staged policy lint runs `hooks/blocking/code_rules_enforcer.py` over each changed file, and CI runs it against the merge base.

package/rules/doc-inventory-integrity.md

@@ -11,6 +11,8 @@ paths:
 
 # Documentation Inventory Integrity
 
+**When:** Changing code that a document inventories.
+
 A doc that inventories code stays in step with the code, in the same change:
 
 1. Every bare filename a per-directory `CLAUDE.md` names in a table cell or a fenced run command exists in its subtree.

package/rules/windows-filesystem-safe.md

@@ -8,6 +8,8 @@ paths:
 
 # Windows Filesystem Safety
 
+**When:** Removing a directory tree or creating a directory in Python or Node.
+
 Call `shutil.rmtree` with an `onexc` (Python 3.12 and later) or `onerror` handler that runs `os.chmod(target_path, stat.S_IWRITE)` and retries. `ignore_errors=True` leaves read-only trees on disk. In Node, call `mkdirSync(targetPath, { recursive: true })` on a path that may exist. Import the shared `force_rmtree` handler trio from its one shared Windows-filesystem module.
 
 **Enforcement:** the staged policy lint's `rmtree-safety` rule, which returns the full `force_rmtree` code. CI runs it against the merge base.

package/scripts/tests/test_rule_index_shape.py

@@ -22,6 +22,7 @@ FULL_TEXT_LINK_PATTERN = re.compile(
     r"^\*\*Full text:\*\*.*?\]\((\.\./docs/rule-guides/[^)#\s]+\.md)\)", re.MULTILINE
 )
 TITLE_PATTERN = re.compile(r"^# \S", re.MULTILINE)
+WHEN_LINE_PATTERN = re.compile(r"^\*\*When(?: this applies)?:\*\* \S", re.MULTILINE)
 
 MAXIMUM_ENTRY_BYTES = 1_500
 MAXIMUM_ALWAYS_ON_BYTES = 12_000
@@ -88,6 +89,16 @@ def test_each_entry_opens_with_a_title_after_its_frontmatter() -> None:
     assert untitled == []
 
 
+def test_each_entry_states_when_it_applies() -> None:
+    without_when_line = [
+        each_path.name
+        for each_path in _entry_paths()
+        if each_path.name not in POINTER_ENTRY_NAMES | CODEX_VERBATIM_ENTRY_NAMES
+        and not WHEN_LINE_PATTERN.search(_entry_text(each_path))
+    ]
+    assert without_when_line == []
+
+
 def _full_text_link_problems(entry_path: Path) -> list[str]:
     all_guide_names = _linked_guide_names(_entry_text(entry_path))
     if not all_guide_names: