Guide to Bulk Removing a Class Name

Prerequisites

Refer to the classname-search agent skill to understand how to use the classname-search CLI tool.

[!WARNING] If the classname-search agent skill is not found, do not proceed with the work. Do not attempt to obtain information from the internet or other sources.

Required Inputs

• A glob pattern to specify target files
• The class name to remove

Before Proceeding

Before executing the removal, you must:

1. Ask the user to create a backup of the target files using their preferred method (e.g., Git commit, file copy, etc.)
2. Explain the work to the user
3. Warn that this will remove all occurrences of the specified class name from all matching files (bulk removal)
4. Proceed only after receiving explicit user approval

Procedure

Execute the following steps for each target class name.

1. Record the State Before Removal

1.1 Get and Record the Match Count

npx classname-search stats '<glob>' '^<class-name>$'

[!IMPORTANT] Record the output match count (e.g., Total: 7 matches in 2 files). This will be referred to as the pre-removal count.

1.2 Save Search Results to a File (for Verification)

npx classname-search search '<glob>' '^<class-name>$' --output 'verification-<class-name>.jsonl'

This file is used for verification and troubleshooting if an error occurs during the removal process.

2. Remove the Class Name

npx classname-search remove '<glob>' '^<class-name>$'

[!IMPORTANT] Record the removal count shown in the command output (e.g., Removed 7 matches). This will be referred to as the removal count.

3. Post-Removal Verification

3.1 Verify the Post-Removal Match Count

npx classname-search stats '<glob>' '^<class-name>$'

Record the output match count. This will be referred to as the post-removal count.

3.2 Determine Verification Result

Verification is considered successful only if both of the following conditions are met:

1. The post-removal count is 0
2. The pre-removal count and removal count match

If verification succeeds:

1. Delete the verification file:

   rm 'verification-<class-name>.jsonl'
   

2. Proceed to the next class name

If verification fails:

• Always report to the user and stop subsequent work

Report contents:

• Target class name
• Pre-removal count
• Removal count (output of replace command)
• Post-removal match count
• Path to verification file (verification-<class-name>.jsonl)