github/awesome-copilot

Before Network or broad shell → After Network or broad shell

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Network or broad shell

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Network or broad shell

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Network or broad shell

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Instructions only

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Local scripts → After Network or broad shell

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Local scripts

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Network or broad shell

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Network or broad shell

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Local scripts → After Network or broad shell

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Local scripts

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Network or broad shell

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Network or broad shell

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Instructions only

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Network or broad shell

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Instructions only

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Instructions only

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Network or broad shell

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Local scripts → After Network or broad shell

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Local scripts

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Network or broad shell

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Instructions only

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Network or broad shell

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Network or broad shell

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Network or broad shell

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Network or broad shell

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Network or broad shell

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Network or broad shell

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Network or broad shell

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Instructions only

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Network or broad shell

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Network or broad shell

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Instructions only

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Instructions only

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Instructions only

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Network or broad shell

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Instructions only

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Network or broad shell

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Network or broad shell

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Network or broad shell

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Network or broad shell

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Network or broad shell

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Network or broad shell

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Network or broad shell

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Network or broad shell

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Instructions only

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Instructions only

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Network or broad shell

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Local scripts → After Local scripts

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Local scripts

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Instructions only

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Instructions only

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Instructions only

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Network or broad shell

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Instructions only

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Network or broad shell

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Instructions only

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Network or broad shell

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Instructions only

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Instructions only

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Local scripts → After Network or broad shell

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Local scripts

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Instructions only

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Local scripts → After Network or broad shell

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Local scripts

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Network or broad shell

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Instructions only

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Instructions only

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Instructions only

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Instructions only

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Instructions only

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Local scripts → After Network or broad shell

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Local scripts

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Network or broad shell

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Instructions only

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Network or broad shell

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Instructions only

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Instructions only

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Instructions only

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Network or broad shell

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Network or broad shell

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Network or broad shell

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Instructions only

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Network or broad shell

0fe6545b9506 → edbecfa9099c

