| name | Change Management |
| description | Automate CHANGELOG maintenance and stakeholder communication for brand strategy changes. This skill should be used when updating strategy documents to ensure proper documentation and change tracking. |
Change Management
Purpose
Manage changes to brand strategy documents by automating CHANGELOG maintenance and ensuring stakeholders are informed of updates. This skill handles the documentation workflow for strategy evolution, maintaining audit trails and facilitating communication.
When to Use This Skill
Use this skill when:
- Updating strategy documents (
STRATEGY.mdfiles in/brand/strategy/domains) - Needing to document strategy changes for stakeholder communication
- Migrating historical changes to CHANGELOG format
- Ensuring proper audit trails for strategy evolution
Instructions
Available Workflows
- Update CHANGELOG - Analyze strategy changes and update CHANGELOG entries
- Migrate CHANGELOG - Backfill historical CHANGELOG entries from git history
Key Principles
Follow these principles when managing changes:
- One entry per PR - Consolidate all changes in a pull request into a single CHANGELOG entry
- Smart detection - Only update CHANGELOG if existing entries don't adequately reflect the changes
- Stakeholder-focused - Write for Marketing Architects, not developers; focus on "why it matters"
- Evidence-based - Reference research that informed changes when applicable
- Progressive disclosure - Link to detailed research rather than duplicating content
CHANGELOG Format
All CHANGELOG entries must follow this structure:
## [YYYY-MM-DD] - Brief descriptive title
**Type:** Created | Updated | Refined
**PR:** #{number} (if applicable)
**Changes:**
- Specific change 1 (what was added/modified/removed)
- Specific change 2
- Specific change 3
**Why it matters:**
1-2 sentences explaining impact on content creation, positioning, or messaging.
**Research trigger:** (optional)
Reference to research that prompted this change, if applicable.
Example: [Customer insights research](/brand/research/customer-insights/RESEARCH.md)
Tone Guidelines
When writing CHANGELOG entries:
- Clear and direct - No marketing fluff or unnecessary jargon
- Impact-focused - Explain practical implications, not just technical changes
- Respectful - Marketing Architects value intellectual rigor; avoid patronizing language
- Professional - Maintain consistency with brand voice (see
/brand/strategy/voice/STRATEGY.md)
Domain Context
Strategy domains this skill manages:
/brand/strategy/voice/- Brand voice and tone guidelines/brand/strategy/messaging/- Messaging themes and narratives/brand/strategy/positioning/- Market positioning and differentiation/brand/strategy/audience/- Target audience profiles and insights/brand/strategy/brand-fundamentals/- Core brand identity and values
For each domain, load the current STRATEGY.md to understand context before generating CHANGELOG entries.