Playbook
0 / 10 complete0%
  1. 01
  2. 02
  3. 03
  4. 04
  5. 05
  6. 06
  7. 07
  8. 08
  9. 09
  10. 10
Step 09 of 10 Throughout the program, intensifying in the last 6-12 months· advanced

Step 9: Workforce Transition

Capture institutional knowledge before retirement; retrain transferable RPG developers; transition operations; lead the culture change. Failed modernizations often fail here.

What you're doing in this step

Run knowledge capture from retiring engineers (recorded interviews, paired programming, documentation). Many RPG developers can transition to Java / .NET with real training (not "go take a course"). Train IBM i ops teams on cloud / Linux / modern monitoring or plan for departures. Lead the cadence shift (deployments per day vs per quarter) and observability change (dashboards vs joblog).

Recommended prompts

Use one of these to do the work in your IDE

Open the template to read it in full. Click Copy prompt to grab it (with your stack values pre-filled where they apply) — then paste into Claude Code, Cursor, or wherever you build.

Primary recommendation 5 min setup

Documentation Skill

Claude Code skill that generates README, API docs, JSDoc, ADRs, and other docs that match the project's existing voice and depth.

claude-code
Skill· Skill 5 min setup

Migration Planner Skill

Flagship migration skill that walks Claude Code through audit → strategy → slicing → cutover for any legacy system migration.

Use this when: Keeping the workforce-transition plan aligned with the technical migration plan in one place

claude-code
Recommended skills

Drop these into Claude Code for this phase

Skills auto-trigger on the right kind of request. Install once; they apply to every prompt that fits.

Skill· Skill 5 min setup

Documentation Skill

Claude Code skill that generates README, API docs, JSDoc, ADRs, and other docs that match the project's existing voice and depth.

claude-code
Skill· Skill 5 min setup

Migration Planner Skill

Flagship migration skill that walks Claude Code through audit → strategy → slicing → cutover for any legacy system migration.

claude-code
Recommended MCP configs

Wire these tools into Claude Code first

MCP servers give Claude Code direct access to external systems (Jira, browsers, databases). Configure once.

MCP config· MCP config 10 min setup

Confluence MCP for Evoke

Pre-configured Atlassian Confluence MCP server for Claude Code — search, read, and write internal documentation pages from chat.

claude-codemcp
MCP config· MCP config 5 min setup

Filesystem MCP for Evoke

Pre-configured filesystem MCP server for Claude Code — safe, scoped read/write access to project files.

claude-codemcp
When you're done

Verify these in your own work before moving on

This is a checklist for you to mentally tick off in your repo and IDE — the site doesn't track it, you do.

  • Knowledge capture from retiring engineers complete
  • Retraining program for transferable engineers complete
  • Operations team trained on the new stack
  • HR plans for non-transferable roles documented and executed
  • Culture transition managed (deployment cadence, observability practices)
Common pitfalls

What goes wrong at this step

  • Treating the RPG team as obstacles — they have decades of valuable knowledge. Bring them along
  • No retraining budget — engineers can't pick up new skills off-hours
  • Ignoring operations — IBM i ops and cloud ops are different jobs
  • Same leadership running both old and new — patterns that ran IBM i for 20 years won't optimize the cloud-native target
← Previous step

Command Palette

Search for a command to run...