claude-dev-env 2.15.1 → 2.16.0

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

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

package/{agents → .agents/agents}/AGENTS.md

@@ -1,6 +1,6 @@
 # agents
 
-Agent definition files installed into `~/.claude/agents/` by `bin/install.mjs`. Each `.md` file defines a named subagent: its description (shown in the Claude Code UI), allowed tools, and behavioral instructions.
+Agent definition files installed into `~/.agents/agents/` by `bin/install.mjs`. `~/.claude/agents` is a directory pointer to that folder. Each `.md` file defines a named subagent: its description (shown in the Claude Code UI), allowed tools, and behavioral instructions.
 
 ## Agent files
 
@@ -22,5 +22,5 @@ Each file uses YAML frontmatter (`name`, `description`, `tools`, optional `color
 ## Adding an agent
 
 1. Create a new `.md` file in this directory with valid frontmatter.
-2. Run `bin/install.mjs` to copy it to `~/.claude/agents/`.
+2. Run `bin/install.mjs` to copy it to `~/.agents/agents/`.
 3. Restart Claude Code to pick up the new agent.

package/{agents → .agents/agents}/test_agent_frontmatter.py

@@ -83,7 +83,7 @@ INSTRUCTION_ALIAS_FILENAMES = frozenset({"AGENTS.md", "CLAUDE.md"})
 FRONTMATTER_FENCE_LINE = "---"
 MATERIALIZER_MODULE_NAME = "codex_compat_materializer"
 MATERIALIZER_MODULE_PATH = (
-    Path(__file__).resolve().parent.parent / "scripts" / f"{MATERIALIZER_MODULE_NAME}.py"
+    Path(__file__).resolve().parent.parent.parent / "scripts" / f"{MATERIALIZER_MODULE_NAME}.py"
 )
 MODEL_KEY_NAME = "model"
 RENAMED_AGENT_NAME = "an-agent-name-no-file-carries"

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

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

package/{skills → .agents/skills}/AGENTS.md

@@ -13,13 +13,13 @@ Each skill is a self-contained folder Claude Code loads on demand. At startup, o
 | `reference/` | Reference docs the skill cites or the workflow reads. |
 | `*_constants/` | Python package of named constants imported by `scripts/`. |
 
-Skills install to `~/.claude/skills/<skill-name>/` via `packages/claude-dev-env/bin/install.mjs`. See `docs/references/skill-install-system.md` for the install pipeline.
+Skills install to `~/.agents/skills/<skill-name>/` via `packages/claude-dev-env/bin/install.mjs`. Claude Code looks them up at `~/.claude/skills/<skill-name>/`, a directory pointer to that folder. See `docs/references/skill-install-system.md` for the install pipeline.
 
 ## Shared support code
 
 **`skills/_shared/`** — skill-local PR-loop helpers plus `@` stubs that name
 canonical homes under **`@~/.claude/_shared/`** (advisor protocol, PR-loop
-contracts, runtime scripts). Map: `skills/_shared/CLAUDE.md`. End-of-run gotchas: `skills/_shared/end-of-run-gotcha-recommendations.md`.
+contracts, runtime scripts). Map: `skills/_shared/.claude/CLAUDE.md`. End-of-run gotchas: `skills/_shared/end-of-run-gotcha-recommendations.md`.
 
 ## Skill groups
 

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

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

package/{skills → .agents/skills}/_shared/AGENTS.md

@@ -6,7 +6,7 @@
 
 | Home | Path | Holds |
 |---|---|---|
-| **Skills shared** | `~/.claude/skills/_shared/` | Converge helpers, end-of-run gotcha ref, and `@` stubs |
+| **Skills shared** | `~/.agents/skills/_shared/` | Converge helpers, end-of-run gotcha ref, and `@` stubs. Claude Code looks this folder up at `~/.claude/skills/_shared/`. |
 | **Top-level shared** | `~/.claude/_shared/` | Advisor protocol, PR-loop contracts, runtime scripts |
 
 
@@ -28,7 +28,7 @@
 | Stub here | Load |
 |---|---|
 | `advisor/advisor-protocol.md` | `@~/.claude/_shared/advisor/advisor-protocol.md` |
-| `advisor/CLAUDE.md` | `@~/.claude/_shared/advisor/CLAUDE.md` |
+| `advisor/.claude/CLAUDE.md` | `@../AGENTS.md` |
 | `advisor/scripts/README.md` | `@~/.claude/_shared/advisor/scripts/` |
 | `pr-loop/audit-contract.md` | `@~/.claude/_shared/pr-loop/audit-contract.md` |
 | `pr-loop/audit-reply-template.md` | `@~/.claude/_shared/pr-loop/audit-reply-template.md` |

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

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

package/.agents/skills/_shared/pr-loop/.claude/CLAUDE.md

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

package/.agents/skills/_shared/pr-loop/prompts/.claude/CLAUDE.md

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

package/.agents/skills/_shared/pr-loop/scripts/.claude/CLAUDE.md

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

package/.agents/skills/_shared/pr-loop/scripts/skills_pr_loop_constants/.claude/CLAUDE.md

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

package/{skills → .agents/skills}/_shared/pr-loop/scripts/skills_pr_loop_constants/audit_category_schema_constants.py

@@ -6,7 +6,12 @@ import re
 from pathlib import Path
 
 SCRIPTS_DIRECTORY = Path(__file__).resolve().parent.parent
-PACKAGE_ROOT = SCRIPTS_DIRECTORY.parents[3]
+_skills_home_directory = SCRIPTS_DIRECTORY.parents[3]
+PACKAGE_ROOT = (
+    _skills_home_directory.parent
+    if _skills_home_directory.name == ".agents"
+    else _skills_home_directory
+)
 SCHEMA_RELATIVE_PATH = Path("audit-rubrics") / "audit-categories.json"
 CATEGORY_RUBRICS_DIRECTORY = PACKAGE_ROOT / "audit-rubrics" / "category_rubrics"
 PROMPTS_DIRECTORY = PACKAGE_ROOT / "audit-rubrics" / "prompts"

package/{skills → .agents/skills}/_shared/pr-loop/scripts/test_build_audit_prompt.py

@@ -12,6 +12,12 @@ from xml.etree.ElementTree import Element
 import pytest
 
 _SCRIPTS_DIR = Path(__file__).resolve().parent
+_skills_home_directory = _SCRIPTS_DIR.parents[3]
+_PACKAGE_ROOT_FOR_RUBRICS = (
+    _skills_home_directory.parent
+    if _skills_home_directory.name == ".agents"
+    else _skills_home_directory
+)
 if str(_SCRIPTS_DIR) not in sys.path:
     sys.path.insert(0, str(_SCRIPTS_DIR))
 
@@ -26,7 +32,7 @@ from skills_pr_loop_constants.path_resolver_constants import (
     OUTCOME_XML_TEMPLATE,
 )
 
-_CATEGORY_RUBRICS_DIR = _SCRIPTS_DIR.parents[3] / "audit-rubrics" / "category_rubrics"
+_CATEGORY_RUBRICS_DIR = _PACKAGE_ROOT_FOR_RUBRICS / "audit-rubrics" / "category_rubrics"
 _HEADING_PATTERN = re.compile(r"^# Category ([A-Q]) — (.+)$")
 
 
@@ -380,8 +386,8 @@ def test_main_headless_flavor_emits_outcome_path_on_stdout(
     assert "add_comment_to_pending_review" not in captured.out
 
 
-_PACKAGE_ROOT = _SCRIPTS_DIR.parents[3]
-_CODE_QUALITY_AGENT_PATH = _PACKAGE_ROOT / "agents" / "code-quality-agent.md"
+_PACKAGE_ROOT = _PACKAGE_ROOT_FOR_RUBRICS
+_CODE_QUALITY_AGENT_PATH = _PACKAGE_ROOT / ".agents" / "agents" / "code-quality-agent.md"
 _AUDIT_CONTRACT_PATH = _PACKAGE_ROOT / "_shared" / "pr-loop" / "audit-contract.md"
 _PRECATCH_RUBRIC_PATH = _PACKAGE_ROOT / "_shared" / "pr-loop" / "precatch-rubric.md"
 _CATEGORY_Q_LABEL = (

package/{skills → .agents/skills}/_shared/pr-loop/scripts/write_audit_outcomes.py

@@ -70,7 +70,7 @@ def _populate_findings(parent: Element, findings_data: list[dict[str, object]])
 
     Scalar finding fields become XML attributes on `<finding>`; the
     body fields named in `ALL_FINDING_BODY_ELEMENT_KEYS` (defined in
-    `packages/claude-dev-env/skills/_shared/pr-loop/scripts/skills_pr_loop_constants/path_resolver_constants.py`
+    `packages/claude-dev-env/.agents/skills/_shared/pr-loop/scripts/skills_pr_loop_constants/path_resolver_constants.py`
     and currently `("title", "excerpt", "description")`) become child elements.
     Nested dicts or lists in scalar slots are flattened to string form
     so attribute serialization stays well-defined.

package/{skills → .agents/skills}/_shared/pr-loop/scripts/write_fix_outcomes.py

@@ -1,7 +1,7 @@
 """Validate status enum values and write <bugteam_fix> XML at the canonical path.
 
 Status enum (canonical source: `ALL_VALID_FIX_STATUSES` in
-`packages/claude-dev-env/skills/_shared/pr-loop/scripts/skills_pr_loop_constants/path_resolver_constants.py`):
+`packages/claude-dev-env/.agents/skills/_shared/pr-loop/scripts/skills_pr_loop_constants/path_resolver_constants.py`):
 fixed | could_not_address | hook_blocked | unverified_fixed.
 
 Each outcome's scalar fields become XML attributes on `<outcome>`; the

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

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

package/{skills → .agents/skills}/anthropic-plan/AGENTS.md

@@ -19,7 +19,7 @@ Creates a repo-local plan packet under `docs/plans/<slug>/` by running the `plan
 | `SKILL.md` | Entry point. Full planning protocol, workflow contract, packet shape, and validation rules. |
 | `workflow/plan-packet.mjs` | Main workflow script. Reads repo context, writes the packet, runs the validator, spawns `plan-packet-validator`, runs the reuse audit, builds the visual HTML, and returns the packet path. |
 | `workflow/plan-packet.contract.test.mjs` | Contract tests for the workflow script. |
-| `packages/claude-dev-env/skills/anthropic-plan/scripts/validate_packet.py` | Deterministic validator: checks required files, open questions, source-map strength, TDD coverage, and `packet.json` consistency. Exits with code 2 on failure. |
+| `packages/claude-dev-env/.agents/skills/anthropic-plan/scripts/validate_packet.py` | Deterministic validator: checks required files, open questions, source-map strength, TDD coverage, and `packet.json` consistency. Exits with code 2 on failure. |
 | `templates/visual-plan.template.html` | Template for the single-file offline visual HTML the workflow builds after validation. |
 
 ## Entry point

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

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

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

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

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

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

package/{skills → .agents/skills}/anthropic-plan/test_skill_contract.py

@@ -6,11 +6,11 @@ from pathlib import Path
 
 
 SKILL_DIRECTORY = Path(__file__).resolve().parent
-CLAUDE_DIRECTORY = SKILL_DIRECTORY.parent.parent
+PACKAGE_ROOT = SKILL_DIRECTORY.parent.parent.parent
 SKILL_PATH = SKILL_DIRECTORY / "SKILL.md"
-PLAN_COMMAND_PATH = CLAUDE_DIRECTORY / "commands" / "plan.md"
-SR_LOOP_COMMAND_PATH = CLAUDE_DIRECTORY / "commands" / "sr-loop.md"
-VALIDATOR_AGENT_PATH = CLAUDE_DIRECTORY / "agents" / "plan-packet-validator.md"
+PLAN_COMMAND_PATH = PACKAGE_ROOT / "commands" / "plan.md"
+SR_LOOP_COMMAND_PATH = PACKAGE_ROOT / "commands" / "sr-loop.md"
+VALIDATOR_AGENT_PATH = PACKAGE_ROOT / ".agents" / "agents" / "plan-packet-validator.md"
 
 
 def test_skill_invokes_plan_packet_workflow() -> None:

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

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

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

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

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

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

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

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

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

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

package/.agents/skills/autoconverge/workflow/autoconverge_report_constants/.claude/CLAUDE.md

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

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

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

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

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

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

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

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

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

package/{skills → .agents/skills}/bugteam/scripts/bugteam_code_rules_gate.py

@@ -9,8 +9,18 @@ from __future__ import annotations
 import sys
 from pathlib import Path
 
+_here = Path(__file__).resolve()
+_skills_home_directory = _here.parents[3]
+_package_or_user_home = (
+    _skills_home_directory.parent
+    if _skills_home_directory.name == ".agents"
+    else _skills_home_directory
+)
+_shared_under_package = _package_or_user_home / "_shared" / "pr-loop" / "scripts"
 _shared_pr_loop_scripts_directory = (
-    Path(__file__).resolve().parents[3] / "_shared" / "pr-loop" / "scripts"
+    _shared_under_package
+    if _shared_under_package.is_dir()
+    else _package_or_user_home / ".claude" / "_shared" / "pr-loop" / "scripts"
 )
 if str(_shared_pr_loop_scripts_directory) not in sys.path:
     sys.path.insert(0, str(_shared_pr_loop_scripts_directory))

package/{skills → .agents/skills}/bugteam/scripts/bugteam_fix_hookspath.py

@@ -9,8 +9,18 @@ from __future__ import annotations
 import sys
 from pathlib import Path
 
+_here = Path(__file__).resolve()
+_skills_home_directory = _here.parents[3]
+_package_or_user_home = (
+    _skills_home_directory.parent
+    if _skills_home_directory.name == ".agents"
+    else _skills_home_directory
+)
+_shared_under_package = _package_or_user_home / "_shared" / "pr-loop" / "scripts"
 _shared_pr_loop_scripts_directory = (
-    Path(__file__).resolve().parents[3] / "_shared" / "pr-loop" / "scripts"
+    _shared_under_package
+    if _shared_under_package.is_dir()
+    else _package_or_user_home / ".claude" / "_shared" / "pr-loop" / "scripts"
 )
 if str(_shared_pr_loop_scripts_directory) not in sys.path:
     sys.path.insert(0, str(_shared_pr_loop_scripts_directory))

package/{skills → .agents/skills}/bugteam/scripts/bugteam_preflight.py

@@ -9,8 +9,18 @@ from __future__ import annotations
 import sys
 from pathlib import Path
 
+_here = Path(__file__).resolve()
+_skills_home_directory = _here.parents[3]
+_package_or_user_home = (
+    _skills_home_directory.parent
+    if _skills_home_directory.name == ".agents"
+    else _skills_home_directory
+)
+_shared_under_package = _package_or_user_home / "_shared" / "pr-loop" / "scripts"
 _shared_pr_loop_scripts_directory = (
-    Path(__file__).resolve().parents[3] / "_shared" / "pr-loop" / "scripts"
+    _shared_under_package
+    if _shared_under_package.is_dir()
+    else _package_or_user_home / ".claude" / "_shared" / "pr-loop" / "scripts"
 )
 if str(_shared_pr_loop_scripts_directory) not in sys.path:
     sys.path.insert(0, str(_shared_pr_loop_scripts_directory))

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

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

package/{skills → .agents/skills}/bugteam/scripts/reflow_skill_md.py

@@ -1,16 +1,16 @@
-"""Reflow packages/claude-dev-env/skills/bugteam/SKILL.md to 80 columns.
+"""Reflow packages/claude-dev-env/.agents/skills/bugteam/SKILL.md to 80 columns.
 
 Merge soft line breaks outside fenced blocks (space join; URL path fragments
 joined without a space only inside unfinished markdown link targets), then
 wrap with textwrap. Preserves fenced blocks verbatim.
 
-Same algorithm as ``packages/claude-dev-env/skills/pr-converge/scripts/reflow_skill_md.py``
+Same algorithm as ``packages/claude-dev-env/.agents/skills/pr-converge/scripts/reflow_skill_md.py``
 from https://github.com/jl-cmd/claude-dev-env/pull/349 (branch
 ``cursor/pr-converge-skill-line-wrap-ecd1``); ``SKILL_PATH`` points at bugteam
 ``SKILL.md``. Link reference definitions (``[id]: url``) are treated as logical
 line starts so they are not merged with prior paragraphs.
 
