autodoc-agent-kit 1.0.0

package/src/modules/product/skills/eol-message/SKILL.md

@@ -0,0 +1,348 @@
+---
+name: eol-message
+description: Write a clear, empathetic EOL announcement with rationale, customer impact, and next steps. Use when retiring a product, feature, or plan without creating avoidable confusion.
+intent: >-
+  Craft a clear, empathetic End-of-Life (EOL) message that communicates product or feature discontinuation, explains the rationale, addresses customer impact, provides transition support, and positions the replacement solution. Use this to maintain customer trust during difficult transitions and reduce churn by demonstrating care and offering a clear path forward.
+type: component
+---
+
+
+## Purpose
+Craft a clear, empathetic End-of-Life (EOL) message that communicates product or feature discontinuation, explains the rationale, addresses customer impact, provides transition support, and positions the replacement solution. Use this to maintain customer trust during difficult transitions and reduce churn by demonstrating care and offering a clear path forward.
+
+This is not a generic sunset announcement—it's a customer-centric communication that acknowledges loss while framing the change as progress.
+
+## Key Concepts
+
+### The EOL Messaging Framework
+An effective EOL message balances honesty about the change with empathy for customer impact. It includes:
+
+1. **Company context:** Who you are and your commitment to customers
+2. **The announcement:** What's being discontinued and what's replacing it
+3. **The rationale:** Why this decision benefits customers (not just the business)
+4. **Current product context:** What the product was and who it served
+5. **Customer impact:** How this affects users (acknowledge the disruption)
+6. **Transition solution:** What the replacement is and how it improves on the old
+7. **Support measures:** How you'll help customers migrate
+8. **Timeline:** Key dates and milestones
+9. **Call to action:** Next steps and contact info
+
+### Why This Works
+- **Empathy-first:** Acknowledges customer disruption before justifying the decision
+- **Clarity:** No ambiguity about what's changing and when
+- **Support-focused:** Shows you're not abandoning customers mid-transition
+- **Future-oriented:** Frames change as progress, not loss
+
+### Anti-Patterns (What This Is NOT)
+- **Not a terse shutdown notice:** "We're discontinuing Product X. Goodbye."
+- **Not business-centric:** Don't lead with "This reduces our costs"
+- **Not vague:** "Soon" is not a timeline
+- **Not defensive:** Don't blame customers ("low usage forced us to shut down")
+
+### When to Use This
+- Discontinuing a product, feature, or service
+- Migrating customers from legacy to new platform
+- Sunsetting an acquisition target's product
+- Deprecating a technology stack or API
+
+### When NOT to Use This
+- For minor feature tweaks (don't over-communicate small changes)
+- Before you have a transition plan (communicate *after* you know how you'll support customers)
+- If you're secretly hoping customers won't notice (be transparent)
+
+---
+
+## Application
+
+Use `template.md` for the full fill-in structure.
+
+### Step 1: Gather Context
+Before drafting, ensure you have:
+- **Product being discontinued:** What specifically is ending?
+- **Replacement solution:** What's replacing it (if anything)?
+- **Timeline:** Key dates (announcement, feature freeze, shutdown, data export deadline)
+- **Customer impact:** How many users affected? What workflows disrupted?
+- **Support plan:** Migration support, training, discounts, data export tools
+- **Rationale:** Why is this happening? (Technology obsolescence, strategic shift, consolidation, etc.)
+
+**If missing context:** Don't send the message until you have a complete transition plan. Customers will ask "What do I do now?"—you must have an answer.
+
+---
+
+### Step 2: Draft the Product Transition Narrative
+
+#### Company Context
+Establish who you are and your commitment:
+
+```markdown
+### Product Transition Narrative
+
+**We are:** [Describe the company and its relationship to the product being phased out]
+- [Key point about company's commitment to customers]
+- [Key point about company's product evolution]
+- [Key point about company's future vision]
+```
+
+**Example:**
+```markdown
+**We are:** Acme Workflows, a workflow automation platform serving 50,000 small businesses
+- We're committed to helping you save time and focus on what matters
+- We continuously evolve our product based on your feedback and technological advances
+- We're building toward a future where automation is accessible, powerful, and simple
+```
+
+---
+
+#### The Announcement
+Be clear and direct:
+
+```markdown
+**Announcing:**
+- [Single sentence that clearly states the EOL of the product and introduces its replacement]
+```
+
+**Example:**
+- "We are discontinuing Acme Workflows Classic on December 31, 2026, and migrating all customers to Acme Workflows Pro."
+
+---
+
+#### The Rationale (Customer-Benefit-Focused)
+Explain *why* this benefits customers:
+
+```markdown
+**Because:**
+- [Reason 1: e.g., technological advancements]
+- [Reason 2: e.g., improved performance]
+- [Reason 3: e.g., better alignment with customer needs]
+
+**Which means for you:**
+- [Describe the impact and benefits from the customer's perspective]
+```
+
+**Example:**
+```markdown
+**Because:**
+- Acme Workflows Classic runs on outdated infrastructure that limits performance and scalability
+- Acme Workflows Pro is built on modern technology that enables faster automation, better integrations, and real-time collaboration
+- Consolidating to one platform allows us to invest 100% of our engineering resources in features you've requested
+
+**Which means for you:**
+- Faster automation execution (3x speed improvement)
+- 50+ new integrations with tools you already use
+- Access to new features like real-time collaboration and mobile app
+```
+
+---
+
+### Step 3: Provide Current Product Context
+
+Acknowledge what's being lost:
+
+```markdown
+### Current Product Context
+
+**Our product** [name of the product being discontinued]
+- **is a** [brief description of the product and its primary function]
+- **that has served** [target customer/user] for [duration or timeframe]
+- **by providing** [key benefits or solutions the product offered]
+```
+
+**Example:**
+```markdown
+**Our product** Acme Workflows Classic
+- **is a** workflow automation tool that helps small businesses eliminate repetitive tasks
+- **that has served** over 20,000 customers for 8 years
+- **by providing** reliable, straightforward automation without requiring technical expertise
+```
+
+---
+
+### Step 4: Acknowledge Customer Impact
+
+Be honest about disruption:
+
+```markdown
+### Customer Impact
+
+**We understand that this may affect you by:**
+- [Potential impact 1 on customer operations or processes]
+- [Potential impact 2 on customer operations or processes]
+- [Potential impact 3 on customer operations or processes (if applicable)]
+```
+
+**Example:**
+```markdown
+**We understand that this may affect you by:**
+- Requiring time to migrate workflows from Classic to Pro
+- Learning new features and interface changes
+- Updating integrations or API connections if you've customized workflows
+```
+
+---
+
+### Step 5: Present the Transition Solution
+
+Use positioning statement format (reference `skills/positioning-statement/SKILL.md`):
+
+```markdown
+### Transition Solution
+
+**For** [target customer/user affected by the EOL]
+- **that currently use** [name of the product being phased out]
+- [name of the replacement product]
+- **is a** [definition of the replacement product category]
+- **that** [statement of benefit to the user, focusing on continuity and improvements]
+
+### Differentiation and Continuity
+
+- **Like** [product being phased out],
+- [name of the replacement product]
+- **provides** [how the replacement maintains key benefits of the old product]
+- **while also offering** [new benefits or improvements]
+```
+
+**Example:**
+```markdown
+### Transition Solution
+
+**For** small business owners
+- **that currently use** Acme Workflows Classic
+- Acme Workflows Pro
+- **is a** next-generation workflow automation platform
+- **that** maintains all the simplicity and reliability you love while adding 3x faster performance, 50+ new integrations, and real-time collaboration
+
+### Differentiation and Continuity
+
+- **Like** Acme Workflows Classic,
+- Acme Workflows Pro
+- **provides** easy-to-build automations without coding, reliable execution, and straightforward pricing
+- **while also offering** 3x faster workflows, mobile app access, real-time team collaboration, and integrations with tools like Slack, Asana, and Notion
+```
+
+---
+
+### Step 6: Outline Support Measures and Timeline
+
+#### Support Measures
+
+```markdown
+### Support and Next Steps
+
+**To ensure a smooth transition, we will:**
+- [Support measure 1, e.g., "Provide 1-on-1 migration assistance for all customers"]
+- [Support measure 2, e.g., "Automatically migrate your workflows (with your approval)"]
+- [Support measure 3, e.g., "Offer a 3-month discount on Acme Workflows Pro for existing customers"]
+```
+
+---
+
+#### Timeline
+
+```markdown
+### Timeline
+
+- [Key date 1 and associated milestone, e.g., "March 1, 2026: Migration tool available"]
+- [Key date 2 and associated milestone, e.g., "September 1, 2026: Acme Workflows Classic becomes read-only"]
+- [Key date 3 and associated milestone, e.g., "December 31, 2026: Acme Workflows Classic fully discontinued, data export deadline"]
+```
+
+**Quality checks:**
+- **Sufficient lead time:** Customers need time to plan (6-12 months is typical)
+- **Clear milestones:** When does functionality freeze? When does shutdown happen?
+- **Data export deadline:** When do they lose access to their data?
+
+---
+
+### Step 7: Provide Clear Next Steps
+
+```markdown
+### Call to Action
+
+- [Clear next steps for customers, e.g., "Log in to your account to start the migration wizard"]
+- [Contact information for questions or assistance, e.g., "Contact our support team at support@acme.com or call 1-800-ACME-HELP"]
+```
+
+---
+
+## Examples
+
+See `examples/sample.md` for a full EOL message example.
+
+Mini example excerpt:
+
+```markdown
+**Announcing:** We are discontinuing Acme Classic on Dec 31, 2026
+**Because:** Legacy infrastructure limits performance
+**Which means for you:** Faster automation + new integrations
+```
+
+## Common Pitfalls
+
+### Pitfall 1: Business-Centric Rationale
+**Symptom:** "We're discontinuing Product X to reduce costs and consolidate our portfolio."
+
+**Consequence:** Customers feel like collateral damage in a business decision.
+
+**Fix:** Frame rationale around customer benefits: "We're consolidating to Product Y so we can invest 100% of resources in features you've requested."
+
+---
+
+### Pitfall 2: Vague Timeline
+**Symptom:** "Product X will be discontinued soon."
+
+**Consequence:** Customers can't plan. Anxiety and churn increase.
+
+**Fix:** Provide specific dates: "March 1: Migration tool available. December 31: Full shutdown."
+
+---
+
+### Pitfall 3: No Support Plan
+**Symptom:** "You'll need to migrate to Product Y. Good luck!"
+
+**Consequence:** Customers feel abandoned. High churn risk.
+
+**Fix:** Offer migration support: "1-on-1 assistance, auto-migration tool, 3-month discount, training resources."
+
+---
+
+### Pitfall 4: Ignoring Customer Impact
+**Symptom:** Message jumps from announcement to "Here's the new product!"
+
+**Consequence:** Customers feel their concerns aren't acknowledged.
+
+**Fix:** Explicitly acknowledge impact: "We understand this requires time to migrate and learn new features."
+
+---
+
+### Pitfall 5: Terse or Defensive Tone
+**Symptom:** "Due to low usage, we're shutting down Product X."
+
+**Consequence:** Sounds like you're blaming customers.
+
+**Fix:** Be empathetic and forward-looking: "We're consolidating to focus on the future of automation."
+
+---
+
+## References
+
+### Related Skills
+- `skills/positioning-statement/SKILL.md` — Informs the transition solution positioning
+- `skills/problem-statement/SKILL.md` — Helps frame the customer impact section
+- `skills/proto-persona/SKILL.md` — Defines affected customers
+
+### External Frameworks
+- Crisis communication best practices — Transparency, empathy, action
+- Customer success playbooks — Retention during product transitions
+
+### Dean's Work
+- EOL Messaging Template (created for product lifecycle management)
+
+### Provenance
+- Adapted from `prompts/eol-for-a-product-message.md` in the `https://github.com/deanpeters/product-manager-prompts` repo.
+
+---
+
+**Skill type:** Component
+**Suggested filename:** `eol-message.md`
+**Suggested placement:** `/skills/components/`
+**Dependencies:** References `skills/positioning-statement/SKILL.md`, `skills/problem-statement/SKILL.md`, `skills/proto-persona/SKILL.md`

package/src/modules/product/skills/eol-message/examples/sample.md

@@ -0,0 +1,87 @@
+# EOL Message Examples
+
+### Example 1: Good EOL Message (Workflow Automation Product)
+
+```markdown
+## End-of-Life Announcement: Acme Workflows Classic
+
+### Product Transition Narrative
+
+**We are:** Acme Workflows, a workflow automation platform serving 50,000 small businesses
+- We're committed to helping you save time and focus on what matters
+- We continuously evolve our product based on your feedback and technological advances
+- We're building toward a future where automation is accessible, powerful, and simple
+
+**Announcing:**
+- We are discontinuing Acme Workflows Classic on December 31, 2026, and migrating all customers to Acme Workflows Pro.
+
+**Because:**
+- Acme Workflows Classic runs on outdated infrastructure that limits performance and scalability
+- Acme Workflows Pro is built on modern technology that enables 3x faster automation, better integrations, and real-time collaboration
+- Consolidating to one platform allows us to invest 100% of our engineering resources in features you've requested
+
+**Which means for you:**
+- 3x faster automation execution
+- 50+ new integrations (Slack, Asana, Notion, and more)
+- Access to new features like real-time collaboration and mobile app
+- Continued reliability and simplicity you expect from Acme
+
+### Current Product Context
+
+**Our product** Acme Workflows Classic
+- **is a** workflow automation tool that helps small businesses eliminate repetitive tasks
+- **that has served** over 20,000 customers for 8 years
+- **by providing** reliable, straightforward automation without requiring technical expertise
+
+### Customer Impact
+
+**We understand that this may affect you by:**
+- Requiring time to migrate workflows from Classic to Pro (estimated 1-2 hours for most customers)
+- Learning new features and interface changes
+- Updating API connections if you've customized workflows
+
+### Transition Solution
+
+**For** small business owners
+- **that currently use** Acme Workflows Classic
+- Acme Workflows Pro
+- **is a** next-generation workflow automation platform
+- **that** maintains all the simplicity and reliability you love while adding 3x faster performance, 50+ new integrations, and real-time collaboration
+
+### Differentiation and Continuity
+
+- **Like** Acme Workflows Classic,
+- Acme Workflows Pro
+- **provides** easy-to-build automations without coding, reliable execution, and straightforward pricing
+- **while also offering** 3x faster workflows, mobile app access, real-time team collaboration, and integrations with Slack, Asana, and Notion
+
+### Support and Next Steps
+
+**To ensure a smooth transition, we will:**
+- Provide 1-on-1 migration assistance for all customers (schedule via support portal)
+- Automatically migrate your workflows with your approval (no manual rebuild needed)
+- Offer a 3-month 20% discount on Acme Workflows Pro for existing Classic customers
+- Maintain full access to Acme Workflows Classic until December 31, 2026 (no disruption during transition)
+
+### Timeline
+
+- **March 1, 2026:** Migration tool available; begin migrating at your convenience
+- **September 1, 2026:** Acme Workflows Classic becomes read-only (no new workflows, existing workflows still run)
+- **December 31, 2026:** Acme Workflows Classic fully discontinued; data export must be completed by this date
+
+### Call to Action
+
+- Log in to your account at acme.com/migrate to start the migration wizard
+- Schedule 1-on-1 migration support at acme.com/support
+- Contact our support team with questions: support@acme.com or 1-800-ACME-HELP
+```
+
+**Why this works:**
+- Empathy-first (acknowledges company commitment, then announces change)
+- Rationale is customer-benefit-focused (faster, more integrations, new features)
+- Acknowledges disruption honestly (migration takes time, learning curve)
+- Support measures are generous (1-on-1 help, auto-migration, discount)
+- Timeline is clear and provides ample lead time (9 months)
+- Call to action is specific and easy
+
+---

package/src/modules/product/skills/eol-message/template.md

@@ -0,0 +1,74 @@
+# EOL Message Template
+
+Use this template to craft an end-of-life announcement with empathy and clear transition guidance.
+
+## Provenance
+Adapted from `prompts/eol-for-a-product-message.md` in the `https://github.com/deanpeters/product-manager-prompts` repo.
+
+## Template
+```markdown
+## End-of-Life Announcement: [Product Name]
+
+### Product Transition Narrative
+
+**We are:** [Company and relationship to the product]
+- [Commitment to customers]
+- [Product evolution]
+- [Future vision]
+
+**Announcing:**
+- [Clear EOL statement and replacement]
+
+**Because:**
+- [Reason 1: customer-benefit focused]
+- [Reason 2]
+- [Reason 3]
+
+**Which means for you:**
+- [Customer impact and benefits]
+
+### Current Product Context
+
+**Our product** [name]
+- **is a** [brief description]
+- **that has served** [target customer] for [timeframe]
+- **by providing** [key benefits]
+
+### Customer Impact
+
+**We understand that this may affect you by:**
+- [Impact 1]
+- [Impact 2]
+- [Impact 3]
+
+### Transition Solution
+
+**For** [target customer]
+- **that currently use** [old product]
+- [replacement product]
+- **is a** [category]
+- **that** [benefit focused on continuity and improvements]
+
+### Differentiation and Continuity
+
+- **Like** [old product]
+- [replacement product]
+- **provides** [continuity of key benefits]
+- **while also offering** [new benefits]
+
+### Support and Next Steps
+
+**To ensure a smooth transition, we will:**
+- [Support measure 1]
+- [Support measure 2]
+- [Support measure 3]
+
+### Timeline
+- [Key date 1 + milestone]
+- [Key date 2 + milestone]
+- [Key date 3 + milestone]
+
+### Call to Action
+- [Next steps]
+- [Contact info]
+```