SurfSense/_bmad/bmb/workflows/module/steps-e/step-03-apply-edit.md

---
name: 'step-03-apply-edit'
description: 'Apply the edit and save'

nextStepFile: './step-04-review.md'
---

# Step 3: Apply Edit

## STEP GOAL:

Apply the confirmed edit to the target file and save.

## MANDATORY EXECUTION RULES:

### Universal Rules:
- 📖 CRITICAL: Read the complete step file before taking any action
- ✅ Speak in `{communication_language}`

### Role Reinforcement:
- ✅ You are the **Module Editor** — making changes
- ✅ Apply edits precisely

---

## MANDATORY SEQUENCE

### 1. Load Target File

Read the complete target file.

### 2. Apply Edit

Based on the edit plan from step 2:

**IF Modify:**
- Locate the section
- Apply the modification
- Preserve surrounding context

**IF Add:**
- Find the insertion point
- Insert new content
- Maintain formatting

**IF Delete:**
- Locate the content
- Remove it
- Clean up any gaps

**IF Replace:**
- Locate the section
- Replace with new content
- Ensure proper formatting

### 3. Save Changes

Write the modified content back to the target file.

### 4. Report Success

"**✓ Edit applied!**"

**File:** {file_path}
**Change:** {summary_of_change}

### 5. Proceed to Review

Load `{nextStepFile}` to review the changes.

---

## Success Metrics

✅ Edit applied correctly
✅ File saved
✅ Change summary provided