-Run: python3 packages/claude-dev-env/skills/bugteam/scripts/reflow_skill_md.py
+Run: python3 packages/claude-dev-env/.agents/skills/bugteam/scripts/reflow_skill_md.py
 """
 
 from __future__ import annotations

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

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

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

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

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

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

package/{skills → .agents/skills}/codex-review/scripts/codex_usage_probe.py

@@ -43,8 +43,18 @@ from datetime import datetime, timezone
 from pathlib import Path
 from typing import IO, Protocol
 
+_here = Path(__file__).resolve()
+_skills_home_directory = _here.parents[3]
+_package_or_user_home = (
+    _skills_home_directory.parent
+    if _skills_home_directory.name == ".agents"
+    else _skills_home_directory
+)
+_shared_under_package = _package_or_user_home / "_shared" / "process-tree" / "scripts"
 _shared_process_tree_scripts_directory = (
-    Path(__file__).resolve().parents[3] / "_shared" / "process-tree" / "scripts"
+    _shared_under_package
+    if _shared_under_package.is_dir()
+    else _package_or_user_home / ".claude" / "_shared" / "process-tree" / "scripts"
 )
 if str(_shared_process_tree_scripts_directory) not in sys.path:
     sys.path.insert(0, str(_shared_process_tree_scripts_directory))

package/{skills → .agents/skills}/codex-review/scripts/run_codex_review.py

@@ -23,8 +23,18 @@ import sys
 from dataclasses import dataclass
 from pathlib import Path
 
+_here = Path(__file__).resolve()
+_skills_home_directory = _here.parents[3]
+_package_or_user_home = (
+    _skills_home_directory.parent
+    if _skills_home_directory.name == ".agents"
+    else _skills_home_directory
+)
+_shared_under_package = _package_or_user_home / "_shared" / "process-tree" / "scripts"
 _shared_process_tree_scripts_directory = (
-    Path(__file__).resolve().parents[3] / "_shared" / "process-tree" / "scripts"
+    _shared_under_package
+    if _shared_under_package.is_dir()
+    else _package_or_user_home / ".claude" / "_shared" / "process-tree" / "scripts"
 )
 if str(_shared_process_tree_scripts_directory) not in sys.path:
     sys.path.insert(0, str(_shared_process_tree_scripts_directory))

package/{skills → .agents/skills}/codex-review/test_skill_scaffold.py

@@ -11,11 +11,11 @@ SKILL_DIRECTORY = Path(__file__).resolve().parent
 SKILL_PATH = SKILL_DIRECTORY / "SKILL.md"
 PACKAGE_MAP_PATH = SKILL_DIRECTORY / "AGENTS.md"
 REFERENCE_DIRECTORY = SKILL_DIRECTORY / "reference"
-PACKAGE_ROOT = SKILL_DIRECTORY.parents[1]
+PACKAGE_ROOT = SKILL_DIRECTORY.parents[2]
 PYPROJECT_PATH = PACKAGE_ROOT / "pyproject.toml"
 EVER_SHIPPED_SKILLS_PATH = PACKAGE_ROOT / "bin" / "ever-shipped-skills.mjs"
 CONSTANTS_PACKAGE_NAME = "codex_review_scripts_constants"
-CONSTANTS_PACKAGE_DIR = "skills/codex-review/scripts/codex_review_scripts_constants"
+CONSTANTS_PACKAGE_DIR = ".agents/skills/codex-review/scripts/codex_review_scripts_constants"
 SKILL_NAME = "codex-review"
 MAXIMUM_SKILL_BODY_LINE_COUNT = 500
 
@@ -182,11 +182,11 @@ def test_package_map_agents_md_exists() -> None:
 def test_reference_shell_pages_exist() -> None:
     assert (REFERENCE_DIRECTORY / "cli-contract.md").is_file()
     assert (REFERENCE_DIRECTORY / "loop-integration.md").is_file()
-    assert (REFERENCE_DIRECTORY / "CLAUDE.md").is_file()
+    assert (REFERENCE_DIRECTORY / ".claude" / "CLAUDE.md").is_file()
 
 
 def test_constants_package_directory_exists() -> None:
     constants_directory = SKILL_DIRECTORY / "scripts" / "codex_review_scripts_constants"
 
     assert (constants_directory / "__init__.py").is_file()
-    assert (constants_directory / "CLAUDE.md").is_file()
+    assert (constants_directory / ".claude" / "CLAUDE.md").is_file()

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

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

package/{skills → .agents/skills}/e-code-review/reference/effort-evaluation.md

@@ -14,7 +14,7 @@ Offline-first harness for choosing e-code-review effort and publishing cited ski
 ## How to run offline tests
 
 ```
-python -m pytest packages/claude-dev-env/skills/e-code-review/scripts/test_effort_evaluation.py -q
+python -m pytest packages/claude-dev-env/.agents/skills/e-code-review/scripts/test_effort_evaluation.py -q
 ```
 
 ## Skill defaults (OP-02C — e-code-review family)

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

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

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

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

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

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

package/{skills → .agents/skills}/grokify/evals/README.md

@@ -26,7 +26,7 @@ node skills/grokify/evals/run-capability-evals.mjs
 GROK_CAPABILITY_EVALS=1 node skills/grokify/evals/run-capability-evals.mjs
 ```
 
-From this skill folder (`packages/claude-dev-env/skills/grokify`):
+From this skill folder (`packages/claude-dev-env/.agents/skills/grokify`):
 
 ```powershell
 # Windows PowerShell

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

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

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

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

package/{skills → .agents/skills}/pr-converge/pr_converge_skill_constants/AGENTS.md

@@ -23,4 +23,4 @@ Importable Python constants module for the `pr-converge` skill. Script-specific
 ## Conventions
 
 - All path templates use `str.format(**kwargs)` with keys `owner`, `repo`, `number`.
-- `packages/claude-dev-env/skills/pr-converge/scripts/pr_converge_scripts_constants/pr_converge_constants.py` re-exports everything here via `from pr_converge_skill_constants.constants import ...` so scripts can import from either location.
+- `packages/claude-dev-env/.agents/skills/pr-converge/scripts/pr_converge_scripts_constants/pr_converge_constants.py` re-exports everything here via `from pr_converge_skill_constants.constants import ...` so scripts can import from either location.

package/{skills → .agents/skills}/pr-converge/pr_converge_skill_constants/constants.py

@@ -2,7 +2,7 @@
 
 All runtime and API constants live here. Script-specific constants
 (CLI args, markdown patterns, reflow settings) stay in
-``packages/claude-dev-env/skills/pr-converge/scripts/pr_converge_scripts_constants/pr_converge_constants.py``,
+``packages/claude-dev-env/.agents/skills/pr-converge/scripts/pr_converge_scripts_constants/pr_converge_constants.py``,
 which imports from here.
 """
 

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

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

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

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

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

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

