pm-claude-skills 61.2.2 → 61.3.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +5 -5
- package/exports/README.md +1 -1
- package/exports/aider/README.md +4 -1
- package/exports/aider/pm-devrel/deprecation-comms-plan/deprecation-comms-plan.md +65 -0
- package/exports/aider/pm-recruiting/reference-check-script/reference-check-script.md +62 -0
- package/exports/aider/pm-social/community-moderation-policy/community-moderation-policy.md +59 -0
- package/exports/chatgpt/README.md +4 -1
- package/exports/chatgpt/pm-devrel/deprecation-comms-plan/SYSTEM_PROMPT.md +65 -0
- package/exports/chatgpt/pm-recruiting/reference-check-script/SYSTEM_PROMPT.md +62 -0
- package/exports/chatgpt/pm-social/community-moderation-policy/SYSTEM_PROMPT.md +59 -0
- package/exports/cline/README.md +4 -1
- package/exports/cline/pm-devrel/deprecation-comms-plan/deprecation-comms-plan.md +65 -0
- package/exports/cline/pm-recruiting/reference-check-script/reference-check-script.md +62 -0
- package/exports/cline/pm-social/community-moderation-policy/community-moderation-policy.md +59 -0
- package/exports/continue/README.md +4 -1
- package/exports/continue/pm-devrel/deprecation-comms-plan/deprecation-comms-plan.md +70 -0
- package/exports/continue/pm-recruiting/reference-check-script/reference-check-script.md +67 -0
- package/exports/continue/pm-social/community-moderation-policy/community-moderation-policy.md +64 -0
- package/exports/cursor/README.md +4 -1
- package/exports/cursor/pm-devrel/deprecation-comms-plan/deprecation-comms-plan.mdc +71 -0
- package/exports/cursor/pm-recruiting/reference-check-script/reference-check-script.mdc +68 -0
- package/exports/cursor/pm-social/community-moderation-policy/community-moderation-policy.mdc +65 -0
- package/exports/gemini/README.md +4 -1
- package/exports/gemini/pm-devrel/deprecation-comms-plan/GEM_INSTRUCTIONS.md +69 -0
- package/exports/gemini/pm-recruiting/reference-check-script/GEM_INSTRUCTIONS.md +66 -0
- package/exports/gemini/pm-social/community-moderation-policy/GEM_INSTRUCTIONS.md +63 -0
- package/exports/kilocode/README.md +4 -1
- package/exports/kilocode/pm-devrel/deprecation-comms-plan/deprecation-comms-plan.md +65 -0
- package/exports/kilocode/pm-recruiting/reference-check-script/reference-check-script.md +62 -0
- package/exports/kilocode/pm-social/community-moderation-policy/community-moderation-policy.md +59 -0
- package/exports/obsidian/README.md +4 -1
- package/exports/obsidian/pm-devrel/deprecation-comms-plan/deprecation-comms-plan.md +80 -0
- package/exports/obsidian/pm-recruiting/reference-check-script/reference-check-script.md +77 -0
- package/exports/obsidian/pm-social/community-moderation-policy/community-moderation-policy.md +74 -0
- package/exports/openclaw/README.md +4 -1
- package/exports/openclaw/community-moderation-policy/SKILL.md +69 -0
- package/exports/openclaw/deprecation-comms-plan/SKILL.md +75 -0
- package/exports/openclaw/reference-check-script/SKILL.md +72 -0
- package/exports/roo/README.md +4 -1
- package/exports/roo/pm-devrel/deprecation-comms-plan/deprecation-comms-plan.md +65 -0
- package/exports/roo/pm-recruiting/reference-check-script/reference-check-script.md +62 -0
- package/exports/roo/pm-social/community-moderation-policy/community-moderation-policy.md +59 -0
- package/exports/windsurf/README.md +4 -1
- package/exports/windsurf/pm-devrel/deprecation-comms-plan/deprecation-comms-plan.md +70 -0
- package/exports/windsurf/pm-recruiting/reference-check-script/reference-check-script.md +67 -0
- package/exports/windsurf/pm-social/community-moderation-policy/community-moderation-policy.md +64 -0
- package/exports/zed/README.md +4 -1
- package/exports/zed/pm-devrel/deprecation-comms-plan/deprecation-comms-plan.md +65 -0
- package/exports/zed/pm-recruiting/reference-check-script/reference-check-script.md +62 -0
- package/exports/zed/pm-social/community-moderation-policy/community-moderation-policy.md +59 -0
- package/package.json +2 -2
- package/skills/community-moderation-policy/SKILL.md +64 -0
- package/skills/deprecation-comms-plan/SKILL.md +70 -0
- package/skills/reference-check-script/SKILL.md +67 -0
- package/web/benchmark.html +1 -1
- package/web/cheatsheet.html +4 -4
- package/web/city.html +1 -1
- package/web/galaxy.html +1 -1
- package/web/galaxy3d.html +2 -2
- package/web/guide.html +5 -5
- package/web/handbook.html +3 -3
- package/web/holo.html +2 -2
- package/web/index.html +3 -3
- package/web/learn.html +1 -1
- package/web/remix.html +1 -1
- package/web/semantic.html +2 -2
- package/web/skills.json +1 -1
- package/web/voice.html +1 -1
package/README.md
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
# 🧠 PM Skills —
|
|
1
|
+
# 🧠 PM Skills — 754 Professional Agent Skills for Claude, ChatGPT, Gemini, Cursor, Codex & Hermes
|
|
2
2
|
|
|
3
3
|
[](#-quick-start)
|
|
4
4
|
[](https://github.com/mohitagw15856/pm-claude-skills/stargazers)
|
|
@@ -12,7 +12,7 @@
|
|
|
12
12
|
[](LICENSE)
|
|
13
13
|
[](https://github.com/sponsors/mohitagw15856)
|
|
14
14
|
|
|
15
|
-
**A library of
|
|
15
|
+
**A library of 754 skills — each one a plain `SKILL.md` file that teaches your AI assistant to do one professional task properly.** Decode a lease before you sign it. Write a PRD your team can execute. Simulate the promotion committee before the real one meets. Check the weather with zero API keys. Generic AI gives you filler; these give you the structure a senior professional actually uses.
|
|
16
16
|
|
|
17
17
|
Works natively in **Claude Code** and **Hermes Agent**, with ready-to-paste exports for **ChatGPT, Gemini, Cursor, Codex** and 8 more tools. *(PM stands for Professional, not just Product Management.)*
|
|
18
18
|
|
|
@@ -30,7 +30,7 @@ No `npm install` needed — `npx pm-claude-skills …` always runs the latest. `
|
|
|
30
30
|
|
|
31
31
|
## 📚 The skills
|
|
32
32
|
|
|
33
|
-
Every skill follows the same discipline: what it produces, the inputs it needs, a real framework (severity scales, decision rules — not vibes), a concrete output template, quality checks, and anti-patterns. All
|
|
33
|
+
Every skill follows the same discipline: what it produces, the inputs it needs, a real framework (severity scales, decision rules — not vibes), a concrete output template, quality checks, and anti-patterns. All 754 pass the [SkillSpec](SKILLSPEC.md) L3 gate and a security audit in CI.
|
|
34
34
|
|
|
35
35
|
### For everyone — life's paperwork and decisions
|
|
36
36
|
|
|
@@ -155,7 +155,7 @@ The whole library on one poster — start path, standout features, and install o
|
|
|
155
155
|
|
|
156
156
|
## 🆕 Latest
|
|
157
157
|
|
|
158
|
-
**v61.
|
|
158
|
+
**v61.3.0 — most-requested:** three skills built straight from the demand queue — **[reference-check-script](skills/reference-check-script/SKILL.md)** (rigorous candidate reference calls with a scoring rubric), **[deprecation-comms-plan](skills/deprecation-comms-plan/SKILL.md)** (the customer-comms program for sunsetting an API/feature), and **[community-moderation-policy](skills/community-moderation-policy/SKILL.md)** (a fair, enforceable moderation policy + enforcement ladder for a user community). *Earlier — v61.2.2:* **[youtube-script](skills/youtube-script/SKILL.md)** (long-form video). *v61.2, the builder's toolkit;* *v61.1, the demand side:* **[find](https://mohitagw15856.github.io/pm-claude-skills/find.html)** (task→skill router) with an honest **measured / no-claim** badge and **[SkillSpec as an adoptable standard](conformance/REGISTRY.md)**. Full history: **[CHANGELOG](CHANGELOG.md)** · [releases](https://github.com/mohitagw15856/pm-claude-skills/releases)
|
|
159
159
|
|
|
160
160
|
## 🤝 Contributing
|
|
161
161
|
|
|
@@ -171,4 +171,4 @@ MIT — use them, fork them, ship them at work. Skills are judgment, and judgmen
|
|
|
171
171
|
|
|
172
172
|
---
|
|
173
173
|
|
|
174
|
-
*Built by [Mohit](https://github.com/mohitagw15856) with Claude.
|
|
174
|
+
*Built by [Mohit](https://github.com/mohitagw15856) with Claude. 754 skills · 90 bundles · 31 professions · every commit gated. The long version of this README — every feature, wave, and frontier bet — lives in the **[Showcase](docs/SHOWCASE.md)**.*
|
package/exports/README.md
CHANGED
|
@@ -8,7 +8,7 @@ by hand; edit the source skill and run:
|
|
|
8
8
|
node scripts/build-exports.mjs
|
|
9
9
|
```
|
|
10
10
|
|
|
11
|
-
Currently exporting **
|
|
11
|
+
Currently exporting **754 skills** to:
|
|
12
12
|
|
|
13
13
|
- **ChatGPT — Custom GPT instructions** → `exports/chatgpt/`
|
|
14
14
|
- **Google Gemini — Gem instructions** → `exports/gemini/`
|
package/exports/aider/README.md
CHANGED
|
@@ -3,7 +3,7 @@
|
|
|
3
3
|
> Auto-generated from `skills/*/SKILL.md` by `scripts/build-exports.mjs`.
|
|
4
4
|
> **Do not edit these files by hand** — edit the source skill and regenerate.
|
|
5
5
|
|
|
6
|
-
|
|
6
|
+
754 skills exported. Copy a `.md rule` into the tool to use it.
|
|
7
7
|
|
|
8
8
|
| Skill | Bundle | Path |
|
|
9
9
|
|---|---|---|
|
|
@@ -126,6 +126,7 @@
|
|
|
126
126
|
| College App Parent Guide | `pm-parents` | `pm-parents/college-app-parent-guide/college-app-parent-guide.md` |
|
|
127
127
|
| College Cost | `pm-calculators` | `pm-calculators/college-cost/college-cost.md` |
|
|
128
128
|
| Community Management Playbook | `pm-social` | `pm-social/community-management-playbook/community-management-playbook.md` |
|
|
129
|
+
| Community Moderation Policy | `pm-social` | `pm-social/community-moderation-policy/community-moderation-policy.md` |
|
|
129
130
|
| Company Brief | `pm-jobsearch` | `pm-jobsearch/company-brief/company-brief.md` |
|
|
130
131
|
| Company Event Ops | `pm-cowork` | `pm-cowork/company-event-ops/company-event-ops.md` |
|
|
131
132
|
| Comparative Market Analysis | `pm-realestate` | `pm-realestate/comparative-market-analysis/comparative-market-analysis.md` |
|
|
@@ -203,6 +204,7 @@
|
|
|
203
204
|
| Demo Script | `pm-cowork` | `pm-cowork/demo-script/demo-script.md` |
|
|
204
205
|
| Dependency Audit | `pm-engineering` | `pm-engineering/dependency-audit/dependency-audit.md` |
|
|
205
206
|
| Dependency Conflict Resolver | `pm-engineering` | `pm-engineering/dependency-conflict-resolver/dependency-conflict-resolver.md` |
|
|
207
|
+
| Deprecation Comms Plan | `pm-devrel` | `pm-devrel/deprecation-comms-plan/deprecation-comms-plan.md` |
|
|
206
208
|
| Design Critique | `pm-design` | `pm-design/design-critique/design-critique.md` |
|
|
207
209
|
| Design Handoff Brief | `pm-advanced` | `pm-advanced/design-handoff-brief/design-handoff-brief.md` |
|
|
208
210
|
| Design System Audit | `pm-design` | `pm-design/design-system-audit/design-system-audit.md` |
|
|
@@ -541,6 +543,7 @@
|
|
|
541
543
|
| Red-Team Review | `pm-cross` | `pm-cross/red-team-review/red-team-review.md` |
|
|
542
544
|
| Redundancy Consultation | `pm-hr` | `pm-hr/redundancy-consultation/redundancy-consultation.md` |
|
|
543
545
|
| Refactoring Plan | `pm-craft` | `pm-craft/refactoring-plan/refactoring-plan.md` |
|
|
546
|
+
| Reference Check Script | `pm-recruiting` | `pm-recruiting/reference-check-script/reference-check-script.md` |
|
|
544
547
|
| Reference Letter | `pm-lifeadmin` | `pm-lifeadmin/reference-letter/reference-letter.md` |
|
|
545
548
|
| Reference Request Kit | `pm-layoff` | `pm-layoff/reference-request-kit/reference-request-kit.md` |
|
|
546
549
|
| Referral Program | `pm-growth` | `pm-growth/referral-program/referral-program.md` |
|
|
@@ -0,0 +1,65 @@
|
|
|
1
|
+
# Deprecation Comms Plan Skill
|
|
2
|
+
|
|
3
|
+
Deprecations go wrong in two ways: too fast (customers get broken and churn angry) or too quiet (they find out when it breaks). This skill plans the wind-down as a *communications program*, not an announcement — enough runway, messaging matched to how much each customer depends on the thing, a real migration path, and a plan for the accounts that will need a human.
|
|
4
|
+
|
|
5
|
+
## Working from a brief
|
|
6
|
+
|
|
7
|
+
Given what's being deprecated and why, **produce the full plan** — infer the risk tiers from usage and contract exposure. Right-size the runway to how hard the migration is (an internal flag flip is weeks; a public API is many months). If there's no migration path yet, flag that as a blocker before any announcement.
|
|
8
|
+
|
|
9
|
+
## Required Inputs
|
|
10
|
+
|
|
11
|
+
Ask for (if not provided, else infer and label the assumption):
|
|
12
|
+
- **What's being deprecated** and **why** (cost, security, strategy, replaced-by)
|
|
13
|
+
- **Who depends on it** — rough usage, and which segments/contracts are exposed
|
|
14
|
+
- **The replacement / migration path** (or that there isn't one yet)
|
|
15
|
+
- **Hard constraints** — a forcing date (security, legal, contract), team capacity
|
|
16
|
+
|
|
17
|
+
## Output Format
|
|
18
|
+
|
|
19
|
+
### Deprecation policy in one line
|
|
20
|
+
The principle you're committing to (e.g. _"announce → N months deprecated (works, warns) → sunset, with a migration path live before we announce"_).
|
|
21
|
+
|
|
22
|
+
### Timeline
|
|
23
|
+
|
|
24
|
+
| Phase | Date / window | What changes | What customers can still do |
|
|
25
|
+
|---|---|---|---|
|
|
26
|
+
| Announce | | nothing breaks; docs + warnings | full use, start migrating |
|
|
27
|
+
| Deprecated | | warnings, no new adoption | migrate |
|
|
28
|
+
| Sunset | | turned off | must have migrated |
|
|
29
|
+
|
|
30
|
+
Include grace periods and any extension policy for large accounts.
|
|
31
|
+
|
|
32
|
+
### Tiered messaging
|
|
33
|
+
Segmented by dependence, not one blast:
|
|
34
|
+
- **Tier 1 — heavy/contractual users:** proactive, human (CSM/AM), often a call + tailored plan.
|
|
35
|
+
- **Tier 2 — active users:** direct email + in-product warning + migration guide.
|
|
36
|
+
- **Tier 3 — light/dormant:** changelog, docs banner, deprecation headers.
|
|
37
|
+
|
|
38
|
+
For each: the core message (what, when, why, what to do), the ask, and the escalation path.
|
|
39
|
+
|
|
40
|
+
### Migration guide outline
|
|
41
|
+
The structure of the how-to: before/after, step-by-step, code/config examples, a mapping table (old → new), FAQ, and where to get help.
|
|
42
|
+
|
|
43
|
+
### Channel plan
|
|
44
|
+
Which channels fire at which phase — email, in-product, docs/changelog, API deprecation headers/`Sunset` header, status page, community/social — and the cadence (announce, reminders at intervals, final notice).
|
|
45
|
+
|
|
46
|
+
### Internal escalation playbook
|
|
47
|
+
The at-risk account list, who owns each, the CSM talking points, the "customer can't migrate in time" decision tree, and the exception/extension approval path.
|
|
48
|
+
|
|
49
|
+
## Quality Checks
|
|
50
|
+
|
|
51
|
+
- [ ] A migration path exists and is referenced everywhere before any customer message goes out
|
|
52
|
+
- [ ] Runway is sized to migration difficulty, with grace periods stated
|
|
53
|
+
- [ ] Messaging is tiered by dependence; Tier-1 accounts get a human, not a blast
|
|
54
|
+
- [ ] Every message says what, when, why, and the exact next step
|
|
55
|
+
- [ ] The channel cadence includes reminders and a final notice, not a single announcement
|
|
56
|
+
- [ ] High-risk accounts have a named owner and an escalation/extension path
|
|
57
|
+
|
|
58
|
+
## Anti-Patterns
|
|
59
|
+
|
|
60
|
+
- Too little runway for the migration actually required
|
|
61
|
+
- A silent breaking change, or burying it in a changelog nobody reads
|
|
62
|
+
- Announcing before the migration path is live
|
|
63
|
+
- One-size messaging that treats a whale like a dormant free user
|
|
64
|
+
- No plan for the accounts that physically can't migrate in time
|
|
65
|
+
- "Why" that blames the customer or the old system instead of owning the change
|
|
@@ -0,0 +1,62 @@
|
|
|
1
|
+
# Reference Check Script Skill
|
|
2
|
+
|
|
3
|
+
A reference check fails when it's a formality — you call, they say "great to work with," you tick the box. This skill writes a call that actually de-risks the hire: questions that make it *safe and easy* for a referee to be honest, follow-ups that open the gap between polite and true, and a rubric that turns what you hear into a defensible signal.
|
|
4
|
+
|
|
5
|
+
## Working from a brief
|
|
6
|
+
|
|
7
|
+
Given the role and what you need to validate, **write the full script** — tailor the questions to the specific concerns (the shaky interview signal, the seniority stretch, the manager-vs-IC question). Default to a ~20–25 minute call structure.
|
|
8
|
+
|
|
9
|
+
## Required Inputs
|
|
10
|
+
|
|
11
|
+
Ask for (if not provided, else infer and label the assumption):
|
|
12
|
+
- **Role** and level, and the **1–3 things to validate or de-risk** (the open questions from interviews)
|
|
13
|
+
- **Referee relationship** to the candidate (former manager / peer / report / client)
|
|
14
|
+
- **Reference type** — candidate-provided or back-channel (changes how candid you probe)
|
|
15
|
+
|
|
16
|
+
## Output Format
|
|
17
|
+
|
|
18
|
+
### Framing (how to open)
|
|
19
|
+
A 2–3 sentence opener that sets candor: confidential, no scripted "sales pitch" needed, you're calibrating not gatekeeping. The single most important move — referees mirror the tone you set.
|
|
20
|
+
|
|
21
|
+
### Question set (in order)
|
|
22
|
+
Grouped, with the *intent* of each noted:
|
|
23
|
+
1. **Relationship & context** — how they worked together, for how long, on what.
|
|
24
|
+
2. **Scope & performance** — what the candidate actually owned; where they ranked among peers.
|
|
25
|
+
3. **Strengths** — with a concrete example ("tell me about a time…").
|
|
26
|
+
4. **Growth areas** — asked as _"where did they most need to grow / what coaching helped?"_ (not "weaknesses").
|
|
27
|
+
5. **Working style** — how they handle conflict, feedback, ambiguity, pressure.
|
|
28
|
+
6. **The rehire question** — _"Would you hire them again? For what kind of role?"_ — and listen to the hesitation.
|
|
29
|
+
|
|
30
|
+
### Probing follow-ups
|
|
31
|
+
The second question that opens the gap: "Can you give me an example?" · "How did that compare to others at that level?" · "What would their harshest fair critic say?" · silence (let them fill it).
|
|
32
|
+
|
|
33
|
+
### Scoring rubric
|
|
34
|
+
|
|
35
|
+
| Signal | 🟢 Green | 🟡 Yellow | 🔴 Red |
|
|
36
|
+
|---|---|---|---|
|
|
37
|
+
| Specificity | concrete examples | generic praise | evasive / can't recall |
|
|
38
|
+
| Rehire | enthusiastic, unprompted | qualified | hesitation or no |
|
|
39
|
+
| Growth honesty | candid, coachable | vague | defensive / dodged |
|
|
40
|
+
|
|
41
|
+
Plus a one-line **overall read** and any follow-up to run (e.g. a back-channel if listed refs are all glowing-but-generic).
|
|
42
|
+
|
|
43
|
+
### Legal & fairness guardrails
|
|
44
|
+
Ask about job performance only. Do **not** ask about age, health/disability, family/pregnancy, religion, national origin, or other protected characteristics. Keep it consistent across candidates so it's comparable and defensible.
|
|
45
|
+
|
|
46
|
+
## Quality Checks
|
|
47
|
+
|
|
48
|
+
- [ ] The opener explicitly invites candor (not a box-tick)
|
|
49
|
+
- [ ] Questions are open and non-leading — no "they were a great team player, right?"
|
|
50
|
+
- [ ] At least one question forces a concrete example and one comparative ranking
|
|
51
|
+
- [ ] The rehire question is included and its hesitation is scored, not just its answer
|
|
52
|
+
- [ ] The rubric converts what's heard into 🟢🟡🔴 with an overall read
|
|
53
|
+
- [ ] Protected-class questions are explicitly excluded; the script is consistent across candidates
|
|
54
|
+
|
|
55
|
+
## Anti-Patterns
|
|
56
|
+
|
|
57
|
+
- Leading questions that hand the referee the answer
|
|
58
|
+
- Accepting "they were great" without a follow-up for a specific example
|
|
59
|
+
- Only calling candidate-selected references (all curated to be positive)
|
|
60
|
+
- Treating the call as confirmation, not investigation
|
|
61
|
+
- Asking anything about protected characteristics
|
|
62
|
+
- No rubric — a vibe instead of a comparable, documented signal
|
|
@@ -0,0 +1,59 @@
|
|
|
1
|
+
# Community Moderation Policy Skill
|
|
2
|
+
|
|
3
|
+
A moderation policy fails when it's vague ("be respectful") or applied inconsistently — members can't predict what's allowed, and mods burn out making judgment calls with no backing. This skill writes a policy that is *enforceable*: concrete rules with examples, a ladder that matches consequence to behavior, and the process that makes enforcement feel fair even to the person on the receiving end.
|
|
4
|
+
|
|
5
|
+
## Working from a brief
|
|
6
|
+
|
|
7
|
+
Given the community (platform, size, purpose, audience), **write the full policy** — tune severity and tone to the space (a professional Slack ≠ a gaming Discord). Keep the public-facing rules short and human; put the operational detail in the moderator guidelines.
|
|
8
|
+
|
|
9
|
+
## Required Inputs
|
|
10
|
+
|
|
11
|
+
Ask for (if not provided, else infer and label the assumption):
|
|
12
|
+
- **The community** — platform, rough size, purpose, and audience norms
|
|
13
|
+
- **The values / what "good" looks like** here, and the behaviors you most want to prevent
|
|
14
|
+
- **Team** — how many moderators, volunteer or staff, tools available
|
|
15
|
+
- **Legal/brand constraints** — platform ToS, regulated topics, company brand line
|
|
16
|
+
|
|
17
|
+
## Output Format
|
|
18
|
+
|
|
19
|
+
### Code of conduct (public-facing)
|
|
20
|
+
Short, plain, and specific. The core rules stated positively where possible, each with a **one-line example of what crosses the line** so it's not ambiguous. Cover the usual: harassment, hate speech, spam/self-promo, off-topic, NSFW, illegal content — scoped to this community.
|
|
21
|
+
|
|
22
|
+
### Enforcement ladder
|
|
23
|
+
Consequence matched to behavior and repetition:
|
|
24
|
+
|
|
25
|
+
| Level | Trigger | Action | Who can apply |
|
|
26
|
+
|---|---|---|---|
|
|
27
|
+
| 1 | first minor / borderline | friendly warning, edit/remove | any mod |
|
|
28
|
+
| 2 | repeat / clear violation | formal warning, temp mute | any mod |
|
|
29
|
+
| 3 | serious or repeated | temp ban (e.g. 7 days) | senior mod |
|
|
30
|
+
| 4 | severe / incorrigible | permanent ban | admin |
|
|
31
|
+
| **Zero-tolerance** | threats, doxxing, CSAM, targeted harassment | immediate ban + report | admin, no warning |
|
|
32
|
+
|
|
33
|
+
### Appeals process
|
|
34
|
+
How a member contests an action: where to appeal, who reviews (not the acting mod), the timeline, and what can/can't be overturned. Appeals are what make the ladder feel legitimate.
|
|
35
|
+
|
|
36
|
+
### Moderator guidelines (internal)
|
|
37
|
+
- **Consistency** — decide by the rule, not the person; document every Level 2+ action.
|
|
38
|
+
- **Conflicts** — don't moderate a thread you're personally in; hand off.
|
|
39
|
+
- **Edge cases** — borderline calls, sarcasm/context, brigading and coordinated behavior, when to lock vs remove.
|
|
40
|
+
- **Transparency** — what's communicated to the member vs. handled quietly; a mod log.
|
|
41
|
+
- **Mod wellbeing** — rotation for heavy content, escalation for threats to mods.
|
|
42
|
+
|
|
43
|
+
## Quality Checks
|
|
44
|
+
|
|
45
|
+
- [ ] Every rule is concrete enough to predict a call, with an example of the line
|
|
46
|
+
- [ ] The ladder ties specific triggers to specific actions and who may apply them
|
|
47
|
+
- [ ] Severe cases (threats, doxxing, CSAM) are zero-tolerance and route to reporting
|
|
48
|
+
- [ ] An appeals path exists and is reviewed by someone other than the acting mod
|
|
49
|
+
- [ ] Mod guidelines cover consistency, conflicts of interest, and documentation
|
|
50
|
+
- [ ] Tone and severity fit this community; it aligns with the platform ToS
|
|
51
|
+
|
|
52
|
+
## Anti-Patterns
|
|
53
|
+
|
|
54
|
+
- Vague rules ("don't be a jerk") with no examples — unenforceable and arbitrary-feeling
|
|
55
|
+
- A single "ban" hammer with no graduated steps for minor issues
|
|
56
|
+
- Inconsistent enforcement by mood or by who the member is
|
|
57
|
+
- No appeals process (every action feels final and unjust)
|
|
58
|
+
- Unwritten rules enforced as if everyone knew them
|
|
59
|
+
- Warning-laddering genuine threats or doxxing instead of acting immediately
|
|
@@ -3,7 +3,7 @@
|
|
|
3
3
|
> Auto-generated from `skills/*/SKILL.md` by `scripts/build-exports.mjs`.
|
|
4
4
|
> **Do not edit these files by hand** — edit the source skill and regenerate.
|
|
5
5
|
|
|
6
|
-
|
|
6
|
+
754 skills exported. Copy a `SYSTEM_PROMPT.md` into the tool to use it.
|
|
7
7
|
|
|
8
8
|
| Skill | Bundle | Path |
|
|
9
9
|
|---|---|---|
|
|
@@ -126,6 +126,7 @@
|
|
|
126
126
|
| College App Parent Guide | `pm-parents` | `pm-parents/college-app-parent-guide/SYSTEM_PROMPT.md` |
|
|
127
127
|
| College Cost | `pm-calculators` | `pm-calculators/college-cost/SYSTEM_PROMPT.md` |
|
|
128
128
|
| Community Management Playbook | `pm-social` | `pm-social/community-management-playbook/SYSTEM_PROMPT.md` |
|
|
129
|
+
| Community Moderation Policy | `pm-social` | `pm-social/community-moderation-policy/SYSTEM_PROMPT.md` |
|
|
129
130
|
| Company Brief | `pm-jobsearch` | `pm-jobsearch/company-brief/SYSTEM_PROMPT.md` |
|
|
130
131
|
| Company Event Ops | `pm-cowork` | `pm-cowork/company-event-ops/SYSTEM_PROMPT.md` |
|
|
131
132
|
| Comparative Market Analysis | `pm-realestate` | `pm-realestate/comparative-market-analysis/SYSTEM_PROMPT.md` |
|
|
@@ -203,6 +204,7 @@
|
|
|
203
204
|
| Demo Script | `pm-cowork` | `pm-cowork/demo-script/SYSTEM_PROMPT.md` |
|
|
204
205
|
| Dependency Audit | `pm-engineering` | `pm-engineering/dependency-audit/SYSTEM_PROMPT.md` |
|
|
205
206
|
| Dependency Conflict Resolver | `pm-engineering` | `pm-engineering/dependency-conflict-resolver/SYSTEM_PROMPT.md` |
|
|
207
|
+
| Deprecation Comms Plan | `pm-devrel` | `pm-devrel/deprecation-comms-plan/SYSTEM_PROMPT.md` |
|
|
206
208
|
| Design Critique | `pm-design` | `pm-design/design-critique/SYSTEM_PROMPT.md` |
|
|
207
209
|
| Design Handoff Brief | `pm-advanced` | `pm-advanced/design-handoff-brief/SYSTEM_PROMPT.md` |
|
|
208
210
|
| Design System Audit | `pm-design` | `pm-design/design-system-audit/SYSTEM_PROMPT.md` |
|
|
@@ -541,6 +543,7 @@
|
|
|
541
543
|
| Red-Team Review | `pm-cross` | `pm-cross/red-team-review/SYSTEM_PROMPT.md` |
|
|
542
544
|
| Redundancy Consultation | `pm-hr` | `pm-hr/redundancy-consultation/SYSTEM_PROMPT.md` |
|
|
543
545
|
| Refactoring Plan | `pm-craft` | `pm-craft/refactoring-plan/SYSTEM_PROMPT.md` |
|
|
546
|
+
| Reference Check Script | `pm-recruiting` | `pm-recruiting/reference-check-script/SYSTEM_PROMPT.md` |
|
|
544
547
|
| Reference Letter | `pm-lifeadmin` | `pm-lifeadmin/reference-letter/SYSTEM_PROMPT.md` |
|
|
545
548
|
| Reference Request Kit | `pm-layoff` | `pm-layoff/reference-request-kit/SYSTEM_PROMPT.md` |
|
|
546
549
|
| Referral Program | `pm-growth` | `pm-growth/referral-program/SYSTEM_PROMPT.md` |
|
|
@@ -0,0 +1,65 @@
|
|
|
1
|
+
# Deprecation Comms Plan Skill
|
|
2
|
+
|
|
3
|
+
Deprecations go wrong in two ways: too fast (customers get broken and churn angry) or too quiet (they find out when it breaks). This skill plans the wind-down as a *communications program*, not an announcement — enough runway, messaging matched to how much each customer depends on the thing, a real migration path, and a plan for the accounts that will need a human.
|
|
4
|
+
|
|
5
|
+
## Working from a brief
|
|
6
|
+
|
|
7
|
+
Given what's being deprecated and why, **produce the full plan** — infer the risk tiers from usage and contract exposure. Right-size the runway to how hard the migration is (an internal flag flip is weeks; a public API is many months). If there's no migration path yet, flag that as a blocker before any announcement.
|
|
8
|
+
|
|
9
|
+
## Required Inputs
|
|
10
|
+
|
|
11
|
+
Ask for (if not provided, else infer and label the assumption):
|
|
12
|
+
- **What's being deprecated** and **why** (cost, security, strategy, replaced-by)
|
|
13
|
+
- **Who depends on it** — rough usage, and which segments/contracts are exposed
|
|
14
|
+
- **The replacement / migration path** (or that there isn't one yet)
|
|
15
|
+
- **Hard constraints** — a forcing date (security, legal, contract), team capacity
|
|
16
|
+
|
|
17
|
+
## Output Format
|
|
18
|
+
|
|
19
|
+
### Deprecation policy in one line
|
|
20
|
+
The principle you're committing to (e.g. _"announce → N months deprecated (works, warns) → sunset, with a migration path live before we announce"_).
|
|
21
|
+
|
|
22
|
+
### Timeline
|
|
23
|
+
|
|
24
|
+
| Phase | Date / window | What changes | What customers can still do |
|
|
25
|
+
|---|---|---|---|
|
|
26
|
+
| Announce | | nothing breaks; docs + warnings | full use, start migrating |
|
|
27
|
+
| Deprecated | | warnings, no new adoption | migrate |
|
|
28
|
+
| Sunset | | turned off | must have migrated |
|
|
29
|
+
|
|
30
|
+
Include grace periods and any extension policy for large accounts.
|
|
31
|
+
|
|
32
|
+
### Tiered messaging
|
|
33
|
+
Segmented by dependence, not one blast:
|
|
34
|
+
- **Tier 1 — heavy/contractual users:** proactive, human (CSM/AM), often a call + tailored plan.
|
|
35
|
+
- **Tier 2 — active users:** direct email + in-product warning + migration guide.
|
|
36
|
+
- **Tier 3 — light/dormant:** changelog, docs banner, deprecation headers.
|
|
37
|
+
|
|
38
|
+
For each: the core message (what, when, why, what to do), the ask, and the escalation path.
|
|
39
|
+
|
|
40
|
+
### Migration guide outline
|
|
41
|
+
The structure of the how-to: before/after, step-by-step, code/config examples, a mapping table (old → new), FAQ, and where to get help.
|
|
42
|
+
|
|
43
|
+
### Channel plan
|
|
44
|
+
Which channels fire at which phase — email, in-product, docs/changelog, API deprecation headers/`Sunset` header, status page, community/social — and the cadence (announce, reminders at intervals, final notice).
|
|
45
|
+
|
|
46
|
+
### Internal escalation playbook
|
|
47
|
+
The at-risk account list, who owns each, the CSM talking points, the "customer can't migrate in time" decision tree, and the exception/extension approval path.
|
|
48
|
+
|
|
49
|
+
## Quality Checks
|
|
50
|
+
|
|
51
|
+
- [ ] A migration path exists and is referenced everywhere before any customer message goes out
|
|
52
|
+
- [ ] Runway is sized to migration difficulty, with grace periods stated
|
|
53
|
+
- [ ] Messaging is tiered by dependence; Tier-1 accounts get a human, not a blast
|
|
54
|
+
- [ ] Every message says what, when, why, and the exact next step
|
|
55
|
+
- [ ] The channel cadence includes reminders and a final notice, not a single announcement
|
|
56
|
+
- [ ] High-risk accounts have a named owner and an escalation/extension path
|
|
57
|
+
|
|
58
|
+
## Anti-Patterns
|
|
59
|
+
|
|
60
|
+
- Too little runway for the migration actually required
|
|
61
|
+
- A silent breaking change, or burying it in a changelog nobody reads
|
|
62
|
+
- Announcing before the migration path is live
|
|
63
|
+
- One-size messaging that treats a whale like a dormant free user
|
|
64
|
+
- No plan for the accounts that physically can't migrate in time
|
|
65
|
+
- "Why" that blames the customer or the old system instead of owning the change
|
|
@@ -0,0 +1,62 @@
|
|
|
1
|
+
# Reference Check Script Skill
|
|
2
|
+
|
|
3
|
+
A reference check fails when it's a formality — you call, they say "great to work with," you tick the box. This skill writes a call that actually de-risks the hire: questions that make it *safe and easy* for a referee to be honest, follow-ups that open the gap between polite and true, and a rubric that turns what you hear into a defensible signal.
|
|
4
|
+
|
|
5
|
+
## Working from a brief
|
|
6
|
+
|
|
7
|
+
Given the role and what you need to validate, **write the full script** — tailor the questions to the specific concerns (the shaky interview signal, the seniority stretch, the manager-vs-IC question). Default to a ~20–25 minute call structure.
|
|
8
|
+
|
|
9
|
+
## Required Inputs
|
|
10
|
+
|
|
11
|
+
Ask for (if not provided, else infer and label the assumption):
|
|
12
|
+
- **Role** and level, and the **1–3 things to validate or de-risk** (the open questions from interviews)
|
|
13
|
+
- **Referee relationship** to the candidate (former manager / peer / report / client)
|
|
14
|
+
- **Reference type** — candidate-provided or back-channel (changes how candid you probe)
|
|
15
|
+
|
|
16
|
+
## Output Format
|
|
17
|
+
|
|
18
|
+
### Framing (how to open)
|
|
19
|
+
A 2–3 sentence opener that sets candor: confidential, no scripted "sales pitch" needed, you're calibrating not gatekeeping. The single most important move — referees mirror the tone you set.
|
|
20
|
+
|
|
21
|
+
### Question set (in order)
|
|
22
|
+
Grouped, with the *intent* of each noted:
|
|
23
|
+
1. **Relationship & context** — how they worked together, for how long, on what.
|
|
24
|
+
2. **Scope & performance** — what the candidate actually owned; where they ranked among peers.
|
|
25
|
+
3. **Strengths** — with a concrete example ("tell me about a time…").
|
|
26
|
+
4. **Growth areas** — asked as _"where did they most need to grow / what coaching helped?"_ (not "weaknesses").
|
|
27
|
+
5. **Working style** — how they handle conflict, feedback, ambiguity, pressure.
|
|
28
|
+
6. **The rehire question** — _"Would you hire them again? For what kind of role?"_ — and listen to the hesitation.
|
|
29
|
+
|
|
30
|
+
### Probing follow-ups
|
|
31
|
+
The second question that opens the gap: "Can you give me an example?" · "How did that compare to others at that level?" · "What would their harshest fair critic say?" · silence (let them fill it).
|
|
32
|
+
|
|
33
|
+
### Scoring rubric
|
|
34
|
+
|
|
35
|
+
| Signal | 🟢 Green | 🟡 Yellow | 🔴 Red |
|
|
36
|
+
|---|---|---|---|
|
|
37
|
+
| Specificity | concrete examples | generic praise | evasive / can't recall |
|
|
38
|
+
| Rehire | enthusiastic, unprompted | qualified | hesitation or no |
|
|
39
|
+
| Growth honesty | candid, coachable | vague | defensive / dodged |
|
|
40
|
+
|
|
41
|
+
Plus a one-line **overall read** and any follow-up to run (e.g. a back-channel if listed refs are all glowing-but-generic).
|
|
42
|
+
|
|
43
|
+
### Legal & fairness guardrails
|
|
44
|
+
Ask about job performance only. Do **not** ask about age, health/disability, family/pregnancy, religion, national origin, or other protected characteristics. Keep it consistent across candidates so it's comparable and defensible.
|
|
45
|
+
|
|
46
|
+
## Quality Checks
|
|
47
|
+
|
|
48
|
+
- [ ] The opener explicitly invites candor (not a box-tick)
|
|
49
|
+
- [ ] Questions are open and non-leading — no "they were a great team player, right?"
|
|
50
|
+
- [ ] At least one question forces a concrete example and one comparative ranking
|
|
51
|
+
- [ ] The rehire question is included and its hesitation is scored, not just its answer
|
|
52
|
+
- [ ] The rubric converts what's heard into 🟢🟡🔴 with an overall read
|
|
53
|
+
- [ ] Protected-class questions are explicitly excluded; the script is consistent across candidates
|
|
54
|
+
|
|
55
|
+
## Anti-Patterns
|
|
56
|
+
|
|
57
|
+
- Leading questions that hand the referee the answer
|
|
58
|
+
- Accepting "they were great" without a follow-up for a specific example
|
|
59
|
+
- Only calling candidate-selected references (all curated to be positive)
|
|
60
|
+
- Treating the call as confirmation, not investigation
|
|
61
|
+
- Asking anything about protected characteristics
|
|
62
|
+
- No rubric — a vibe instead of a comparable, documented signal
|
|
@@ -0,0 +1,59 @@
|
|
|
1
|
+
# Community Moderation Policy Skill
|
|
2
|
+
|
|
3
|
+
A moderation policy fails when it's vague ("be respectful") or applied inconsistently — members can't predict what's allowed, and mods burn out making judgment calls with no backing. This skill writes a policy that is *enforceable*: concrete rules with examples, a ladder that matches consequence to behavior, and the process that makes enforcement feel fair even to the person on the receiving end.
|
|
4
|
+
|
|
5
|
+
## Working from a brief
|
|
6
|
+
|
|
7
|
+
Given the community (platform, size, purpose, audience), **write the full policy** — tune severity and tone to the space (a professional Slack ≠ a gaming Discord). Keep the public-facing rules short and human; put the operational detail in the moderator guidelines.
|
|
8
|
+
|
|
9
|
+
## Required Inputs
|
|
10
|
+
|
|
11
|
+
Ask for (if not provided, else infer and label the assumption):
|
|
12
|
+
- **The community** — platform, rough size, purpose, and audience norms
|
|
13
|
+
- **The values / what "good" looks like** here, and the behaviors you most want to prevent
|
|
14
|
+
- **Team** — how many moderators, volunteer or staff, tools available
|
|
15
|
+
- **Legal/brand constraints** — platform ToS, regulated topics, company brand line
|
|
16
|
+
|
|
17
|
+
## Output Format
|
|
18
|
+
|
|
19
|
+
### Code of conduct (public-facing)
|
|
20
|
+
Short, plain, and specific. The core rules stated positively where possible, each with a **one-line example of what crosses the line** so it's not ambiguous. Cover the usual: harassment, hate speech, spam/self-promo, off-topic, NSFW, illegal content — scoped to this community.
|
|
21
|
+
|
|
22
|
+
### Enforcement ladder
|
|
23
|
+
Consequence matched to behavior and repetition:
|
|
24
|
+
|
|
25
|
+
| Level | Trigger | Action | Who can apply |
|
|
26
|
+
|---|---|---|---|
|
|
27
|
+
| 1 | first minor / borderline | friendly warning, edit/remove | any mod |
|
|
28
|
+
| 2 | repeat / clear violation | formal warning, temp mute | any mod |
|
|
29
|
+
| 3 | serious or repeated | temp ban (e.g. 7 days) | senior mod |
|
|
30
|
+
| 4 | severe / incorrigible | permanent ban | admin |
|
|
31
|
+
| **Zero-tolerance** | threats, doxxing, CSAM, targeted harassment | immediate ban + report | admin, no warning |
|
|
32
|
+
|
|
33
|
+
### Appeals process
|
|
34
|
+
How a member contests an action: where to appeal, who reviews (not the acting mod), the timeline, and what can/can't be overturned. Appeals are what make the ladder feel legitimate.
|
|
35
|
+
|
|
36
|
+
### Moderator guidelines (internal)
|
|
37
|
+
- **Consistency** — decide by the rule, not the person; document every Level 2+ action.
|
|
38
|
+
- **Conflicts** — don't moderate a thread you're personally in; hand off.
|
|
39
|
+
- **Edge cases** — borderline calls, sarcasm/context, brigading and coordinated behavior, when to lock vs remove.
|
|
40
|
+
- **Transparency** — what's communicated to the member vs. handled quietly; a mod log.
|
|
41
|
+
- **Mod wellbeing** — rotation for heavy content, escalation for threats to mods.
|
|
42
|
+
|
|
43
|
+
## Quality Checks
|
|
44
|
+
|
|
45
|
+
- [ ] Every rule is concrete enough to predict a call, with an example of the line
|
|
46
|
+
- [ ] The ladder ties specific triggers to specific actions and who may apply them
|
|
47
|
+
- [ ] Severe cases (threats, doxxing, CSAM) are zero-tolerance and route to reporting
|
|
48
|
+
- [ ] An appeals path exists and is reviewed by someone other than the acting mod
|
|
49
|
+
- [ ] Mod guidelines cover consistency, conflicts of interest, and documentation
|
|
50
|
+
- [ ] Tone and severity fit this community; it aligns with the platform ToS
|
|
51
|
+
|
|
52
|
+
## Anti-Patterns
|
|
53
|
+
|
|
54
|
+
- Vague rules ("don't be a jerk") with no examples — unenforceable and arbitrary-feeling
|
|
55
|
+
- A single "ban" hammer with no graduated steps for minor issues
|
|
56
|
+
- Inconsistent enforcement by mood or by who the member is
|
|
57
|
+
- No appeals process (every action feels final and unjust)
|
|
58
|
+
- Unwritten rules enforced as if everyone knew them
|
|
59
|
+
- Warning-laddering genuine threats or doxxing instead of acting immediately
|
package/exports/cline/README.md
CHANGED
|
@@ -3,7 +3,7 @@
|
|
|
3
3
|
> Auto-generated from `skills/*/SKILL.md` by `scripts/build-exports.mjs`.
|
|
4
4
|
> **Do not edit these files by hand** — edit the source skill and regenerate.
|
|
5
5
|
|
|
6
|
-
|
|
6
|
+
754 skills exported. Copy a `.md rule` into the tool to use it.
|
|
7
7
|
|
|
8
8
|
| Skill | Bundle | Path |
|
|
9
9
|
|---|---|---|
|
|
@@ -126,6 +126,7 @@
|
|
|
126
126
|
| College App Parent Guide | `pm-parents` | `pm-parents/college-app-parent-guide/college-app-parent-guide.md` |
|
|
127
127
|
| College Cost | `pm-calculators` | `pm-calculators/college-cost/college-cost.md` |
|
|
128
128
|
| Community Management Playbook | `pm-social` | `pm-social/community-management-playbook/community-management-playbook.md` |
|
|
129
|
+
| Community Moderation Policy | `pm-social` | `pm-social/community-moderation-policy/community-moderation-policy.md` |
|
|
129
130
|
| Company Brief | `pm-jobsearch` | `pm-jobsearch/company-brief/company-brief.md` |
|
|
130
131
|
| Company Event Ops | `pm-cowork` | `pm-cowork/company-event-ops/company-event-ops.md` |
|
|
131
132
|
| Comparative Market Analysis | `pm-realestate` | `pm-realestate/comparative-market-analysis/comparative-market-analysis.md` |
|
|
@@ -203,6 +204,7 @@
|
|
|
203
204
|
| Demo Script | `pm-cowork` | `pm-cowork/demo-script/demo-script.md` |
|
|
204
205
|
| Dependency Audit | `pm-engineering` | `pm-engineering/dependency-audit/dependency-audit.md` |
|
|
205
206
|
| Dependency Conflict Resolver | `pm-engineering` | `pm-engineering/dependency-conflict-resolver/dependency-conflict-resolver.md` |
|
|
207
|
+
| Deprecation Comms Plan | `pm-devrel` | `pm-devrel/deprecation-comms-plan/deprecation-comms-plan.md` |
|
|
206
208
|
| Design Critique | `pm-design` | `pm-design/design-critique/design-critique.md` |
|
|
207
209
|
| Design Handoff Brief | `pm-advanced` | `pm-advanced/design-handoff-brief/design-handoff-brief.md` |
|
|
208
210
|
| Design System Audit | `pm-design` | `pm-design/design-system-audit/design-system-audit.md` |
|
|
@@ -541,6 +543,7 @@
|
|
|
541
543
|
| Red-Team Review | `pm-cross` | `pm-cross/red-team-review/red-team-review.md` |
|
|
542
544
|
| Redundancy Consultation | `pm-hr` | `pm-hr/redundancy-consultation/redundancy-consultation.md` |
|
|
543
545
|
| Refactoring Plan | `pm-craft` | `pm-craft/refactoring-plan/refactoring-plan.md` |
|
|
546
|
+
| Reference Check Script | `pm-recruiting` | `pm-recruiting/reference-check-script/reference-check-script.md` |
|
|
544
547
|
| Reference Letter | `pm-lifeadmin` | `pm-lifeadmin/reference-letter/reference-letter.md` |
|
|
545
548
|
| Reference Request Kit | `pm-layoff` | `pm-layoff/reference-request-kit/reference-request-kit.md` |
|
|
546
549
|
| Referral Program | `pm-growth` | `pm-growth/referral-program/referral-program.md` |
|
|
@@ -0,0 +1,65 @@
|
|
|
1
|
+
# Deprecation Comms Plan Skill
|
|
2
|
+
|
|
3
|
+
Deprecations go wrong in two ways: too fast (customers get broken and churn angry) or too quiet (they find out when it breaks). This skill plans the wind-down as a *communications program*, not an announcement — enough runway, messaging matched to how much each customer depends on the thing, a real migration path, and a plan for the accounts that will need a human.
|
|
4
|
+
|
|
5
|
+
## Working from a brief
|
|
6
|
+
|
|
7
|
+
Given what's being deprecated and why, **produce the full plan** — infer the risk tiers from usage and contract exposure. Right-size the runway to how hard the migration is (an internal flag flip is weeks; a public API is many months). If there's no migration path yet, flag that as a blocker before any announcement.
|
|
8
|
+
|
|
9
|
+
## Required Inputs
|
|
10
|
+
|
|
11
|
+
Ask for (if not provided, else infer and label the assumption):
|
|
12
|
+
- **What's being deprecated** and **why** (cost, security, strategy, replaced-by)
|
|
13
|
+
- **Who depends on it** — rough usage, and which segments/contracts are exposed
|
|
14
|
+
- **The replacement / migration path** (or that there isn't one yet)
|
|
15
|
+
- **Hard constraints** — a forcing date (security, legal, contract), team capacity
|
|
16
|
+
|
|
17
|
+
## Output Format
|
|
18
|
+
|
|
19
|
+
### Deprecation policy in one line
|
|
20
|
+
The principle you're committing to (e.g. _"announce → N months deprecated (works, warns) → sunset, with a migration path live before we announce"_).
|
|
21
|
+
|
|
22
|
+
### Timeline
|
|
23
|
+
|
|
24
|
+
| Phase | Date / window | What changes | What customers can still do |
|
|
25
|
+
|---|---|---|---|
|
|
26
|
+
| Announce | | nothing breaks; docs + warnings | full use, start migrating |
|
|
27
|
+
| Deprecated | | warnings, no new adoption | migrate |
|
|
28
|
+
| Sunset | | turned off | must have migrated |
|
|
29
|
+
|
|
30
|
+
Include grace periods and any extension policy for large accounts.
|
|
31
|
+
|
|
32
|
+
### Tiered messaging
|
|
33
|
+
Segmented by dependence, not one blast:
|
|
34
|
+
- **Tier 1 — heavy/contractual users:** proactive, human (CSM/AM), often a call + tailored plan.
|
|
35
|
+
- **Tier 2 — active users:** direct email + in-product warning + migration guide.
|
|
36
|
+
- **Tier 3 — light/dormant:** changelog, docs banner, deprecation headers.
|
|
37
|
+
|
|
38
|
+
For each: the core message (what, when, why, what to do), the ask, and the escalation path.
|
|
39
|
+
|
|
40
|
+
### Migration guide outline
|
|
41
|
+
The structure of the how-to: before/after, step-by-step, code/config examples, a mapping table (old → new), FAQ, and where to get help.
|
|
42
|
+
|
|
43
|
+
### Channel plan
|
|
44
|
+
Which channels fire at which phase — email, in-product, docs/changelog, API deprecation headers/`Sunset` header, status page, community/social — and the cadence (announce, reminders at intervals, final notice).
|
|
45
|
+
|
|
46
|
+
### Internal escalation playbook
|
|
47
|
+
The at-risk account list, who owns each, the CSM talking points, the "customer can't migrate in time" decision tree, and the exception/extension approval path.
|
|
48
|
+
|
|
49
|
+
## Quality Checks
|
|
50
|
+
|
|
51
|
+
- [ ] A migration path exists and is referenced everywhere before any customer message goes out
|
|
52
|
+
- [ ] Runway is sized to migration difficulty, with grace periods stated
|
|
53
|
+
- [ ] Messaging is tiered by dependence; Tier-1 accounts get a human, not a blast
|
|
54
|
+
- [ ] Every message says what, when, why, and the exact next step
|
|
55
|
+
- [ ] The channel cadence includes reminders and a final notice, not a single announcement
|
|
56
|
+
- [ ] High-risk accounts have a named owner and an escalation/extension path
|
|
57
|
+
|
|
58
|
+
## Anti-Patterns
|
|
59
|
+
|
|
60
|
+
- Too little runway for the migration actually required
|
|
61
|
+
- A silent breaking change, or burying it in a changelog nobody reads
|
|
62
|
+
- Announcing before the migration path is live
|
|
63
|
+
- One-size messaging that treats a whale like a dormant free user
|
|
64
|
+
- No plan for the accounts that physically can't migrate in time
|
|
65
|
+
- "Why" that blames the customer or the old system instead of owning the change
|