Skip to content

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

Open
policyengine[bot] wants to merge 1 commit into
mainfrom
bot/learnings-aspen-eitc-ctc
Open

Document migration from @policyengine/design-system to ui-kit/legacy#145
policyengine[bot] wants to merge 1 commit into
mainfrom
bot/learnings-aspen-eitc-ctc

Conversation

@policyengine

@policyengine policyengine Bot commented May 9, 2026

Copy link
Copy Markdown
Contributor

Summary

Add migration documentation for projects using the deprecated @policyengine/design-system package.

Changes

New reference document: migration-from-design-system.md

  • Legacy compatibility mode using /legacy subpath in ui-kit 0.8.0+
  • TypeScript typedef quirk workaround for token imports
  • CSS variable name differences (--pe-* vs shadcn-style)
  • Full migration path to modern ui-kit setup
  • Troubleshooting section for common migration issues

Updated SKILL.md:

  • Added migration-related triggers: "design-system deprecated", "migrate from design-system", "ui-kit/legacy"
  • Added callout linking to migration guide

Context

Learned from PolicyEngine/aspen-eitc-ctc#6 that:

  1. @policyengine/design-system is deprecated
  2. Projects should migrate to @policyengine/ui-kit@^0.8.0
  3. The /legacy subpath provides drop-in API compatibility
  4. Token imports require full path due to TypeScript typedef quirk
  5. CSS variable names differ between packages

This documentation will help future Claude Code sessions handle similar migrations efficiently.

Test plan

  • Documentation is clear and actionable
  • Triggers added to skill description
  • Examples match actual migration pattern from aspen-eitc-ctc

🤖 Generated with Claude Code

@PolicyEngine-Bot @claude
Document migration from @policyengine/design-system to ui-kit/legacy
983582b 
Add comprehensive migration guide for projects using the deprecated
@policyengine/design-system package.

## Changes

- New reference doc: migration-from-design-system.md
  - Legacy compatibility mode (/legacy subpath)
  - TypeScript typedef quirk workaround
  - CSS variable name differences (--pe-* vs shadcn style)
  - Full migration path to modern ui-kit
  - Troubleshooting common migration issues

- Updated SKILL.md triggers to include migration keywords

## Context

Learned from aspen-eitc-ctc PR #6 that design-system is deprecated
and projects should migrate to ui-kit 0.8.0+ with /legacy subpath
for drop-in compatibility.

🤖 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