- 3 description: Build agentic applications with GitHub Copilot SDK. Use when embedding AI agents in apps, creating custom tools, implementing streaming responses, managing sessions, connecting to MCP servers, or creating custom agents. Triggers on Copilot SDK, GitHub SDK, agentic app, embed Copilot, programmable agent, MCP server, custom agent.
+ 3 description: Build agentic applications with the Microsoft Copilot SDK, transitioning from GitHub Copilot SDK. Use when embedding AI agents in apps, creating custom tools, implementing streaming responses, managing sessions, connecting to MCP servers, or creating custom agents. Triggers on Copilot SDK, Microsoft Copilot SDK, GitHub Copilot SDK, agentic app, embed Copilot, programmable agent, MCP server, custom agent.
- 6 # GitHub Copilot SDK
+ 6 # Microsoft Copilot SDK
- 12 The GitHub Copilot SDK exposes the same engine behind Copilot CLI: a production-tested agent runtime you can invoke programmatically. No need to build your own orchestration - you define agent behavior, Copilot handles planning, tool invocation, file edits, and more.
+ 12 The Microsoft Copilot SDK is transitioning from the GitHub Copilot SDK. It is becoming the programmable interface for the Microsoft Copilot harness, the shared agent foundation used across Microsoft and GitHub products. This transition is happening in phases, and no immediate changes are required for existing users. Package names, namespaces, and some documentation may continue to use GitHub branding during the transition.
+ 13 
+ 14 This guide keeps the currently published package names and imports in its examples. Follow the [official transition announcement](https://github.blog/changelog/2026-10-28-github-copilot-sdk-is-becoming-microsoft-copilot-sdk/) for migration updates.
+ 15 
+ 16 The SDK provides a production-tested agent runtime you can invoke programmatically. You define agent behavior, while Copilot handles planning, tool invocation, file edits, and more.

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Network or broad shell

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Local scripts → After Local scripts

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Local scripts

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Instructions only

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Instructions only

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Instructions only

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Instructions only

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Instructions only

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Instructions only

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Instructions only

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Network or broad shell

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Instructions only

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Network or broad shell

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Network or broad shell

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Instructions only

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

0fe6545b9506 → edbecfa9099c

- 3 description: 'Create Spring Boot Java Project Skeleton'
+ 3 description: 'Create a new Spring Boot Java project (Maven or Gradle) from start.spring.io with sensible defaults for configuration, PostgreSQL, logging, security, testing and Docker. Use when asked to scaffold, bootstrap or generate a Spring Boot application. Detects existing project versions and never upgrades implicitly.'
- 6 # Create Spring Boot Java project prompt
+ 6 # Create a Spring Boot Java project
- 8 - Please make sure you have the following software installed on your system:
+ 8 Scaffold a Spring Boot application with [start.spring.io](https://start.spring.io), then apply a small set of opinionated defaults. Out of scope for now: front-ends (Vue/React/Angular), cloud deployment (Azure), Git setup, CRaC and AOT images.
- 10   - Java 21
- 11   - Docker
- 12   - Docker Compose
+ 10 ## Step 0: Detect before you create
- 14 - If you need to custom the project name, please change the `artifactId` and the `packageName` in [download-spring-boot-project-template](#download-spring-boot-project-template)
+ 12 - If the working directory already contains a `pom.xml` or `build.gradle(.kts)`, this is an **existing project**: do not regenerate it. Read its Spring Boot, Java and test-framework versions and follow them. **Never upgrade versions implicitly**; propose an upgrade and wait for the user's decision.
+ 13 - Check the tools: `java -version` (JDK matching the chosen Java version), `docker --version` (needed for Testcontainers and Compose). On the default path (current Boot via start.spring.io) Maven/Gradle need not be installed: the generated wrapper is used. The Boot 3.5 fallback needs Maven or Gradle installed once to create the wrapper (see [versions.md](references/versions.md)).
+ 14 - Ask only for what is missing: project name, group id, package, build tool (default **Maven**), dependencies (default: web, actuator, validation, devtools; add `data-jpa`, `postgresql`, `security`, `docker-compose`, `testcontainers` when a database or auth is needed).
- 16 - If you need to update the Spring Boot version, please change the `bootVersion` in [download-spring-boot-project-template](#download-spring-boot-project-template)
+ 16 ## Step 1: Resolve versions
- 18 ## Check Java version
+ 18 Follow [references/versions.md](references/versions.md): query `https://start.spring.io/metadata/client` at run time for the latest stable Spring Boot release, fall back to the documented pinned values if offline. Do not hardcode `latest` anywhere.
- 20 - Run following command in terminal and check the version of Java
+ 20 ## Step 2: Generate the project
- 22 ```shell
- 23 java -version
+ 22 Use the start.spring.io HTTP API with explicit, pinned parameters (no piped installers). Replace the values in capitals.
+ 23 
+ 24 Maven:
+ 25 
+ 26 ```bash
+ 27 curl -fsS https://start.spring.io/starter.zip \
+ 28   -d type=maven-project -d language=java -d packaging=jar \
+ 29   -d bootVersion=BOOT_VERSION -d javaVersion=JAVA_VERSION \
+ 30   -d groupId=com.example -d artifactId=demo -d name=demo \
+ 31   -d packageName=com.example.demo -d baseDir=demo \
+ 32   -d dependencies=web,actuator,validation,devtools \
+ 33   -o demo.zip && unzip -q demo.zip && rm demo.zip
- 26 ## Download Spring Boot project template
+ 36 Gradle: same command with `-d type=gradle-project` (Groovy DSL) or `-d type=gradle-project-kotlin` (Kotlin DSL; the language stays `java`).
- 28 - Run following command in terminal to download a Spring Boot project template
+ 38 Inspect the result (`ls demo`, read the build file) and make sure the wrapper (`mvnw` or `gradlew`) is executable. Add `-d dependencies=...,data-jpa,postgresql,docker-compose,testcontainers` for a database project.
- 30 ```shell
- 31 curl https://start.spring.io/starter.zip \
- 32   -d artifactId=${input:projectName:demo-java} \
- 33   -d bootVersion=3.4.5 \
- 34   -d dependencies=lombok,configuration-processor,web,data-jpa,postgresql,data-redis,data-mongodb,validation,cache,testcontainers \
- 35   -d javaVersion=21 \
- 36   -d packageName=com.example \
- 37   -d packaging=jar \
- 38   -d type=maven-project \
- 39   -o starter.zip
- 40 ```
+ 40 ## Step 3: Apply the defaults
- 42 ## Unzip the downloaded file
+ 42 | Area | What to do | Reference |
+ 43 |------|-----------|-----------|
+ 44 | Boot 3 vs 4 differences | Starter names, Jackson 3, test modules | [references/spring-boot-4.md](references/spring-boot-4.md) |
+ 45 | Configuration | `application.properties` or `.yml` (match the project), profiles, `@ConfigurationProperties`, secrets via environment | [references/configuration.md](references/configuration.md) |
+ 46 | Database | PostgreSQL, Hibernate settings, Compose for dev, Testcontainers for tests | [references/database.md](references/database.md) |
+ 47 | Logging | SLF4J, parameterized messages, levels, structured logging | [references/logging.md](references/logging.md) |
+ 48 | Security | Spring Security basics, secure defaults, Problem Details | [references/security.md](references/security.md) |
+ 49 | Docker | JVM image and GraalVM native image Dockerfiles | [references/docker.md](references/docker.md) |
+ 50 | Testing | See the `spring-boot-testing` skill (slices, Testcontainers, Failsafe) | `skills/spring-boot-testing` |
+ 51 | Best practices | See the `java-springboot` skill and `instructions/springboot.instructions.md` | `skills/java-springboot` |
- 44 - Run following command in terminal to unzip the downloaded file
+ 53 Keep dotfiles minimal: a `.gitignore` covering `target/`, `build/`, `.gradle/`, IDE folders and `.env`; never commit `.env` (commit a `.env.sample`).
- 46 ```shell
- 47 unzip starter.zip -d ./${input:projectName:demo-java}
- 48 ```
+ 55 ## Step 4: Verify
- 50 ## Remove the downloaded zip file
+ 57 1. Build and test: `./mvnw verify` (Maven) or `./gradlew build` (Gradle).
+ 58 2. Run: `./mvnw spring-boot:run` or `./gradlew bootRun`, then `curl -fsS localhost:8080/actuator/health` must return `{"status":"UP"}`.
+ 59 3. Report the chosen versions and anything that was skipped or deferred.
- 52 - Run following command in terminal to delete the downloaded zip file
+ 61 ## Provenance
- 54 ```shell
- 55 rm -f starter.zip
- 56 ```
- 57 
- 58 ## Change directory to the project root
- 59 
- 60 - Run following command in terminal to change directory to the project root
- 61 
- 62 ```shell
- 63 cd ${input:projectName:demo-java}
- 64 ```
- 65 
- 66 ## Add additional dependencies
- 67 
- 68 - Insert `springdoc-openapi-starter-webmvc-ui` and `archunit-junit5` dependency into `pom.xml` file
- 69 
- 70 ```xml
- 71 <dependency>
- 72   <groupId>org.springdoc</groupId>
- 73   <artifactId>springdoc-openapi-starter-webmvc-ui</artifactId>
- 74   <version>2.8.6</version>
- 75 </dependency>
- 76 <dependency>
- 77   <groupId>com.tngtech.archunit</groupId>
- 78   <artifactId>archunit-junit5</artifactId>
- 79   <version>1.2.1</version>
- 80   <scope>test</scope>
- 81 </dependency>
- 82 ```
- 83 
- 84 ## Add SpringDoc, Redis, JPA and MongoDB configurations
- 85 
- 86 - Insert SpringDoc configurations into `application.properties` file
- 87 
- 88 ```properties
- 89 # SpringDoc configurations
- 90 springdoc.swagger-ui.doc-expansion=none
- 91 springdoc.swagger-ui.operations-sorter=alpha
- 92 springdoc.swagger-ui.tags-sorter=alpha
- 93 ```
- 94 
- 95 - Insert Redis configurations into `application.properties` file
- 96 
- 97 ```properties
- 98 # Redis configurations
- 99 spring.data.redis.host=localhost
- 100 spring.data.redis.port=6379

This preview is limited. See the complete change on GitHub.

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Instructions only

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Instructions only

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Network or broad shell

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Instructions only

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Instructions only

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Instructions only

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Network or broad shell

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Instructions only

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Instructions only

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Network or broad shell

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Local scripts → After Network or broad shell

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Local scripts

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Network or broad shell

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Local scripts → After Network or broad shell

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Local scripts

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Instructions only

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Local scripts → After Network or broad shell

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Local scripts

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Instructions only

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Network or broad shell

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Instructions only

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Network or broad shell

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Instructions only

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Instructions only

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Network or broad shell

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Instructions only

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Instructions only

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Instructions only

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Instructions only

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Network or broad shell

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Instructions only

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Instructions only

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Instructions only

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Instructions only

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Instructions only

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Network or broad shell

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Local scripts → After Network or broad shell

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Local scripts

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Local scripts → After Network or broad shell

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Local scripts

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Instructions only

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Instructions only

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Network or broad shell

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Network or broad shell

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Instructions only

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → edbecfa9099c

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Network or broad shell

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Instructions only

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Local scripts → After Network or broad shell

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Local scripts

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Network or broad shell

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Instructions only

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Instructions only

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Instructions only

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Instructions only

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Instructions only

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Instructions only

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Instructions only

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Instructions only

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Network or broad shell

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Network or broad shell

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Instructions only

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Instructions only

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Instructions only

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Instructions only

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Network or broad shell

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Instructions only

0fe6545b9506 → edbecfa9099c

+ 8 ## When to Use
+ 9 
+ 10 Use for DevOps, platform, container, pipeline, or release tasks - any work that touches infrastructure, deployment, CI/CD, Docker, Kubernetes, health checks, rollback, feature flags, production readiness, or mobile release workflows.
+ 11 
+ 12 ## Numbered Workflow
+ 13 
+ 14 1. **Assess** - identify workload type, target provider/environment, acceptance criteria, and risk level.
+ 15 2. **Classify** - select applicable sections (deployment strategy, Docker, K8s, CI/CD, health, config, rollback, feature flags, mobile) based on workload/provider/environment.
+ 16 3. **Plan** - for each selected section, define concrete steps, validation checks, and rollback triggers.
+ 17 4. **Apply** - execute the plan, running validation at each gate (lint -> typecheck -> unit -> integration -> preview -> smoke).
+ 18 5. **Verify** - confirm health endpoints, monitoring, rollback capability, and documented outcome.
+ 19 6. **Rollback-ready** - ensure a tested rollback path exists before declaring success.
+ 20 
+ 21 ## Edge Cases
+ 22 
+ 23 - Idempotent re-run: workflow must be safe to execute multiple times without side effects.
+ 24 - Missing credentials: fail fast with clear error; never proceed with partial auth.
+ 25 - Workload without health endpoint: deploy but flag as incomplete; require health endpoint before production promotion.
+ 26 - Image digest pinning: always pin by digest (`image@sha256:...`) not tag for production.
+ 27 - Phased rollout rollback: if canary/blue-green rollout fails, revert traffic split instantly; do not wait for full rollback.
+ 28 
+ 29 ---
+ 30 
- 13 - Blue-green: duplicate environments, atomic cutover, instant rollback, 2× infra.
+ 36 - Blue-green: duplicate environments, atomic cutover, instant rollback, 2x infra.

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Network or broad shell

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Instructions only

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Instructions only

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Network or broad shell

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Instructions only

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Network or broad shell

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Instructions only

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Instructions only

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Network or broad shell

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Network or broad shell

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Network or broad shell

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Network or broad shell

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Network or broad shell

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Network or broad shell

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Network or broad shell

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Instructions only

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Instructions only

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Instructions only

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Instructions only

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Instructions only

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Instructions only

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Instructions only

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Instructions only

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Network or broad shell

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Network or broad shell

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Network or broad shell

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Network or broad shell

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Network or broad shell

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Network or broad shell

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Network or broad shell

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Instructions only

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Instructions only

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Network or broad shell

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Network or broad shell

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Network or broad shell

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Network or broad shell

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Network or broad shell

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Instructions only

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Instructions only

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Instructions only

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Instructions only

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Instructions only

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Instructions only

0fe6545b9506 → edbecfa9099c

- 3 description: 'Get best practices for developing applications with Spring Boot.'
+ 3 description: 'Write and review application code in an existing Spring Boot 3/4 project: controllers, validation and ProblemDetail errors, Spring Data JPA/JDBC, RestClient and HTTP interfaces, configuration properties, Kafka/AMQP, caching, scheduling, virtual threads, AOT and startup tuning. Use when adding or changing features. To scaffold a new project use create-spring-boot-java-project instead.'
- 6 # Spring Boot Best Practices
+ 6 # Spring Boot application development
- 8 Your goal is to help me write high-quality Spring Boot applications by following established best practices.
+ 8 Opinionated rules plus a router to deeper references. Code samples in the references were compiled and run on Spring Boot 4.1.1 (Spring Framework 7) and, where they differ, on Boot 3.5.16 (Framework 6.2). Boot 3 vs 4 differences are marked "Boot 3" / "Boot 4" in each reference.
- 10 ## Project Setup & Structure
+ 10 ## Before writing code
- 12 - **Build Tool:** Use Maven (`pom.xml`) or Gradle (`build.gradle`) for dependency management.
- 13 - **Starters:** Use Spring Boot starters (e.g., `spring-boot-starter-web`, `spring-boot-starter-data-jpa`) to simplify dependency management.
- 14 - **Package Structure:** Organize code by feature/domain (e.g., `com.example.app.order`, `com.example.app.user`) rather than by layer (e.g., `com.example.app.controller`, `com.example.app.service`).
+ 12 1. **Detect, do not assume:** read `pom.xml`/`build.gradle(.kts)` for the Spring Boot version, Java version, starters in use (`spring-boot-starter-web` is Boot 3, `spring-boot-starter-webmvc` is Boot 4), persistence (JPA, JDBC), the migration tool, the test setup, and the package layout and naming conventions of the existing code. Match them.
+ 13 2. **Never upgrade Spring Boot, Java or dependencies implicitly.** A Boot 3 -> 4 move is a deliberate task (`spring-boot-4-migration`).
+ 14 3. **Ask before adding infrastructure:** a broker (Kafka, RabbitMQ), a cache provider, a new database, or a scheduler/async setup. Add only what the user requested, with the Boot-managed version (no explicit version for BOM-managed artifacts, never `latest`).
+ 15 4. **Verify every change** with the project's own build: `./mvnw verify` or `./gradlew build` (plain `mvn`/`gradle` if no wrapper). Integration tests need Docker when they use Testcontainers.
- 16 ## Dependency Injection & Components
+ 17 ## Router
- 18 - **Constructor Injection:** Always use constructor-based injection for required dependencies. This makes components easier to test and dependencies explicit.
- 19 - **Immutability:** Declare dependency fields as `private final`.
- 20 - **Component Stereotypes:** Use `@Component`, `@Service`, `@Repository`, and `@Controller`/`@RestController` annotations appropriately to define beans.
+ 19 | Task | Read |
+ 20 | --- | --- |
+ 21 | Repositories, projections, pagination, N+1, `@Transactional`, auditing, Flyway/Liquibase, Spring Data JDBC | `references/data.md` |
+ 22 | Controllers, validation, `ProblemDetail`, `RestClient`, `@HttpExchange`, API versioning, OpenAPI, JSpecify | `references/rest-api.md` |
+ 23 | Kafka/AMQP, `@Cacheable`/Caffeine, `@Scheduled`, `@Async`, virtual threads, outbox | `references/messaging-caching.md` |
+ 24 | `@ConfigurationProperties`, profiles, secrets, config import, Docker Compose / Testcontainers at dev time | `references/configuration.md` |
+ 25 | AOT, CDS/AppCDS, lazy initialization, native image | `references/aot-and-startup.md` |
- 22 ## Configuration
+ 27 If these standalone skills are installed, also use them for their topic; otherwise rely on the official docs: `java-hibernate-jpa` (JPA mapping), `spring-boot-testing` (tests), `spring-security` (authentication, authorization, CSRF/CORS), `spring-observability` (metrics, tracing, Actuator, logs), `create-spring-boot-java-project` (project defaults, Boot 3 vs 4 build changes), `java-add-graalvm-native-image-support` (native executable).
- 24 - **Externalized Configuration:** Use `application.yml` (or `application.properties`) for configuration. YAML is often preferred for its readability and hierarchical structure.
- 25 - **Type-Safe Properties:** Use `@ConfigurationProperties` to bind configuration to strongly-typed Java objects.
- 26 - **Profiles:** Use Spring Profiles (`application-dev.yml`, `application-prod.yml`) to manage environment-specific configurations.
- 27 - **Secrets Management:** Do not hardcode secrets. Use environment variables, or a dedicated secret management tool like HashiCorp Vault or AWS Secrets Manager.
+ 29 ## Core rules
- 29 ## Web Layer (Controllers)
+ 31 - **Structure and layers:** package by feature; constructor injection; controllers return DTOs/records, never entities; services own the transaction.
+ 32 - **Validation and errors:** Bean Validation on request records with `@Valid`; one `@RestControllerAdvice` returning `ProblemDetail`. JSpecify annotations document nullability only and do not validate.
+ 33 - **Jackson:** Boot 4 uses Jackson 3 (`tools.jackson.databind.*`, `JsonMapper`; annotations stay in `com.fasterxml.jackson.annotation`); Boot 3 uses Jackson 2 (`com.fasterxml.jackson.databind.*`, `ObjectMapper`).
+ 34 - **Slice-test gotcha:** put `@EnableJpaAuditing`, `@EnableCaching`, `@EnableAsync`, `@EnableScheduling` on dedicated `@Configuration` classes, not on the `@SpringBootApplication` class, or slices such as `@DataJpaTest` fail to start (for example, no `CacheManager`). Slices do not scan `@Configuration` classes: `@Import` the one a test needs.
+ 35 - **Proxied beans:** `@Cacheable`, `@Async` and `@Transactional` work through proxies: they do nothing on self-invocation or on `private`/`final` methods; test them through the injected bean.
- 31 - **RESTful APIs:** Design clear and consistent RESTful endpoints.
- 32 - **DTOs (Data Transfer Objects):** Use DTOs to expose and consume data in the API layer. Do not expose JPA entities directly to the client.
- 33 - **Validation:** Use Java Bean Validation (JSR 380) with annotations (`@Valid`, `@NotNull`, `@Size`) on DTOs to validate request payloads.
- 34 - **Error Handling:** Implement a global exception handler using `@ControllerAdvice` and `@ExceptionHandler` to provide consistent error responses.
+ 37 ## Checklist
- 36 ## Service Layer
+ 39 - [ ] Versions, build tool and conventions detected; starters match the Boot major
+ 40 - [ ] No new infrastructure or dependency without the user's agreement
+ 41 - [ ] `./mvnw verify` / `./gradlew build` passes; secrets absent from code, properties and logs
- 38 - **Business Logic:** Encapsulate all business logic within `@Service` classes.
- 39 - **Statelessness:** Services should be stateless.
- 40 - **Transaction Management:** Use `@Transactional` on service methods to manage database transactions declaratively. Apply it at the most granular level necessary.
- 41 
- 42 ## Data Layer (Repositories)
- 43 
- 44 - **Spring Data JPA:** Use Spring Data JPA repositories by extending `JpaRepository` or `CrudRepository` for standard database operations.
- 45 - **Custom Queries:** For complex queries, use `@Query` or the JPA Criteria API.
- 46 - **Projections:** Use DTO projections to fetch only the necessary data from the database.
- 47 
- 48 ## Logging
- 49 
- 50 - **SLF4J:** Use the SLF4J API for logging.
- 51 - **Logger Declaration:** `private static final Logger logger = LoggerFactory.getLogger(MyClass.class);`
- 52 - **Parameterized Logging:** Use parameterized messages (`logger.info("Processing user {}...", userId);`) instead of string concatenation to improve performance.
- 53 
- 54 ## Testing
- 55 
- 56 - **Unit Tests:** Write unit tests for services and components using JUnit 5 and a mocking framework like Mockito.
- 57 - **Integration Tests:** Use `@SpringBootTest` for integration tests that load the Spring application context.
- 58 - **Test Slices:** Use test slice annotations like `@WebMvcTest` (for controllers) or `@DataJpaTest` (for repositories) to test specific parts of the application in isolation.
- 59 - **Testcontainers:** Consider using Testcontainers for reliable integration tests with real databases, message brokers, etc.
- 60 
- 61 ## Security
- 62 
- 63 - **Spring Security:** Use Spring Security for authentication and authorization.
- 64 - **Password Encoding:** Always encode passwords using a strong hashing algorithm like BCrypt.
- 65 - **Input Sanitization:** Prevent SQL injection by using Spring Data JPA or parameterized queries. Prevent Cross-Site Scripting (XSS) by properly encoding output.
+ 43 See also: Spring Boot reference <https://docs.spring.io/spring-boot/reference/>, Spring Framework reference <https://docs.spring.io/spring-framework/reference/>, Spring Data <https://docs.spring.io/spring-data/commons/reference/>.

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Instructions only

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Network or broad shell

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Instructions only

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Instructions only

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Network or broad shell

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Instructions only

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Network or broad shell

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Local scripts → After Network or broad shell

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Local scripts

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Network or broad shell

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → edbecfa9099c

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Network or broad shell

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Network or broad shell

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Instructions only

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Local scripts → After Network or broad shell

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Local scripts

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Network or broad shell

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Network or broad shell

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Instructions only

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Instructions only

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Instructions only

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Instructions only

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Network or broad shell

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

0fe6545b9506 → edbecfa9099c

- 8   - Detecting mutable npm/npx, bunx, pnpm dlx, yarn dlx, and npm exec references in MCP configurations
+ 8   - Detecting mutable npm/npx, bunx, pnpm dlx, yarn dlx, npm exec, uvx, uv tool run, and pipx run references in MCP configurations
- 159 def split_package_spec(spec: str):
- 160     """Split npm-style package selectors, including scoped packages."""
+ 159 EXACT_PYTHON = re.compile(r"^===?\s*\d+(?:\.\d+)*(?:(?:a|b|rc)\d+)?(?:\.post\d+)?(?:\.dev\d+)?$")
+ 160 PYTHON_SPEC = re.compile(r"([A-Za-z0-9][A-Za-z0-9._-]*(?:\[[^\]]*\])?)\s*((?:===?|~=|!=|<=?|>=?)\s*.+)")
+ 161 PYTHON_RUNNERS = {"uvx", "uvx.exe", "uv", "uv.exe", "pipx", "pipx.exe"}
+ 162 
+ 163 
+ 164 def launcher_name(server_config: dict) -> str:
+ 165     return str(server_config.get("command", "")).replace("\\", "/").rsplit("/", 1)[-1].lower()
+ 166 
+ 167 
+ 168 def split_package_spec(spec: str, python: bool = False):
+ 169     """Split npm-style selectors (including scoped packages) or Python requirements."""
+ 171     requirement = PYTHON_SPEC.fullmatch(spec) if python else None
+ 172     if requirement:
+ 173         return requirement.group(1), requirement.group(2)  # e.g. ("pkg", "==1.2.0")
- 176     command = str(server_config.get("command", "")).replace("\\", "/").rsplit("/", 1)[-1].lower()
+ 188     command = launcher_name(server_config)
- 180     if command in {"npm", "npm.cmd"}:
+ 192     package_flags = {"-p", "--package"}
+ 193     ignored_flags = {"-y", "--yes", "--no", "--quiet"}
+ 194     if command in PYTHON_RUNNERS:
+ 195         if command in {"uv", "uv.exe"}:
+ 196             if args[:2] != ["tool", "run"]:
+ 197                 return None
+ 198             args = args[2:]
+ 199         elif command in {"pipx", "pipx.exe"}:
+ 200             if not args or args[0] != "run":
+ 201                 return None
+ 202             args = args[1:]
+ 203         # uvx -p means --python, so only the requirement flags name packages.
+ 204         package_flags = {"--spec"} if command.startswith("pipx") else {"--from"}
+ 205         ignored_flags = set()
+ 206     elif command in {"npm", "npm.cmd"}:
- 195         if arg in {"-p", "--package"}:
+ 221         if arg in package_flags:
- 200         elif arg.startswith("--package="):
+ 226         elif arg.startswith("--") and arg.split("=", 1)[0] in package_flags:
- 204         elif arg in {"-y", "--yes", "--no", "--quiet"}:
+ 230         elif arg in ignored_flags:
+ 247     python = launcher_name(server_config) in PYTHON_RUNNERS
+ 248     if specs and python and any("://" in s or " @ " in s or s.startswith(("git+", ".", "/", "~", "file:")) for s in specs):
+ 249         specs = None  # Git, URL, and path sources: a tag or file can change; review by hand.
- 230         package, version = split_package_spec(spec)
- 231         if version and EXACT_SEMVER.fullmatch(version):
+ 259         package, version = split_package_spec(spec, python)
+ 260         if version and (EXACT_SEMVER.fullmatch(version) or EXACT_PYTHON.fullmatch(version)):
+ 276 { "command": "uvx", "args": ["my-mcp-server@2.1.0"] }
+ 277 { "command": "uvx", "args": ["--from", "my-mcp-server==2.1.0", "my-mcp-server"] }
- 254 ```
- 255 
- 256 The extractor reviews every explicit `--package` / `-p` selector. Unknown launchers or flags require manual review rather than a clean result. An exact direct selector does not prove package integrity, benign behavior, or reproducibility of transitive dependencies without a lockfile.
+ 285 { "command": "uvx", "args": ["my-mcp-server"] }
+ 286 { "command": "pipx", "args": ["run", "--spec", "my-mcp-server>=2.1", "my-mcp-server"] }
+ 287 ```
+ 288 
+ 289 The extractor reviews every explicit `--package` / `-p` selector for JavaScript runners, and every `--from` (`uvx`, `uv tool run`) or `--spec` (`pipx run`) requirement for Python runners. For `uvx`, `-p` selects the Python interpreter, not a package. Git, URL, and local path sources for Python runners (for example `git+https://...@v1.0.0`) go to manual review, because a tag or file can change behind an exact-looking reference. Unknown launchers or flags require manual review rather than a clean result. An exact direct selector does not prove package integrity, benign behavior, or reproducibility of transitive dependencies without a lockfile.

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Local scripts → After Network or broad shell

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Local scripts

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Network or broad shell

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Instructions only

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Instructions only

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Network or broad shell

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Network or broad shell

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Network or broad shell

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Local scripts → After Network or broad shell

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Local scripts

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Network or broad shell

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Network or broad shell

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Network or broad shell

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Local scripts → After Network or broad shell

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Local scripts

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Network or broad shell

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Instructions only

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Network or broad shell

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Network or broad shell

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Network or broad shell

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Network or broad shell

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Instructions only

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Instructions only

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Instructions only

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Instructions only

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Network or broad shell

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Instructions only

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → edbecfa9099c

No earlier version was observed for comparison.

Compare on GitHub

Before Local scripts → After Network or broad shell

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Local scripts

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Instructions only

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Network or broad shell

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Network or broad shell

0fe6545b9506 → edbecfa9099c

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → 0fe6545b9506

No earlier version was observed for comparison.

Compare on GitHub