package/{skills → .agents/skills}/pr-converge/scripts/_pr_converge_path_setup.py

@@ -3,6 +3,10 @@
 Importing this module makes the skill's constants package and the shared
 ``reviews_disabled`` module resolvable when a script in this directory runs
 as ``__main__``. Each directory is added once, guarded against duplicates.
+
+The skill tree lives under ``.agents/skills``. Shared PR-loop scripts live
+under the package ``_shared`` tree, or under ``~/.claude/_shared`` when this
+file is loaded from an installed agents home.
 """
 
 import sys
@@ -11,9 +15,20 @@ from pathlib import Path
 _scripts_directory = Path(__file__).resolve().parent
 _skill_directory = _scripts_directory.parent
 _skills_directory = _skill_directory.parent
-_claude_dev_env_directory = _skills_directory.parent
+_skills_home_directory = _skills_directory.parent
+_package_or_user_home = (
+    _skills_home_directory.parent
+    if _skills_home_directory.name == ".agents"
+    else _skills_home_directory
+)
+_shared_under_package = _package_or_user_home / "_shared" / "pr-loop" / "scripts"
+_shared_under_claude = (
+    _package_or_user_home / ".claude" / "_shared" / "pr-loop" / "scripts"
+)
 _shared_pr_loop_scripts_directory = (
-    _claude_dev_env_directory / "_shared" / "pr-loop" / "scripts"
+    _shared_under_package
+    if _shared_under_package.is_dir()
+    else _shared_under_claude
 )
 _codex_review_scripts_directory = _skills_directory / "codex-review" / "scripts"
 

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

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

package/{skills → .agents/skills}/pr-converge/scripts/reflow_skill_md.py

@@ -1,10 +1,10 @@
-"""Reflow packages/claude-dev-env/skills/pr-converge/SKILL.md to 80 columns.
+"""Reflow packages/claude-dev-env/.agents/skills/pr-converge/SKILL.md to 80 columns.
 
 Merge soft line breaks outside fenced blocks (space join; URL path fragments
 joined without a space only inside unfinished markdown link targets), then
 wrap with textwrap. Preserves fenced blocks verbatim.
 
-Run: python3 packages/claude-dev-env/skills/pr-converge/scripts/reflow_skill_md.py
+Run: python3 packages/claude-dev-env/.agents/skills/pr-converge/scripts/reflow_skill_md.py
 """
 
 from __future__ import annotations

