Skip to content

Document migration from @policyengine/design-system to ui-kit#143

Open
policyengine[bot] wants to merge 1 commit into
mainfrom
bot/learnings-uk-land-value-tax
Open

Document migration from @policyengine/design-system to ui-kit#143
policyengine[bot] wants to merge 1 commit into
mainfrom
bot/learnings-uk-land-value-tax

Conversation

@policyengine

@policyengine policyengine Bot commented May 9, 2026

Copy link
Copy Markdown
Contributor

Summary

Add comprehensive migration guide for moving from the deprecated @policyengine/design-system package to @policyengine/ui-kit.

Learned from uk-land-value-tax PR #12 (PolicyEngine/uk-land-value-tax#12), where I discovered the /legacy subpath in ui-kit 0.8.0 that mirrors the old design-system API.

Changes

New reference guide (migration-from-design-system.md):

  • Documents the /legacy subpath for gradual migration
  • Explains why CSS variables need to be inlined (legacy doesn't export tokens.css)
  • Provides two migration paths: legacy (quick) vs. modern (recommended)
  • Includes real example from uk-land-value-tax dashboard
  • Troubleshooting section for common migration issues

Updated skill triggers:

  • Added "migrate from design-system", "design-system to ui-kit", "/legacy subpath" to trigger keywords
  • Updated description to mention design-system migration

Why This Matters

The existing skills reference @policyengine/design-system in several places (app-skill, design-skill, content-generation-skill) but don't document the migration path. This gap would cause future Claude sessions to struggle with:

  1. Not knowing about the /legacy subpath
  2. Being confused about why CSS imports fail after changing package
  3. Not understanding when to inline CSS variables vs. use theme.css

Test Plan

  • Verified guide accuracy against uk-land-value-tax PR Fix duplicate agent registration #12
  • Checked that trigger keywords match common migration queries
  • Confirmed guide structure matches existing reference docs

🤖 Generated with Claude Code

@PolicyEngine-Bot @claude
Document migration from @policyengine/design-system to ui-kit
f080264 
Add comprehensive migration guide covering the /legacy subpath introduced
in ui-kit 0.8.0. This path allows gradual migration from the deprecated
design-system package with minimal code changes.

Learned from uk-land-value-tax PR #12 migration work.

Changes:
- New migration-from-design-system.md reference guide
- Updated skill triggers to include design-system migration keywords
- Documents both legacy subpath (quick) and modern (recommended) paths
- Includes specific example from uk-land-value-tax dashboard

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
@policyengine

policyengine Bot commented May 9, 2026

Copy link
Copy Markdown
Contributor Author

Sorry @PolicyEngine[bot], only members of the PolicyEngine/core-developers team can invoke Claude Code.

28 similar comments
@policyengine

policyengine Bot commented May 9, 2026

Copy link
Copy Markdown
Contributor Author

Sorry @PolicyEngine[bot], only members of the PolicyEngine/core-developers team can invoke Claude Code.

@policyengine

policyengine Bot commented May 9, 2026

Copy link
Copy Markdown
Contributor Author

Sorry @PolicyEngine[bot], only members of the PolicyEngine/core-developers team can invoke Claude Code.

@policyengine

policyengine Bot commented May 9, 2026

Copy link
Copy Markdown
Contributor Author

Sorry @PolicyEngine[bot], only members of the PolicyEngine/core-developers team can invoke Claude Code.

@policyengine

policyengine Bot commented May 9, 2026

Copy link
Copy Markdown
Contributor Author

Sorry @PolicyEngine[bot], only members of the PolicyEngine/core-developers team can invoke Claude Code.

@policyengine

policyengine Bot commented May 9, 2026

Copy link
Copy Markdown
Contributor Author

Sorry @PolicyEngine[bot], only members of the PolicyEngine/core-developers team can invoke Claude Code.

@policyengine

policyengine Bot commented May 9, 2026

Copy link
Copy Markdown
Contributor Author

Sorry @PolicyEngine[bot], only members of the PolicyEngine/core-developers team can invoke Claude Code.

@policyengine

policyengine Bot commented May 9, 2026

Copy link
Copy Markdown
Contributor Author

Sorry @PolicyEngine[bot], only members of the PolicyEngine/core-developers team can invoke Claude Code.

@policyengine

policyengine Bot commented May 9, 2026

Copy link
Copy Markdown
Contributor Author

Sorry @PolicyEngine[bot], only members of the PolicyEngine/core-developers team can invoke Claude Code.

@policyengine

policyengine Bot commented May 9, 2026

Copy link
Copy Markdown
Contributor Author

Sorry @PolicyEngine[bot], only members of the PolicyEngine/core-developers team can invoke Claude Code.

@policyengine

policyengine Bot commented May 9, 2026

Copy link
Copy Markdown
Contributor Author

Sorry @PolicyEngine[bot], only members of the PolicyEngine/core-developers team can invoke Claude Code.

@policyengine

policyengine Bot commented May 9, 2026

Copy link
Copy Markdown
Contributor Author

Sorry @PolicyEngine[bot], only members of the PolicyEngine/core-developers team can invoke Claude Code.

@policyengine

policyengine Bot commented May 9, 2026

Copy link
Copy Markdown
Contributor Author

Sorry @PolicyEngine[bot], only members of the PolicyEngine/core-developers team can invoke Claude Code.

@policyengine

policyengine Bot commented May 9, 2026

Copy link
Copy Markdown
Contributor Author

Sorry @PolicyEngine[bot], only members of the PolicyEngine/core-developers team can invoke Claude Code.

@policyengine

policyengine Bot commented May 9, 2026

Copy link
Copy Markdown
Contributor Author

Sorry @PolicyEngine[bot], only members of the PolicyEngine/core-developers team can invoke Claude Code.

@policyengine

policyengine Bot commented May 9, 2026

Copy link
Copy Markdown
Contributor Author

Sorry @PolicyEngine[bot], only members of the PolicyEngine/core-developers team can invoke Claude Code.

@policyengine

policyengine Bot commented May 9, 2026

Copy link
Copy Markdown
Contributor Author

Sorry @PolicyEngine[bot], only members of the PolicyEngine/core-developers team can invoke Claude Code.

@policyengine

policyengine Bot commented May 9, 2026

Copy link
Copy Markdown
Contributor Author

Sorry @PolicyEngine[bot], only members of the PolicyEngine/core-developers team can invoke Claude Code.

@policyengine

policyengine Bot commented May 9, 2026

Copy link
Copy Markdown
Contributor Author

Sorry @PolicyEngine[bot], only members of the PolicyEngine/core-developers team can invoke Claude Code.

@policyengine

policyengine Bot commented May 9, 2026

Copy link
Copy Markdown
Contributor Author

Sorry @PolicyEngine[bot], only members of the PolicyEngine/core-developers team can invoke Claude Code.

@policyengine

policyengine Bot commented May 9, 2026

Copy link
Copy Markdown
Contributor Author

Sorry @PolicyEngine[bot], only members of the PolicyEngine/core-developers team can invoke Claude Code.

@policyengine

policyengine Bot commented May 9, 2026

Copy link
Copy Markdown
Contributor Author

Sorry @PolicyEngine[bot], only members of the PolicyEngine/core-developers team can invoke Claude Code.

@policyengine

policyengine Bot commented May 9, 2026

Copy link
Copy Markdown
Contributor Author

Sorry @PolicyEngine[bot], only members of the PolicyEngine/core-developers team can invoke Claude Code.

@policyengine

policyengine Bot commented May 9, 2026

Copy link
Copy Markdown
Contributor Author

Sorry @PolicyEngine[bot], only members of the PolicyEngine/core-developers team can invoke Claude Code.

@policyengine

policyengine Bot commented May 9, 2026

Copy link
Copy Markdown
Contributor Author

Sorry @PolicyEngine[bot], only members of the PolicyEngine/core-developers team can invoke Claude Code.

@policyengine

policyengine Bot commented May 9, 2026

Copy link
Copy Markdown
Contributor Author

Sorry @PolicyEngine[bot], only members of the PolicyEngine/core-developers team can invoke Claude Code.

@policyengine

policyengine Bot commented May 9, 2026

Copy link
Copy Markdown
Contributor Author

Sorry @PolicyEngine[bot], only members of the PolicyEngine/core-developers team can invoke Claude Code.

@policyengine

policyengine Bot commented May 9, 2026

Copy link
Copy Markdown
Contributor Author

Sorry @PolicyEngine[bot], only members of the PolicyEngine/core-developers team can invoke Claude Code.

@policyengine

policyengine Bot commented May 9, 2026

Copy link
Copy Markdown
Contributor Author

Sorry @PolicyEngine[bot], only members of the PolicyEngine/core-developers team can invoke Claude Code.

@policyengine

policyengine Bot commented May 9, 2026

Copy link
Copy Markdown
Contributor Author

Sorry @PolicyEngine[bot], only members of the PolicyEngine/core-developers team can invoke Claude Code.

29 similar comments
@policyengine

policyengine Bot commented May 9, 2026

Copy link
Copy Markdown
Contributor Author

Sorry @PolicyEngine[bot], only members of the PolicyEngine/core-developers team can invoke Claude Code.

@policyengine

policyengine Bot commented May 9, 2026

Copy link
Copy Markdown
Contributor Author

Sorry @PolicyEngine[bot], only members of the PolicyEngine/core-developers team can invoke Claude Code.

@policyengine

policyengine Bot commented May 9, 2026

Copy link
Copy Markdown
Contributor Author

Sorry @PolicyEngine[bot], only members of the PolicyEngine/core-developers team can invoke Claude Code.

@policyengine

policyengine Bot commented May 9, 2026

Copy link
Copy Markdown
Contributor Author

Sorry @PolicyEngine[bot], only members of the PolicyEngine/core-developers team can invoke Claude Code.

@policyengine

policyengine Bot commented May 9, 2026

Copy link
Copy Markdown
Contributor Author

Sorry @PolicyEngine[bot], only members of the PolicyEngine/core-developers team can invoke Claude Code.

@policyengine

policyengine Bot commented May 9, 2026

Copy link
Copy Markdown
Contributor Author

Sorry @PolicyEngine[bot], only members of the PolicyEngine/core-developers team can invoke Claude Code.

@policyengine

policyengine Bot commented May 9, 2026

Copy link
Copy Markdown
Contributor Author

Sorry @PolicyEngine[bot], only members of the PolicyEngine/core-developers team can invoke Claude Code.

@policyengine

policyengine Bot commented May 9, 2026

Copy link
Copy Markdown
Contributor Author

Sorry @PolicyEngine[bot], only members of the PolicyEngine/core-developers team can invoke Claude Code.

@policyengine

policyengine Bot commented May 9, 2026

Copy link
Copy Markdown
Contributor Author

Sorry @PolicyEngine[bot], only members of the PolicyEngine/core-developers team can invoke Claude Code.

@policyengine

policyengine Bot commented May 9, 2026

Copy link
Copy Markdown
Contributor Author

Sorry @PolicyEngine[bot], only members of the PolicyEngine/core-developers team can invoke Claude Code.

@policyengine

policyengine Bot commented May 9, 2026

Copy link
Copy Markdown
Contributor Author

Sorry @PolicyEngine[bot], only members of the PolicyEngine/core-developers team can invoke Claude Code.

@policyengine

policyengine Bot commented May 9, 2026

Copy link
Copy Markdown
Contributor Author

Sorry @PolicyEngine[bot], only members of the PolicyEngine/core-developers team can invoke Claude Code.

@policyengine

policyengine Bot commented May 9, 2026

Copy link
Copy Markdown
Contributor Author

Sorry @PolicyEngine[bot], only members of the PolicyEngine/core-developers team can invoke Claude Code.

@policyengine

policyengine Bot commented May 9, 2026

Copy link
Copy Markdown
Contributor Author

Sorry @PolicyEngine[bot], only members of the PolicyEngine/core-developers team can invoke Claude Code.

@policyengine

policyengine Bot commented May 9, 2026

Copy link
Copy Markdown
Contributor Author

Sorry @PolicyEngine[bot], only members of the PolicyEngine/core-developers team can invoke Claude Code.

@policyengine

policyengine Bot commented May 9, 2026

Copy link
Copy Markdown
Contributor Author

Sorry @PolicyEngine[bot], only members of the PolicyEngine/core-developers team can invoke Claude Code.

@policyengine

policyengine Bot commented May 9, 2026

Copy link
Copy Markdown
Contributor Author

Sorry @PolicyEngine[bot], only members of the PolicyEngine/core-developers team can invoke Claude Code.

@policyengine

policyengine Bot commented May 9, 2026

Copy link
Copy Markdown
Contributor Author

Sorry @PolicyEngine[bot], only members of the PolicyEngine/core-developers team can invoke Claude Code.

@policyengine

policyengine Bot commented May 9, 2026

Copy link
Copy Markdown
Contributor Author

Sorry @PolicyEngine[bot], only members of the PolicyEngine/core-developers team can invoke Claude Code.

@policyengine

policyengine Bot commented May 9, 2026

Copy link
Copy Markdown
Contributor Author

Sorry @PolicyEngine[bot], only members of the PolicyEngine/core-developers team can invoke Claude Code.

@policyengine

policyengine Bot commented May 9, 2026

Copy link
Copy Markdown
Contributor Author

Sorry @PolicyEngine[bot], only members of the PolicyEngine/core-developers team can invoke Claude Code.

@policyengine

policyengine Bot commented May 9, 2026

Copy link
Copy Markdown
Contributor Author

Sorry @PolicyEngine[bot], only members of the PolicyEngine/core-developers team can invoke Claude Code.

@policyengine

policyengine Bot commented May 9, 2026

Copy link
Copy Markdown
Contributor Author

Sorry @PolicyEngine[bot], only members of the PolicyEngine/core-developers team can invoke Claude Code.

@policyengine

policyengine Bot commented May 9, 2026

Copy link
Copy Markdown
Contributor Author

Sorry @PolicyEngine[bot], only members of the PolicyEngine/core-developers team can invoke Claude Code.

@policyengine

policyengine Bot commented May 9, 2026

Copy link
Copy Markdown
Contributor Author

Sorry @PolicyEngine[bot], only members of the PolicyEngine/core-developers team can invoke Claude Code.

@policyengine

policyengine Bot commented May 9, 2026

Copy link
Copy Markdown
Contributor Author

Sorry @PolicyEngine[bot], only members of the PolicyEngine/core-developers team can invoke Claude Code.

@policyengine

policyengine Bot commented May 9, 2026

Copy link
Copy Markdown
Contributor Author

Sorry @PolicyEngine[bot], only members of the PolicyEngine/core-developers team can invoke Claude Code.

@policyengine

policyengine Bot commented May 9, 2026

Copy link
Copy Markdown
Contributor Author

Sorry @PolicyEngine[bot], only members of the PolicyEngine/core-developers team can invoke Claude Code.

@policyengine

policyengine Bot commented May 9, 2026

Copy link
Copy Markdown
Contributor Author

Sorry @PolicyEngine[bot], only members of the PolicyEngine/core-developers team can invoke Claude Code.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

No reviews

Assignees

No one assigned

Labels

None yet

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

1 participant

@PolicyEngine-Bot