Guidelines for thoroughly validating mode changes to ensure cohesion,
consistency, and prevent contradictions across all mode components.
Every change must be reviewed in context of the entire mode
- Read all existing XML instruction files
- Verify new changes align with existing patterns
- Check for duplicate or conflicting instructions
- Ensure terminology is consistent throughout
Use ask_followup_question extensively to clarify ambiguities
User's intent is unclear
Multiple interpretations are possible
Changes might conflict with existing functionality
Impact on other modes needs clarification
I notice this change might affect how the mode interacts with file permissions. Should we also update the file regex patterns to match?
Yes, update the file regex to include the new file types
No, keep the current file restrictions as they are
Let me explain what file types I need to work with
Show me the current file restrictions first
]]>
Actively search for and resolve contradictions
Permission Mismatch
Instructions reference tools the mode doesn't have access to
Either grant the tool permission or update the instructions
Workflow Conflicts
Different XML files describe conflicting workflows
Consolidate workflows and ensure single source of truth
Role Confusion
Mode's roleDefinition doesn't match its actual capabilities
Update roleDefinition to accurately reflect the mode's purpose
Before making any changes
Read and understand all existing mode files
Create a mental model of current mode behavior
Identify potential impact areas
Ask clarifying questions about intended changes
While making changes
Document each change and its rationale
Cross-reference with other files after each change
Verify examples still work with new changes
Update related documentation immediately
After changes are complete
All XML files are well-formed and valid
File naming follows established patterns
Tag names are consistent across files
No orphaned or unused instructions
roleDefinition accurately describes the mode
whenToUse is clear and distinguishable
Tool permissions match instruction requirements
File restrictions align with mode purpose
Examples are accurate and functional
Mode boundaries are well-defined
Handoff points to other modes are clear
No overlap with other modes' responsibilities
Orchestrator can correctly route to this mode
Maintain consistent tone and terminology
Use the same terms for the same concepts throughout
Keep instruction style consistent across files
Maintain the same level of detail in similar sections
Ensure instructions flow logically
Prerequisites come before dependent steps
Complex concepts build on simpler ones
Examples follow the explained patterns
Ensure all aspects are covered without gaps
Every mentioned tool has usage instructions
All workflows have complete examples
Error scenarios are addressed
Before we proceed with changes, I want to ensure I understand the full scope. What is the main goal of these modifications?
Add new functionality while keeping existing features
Fix issues with current implementation
Refactor for better organization
Expand the mode's capabilities into new areas
This change might affect other parts of the mode. How should we handle the impact on [specific area]?
Update all affected areas to maintain consistency
Keep the existing behavior for backward compatibility
Create a migration path from old to new behavior
Let me review the impact first
I've completed the changes and validation. Which aspect would you like me to test more thoroughly?
Test the new workflow end-to-end
Verify file permissions work correctly
Check integration with other modes
Review all changes one more time
Instructions reference tools not in the mode's groups
Either add the tool group or remove the instruction
File regex doesn't match described file types
Update regex pattern to match intended files
Examples don't follow stated best practices
Update examples to demonstrate best practices
Duplicate instructions in different files
Consolidate to single location and reference