package/{skills → .agents/skills}/pr-converge/scripts/test__pr_converge_path_setup.py

@@ -19,12 +19,15 @@ _SCRIPTS_DIRECTORY = Path(__file__).absolute().parent
 
 def test_path_setup_registers_skill_and_shared_directories() -> None:
     skill_directory = _SCRIPTS_DIRECTORY.parent
-    shared_directory = (
-        _SCRIPTS_DIRECTORY.parent.parent.parent / "_shared" / "pr-loop" / "scripts"
-    )
+    shared_entries = [
+        each_path
+        for each_path in sys.path
+        if each_path.replace("\\", "/").endswith("_shared/pr-loop/scripts")
+    ]
     codex_scripts_directory = (
         _SCRIPTS_DIRECTORY.parent.parent / "codex-review" / "scripts"
     )
     assert str(skill_directory) in sys.path
-    assert str(shared_directory) in sys.path
+    assert shared_entries
+    assert Path(shared_entries[0]).is_dir()
     assert str(codex_scripts_directory) in sys.path

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

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

package/{skills → .agents/skills}/prototype/scripts/test_probe_sandbox_safety.py

@@ -34,7 +34,7 @@ from prototype_scripts_constants.config.probe_sandbox_safety_constants import (
 
 SCRIPTS_DIRECTORY = Path(__file__).resolve().parent
 PROBE_PATH = SCRIPTS_DIRECTORY / "probe_sandbox_safety.py"
-HOOKS_BLOCKING_DIRECTORY = SCRIPTS_DIRECTORY.parents[2] / "hooks" / "blocking"
+HOOKS_BLOCKING_DIRECTORY = SCRIPTS_DIRECTORY.parents[3] / "hooks" / "blocking"
 
 PII_HOOK_BASENAME = ALL_SAFETY_HOOK_SCRIPT_BASENAMES[0]
 DESTRUCTIVE_HOOK_BASENAME = ALL_SAFETY_HOOK_SCRIPT_BASENAMES[1]

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

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

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

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

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

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