claude-dev-env 1.55.1 → 1.55.2

package/CLAUDE.md

@@ -41,6 +41,15 @@ Ask the subagent for a specific answer: "return the file:line where X is defined
 
 Reserve `Read`/`Grep`/`Glob` for files you will actually touch this turn. Compose subagent prompts via the protocol in `agent-spawn-protocol`.
 
+## Target Execution Workflow for Code Tasks
+
+Run every multi-step code task in two phases:
+
+1. **Coders** — one Sonnet agent per scoped assignment writes the code. A coder that hits a decision it can't reasonably solve consults the tool-less `fable-advisor` agent — which returns a plan, a correction, or a stop signal — and resumes. Source: Anthropic's advisor strategy (https://claude.com/blog/the-advisor-strategy).
+2. **Verification** — when the coders finish, the main session spawns the `fable-verifier` agent in a fresh context. It derives and runs the checks itself rather than trusting coder reports: the task's named gates, tests against baselines recorded before the coders ran, and a two-way diff-vs-assignment reading (every task item maps to a hunk, every hunk maps to a task item, nothing missing). A finding must cite a failing command or a named task item. Source: the fresh-context review step in Claude Code best practices (https://code.claude.com/docs/en/best-practices) — the agent doing the work isn't the one grading it.
+
+Repair agents run only on reported findings; the verifier re-checks after each repair. Work lands (commit, push, draft PR) only on a clean verdict — enforced by the `verified_commit_gate` hook, which blocks `git commit`/`git push` unless a hook-minted verdict covers the current branch diff. The one exemption is mechanical, not discretionary: a diff whose every changed file is non-code or has an unchanged Python AST once docstrings are stripped (docs, docstrings, comments).
+
 ## Additional Non-overlapping Rules
 
 - **task_scope:** Match every action to what was explicitly requested. When intent is ambiguous, research official docs and present options via AskUserQuestion before making any changes. Proceed with edits only on explicit instruction.

package/hooks/blocking/md_path_exemptions.py

@@ -21,12 +21,10 @@ from hooks_constants.md_to_html_blocker_constants import (  # noqa: E402
     ALL_EXEMPT_PLUGIN_DIRECTORY_SEGMENTS,
     ALL_EXEMPT_ROOT_FILENAMES_LOWER,
     CLAUDE_DEV_ENV_REPO_NAME_SEGMENT,
-    CLAUDE_DIRECTORY_PATH_PREFIX,
-    CLAUDE_DIRECTORY_SEGMENT_MARKER,
+    CLAUDE_DIRECTORY_NAME,
+    CLAUDE_PROFILE_DIRECTORY_NAME_PREFIX,
     MINIMUM_SEGMENT_COUNT_TO_MATCH_INDICATOR,
     PACKAGES_TOP_LEVEL_SEGMENT,
-    PLUGIN_DIRECTORY_PATH_PREFIX,
-    PLUGIN_DIRECTORY_SEGMENT_MARKER,
     PLUGIN_ROOT_MARKER_DIRECTORY_NAME,
     REPO_ROOT_MARKER_NAME,
     RESOLVED_HOME_DIRECTORY_LOWER,
@@ -38,7 +36,9 @@ def is_exempt_path(file_path: str) -> bool:
     """Return True when the .md file path is exempt from the blocker policy.
 
     Exemption sources, in order of evaluation:
-    - Any segment under `.claude/` or `.claude-plugin/` (case-insensitive)
+    - Any directory segment named `.claude` or prefixed `.claude-`
+      (case-insensitive): project infrastructure, profile directories like
+      `.claude-mel/`, and `.claude-plugin/`
     - Basename in `ALL_EXEMPT_ANYWHERE_FILENAMES` (e.g. SKILL.md)
     - Anchored under `packages/claude-dev-env/<one of
       ALL_CLAUDE_CODE_SOURCE_TOP_DIRECTORIES>/...` (docs, rules,
@@ -60,15 +60,7 @@ def is_exempt_path(file_path: str) -> bool:
     expanded_path = os.path.expanduser(file_path)
     normalized = os.path.normpath(expanded_path).replace("\\", "/")
     lower_normalized = normalized.lower()
-    if (
-        CLAUDE_DIRECTORY_SEGMENT_MARKER in lower_normalized
-        or lower_normalized.startswith(CLAUDE_DIRECTORY_PATH_PREFIX)
-    ):
-        return True
-    if (
-        PLUGIN_DIRECTORY_SEGMENT_MARKER in lower_normalized
-        or lower_normalized.startswith(PLUGIN_DIRECTORY_PATH_PREFIX)
-    ):
+    if _has_claude_infrastructure_segment(lower_normalized):
         return True
     basename_lower = os.path.basename(normalized).lower()
     if basename_lower in ALL_EXEMPT_ANYWHERE_FILENAMES_LOWER:
@@ -101,6 +93,33 @@ def _resolve_absolute_directory(normalized_path: str) -> str:
     return os.path.abspath(directory)
 
 
+def _has_claude_infrastructure_segment(lower_normalized_path: str) -> bool:
+    """A directory named `.claude` or prefixed `.claude-` (profile and
+    plugin directories) holds Claude infrastructure; any path inside one
+    is exempt.
+
+    Only directory segments are matched. The final segment is always the
+    file's basename (``normpath`` strips any trailing slash), so a file
+    merely named with the ``.claude-`` prefix in an ordinary directory
+    stays subject to the policy.
+
+    Args:
+        lower_normalized_path: Lowercased path with separators normalized
+            to forward slashes.
+
+    Returns:
+        True when any directory segment names a Claude infrastructure
+        directory.
+    """
+    all_directory_segments = lower_normalized_path.split("/")[:-1]
+    for each_segment in all_directory_segments:
+        if each_segment == CLAUDE_DIRECTORY_NAME:
+            return True
+        if each_segment.startswith(CLAUDE_PROFILE_DIRECTORY_NAME_PREFIX):
+            return True
+    return False
+
+
 def _has_plugin_directory_segment(lower_normalized_path: str) -> bool:
     for each_directory_segment in ALL_EXEMPT_PLUGIN_DIRECTORY_SEGMENTS:
         segment_marker = f"/{each_directory_segment}/"

package/hooks/blocking/md_to_html_blocker.py

@@ -25,6 +25,7 @@ from hooks_constants.md_to_html_blocker_constants import (  # noqa: E402
     ALL_EXEMPT_PLUGIN_DIRECTORY_SEGMENTS,
     CLAUDE_DEV_ENV_REPO_NAME_SEGMENT,
     CLAUDE_DIRECTORY_NAME,
+    CLAUDE_PROFILE_DIRECTORY_NAME_PREFIX,
     PACKAGES_TOP_LEVEL_SEGMENT,
     PLUGIN_ROOT_MARKER_DIRECTORY_NAME,
 )
@@ -63,7 +64,7 @@ def _block_context() -> str:
         "Reference for HTML effectiveness patterns:\n"
         f"{_html_effectiveness_url}\n"
         "Exceptions (.md still allowed):\n"
-        f"- Files inside {CLAUDE_DIRECTORY_NAME}/ or {PLUGIN_ROOT_MARKER_DIRECTORY_NAME}/ directories\n"
+        f"- Files inside {CLAUDE_DIRECTORY_NAME}/ or {CLAUDE_PROFILE_DIRECTORY_NAME_PREFIX}*/ directories\n"
         f"- {_exempt_anywhere_filenames_summary} anywhere\n"
         f"- Files under {_exempt_plugin_segments_summary} directories\n"
         f"- Files under {_claude_dev_env_source_directories_summary} source directories\n"
@@ -79,7 +80,7 @@ def _block_system_message() -> str:
         ".md files are blocked in this project — generate a self-contained .html "
         f"file instead. See {_html_effectiveness_url} for "
         f"design patterns and examples. Exemptions: {CLAUDE_DIRECTORY_NAME}/ and "
-        f"{PLUGIN_ROOT_MARKER_DIRECTORY_NAME}/ infrastructure, "
+        f"{CLAUDE_PROFILE_DIRECTORY_NAME_PREFIX}*/ infrastructure, "
         f"{_exempt_anywhere_filenames_summary} anywhere, {_exempt_plugin_segments_summary} trees, "
         f"{_claude_dev_env_source_directories_summary} source trees, "
         f"files under a {PLUGIN_ROOT_MARKER_DIRECTORY_NAME}/ root, "

package/hooks/blocking/test_md_to_html_blocker_exemptions.py

@@ -1,7 +1,8 @@
 """Tests for md_to_html_blocker directory and filename exemptions.
 
-Covers which directory trees (`.claude/`, `.claude-plugin/`, source subtrees
-under `packages/claude-dev-env/`, `agents/`, `skills/`, `commands/`) and which
+Covers which directory trees (`.claude/`, `.claude-*/` profile and plugin
+directories, source subtrees under `packages/claude-dev-env/`, `agents/`,
+`skills/`, `commands/`) and which
 root-level filenames (`README.md`, `CHANGELOG.md`, `CLAUDE.md`, `AGENTS.md`,
 `SKILL.md`) are exempt from the `.md` block, and the segment-anchored matching
 that prevents nested look-alike paths from bypassing the block.
@@ -366,3 +367,68 @@ def test_blocks_ordinary_docs_md_file():
     assert result.returncode == 0
     output = json.loads(result.stdout)
     assert output["hookSpecificOutput"]["permissionDecision"] == "deny"
+
+
+def test_passes_claude_profile_memory_directory():
+    """A Claude profile directory (`.claude-<name>/`, e.g. `.claude-mel/`)
+    carries the same infrastructure as `.claude/`; per-project memory files
+    under it accept .md writes."""
+    result = _run_hook(
+        "Write",
+        {
+            "file_path": (
+                "C:/Users/sample/.claude-mel/projects"
+                "/sample-project/memory/fact.md"
+            ),
+            "content": "# Fact",
+        },
+    )
+    assert result.returncode == 0
+    assert result.stdout == ""
+
+
+def test_passes_relative_claude_profile_directory():
+    result = _run_hook(
+        "Write",
+        {
+            "file_path": ".claude-mel/projects/sample/memory/fact.md",
+            "content": "# Fact",
+        },
+    )
+    assert result.returncode == 0
+    assert result.stdout == ""
+
+
+def test_passes_claude_profile_directory_case_insensitive():
+    result = _run_hook(
+        "Write",
+        {"file_path": "C:/Users/sample/.Claude-Mel/MEMORY.md", "content": "# Index"},
+    )
+    assert result.returncode == 0
+    assert result.stdout == ""
+
+
+def test_blocks_dot_directory_that_starts_with_claude_but_lacks_hyphen():
+    """`.claudette/` is not Claude infrastructure: only a directory named
+    exactly `.claude` or carrying the `.claude-` prefix is exempt."""
+    result = _run_hook(
+        "Write",
+        {"file_path": "notes/.claudette/intro.md", "content": "# Intro"},
+    )
+    assert result.returncode == 0
+    output = json.loads(result.stdout)
+    assert output["hookSpecificOutput"]["permissionDecision"] == "deny"
+
+
+def test_blocks_claude_prefixed_filename_in_plain_directory():
+    """A file merely named with the `.claude-` prefix (e.g.
+    `docs/.claude-notes.md`) is not Claude infrastructure: the exemption
+    matches directory segments only, so a `.claude-*.md` basename inside
+    an ordinary directory is blocked."""
+    result = _run_hook(
+        "Write",
+        {"file_path": "docs/.claude-notes.md", "content": "# Notes"},
+    )
+    assert result.returncode == 0
+    output = json.loads(result.stdout)
+    assert output["hookSpecificOutput"]["permissionDecision"] == "deny"

package/hooks/hooks_constants/md_to_html_blocker_constants.py

@@ -24,10 +24,7 @@ REPO_ROOT_MARKER_NAME: str = ".git"
 CLAUDE_DIRECTORY_NAME: str = ".claude"
 PLUGIN_ROOT_MARKER_DIRECTORY_NAME: str = ".claude-plugin"
 
-CLAUDE_DIRECTORY_SEGMENT_MARKER: str = f"/{CLAUDE_DIRECTORY_NAME}/"
-CLAUDE_DIRECTORY_PATH_PREFIX: str = f"{CLAUDE_DIRECTORY_NAME}/"
-PLUGIN_DIRECTORY_SEGMENT_MARKER: str = f"/{PLUGIN_ROOT_MARKER_DIRECTORY_NAME}/"
-PLUGIN_DIRECTORY_PATH_PREFIX: str = f"{PLUGIN_ROOT_MARKER_DIRECTORY_NAME}/"
+CLAUDE_PROFILE_DIRECTORY_NAME_PREFIX: str = f"{CLAUDE_DIRECTORY_NAME}-"
 
 ALL_EXEMPT_ANYWHERE_FILENAMES_LOWER: frozenset[str] = frozenset(
     each_filename.lower() for each_filename in ALL_EXEMPT_ANYWHERE_FILENAMES
@@ -68,12 +65,9 @@ __all__ = [
     "ALL_EXEMPT_ROOT_FILENAMES_LOWER",
     "CLAUDE_DEV_ENV_REPO_NAME_SEGMENT",
     "CLAUDE_DIRECTORY_NAME",
-    "CLAUDE_DIRECTORY_PATH_PREFIX",
-    "CLAUDE_DIRECTORY_SEGMENT_MARKER",
+    "CLAUDE_PROFILE_DIRECTORY_NAME_PREFIX",
     "MINIMUM_SEGMENT_COUNT_TO_MATCH_INDICATOR",
     "PACKAGES_TOP_LEVEL_SEGMENT",
-    "PLUGIN_DIRECTORY_PATH_PREFIX",
-    "PLUGIN_DIRECTORY_SEGMENT_MARKER",
     "PLUGIN_ROOT_MARKER_DIRECTORY_NAME",
     "REPO_ROOT_MARKER_NAME",
     "RESOLVED_HOME_DIRECTORY_LOWER",

package/hooks/hooks_constants/test_md_to_html_blocker_constants.py

@@ -115,3 +115,11 @@ def test_plugin_root_marker_directory_name_is_dot_claude_plugin() -> None:
     a plugin repo root and exempted."""
     assert constants_module.PLUGIN_ROOT_MARKER_DIRECTORY_NAME == ".claude-plugin"
     assert "PLUGIN_ROOT_MARKER_DIRECTORY_NAME" in constants_module.__all__
+
+
+def test_claude_profile_directory_name_prefix_is_dot_claude_hyphen() -> None:
+    """A directory whose name carries the `.claude-` prefix (profile
+    directories like `.claude-mel/`, plus `.claude-plugin/`) is Claude
+    infrastructure; any path inside one bypasses the .md block."""
+    assert constants_module.CLAUDE_PROFILE_DIRECTORY_NAME_PREFIX == ".claude-"
+    assert "CLAUDE_PROFILE_DIRECTORY_NAME_PREFIX" in constants_module.__all__

package/package.json

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