Skip to content

chore(agent): add migrate-to-skeleton agent for refactoring legacy components to Skeleton Blueprint architecture#9934

Merged
deleonio merged 2 commits intodevelopfrom
feature/skeleton-migration-agent
Apr 1, 2026
Merged

chore(agent): add migrate-to-skeleton agent for refactoring legacy components to Skeleton Blueprint architecture#9934
deleonio merged 2 commits intodevelopfrom
feature/skeleton-migration-agent

Conversation

@laske185
Copy link
Copy Markdown
Contributor

@laske185 laske185 commented Apr 1, 2026

This pull request introduces a new agent specification, migrate-to-skeleton, for systematically migrating legacy KoliBri web components to the Skeleton Blueprint architecture. The agent provides a comprehensive, step-by-step process to ensure components are refactored according to architectural standards, with a strong emphasis on maintainability, traceability, and code reduction.

Key additions and improvements:

Agent Specification and Migration Procedure

  • Adds .github/agents/migrate-to-skeleton.agent.md, a detailed Markdown file that defines the migrate-to-skeleton agent. This agent guides developers through analyzing, planning, implementing, and validating the migration of legacy components to the Skeleton architecture.
  • Outlines a five-phase migration process: analysis, props-first structure, refactoring by architecture layer, dead code elimination, and validation. Each phase includes explicit instructions and expected outcomes.
  • Includes a gap analysis template, a pre-review checklist, and a validation command sequence to ensure architectural compliance and code quality.

Architecture and Best Practices Reference

  • Summarizes the authoritative architecture as defined in ARC42.md and provides reminders for common pitfalls, ensuring consistent application of patterns and conventions.
  • Details the "prop triangle," controller pattern, state management, and expected file structure for Skeleton components, serving as both a quick reference and a teaching tool

@laske185 laske185 requested a review from deleonio April 1, 2026 06:54
Copy link
Copy Markdown
Contributor

@gemini-code-assist gemini-code-assist bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Code Review

This pull request introduces a new agent instruction file, migrate-to-skeleton.agent.md, which provides a comprehensive guide for refactoring legacy components into the Skeleton Blueprint architecture. The review feedback focuses on correcting technical inaccuracies within the documentation to align with the actual implementation of the BaseController and internal prop utilities. Key corrections include updating the controller constructor to accept setState and getState functions, renaming methods to getRenderProp and setRenderProp, and adjusting the createPropDefinition signature to match the architecture specification.

Comment thread .github/agents/migrate-to-skeleton.agent.md Outdated
Comment thread .github/agents/migrate-to-skeleton.agent.md Outdated
Comment thread .github/agents/migrate-to-skeleton.agent.md Outdated
Comment thread .github/agents/migrate-to-skeleton.agent.md Outdated
Comment thread .github/agents/migrate-to-skeleton.agent.md Outdated
Comment thread .github/agents/migrate-to-skeleton.agent.md Outdated
Comment thread .github/agents/migrate-to-skeleton.agent.md
Comment thread .github/agents/migrate-to-skeleton.agent.md Outdated
@github-actions
Copy link
Copy Markdown
Contributor

github-actions bot commented Apr 1, 2026

Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR adds a new GitHub agent specification (migrate-to-skeleton) intended to guide systematic migrations of legacy Stencil components to KoliBri’s Skeleton Blueprint architecture.

Changes:

  • Introduces .github/agents/migrate-to-skeleton.agent.md with a phased migration workflow (analysis → props-first → refactor → dead-code removal → validation).
  • Adds embedded architecture guidance, templates (gap analysis), pitfalls, and a pre-review checklist to standardize refactors.

Comment thread .github/agents/migrate-to-skeleton.agent.md
Comment thread .github/agents/migrate-to-skeleton.agent.md Outdated
Comment thread .github/agents/migrate-to-skeleton.agent.md
Comment thread .github/agents/migrate-to-skeleton.agent.md
Comment thread .github/agents/migrate-to-skeleton.agent.md Outdated
Comment thread .github/agents/migrate-to-skeleton.agent.md Outdated
Comment thread .github/agents/migrate-to-skeleton.agent.md Outdated
Comment thread .github/agents/migrate-to-skeleton.agent.md Outdated

## Argument: $ARGUMENTS

The argument specifies which component to migrate (e.g. `card`, `tooltip`, `alert`).
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

bitte nur vorbilder nennen

// Arrow property — ref setter
public setButtonRef = (element?: HTMLButtonElement): void => { /* ... */ };
public constructor(setState: SetStateFn<MyApi>, getState: GetStateFn<MyApi>) {
super(myPropsConfig, setState, getState);
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

das ist die falsche reihenfolge

@deleonio deleonio merged commit b223aea into develop Apr 1, 2026
11 checks passed
@deleonio deleonio deleted the feature/skeleton-migration-agent branch April 1, 2026 17:07
@publicuibot publicuibot bot locked and limited conversation to collaborators Apr 1, 2026
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants