---
actual_hours: null
assignees: []
created_at: '2025-08-22T01:12:08.094941'
dependencies: []
description: "**CRITICAL QA TESTING TASK**\n\nTest the fix for PM customization issue\
  \ where system was incorrectly writing CLAUDE.md files.\n\n## Test Areas\n\n###\
  \ 1. customize-pm Command Testing\n- Run `claude-mpm customize-pm --level user`\
  \ and verify creates `~/.claude-mpm/INSTRUCTIONS.md` (NOT CLAUDE.md)\n- Run `claude-mpm\
  \ customize-pm --level project` and verify creates `./.claude-mpm/INSTRUCTIONS.md`\
  \ (NOT CLAUDE.md)  \n- Verify NO CLAUDE.md files are created anywhere during these\
  \ operations\n- Test help text shows correct file paths (.claude-mpm/INSTRUCTIONS.md)\n\
  \n### 2. Framework Loader Testing  \n- Verify framework loader loads custom INSTRUCTIONS.md\
  \ from .claude-mpm/ directories\n- Test precedence: project-level should override\
  \ user-level\n- Ensure custom instructions properly integrate with PM behavior\n\
  - Verify no references to CLAUDE.md loading in framework code\n\n### 3. Regression\
  \ Testing\n- Ensure existing PM functionality still works correctly\n- Verify no\
  \ remaining references to CLAUDE.md generation in codebase\n- Test that PM agent\
  \ behavior is properly customized when using custom INSTRUCTIONS.md\n\n### 4. Edge\
  \ Cases\n- Test with existing .claude-mpm/INSTRUCTIONS.md files (should handle gracefully)\n\
  - Test backup functionality when overwriting existing files\n- Test with missing\
  \ .claude-mpm directories (should create them)\n- Test file permissions and error\
  \ handling\n\n## Available Resources\n- There's a test script at `scripts/test_customize_pm_fix.py`\
  \ that may be helpful\n- PM customization docs at `docs/PM_CUSTOMIZATION.md`\n-\
  \ Agent manager implementation in `src/claude_mpm/cli/commands/agent_manager.py`\n\
  \n## Success Criteria\n- ✅ customize-pm command creates .claude-mpm/INSTRUCTIONS.md\
  \ files only\n- ✅ NO CLAUDE.md files created anywhere  \n- ✅ Framework loader properly\
  \ loads custom instructions\n- ✅ All existing PM functionality works\n- ✅ Edge cases\
  \ handled properly\n- ✅ Help text and documentation accurate\n\n## Deliverable\n\
  Comprehensive test report confirming the fix works correctly and no CLAUDE.md files\
  \ are being generated.\n\n**Priority: CRITICAL** - This is a core framework fix\
  \ that needs thorough validation."
due_date: null
estimated_hours: null
id: TSK-0168
labels: []
metadata: {}
parent: null
priority: critical
status: open
tags:
- qa
- pm-customization
- claude-md-fix
- regression-test
title: 'QA: Test PM Customization Fix - No CLAUDE.md Generation'
updated_at: '2025-08-22T01:12:08.094941'
---

# QA: Test PM Customization Fix - No CLAUDE.md Generation

## Description
**CRITICAL QA TESTING TASK**

Test the fix for PM customization issue where system was incorrectly writing CLAUDE.md files.

## Test Areas

### 1. customize-pm Command Testing
- Run `claude-mpm customize-pm --level user` and verify creates `~/.claude-mpm/INSTRUCTIONS.md` (NOT CLAUDE.md)
- Run `claude-mpm customize-pm --level project` and verify creates `./.claude-mpm/INSTRUCTIONS.md` (NOT CLAUDE.md)  
- Verify NO CLAUDE.md files are created anywhere during these operations
- Test help text shows correct file paths (.claude-mpm/INSTRUCTIONS.md)

### 2. Framework Loader Testing  
- Verify framework loader loads custom INSTRUCTIONS.md from .claude-mpm/ directories
- Test precedence: project-level should override user-level
- Ensure custom instructions properly integrate with PM behavior
- Verify no references to CLAUDE.md loading in framework code

### 3. Regression Testing
- Ensure existing PM functionality still works correctly
- Verify no remaining references to CLAUDE.md generation in codebase
- Test that PM agent behavior is properly customized when using custom INSTRUCTIONS.md

### 4. Edge Cases
- Test with existing .claude-mpm/INSTRUCTIONS.md files (should handle gracefully)
- Test backup functionality when overwriting existing files
- Test with missing .claude-mpm directories (should create them)
- Test file permissions and error handling

## Available Resources
- There's a test script at `scripts/test_customize_pm_fix.py` that may be helpful
- PM customization docs at `docs/PM_CUSTOMIZATION.md`
- Agent manager implementation in `src/claude_mpm/cli/commands/agent_manager.py`

## Success Criteria
- ✅ customize-pm command creates .claude-mpm/INSTRUCTIONS.md files only
- ✅ NO CLAUDE.md files created anywhere  
- ✅ Framework loader properly loads custom instructions
- ✅ All existing PM functionality works
- ✅ Edge cases handled properly
- ✅ Help text and documentation accurate

## Deliverable
Comprehensive test report confirming the fix works correctly and no CLAUDE.md files are being generated.

**Priority: CRITICAL** - This is a core framework fix that needs thorough validation.

## Details
- **Status**: open
- **Priority**: critical
- **Assignees**: None
- **Tags**: qa, pm-customization, claude-md-fix, regression-test
- **Created**: 2025-08-22 01:12:08
- **Updated**: 2025-08-22 01:12:08

## Tasks
- [ ] Add task items here

## Notes
_Add any additional notes or context here._
