ecw-upgrade

ecw-upgrade is a command for Claude Code from Aimeerrhythm/enterprise-change-workflow. It costs 24 tokens per session (1,991 once invoked), scanned B, original, MIT.

A project configuration update command for Enterprise Change Workflow, a system for managing and reviewing software changes. It compares the project’s settings with the plugin’s current templates and applies missing configuration items.

In plain words
What is it for?
Use it to check and repair ECW configuration files, add missing sections, and validate the updated setup.
Why use it?
It keeps an initialized project’s workflow configuration aligned with newer templates and reports when the required initial setup is missing.

Command for Claude Code

Written for Claude Code: SessionStart hook event. Also seen: reads .claude/ paths; mentions CLAUDE.md; names the AskUserQuestion tool.

Part of the ecw plugin — 15 skills, 3 commands, 7 agents shipped together

Good fit Use it to check and repair ECW configuration files, add missing sections, and validate the updated setup.

Compare 6 commands from other repositories ↓
Install with agentmods
npx agentmods add commands/aimeerrhythm/enterprise-change-workflow/ecw-upgrade
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Clone the repo
git clone --depth 1 https://github.com/Aimeerrhythm/enterprise-change-workflow

Made for: Claude Code.

Or install ecw, the plugin that ships this one along with the rest of its 15 skills, 3 commands, 7 agents.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for ecw-upgrade

README.md
[![agentmods](https://agentmods.dev/badge/commands/aimeerrhythm/enterprise-change-workflow/ecw-upgrade/github.svg)](https://agentmods.dev/commands/aimeerrhythm/enterprise-change-workflow/ecw-upgrade)
Your own site
<a href="https://agentmods.dev/commands/aimeerrhythm/enterprise-change-workflow/ecw-upgrade"><img src="https://agentmods.dev/badge/commands/aimeerrhythm/enterprise-change-workflow/ecw-upgrade/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for ecw-upgrade

Your own site · 80×15
<a href="https://agentmods.dev/commands/aimeerrhythm/enterprise-change-workflow/ecw-upgrade"><img src="https://agentmods.dev/badge/commands/aimeerrhythm/enterprise-change-workflow/ecw-upgrade.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 24 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.
When invoked 1,991 The whole file, excluding the scripts and references it only reads on demand.
Security scan B 1 finding. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00024 $0.01991
Opus 5 $0.00012 $0.00996
Sonnet 5 $0.00005 $0.00398
Haiku 4.5 $0.00002 $0.00199

Measured 8d ago against content hash 6177c6d7ec95, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-08, from the pricing page.

Security

Grade B, and why

ecw-upgrade scanned grade B with 1 finding against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 8d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Reads agent configuration directoriesmediumAgent snooping

.claude/, .codex/, .gemini/ hold keys, settings and other credentials a mod has no legitimate need for.

- Do **not** modify global `~/.claude/settings.json`.
commands/ecw-upgrade.md · 188 lines

How it starts

The opening of the file, as written. The whole thing — 188 lines — stays where its author put it; the contents beside it link to each section on GitHub.

ECW Upgrade — Project Configuration Sync

You are executing the /ecw-upgrade command. Your task is to compare the project's ECW configuration against current plugin templates, fix everything you can, and auto-validate the result.

Important: This command belongs to the enterprise-change-workflow plugin. All templates are in the plugin's templates/ directory. Read them using the Read tool from the plugin installation path (i.e., templates/ under the parent directory containing this commands/ folder).


Step 0: Prerequisite Check

Check if .claude/ecw/ecw.yml exists. If not:

ECW not initialized. Please run /ecw-init first.

Then stop.


Step 1: Run All Idempotent Checks

Read each project config file and compare against the current plugin template. For each check, determine status: ok (matches template structure) or needs-fix (outdated/missing/malformed).

Check A: ecw.yml Structure Sync

Check: Read project .claude/ecw/ecw.yml and plugin templates/ecw.yml. Compare:

  1. Missing sections — If template has a top-level key (e.g., tdd:, paths:, auto_flow:) that project file lacks, inject the section from template with default values.
  2. Missing fields within sections — If template has fields inside a section (e.g., paths.knowledge_root, tdd.enabled) that project file lacks, add them with template defaults.
  3. Unknown fields (info only) — If project file has top-level keys NOT in the template, report them but do NOT remove. User may have intentional custom extensions.
  4. Preserve user values — Never overwrite fields that exist in both template and project; only add missing ones.

For each fix, use Edit tool to surgically add/remove. Do not rewrite the entire file.

Check B: TDD Enabled for Java Projects

Check: Run ls pom.xml 2>/dev/null in project root to detect Java project.

  • pom.xml not found → skip (non-Java project, TDD auto-enable not applicable)
  • pom.xml found → Read project .claude/ecw/ecw.yml, check tdd.enabled:
    • trueok
    • false or field missing → needs-fix: Set tdd.enabled: true using Edit tool

Read the full file on GitHub · 188 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 8d ago First seen · 188 lines · 24 tokens per session scan B 6177c6d7ec95

Subscribe to this mod's changes

ecw-upgrade is a command published in the GitHub repository Aimeerrhythm/enterprise-change-workflow (1 stars, last pushed 3mo ago), licensed MIT. It adds 24 tokens to every session and 1,991 once invoked, about $0.0001 per session on Opus 5. A static security scan graded it B with 1 finding (reads agent configuration directories). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.