spring-refresh

Spring Boot Skill Freshness

Check whether Spring Boot skills are current with the latest research docs.

Arguments

Parse $ARGUMENTS for mode:

• check (default, no args) — Scan and report freshness
• refresh — Update research docs via deep-research, then report
• update <skill-name> — Help update a specific skill's content

Mode: check

1. Run the freshness scanner:

python3 ${CLAUDE_SKILL_DIR}/scripts/scan_skill_freshness.py --format json ${CLAUDE_SKILL_DIR}/../..

2. Parse the JSON output and present a formatted report with:

   • Research doc staleness table (file, version, last updated, age, status)
   • Skill drift table (name, target version, last modified, research date, drift, status)
   • Summary counts (up-to-date, needs review, needs update)

3. For skills with NEEDS_REVIEW or NEEDS_UPDATE:

   • List which research docs they depend on
   • Suggest running /spring-refresh update <skill-name> for each

Mode: refresh

1. For each Spring Boot research doc, invoke the Skill tool with core:deep-research to refresh:

   • refresh spring-boot-ecosystem (for ecosystem-research.md)
   • refresh spring-boot-ddd-implementation (for ddd-implementation.md)
   • refresh spring-boot-security-observability-testing (for security-observability-testing.md)

2. After all research docs are refreshed, run the check mode to produce the updated report.

3. Show a before/after comparison of research doc dates.

Fallback: If the deep-research skill is not available, skip the research refresh and run check mode only. Inform the user they can manually update research docs.

Mode: update <skill-name>

1. Run check mode first to identify drift status for the specified skill.

2. Read the research docs that map to this skill:

   • spring-boot-ecosystem-research.md → scanner, verify, web-api, data-ddd, modulith, domain-driven-design
   • spring-boot-ddd-implementation.md → domain-driven-design, data-ddd, web-api, modulith
   • spring-boot-security-observability-testing.md → security, observability, testing

3. Read the skill's current content: SKILL.md, EXAMPLES.md, TROUBLESHOOTING.md, and all files in references/.

4. Compare research content against skill content. Identify:

   • New APIs or patterns in research not covered in the skill
   • Deprecated patterns in the skill that research has replaced
   • Version-specific changes (e.g., new Spring Boot minor version features)

5. Present proposed changes to the user for confirmation before editing.

6. After updates, bump the spring-boot-version field if targeting a new version.

Output Format

## Spring Boot Skill Freshness Report

### Research Documents
| Document | Version | Updated | Age | Status |
|----------|---------|---------|-----|--------|

### Skills
| Skill | Target | Modified | Research | Drift | Status |
|-------|--------|----------|----------|-------|--------|

### Recommendations
- [actionable items]

References

• EXAMPLES.md for usage examples
• TROUBLESHOOTING.md for common issues
• Research docs (local): docs/research/spring-boot-*.md
• Research docs on GitHub