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 06 of 10 4-6 months for the first slice· advanced

Step 6: Migrate the First Capability (Vertical Slice)

Ship one complete capability through the new stack. For RPG specifically, slice 1 should be read-only or low-stakes with limited 5250 redesign — exercise the infrastructure, not the riskiest UX.

What you're doing in this step

Pick a small, contained capability (a reporting screen, a simple CRUD entity, an admin screen). Take the rule catalog from Phase 2 as the spec. Build the modern implementation, build behavior parity tests from extracted rules, deploy via feature flag in shadow mode (compare against IBM i for weeks), then canary to a small % of users.

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 0.5 day

Feature Flag Rollout Strategy for Migrations

Use feature flags to safely route traffic between legacy and new systems during migration with controlled rollout and instant rollback.

View template
Template· Template 1-2 days

Behavior Parity Test Suite

Generate tests that lock down current legacy behavior so the new system doesn't accidentally change it during migration.

Use this when: Slice 1 is regulated and parity must be proven; expand the parity-test framework you built in earlier migrations

View template
Template· Template reference document

RPG to Java/.NET Translation Checklist

Pattern-by-pattern translation guide for RPG IV constructs to modern Java or .NET — including indicators, the cycle, native I/O, and the patterns that should be replaced rather than translated.

Use this when: Implementation pattern reference while writing the new code

rpgibm-ijavadotnet
View template
Template· Template 25 min

OpenAPI 3.1 Spec Generator

Generate a complete OpenAPI 3.1 specification from user stories or a feature description, ready for API-first development.

Use this when: Slice exposes a public API; lock the contract first

View template
Template· Template 20 min

React Form Builder (react-hook-form + Zod)

Build a fully accessible, type-safe form with react-hook-form, Zod validation, and shadcn/ui components.

Use this when: Slice 1 has a form-heavy UI replacing a 5250 input screen

reacttypescriptnextjstailwindshadcn-ui
View template
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

Spec-Driven Builder Skill

Tool-neutral skill that walks developers through PRD → stories → schema → API → tests for any new feature, producing real artifacts at each step. The methodology is identical on every supported tool.

claude-codecopilotcursor
View skill
Skill· Skill 5 min setup

Test Generator Skill

Claude Code skill that picks the right test type (unit/integration/E2E) based on context and applies Evoke's testing patterns automatically.

claude-code
View skill
Skill· Skill 5 min setup

Code Reviewer Skill

Claude Code skill that performs comprehensive code review on PRs and diffs, prioritized by severity with concrete fixes.

claude-code
View skill
Skill· Skill 5 min setup

Data Validation Skill

Claude Code skill that compares old and new system outputs for parity — running validation queries on both DBs and reporting drift.

claude-codesql
View skill
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

Azure DevOps MCP for Evoke

Pre-configured Azure DevOps MCP server for Claude Code — work items, repos, PRs, and pipelines from chat.

claude-codemcp
View config
MCP config· MCP config 10 min setup

GitHub MCP for Evoke

Pre-configured GitHub MCP server for Claude Code — issues, PRs, code search, and Actions from chat.

claude-codemcp
View config
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
View config
MCP config· MCP config 10 min setup

Postgres MCP for Evoke

Pre-configured Postgres MCP server for Claude Code — schema inspection and read-only queries to make database work safer and faster.

claude-codemcppostgres
View config
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.

  • Slice 1 implementation complete (frontend + API + DB)
  • Parity tests pass against extracted rules
  • Shadow mode running, comparing to IBM i
  • Performance meets targets
  • Internal validation passed
  • Canary rollout to a small user set successful
  • Stop conditions clear; rollback procedure tested
Common pitfalls

What goes wrong at this step

  • Slice 1 too big — should fail safely
  • Skipping shadow mode — catches bugs that tests miss
  • Replicating 5250 patterns in web — use slice 1 to establish modern UX patterns
  • Performance neglect — ORM-based access can be slower than RPG native I/O on hot paths
← Previous step

Command Palette

Search for a command to run...