claude-dev-env 2.16.0 → 2.17.0

package/hooks/hooks_constants/stop_dispatcher_constants.py

@@ -22,5 +22,4 @@ ALL_STOP_HOSTED_HOOK_PATHS: tuple[str, ...] = (
     "blocking/question_to_user_enforcer.py",
     "blocking/intent_only_ending_blocker.py",
     "blocking/session_handoff_blocker.py",
-    "blocking/eli11_reply_enforcer.py",
 )

package/hooks/hooks_constants/test_ask_user_question_shape.py

@@ -20,7 +20,7 @@ from hooks_constants.ask_user_question_shape import (  # noqa: E402
     mask_inline_code,
     normalize_line_endings,
 )
-from hooks_constants.plain_language_blocker_constants import (  # noqa: E402
+from hooks_constants.ask_user_question_shape_constants import (  # noqa: E402
     MAXIMUM_OPTION_DESCRIPTION_WORD_COUNT,
     MAXIMUM_QUESTION_SENTENCE_COUNT,
     MAXIMUM_QUESTION_WORD_COUNT,

package/hooks/hooks_constants/test_prose_metrics_parity.py

@@ -1,23 +1,6 @@
-"""Parity checks across the duplicated prose-metric copies.
+"""Contract tests for the retained AskUserQuestion shape capability."""
 
-``plain_language_blocker_constants`` and ``eli11_reply_enforcer_constants``
-each carry their own copy of the metrics that read a reply's prose, so a
-tuning landed in one copy alone drifts the two gates apart. These checks fail
-loud on that drift::
-
-    COUNTABLE_WORD_PATTERN      ok:   byte-equal across both copies
-    table-row pattern           ok:   byte-equal across both copies
-    "- Run the migration"       ok:   both copies read a list marker
-    "1.5% of hosts still fail." ok:   neither copy reads a list marker
-    "**1.** Run the migration"  flag: the eli11 copy alone reads a marker
-
-The list-marker copies hold two different shapes — one combined regex against
-a bullet/numbered split — so they are pinned by the lines they agree on plus
-the one line they read differently.
-
-Row 2 of ``~/.claude/orchestrator-runs/falsify-first/parked-items.md`` carries
-the shared home that retires these copies.
-"""
+from __future__ import annotations
 
 import pathlib
 import re
@@ -27,106 +10,45 @@ _HOOKS_ROOT = pathlib.Path(__file__).resolve().parent.parent
 if str(_HOOKS_ROOT) not in sys.path:
     sys.path.insert(0, str(_HOOKS_ROOT))
 
-from hooks_constants.eli11_reply_enforcer_constants import (
-    BULLET_LINE_PATTERN,
-    NUMBERED_STEP_PATTERN,
-    TABLE_ROW_PATTERN,
+from hooks_constants.ask_user_question_shape import (  # noqa: E402
+    COUNTABLE_WORD_PATTERN as ANALYZER_COUNTABLE_WORD_PATTERN,
+    find_chat_detail_markers,
 )
-from hooks_constants.eli11_reply_enforcer_constants import (
-    COUNTABLE_WORD_PATTERN as ELI11_COUNTABLE_WORD_PATTERN,
+from hooks_constants.ask_user_question_shape_constants import (  # noqa: E402
+    ALL_CHAT_DETAIL_MARKERS,
+    COUNTABLE_WORD_PATTERN,
 )
-from hooks_constants.ask_user_question_shape import (
-    COUNTABLE_WORD_PATTERN as SHAPE_COUNTABLE_WORD_PATTERN,
-)
-from hooks_constants.plain_language_blocker_constants import ALL_CHAT_DETAIL_MARKERS
-from hooks_constants.plain_language_blocker_constants import (
-    COUNTABLE_WORD_PATTERN as PLAIN_LANGUAGE_COUNTABLE_WORD_PATTERN,
-)
-
-_TABLE_ROW_MARKER_LABEL = "a table row"
-_LIST_MARKER_LABEL = "a bullet or numbered list marker"
-_BOLD_NUMBERED_STEP_LINE = "**1.** Run the migration"
-
-_ALL_SHARED_LIST_MARKER_LINES = (
-    "- Run the migration",
-    "* Run the migration",
-    "+ Run the migration",
-    "1. Run the migration",
-    "2) Run the migration",
-    "   - Run the migration",
-    "  1. Run the migration",
-)
-
-_ALL_NON_LIST_MARKER_LINES = (
-    "Run the migration",
-    "1.5% of hosts still fail.",
-    "|table|row|",
-    "-no space after the dash",
-)
-
 
-def _chat_detail_marker_named(marker_label: str) -> re.Pattern[str]:
-    """Return the plain-language chat-detail pattern carrying one label.
 
-    Args:
-        marker_label: The label the chat-detail marker table gives a pattern.
-
-    Returns:
-        The compiled pattern registered under that label.
-    """
+def _marker_pattern(marker_label: str) -> re.Pattern[str]:
+    """Return the pattern registered under one shape-marker label."""
     for each_pattern, each_label in ALL_CHAT_DETAIL_MARKERS:
         if each_label == marker_label:
             return each_pattern
-    raise AssertionError(f"no chat-detail marker labeled {marker_label!r}")
-
-
-def _eli11_copy_reads_a_list_marker(reply_line: str) -> bool:
-    """Report whether the eli11 bullet/numbered split reads a list marker.
-
-    Args:
-        reply_line: One line of reply text.
-
-    Returns:
-        True when either half of the split matches the line.
-    """
-    if BULLET_LINE_PATTERN.search(reply_line):
-        return True
-    return bool(NUMBERED_STEP_PATTERN.search(reply_line))
+    raise AssertionError(f"missing shape marker: {marker_label}")
 
 
-def test_countable_word_pattern_copies_stay_byte_equal() -> None:
-    assert (
-        PLAIN_LANGUAGE_COUNTABLE_WORD_PATTERN.pattern
-        == ELI11_COUNTABLE_WORD_PATTERN.pattern
-    )
-    assert (
-        PLAIN_LANGUAGE_COUNTABLE_WORD_PATTERN.flags
-        == ELI11_COUNTABLE_WORD_PATTERN.flags
-    )
-
+def test_analyzer_uses_the_canonical_countable_word_pattern() -> None:
+    assert ANALYZER_COUNTABLE_WORD_PATTERN is COUNTABLE_WORD_PATTERN
 
-def test_shape_analyzer_binds_the_plain_language_countable_word_pattern() -> None:
-    """The pure shape analyzer reuses the shared pattern object, not a private copy."""
-    assert SHAPE_COUNTABLE_WORD_PATTERN is PLAIN_LANGUAGE_COUNTABLE_WORD_PATTERN
 
+def test_shape_marker_table_reads_shared_layout_markers() -> None:
+    table_pattern = _marker_pattern("a table row")
+    list_pattern = _marker_pattern("a bullet or numbered list marker")
 
-def test_table_row_pattern_copies_stay_byte_equal() -> None:
-    plain_language_table_row = _chat_detail_marker_named(_TABLE_ROW_MARKER_LABEL)
-    assert plain_language_table_row.pattern == TABLE_ROW_PATTERN.pattern
-    assert plain_language_table_row.flags == TABLE_ROW_PATTERN.flags
+    assert table_pattern.search("| gate | row |")
+    assert list_pattern.search("- Run the migration")
+    assert list_pattern.search("1. Run the migration")
+    assert not list_pattern.search("1.5% of hosts still fail.")
 
 
-def test_list_marker_copies_agree_on_every_shared_line() -> None:
-    combined_marker = _chat_detail_marker_named(_LIST_MARKER_LABEL)
-    for each_line in _ALL_SHARED_LIST_MARKER_LINES:
-        assert combined_marker.search(each_line)
-        assert _eli11_copy_reads_a_list_marker(each_line)
-    for each_line in _ALL_NON_LIST_MARKER_LINES:
-        assert not combined_marker.search(each_line)
-        assert not _eli11_copy_reads_a_list_marker(each_line)
-
+def test_analyzer_reports_each_layout_marker() -> None:
+    marker_names = find_chat_detail_markers(
+        "Question?\n- Split the file\n\n| gate | row |"
+    )
 
-def test_bold_numbered_step_reads_as_a_list_marker_in_the_eli11_copy_alone() -> None:
-    combined_marker = _chat_detail_marker_named(_LIST_MARKER_LABEL)
-    assert not combined_marker.search(_BOLD_NUMBERED_STEP_LINE)
-    assert _eli11_copy_reads_a_list_marker(_BOLD_NUMBERED_STEP_LINE)
+    assert marker_names == [
+        "a table row",
+        "a bullet or numbered list marker",
+        "more than one paragraph",
+    ]

package/hooks/hooks_constants/test_stop_dispatcher_constants.py

@@ -16,7 +16,6 @@ _EXPECTED_STOP_ORDER = (
     "blocking/question_to_user_enforcer.py",
     "blocking/intent_only_ending_blocker.py",
     "blocking/session_handoff_blocker.py",
-    "blocking/eli11_reply_enforcer.py",
 )
 
 

package/hooks/hooks_constants/working_style_prompt_constants.py

@@ -8,8 +8,12 @@ __all__ = [
 
 WORKING_STYLE_PROMPT = (
     "Document each task in a location that remains easy to find later. Keep a "
-    "running scratch text ledger as you work. Write in plain English. Keep responses "
-    "focused, brief, and concise. Keep disclaimers and caveats short while giving "
+    "running scratch text ledger as you work. Use ELI5 for beginner framing, large "
+    "visuals, minimal text, one stable self-contained HTML artifact, update-in-place "
+    "continuity, and sharing when a user-facing response needs that presentation. "
+    "Keep responses focused, brief, and concise. Apply ~/.claude/rules/asd-ste100-language.md for "
+    "user-facing word choice, sentence style, tone, punctuation, and prose form. "
+    "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 "
@@ -28,12 +32,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 positive prose throughout every generated text surface, including "
-    "documentation, comments, user-facing messages, sub-agent prompts, labels, "
-    "plans, and instructions. Write each point as one direct affirmative statement "
-    "that presents only the intended action, fact, reason, or outcome. Use current, "
-    "immediately relevant context and omit historical clutter. Use plain language, "
-    "full terms, and simple descriptive names that communicate their meaning "
-    "immediately. Keep all text concise, clear, direct, and focused entirely on "
-    "useful information."
+    "Use current, immediately relevant context. Name each action, fact, reason, "
+    "and outcome. Use full terms and specific names for repository work. Keep all "
+    "text concise, clear, direct, and useful."
 )

package/hooks/session/AGENTS.md

@@ -2,6 +2,9 @@
 
 SessionStart and SessionEnd hooks for per-session setup and cleanup: removing stale session and plugin-data directories at startup, detecting unregistered repositories, starting the session's task-list maintenance loop, injecting working-style guidance, and clearing PR-author swap state at shutdown.
 
+The working-style projection uses `~/.claude/rules/asd-ste100-language.md` for
+user-facing word choice, sentence style, tone, punctuation, and prose form.
+
 ## Key files
 
 | File | Event | What it does |
@@ -17,7 +20,7 @@ SessionStart and SessionEnd hooks for per-session setup and cleanup: removing st
 | `_path_setup.py` | — | Inserts the hooks directory on `sys.path` so SessionStart scripts import `hooks_constants` with top-level imports. |
 | `test_orchestrator_auto_starter.py` | — | Tests for `orchestrator_auto_starter.py` |
 | `test_issue_tracker_session_starter.py` | — | Tests for `issue_tracker_session_starter.py` |
-| `working_style_prompt.py` | SessionStart | Emits an `additionalContext` block with the fixed working-style prompt (running ledger, plain English, outcome-first finish, scope discipline). Writes nothing and runs no tools itself. |
+| `working_style_prompt.py` | SessionStart | Emits an `additionalContext` block with the fixed working-style prompt (running ledger, canonical language policy, outcome-first finish, scope discipline). Writes nothing and runs no tools itself. |
 | `test_gh_pr_author_session_cleanup.py` | — | Tests for `gh_pr_author_session_cleanup.py` |
 | `test_session_edit_tracker_cleanup.py` | — | Tests for `session_edit_tracker_cleanup.py` |
 | `test_session_env_cleanup.py` | — | Tests for `session_env_cleanup.py` |

package/hooks/session/test_working_style_prompt.py

@@ -36,14 +36,18 @@ class TestWorkingStylePrompt:
         emitted = json.loads(_run_main())
         assert emitted["additionalContext"] == WORKING_STYLE_PROMPT
 
-    def test_emitted_prompt_preserves_existing_guidance_and_adds_policy(self) -> None:
+    def test_emitted_prompt_contains_canonical_policy_and_scope_guidance(self) -> None:
         emitted = json.loads(_run_main())
         prompt_text = emitted["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 "Use positive prose throughout every generated text surface" in prompt_text
-        assert "Write each point as one direct affirmative statement" in prompt_text
-        assert "Use plain language, full terms, and simple descriptive names" 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 "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

package/hooks/session/working_style_prompt.py

@@ -2,8 +2,10 @@
 """SessionStart hook — inject working-style guidance into the session.
 
 At session start this hook emits an ``additionalContext`` block carrying a fixed
-working-style prompt: keep a running ledger, write in plain English, narrate
-before the first tool call, lead with the outcome, and stay at the asked scope.
+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.
 The hook writes nothing and runs no tools itself.
 """
 

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "claude-dev-env",
-    "version": "2.16.0",
+    "version": "2.17.0",
     "description": "Claude Code development standards — rules, hooks, agents, commands, and skills",
     "type": "module",
     "bin": {
@@ -44,9 +44,6 @@
         "tdd",
         "code-quality"
     ],
-    "dependencies": {
-        "@jl-cmd/prompt-generator": "^1.0.0"
-    },
     "license": "MIT",
     "repository": {
         "type": "git",

package/rules/AGENTS.md

@@ -5,12 +5,13 @@ paths:
 
 # rules
 
-Rule files installed into `~/.claude/rules/` by `bin/install.mjs`. A rule without `paths:` frontmatter loads at the start of every session; a rule with `paths:` frontmatter loads only when the session works with a file its globs match. The `InstructionsLoaded` log records that match as a `path_glob_match` event. Each `.md` file covers one named rule; hook-enforced rules are also backed by a Python hook in `hooks/`.
+Rule files installed into `~/.claude/rules/` by `bin/install.mjs`. A rule without `paths:` frontmatter loads at the start of every session; a rule with `paths:` frontmatter loads only when the session works with a file its globs match. The `InstructionsLoaded` log records that match as a `path_glob_match` event. The `asd-ste100-language.md` file owns general user-facing language. Each other `.md` file covers one named behavior contract; hook-enforced rules are also backed by a Python hook in `hooks/`.
 
 ## Files
 
 | File | Rule |
 |---|---|
+| `asd-ste100-language.md` | Sole general user-facing language authority; concise conversational adaptation of ASD-STE100 Issue 9 |
 | `agent-spawn-protocol.md` | Check context sufficiency before a spawn and ask subagents for file-and-line answers; `/prompt-generator` is recommended for a complex or user-facing spawn |
 | `anti-corollary-tests.md` | Tests must carry information: no corollary matrices over canonical reductions, no suite that only matches a dead-implementation default, stated mutation in the audit lane |
 | `ask-user-question-required.md` | Every user-directed question goes through the `AskUserQuestion` tool — no plain-text questions |
@@ -23,10 +24,8 @@ Rule files installed into `~/.claude/rules/` by `bin/install.mjs`. A rule withou
 | `context7.md` | Use Context7 MCP to fetch current library docs; always prefer live docs over built-in knowledge |
 | `destructive-commands.md` | Allowed removal forms and the ephemeral namespace the `destructive_command_blocker` auto-allows; keep destructive literals out of a Bash command string even as data |
 | `doc-inventory-integrity.md` | Three inventory shapes stay in step with the code: a per-directory `CLAUDE.md` file list, a package `README`/`SKILL.md` inventory, and an env-var summary table |
-| `doc-prose-cuts.md` | Four sentence shapes to cut from prose: exclusion claims, justification sentences, conversation references, and time references |
 | `docstring-prose-matches-implementation.md` | Prose enumerations in docstrings cover every behavior the body applies |
 | `durable-post-artifacts.md` | GitHub post bodies never reference volatile scratch paths; text embeds inline and binary artifacts upload to the `artifacts` release with the permanent URL linked |
-| `eli11-replies.md` | Every chat reply the user reads follows one shape: action first, detail last, few words; `plain-language.md` governs word choice, this rule governs reply length and shape |
 | `explore-thoroughly.md` | Read relevant files and map existing patterns before proposing a change |
 | `falsify-before-green.md` | A check's green counts as evidence only after that same check ran red on a named break, with a passing control beside it |
 | `file-global-constants.md` | File-global constants need at least two same-file references; otherwise move value to `config/` |
@@ -39,11 +38,9 @@ Rule files installed into `~/.claude/rules/` by `bin/install.mjs`. A rule withou
 | `nas-ssh-invocation.md` | Reach the NAS through the paramiko-backed `nas_ssh_key.py` runner, which signs in-process; every ssh-family client reads the key through file permissions, refuses it, and stalls an unattended run on a password prompt |
 | `no-cross-skill-duplicate-helpers.md` | Within one skill a duplicated helper is blocked; across two skill folders a small self-contained copy is a sanctioned isolation tradeoff that draws a non-blocking advisory naming the source skill |
 | `orphan-css-class.md` | Every `class="..."` attribute in Python-generated markup has a matching selector in the `<style>` block |
-| `opus5-communication-contract.md` | Visible concision, one-sentence first progress, important-change-only updates, outcome-first finals, thinking-disabled tool narration (`opus5-communication-contract-v1`) |
 | `paired-test-coverage.md` | A public function omitted by a module's established paired test suite must get a behavioral test |
 | `parallel-tools.md` | Make all independent tool calls in a single response |
 | `plain-illustrative-docstrings.md` | Public docstring narrative reads plainly and shows behavior with a diagram block (a `::` example or a doctest), painting a concrete scene a general developer follows on first read; a run-on backstop hook, a prose-wall backstop hook, and Category O9 audit enforce it |
-| `plain-language.md` | Everyday words, short active sentences, lead with the answer |
 | `prompt-workflow-context-controls.md` | Keep prompt-workflow instruction layers small and stable; load heavy skills on demand |
 | `re-stage-before-commit.md` | Stage the files edited this session before `git commit`; the session edit stage gate denies a commit that leaves a tracked session edit unstaged, with `-a`, a pathspec, a preceding `git add`, and `# partial-commit` as escapes |
 | `research-mode.md` | Three anti-hallucination constraints: say "I don't know", verify with citations, quote for factual grounding |

package/rules/asd-ste100-language.md

@@ -0,0 +1,39 @@
+# ASD-STE100 Language Policy
+
+Use this rule as the sole general language authority for user-facing text in this repository.
+It defines ordinary word choice, sentence style, tone, punctuation, and prose form.
+
+This text is an **ASD-STE100 Issue 9 conversational adaptation**. It applies the standard's
+clear-writing principles to assistant messages. The official standard remains the authority for
+definitions and dictionary decisions.
+
+## Official sources
+
+- [ASD-STE100 Simplified Technical English, Issue 9 (2025-01-15)](https://www.asd-ste100.org/assets/files/ASD-STE100_ISSUE9.pdf)
+- [ASD-STE100 FAQ](https://www.asd-ste100.org/STE_faq.html)
+- [ASD-STE100 About page](https://www.asd-ste100.org/about_STE.html)
+- [ASD-STE100 tools guidance](https://www.asd-ste100.org/STEsoftware.html)
+- [STEMG white paper on ASD-STE100 and artificial intelligence](https://www.asd-ste100.org/assets/files/WhitePaper-ASD-STE100_and_AI.pdf)
+
+## Writing policy
+
+- Write short, complete sentences. Keep one topic in each explanatory sentence.
+- Use active voice. Put the condition first when an instruction has a prerequisite.
+- Write imperative procedure steps. Give one action in each sentence.
+- Prefer familiar, precise words. Use one stable term for one item or action.
+- Write full words and explicit references. Expand abbreviations and contractions when they first appear.
+- Replace ambiguous pronouns with the noun they name.
+- Use inclusive, neutral language.
+- Use periods, commas, colons, and bullets to show structure.
+- Preserve exact quoted labels, identifiers, formulas, titles, and interface text.
+- Use `WARNING` for a real risk of injury or death. Use `CAUTION` for a real risk of equipment, tool, or machine damage. State the command or condition first, then state the result.
+- Aim for 20 words or fewer in a procedure sentence when the technical content allows.
+- Aim for 25 words or fewer in a descriptive sentence when the technical content allows.
+
+Use this policy for chat, tool narration, questions, plans, documentation, code-adjacent prose,
+and durable repository text. Named contracts can add behavior-specific structure, evidence,
+question routing, current-state documentation, completion, docstring, or publication rules.
+Those contracts use this policy for their language.
+
+Treat automated output and language checks as drafting aids. A responsible human verifies
+technical accuracy, terminology, safety, confidentiality, and intended meaning.

package/rules/ask-user-question-required.md

@@ -8,7 +8,7 @@ The `question_to_user_enforcer` Stop hook blocks a response whose final paragrap
 
 `AskUserQuestion` renders as one plain unformatted text block. Detail — plans, counts, tradeoffs, background — goes in chat text before the call. The block itself carries a lean question and short choices. When a choice needs formatting, an inline visualizer tool carries it.
 
-The `plain_language_blocker` PreToolUse hook denies an `AskUserQuestion` call whose `question` text or whose `description` under any of the `options` carries chat detail:
+The `ask_user_question_shape_blocker` PreToolUse hook denies an `AskUserQuestion` call whose `question` text or whose `description` under any of the `options` carries chat detail:
 
 | What the block carries | Cap |
 |---|---|

package/rules/long-horizon-autonomy.md

@@ -30,7 +30,7 @@ On a long build, set a checkpoint cadence and hold to it. At each interval, chec
 
 Before you report progress, check each claim against a tool result from this session. State only what the evidence backs; name anything unverified as unverified. If tests fail, say so with the output; if a step was skipped, say that.
 
-Visible progress follows [`opus5-communication-contract.md`](opus5-communication-contract.md) (`opus5-communication-contract-v1`): the **first progress update is one sentence**; later updates mark only **important discoveries or a direction change**.
+Visible progress follows the [ASD-STE100 language policy](asd-ste100-language.md) and this rule's run-completion contract: the **first progress update is one sentence**; later updates mark only **important discoveries or a direction change**.
 
 ## Re-ground the final message
 

package/scripts/AGENTS.md

@@ -30,6 +30,7 @@ Utility scripts installed into `~/.claude/scripts/` by `bin/install.mjs`. Each s
 | `check.ps1` | Runs the full code-quality check suite |
 | `Get-SessionAccount.ps1` | Reports which Claude account the current session is actually logged into by comparing `~/.claude.json`'s CLI login against a `CLAUDE_USER_DATA_DIR` desktop profile's `lastKnownAccountUuid`, recovering the desktop account's email from profile storage when the two accounts differ |
 | `Capture-PoolHealth.ps1` | Captures Windows memory pool counters, high-handle processes, and kernel pool tags (via `NtQuerySystemInformation` class 22), prints a threshold verdict with a remediation map, and exits non-zero when any alert threshold fires |
+| `Show-Asset.ps1` | Opens files on screen, sizing each image window to the image's pixel dimensions and falling back to the registered default application for non-image files |
 
 ## Subdirectories
 

package/scripts/Show-Asset.ps1

@@ -0,0 +1,106 @@
+<#
+.SYNOPSIS
+Opens files on screen, sizing each image window to the image's own dimensions.
+
+.DESCRIPTION
+For every path given, an image opens in a window whose client area matches the
+image's pixel size, scaled down to fit the primary screen's working area when the
+image is larger than the screen. A small image gets a usable minimum window with
+the picture centered at native size. Non-image files open in their registered
+default application, and any file that cannot be loaded as an image falls back to
+that default application too. Escape or the close button dismisses a window; the
+process exits once every window is closed.
+
+.PARAMETER Paths
+One or more file paths to open.
+#>
+param(
+    [Parameter(ValueFromRemainingArguments = $true)]
+    [string[]]$Paths
+)
+
+Add-Type -AssemblyName System.Windows.Forms
+Add-Type -AssemblyName System.Drawing
+
+try {
+    [System.Windows.Forms.Application]::SetHighDpiMode([System.Windows.Forms.HighDpiMode]::PerMonitorV2) | Out-Null
+}
+catch {
+    $null = $_
+}
+[System.Windows.Forms.Application]::EnableVisualStyles()
+
+$imageExtensions = @('.png', '.jpg', '.jpeg', '.gif', '.bmp', '.webp', '.tif', '.tiff', '.ico')
+$screenMargin = 80
+$minimumClientWidth = 220
+$minimumClientHeight = 160
+$openWindowCount = 0
+
+foreach ($path in $Paths) {
+    if (-not (Test-Path -LiteralPath $path)) { continue }
+    $fullPath = (Resolve-Path -LiteralPath $path).Path
+    $extension = [System.IO.Path]::GetExtension($fullPath).ToLowerInvariant()
+
+    if ($imageExtensions -notcontains $extension) {
+        Invoke-Item -LiteralPath $fullPath
+        continue
+    }
+
+    try {
+        $imageBytes = [System.IO.File]::ReadAllBytes($fullPath)
+        $imageStream = New-Object System.IO.MemoryStream(, $imageBytes)
+        $loadedImage = [System.Drawing.Image]::FromStream($imageStream)
+        $image = New-Object System.Drawing.Bitmap($loadedImage)
+        $loadedImage.Dispose()
+        $imageStream.Dispose()
+    }
+    catch {
+        Invoke-Item -LiteralPath $fullPath
+        continue
+    }
+
+    $workingArea = [System.Windows.Forms.Screen]::PrimaryScreen.WorkingArea
+    $maximumWidth = $workingArea.Width - $screenMargin
+    $maximumHeight = $workingArea.Height - $screenMargin
+    $scale = [Math]::Min(1.0, [Math]::Min($maximumWidth / $image.Width, $maximumHeight / $image.Height))
+
+    $pictureBox = New-Object System.Windows.Forms.PictureBox
+    $pictureBox.Dock = [System.Windows.Forms.DockStyle]::Fill
+    $pictureBox.Image = $image
+
+    if ($scale -lt 1.0) {
+        $pictureBox.SizeMode = [System.Windows.Forms.PictureBoxSizeMode]::Zoom
+        $clientWidth = [int][Math]::Round($image.Width * $scale)
+        $clientHeight = [int][Math]::Round($image.Height * $scale)
+    }
+    else {
+        $pictureBox.SizeMode = [System.Windows.Forms.PictureBoxSizeMode]::CenterImage
+        $clientWidth = [Math]::Max($minimumClientWidth, $image.Width)
+        $clientHeight = [Math]::Max($minimumClientHeight, $image.Height)
+    }
+
+    $form = New-Object System.Windows.Forms.Form
+    $form.Text = [System.IO.Path]::GetFileName($fullPath)
+    $form.AutoScaleMode = [System.Windows.Forms.AutoScaleMode]::None
+    $form.StartPosition = [System.Windows.Forms.FormStartPosition]::CenterScreen
+    $form.ClientSize = New-Object System.Drawing.Size($clientWidth, $clientHeight)
+    $form.KeyPreview = $true
+    $form.BackColor = [System.Drawing.Color]::FromArgb(24, 24, 24)
+    $form.Controls.Add($pictureBox)
+
+    $form.Add_KeyDown({
+            param($sender, $eventArguments)
+            if ($eventArguments.KeyCode -eq [System.Windows.Forms.Keys]::Escape) { $sender.Close() }
+        })
+    $form.Add_FormClosed({
+            $script:openWindowCount--
+            if ($script:openWindowCount -le 0) { [System.Windows.Forms.Application]::Exit() }
+        })
+
+    $openWindowCount++
+    $form.Show()
+}
+
+if ($openWindowCount -gt 0) {
+    [System.Windows.Forms.Application]::Run()
+}

package/scripts/test_validate_instruction_pairs.py

@@ -100,21 +100,48 @@ def test_untracked_import_fails_tracking_check(tmp_path: Path) -> None:
     assert any("Git mode 100644" in each_error for each_error in all_errors)
 
 
-def test_pull_request_trigger_is_unconditional() -> None:
+def test_pull_request_target_trigger_is_unconditional() -> None:
     workflow_text = read_workflow("validate-instruction-pairs.yml")
 
-    assert "  pull_request:\n  push:\n" in workflow_text
+    assert "  pull_request:\n  pull_request_target:\n  push:\n" in workflow_text
 
 
 def test_instruction_pairs_status_context_stays_exact() -> None:
     workflow_text = read_workflow("validate-instruction-pairs.yml")
     reusable_workflow_text = read_workflow("instruction-pairs-reusable.yml")
+    caller_job_body = workflow_text.split("  instruction-pairs:\n", 1)[1]
+    caller_job_before_uses = caller_job_body.split("uses:", 1)[0]
 
     assert (
         "  instruction-pairs:\n"
         "    uses: ./.github/workflows/instruction-pairs-reusable.yml\n"
         "    with:\n"
-        "      validator-ref: ${{ github.event.pull_request.head.sha || github.sha }}\n"
         in workflow_text
     )
+    assert "      validator-ref: ${{ github.sha }}\n" in workflow_text
+    assert (
+        "      checkout-ref: ${{ github.event.pull_request.head.sha || github.sha }}\n"
+        in workflow_text
+    )
+    assert "if:" not in caller_job_before_uses
     assert "  instruction-pairs:\n    name: instruction-pairs\n" in reusable_workflow_text
+
+
+def test_release_please_short_circuit_exists_in_workflow() -> None:
+    workflow_text = read_workflow("validate-instruction-pairs.yml")
+    reusable_workflow_text = read_workflow("instruction-pairs-reusable.yml")
+
+    assert "skip-validation:" in reusable_workflow_text
+    assert "type: boolean" in reusable_workflow_text
+    assert "default: false" in reusable_workflow_text
+    assert "if: ${{ inputs.skip-validation }}" in reusable_workflow_text
+    assert "if: ${{ !inputs.skip-validation }}" in reusable_workflow_text
+    assert (
+        "Skipping instruction-pairs tree validation for a release-please pull request."
+        in reusable_workflow_text
+    )
+    assert "ref: ${{ inputs.checkout-ref }}" in reusable_workflow_text
+    assert "release-please--" in workflow_text
+    assert "chore(.*): release " in workflow_text
+    assert "autorelease: pending" in workflow_text
+    assert "skip-validation:" in workflow_text

package/scripts/tests/test_engine.py

@@ -71,8 +71,8 @@ def test_explicit_roots_write_stem_named_mdc(
     cursor = tmp_path / "cursor-home"
     _write_minimal_curated_rules(claude / "rules")
     _write_minimal_docs(claude / "docs")
-    (claude / "rules" / "plain-language.md").write_text(
-        "# Plain language\n\nUse short sentences.\n",
+    (claude / "rules" / "asd-ste100-language.md").write_text(
+        "# ASD-STE100 Language Policy\n\nUse short sentences.\n",
         encoding="utf-8",
     )
     (claude / "rules" / "CLAUDE.md").write_text("# Inventory\n", encoding="utf-8")
@@ -90,8 +90,8 @@ def test_explicit_roots_write_stem_named_mdc(
         )
         == 0
     )
-    generated = (cursor / "rules" / "plain-language.mdc").read_text(encoding="utf-8")
-    assert 'description: "Plain language"' in generated
+    generated = (cursor / "rules" / "asd-ste100-language.mdc").read_text(encoding="utf-8")
+    assert 'description: "ASD-STE100 Language Policy"' in generated
     assert "alwaysApply: true" in generated
     assert "Use short sentences." in generated
     assert not (cursor / "rules" / "CLAUDE.mdc").is_file()

package/scripts/tests/test_rules.py

@@ -40,8 +40,8 @@ def test_build_mappings_emits_stem_mdc_for_remaining_claude_rules(
     claude = tmp_path / ".claude"
     _write_minimal_curated_rules(claude / "rules")
     (claude / "docs").mkdir(parents=True, exist_ok=True)
-    (claude / "rules" / "plain-language.md").write_text(
-        "# Plain language\n\nBe brief.\n",
+    (claude / "rules" / "asd-ste100-language.md").write_text(
+        "# ASD-STE100 Language Policy\n\nBe brief.\n",
         encoding="utf-8",
     )
     (claude / "rules" / "CLAUDE.md").write_text(
@@ -50,10 +50,10 @@ def test_build_mappings_emits_stem_mdc_for_remaining_claude_rules(
     (claude / "rules" / "AGENTS.md").write_text("# Agent inventory\n", encoding="utf-8")
     mappings = build_mappings(claude)
     output_by_key = {each_mapping.key: each_mapping for each_mapping in mappings}
-    discovered = output_by_key["plain-language"]
-    assert discovered.output_name == "plain-language.mdc"
+    discovered = output_by_key["asd-ste100-language"]
+    assert discovered.output_name == "asd-ste100-language.mdc"
     assert discovered.always_apply is True
-    assert discovered.description == "Plain language"
+    assert discovered.description == "ASD-STE100 Language Policy"
     assert "CLAUDE.md" not in {
         each_source.name
         for each_mapping in mappings

package/system-prompts/AGENTS.md

@@ -2,6 +2,14 @@
 
 System-prompt reference files installed into `~/.claude/system-prompts/` by `bin/install.mjs`. Rules and skills pull a file (or one of its sections) into context on demand by citing its installed path.
 
+Use `~/.claude/rules/asd-ste100-language.md` for user-facing word choice,
+sentence style, tone, punctuation, and prose form. Each prompt keeps its
+role-specific behavior contract.
+
+ELI5 owns the global beginner presentation envelope: large visuals, minimal
+text, one stable self-contained HTML artifact, update-in-place continuity, and
+sharing.
+
 ## Files
 
 | File | Purpose |