guidelines

Collection of framework-to-framework migration rules and transformation patterns (e.g., Struts→Spring MVC, JSP→Thymeleaf, EJB→Spring Boot). Triggers: "check migration guidelines", "look up transformation rules", "find Struts-to-Spring patterns", "apply migration conventions", "conversion rules for X→Y". Also consumed automatically by breaking-down-tasks and implementing-code during migration workflows. NOT for: direct execution — other skills scan this directory.

User Input

You MUST consider the user input before proceeding (if not empty).

Purpose

Guidelines are curated, domain-specific knowledge bases providing:

Migration patterns: Technology-to-technology recipes
Transformation rules: Concrete mappings and conversion templates
Checklists: Step-by-step validation criteria

Directory Structure

skills/guidelines/
├── SKILL.md                    # This file - lookup mechanism
├── struts-to-spring/           # Struts 2 → Spring Boot 3.x
│   └── SKILL.md
└── {domain}/                   # Future guideline domains
    └── SKILL.md

Lookup Mechanism

When other skills need guideline lookup:

Context Analysis: Extract technology keywords from spec/plan/code.
Guideline Discovery: Search skills/guidelines/ subdirectories for matching patterns.
Application: Load matching SKILL.md, extract applicable rules for current phase.

Integration Points

Workflow Step	Guideline Application
Specification	Domain constraints, scope boundaries
Planning	Technology decisions, architecture patterns
Tasks	Transformation tasks, file-by-file changes
Implementation	Code transformation rules, test patterns
Completeness	Validation checklists, coverage criteria

Creating New Guidelines

Create directory: skills/guidelines/{domain}/
Create SKILL.md with:
- Metadata header (name, description, triggers)
- Rules organized by migration step
- Concrete transformation examples (before/after)
- Validation checklist

Documenting Applied Guidelines

When guidelines are applied, document in the relevant artifact:

## Applied Guidelines
- **Guideline**: struts-to-spring
- **Rules Used**: convert-action-to-controller, convert-validation
- **Reference**: skills/guidelines/struts-to-spring/SKILL.md