feat: move Vaadin configuration to AppShell and document the Dev Loop

walking-skeleton/README-empty.md

@@ -37,6 +37,25 @@ The application is then available at http://localhost:8080. The `-m` option sets
 application uses up to 75% of it for the Java heap, which holds the UI state of all users, so adjust the limit to fit
 your application.
 
+## Agentic Development
+
+If you develop with an AI coding agent, such as Claude Code or Codex, enable the Vaadin Dev Loop. It lets the agent make
+its changes live in the running application with a single command, and tells it whether they took effect, without
+restarting the application or checking screenshots. To enable it, run:
+
+```bash
+./mvnw vaadin:install-dev-cli
+```
+
+This installs the Dev Loop CLI into `.vaadin/`, and skills that teach your agent how to use it into `.agents/skills/` and
+`.claude/skills/`. Commit these files with the rest of the project, and run the command again after upgrading Vaadin.
+
+The Dev Loop needs to own the application process, so start the application with `.vaadin/vaadin-dev start` instead of
+`./mvnw` or your IDE.
+
+The Dev Loop is a preview feature. To learn more, including how to give your agent access to the Vaadin documentation,
+see the [Dev Loop tutorial](https://vaadin.com/docs/v25/building-apps/agentic-development/dev-loop-tutorial).
+
 ## Getting Started
 
 The [Quick Start](https://vaadin.com/docs/v25/getting-started/quick-start) tutorial helps you get started with Vaadin in 

walking-skeleton/README-flow.md

@@ -20,7 +20,8 @@ src
 │       │   ├── Task.java
 │       │   ├── TaskRepository.java
 │       │   └── TaskService.java                
-│       └── Application.java     
+│       ├── Application.java
+│       └── AppShell.java
 ├── main/resources
 │   ├── META-INF
 │   │   └── resources
@@ -38,7 +39,8 @@ src
 ```
 
 The main entry point into the application is `Application.java`. This class contains the `main()` method that starts up 
-the Spring Boot application.
+the Spring Boot application. The Vaadin-specific configuration, such as stylesheets and server push, is in 
+`AppShell.java`.
 
 The project follows a *feature-based package structure*, organizing code by *functional units* rather than traditional 
 architectural layers. It includes two feature packages: `base` and `examplefeature`.
@@ -59,6 +61,25 @@ You can also start the application from the command line by running:
 ./mvnw
 ```
 
+## Agentic Development
+
+If you develop with an AI coding agent, such as Claude Code or Codex, enable the Vaadin Dev Loop. It lets the agent make
+its changes live in the running application with a single command, and tells it whether they took effect, without
+restarting the application or checking screenshots. To enable it, run:
+
+```bash
+./mvnw vaadin:install-dev-cli
+```
+
+This installs the Dev Loop CLI into `.vaadin/`, and skills that teach your agent how to use it into `.agents/skills/` and
+`.claude/skills/`. Commit these files with the rest of the project, and run the command again after upgrading Vaadin.
+
+The Dev Loop needs to own the application process, so start the application with `.vaadin/vaadin-dev start` instead of
+`./mvnw` or your IDE.
+
+The Dev Loop is a preview feature. To learn more, including how to give your agent access to the Vaadin documentation,
+see the [Dev Loop tutorial](https://vaadin.com/docs/v25/building-apps/agentic-development/dev-loop-tutorial).
+
 ## Building for Production
 
 To build the application in production mode, run:

walking-skeleton/src/main/java/com/example/application/AppShell.java

@@ -0,0 +1,12 @@
+package com.example.application;
+
+import com.vaadin.flow.component.dependency.StyleSheet;
+import com.vaadin.flow.component.page.AppShellConfigurator;
+import com.vaadin.flow.component.page.Push;
+import com.vaadin.flow.theme.aura.Aura;
+
+@StyleSheet(Aura.STYLESHEET)
+@StyleSheet("styles.css") // Your custom styles
+@Push
+public class AppShell implements AppShellConfigurator {
+}

walking-skeleton/src/main/java/com/example/application/Application.java

@@ -1,18 +1,10 @@
 package com.example.application;
 
-import com.vaadin.flow.theme.aura.Aura;
 import org.springframework.boot.SpringApplication;
 import org.springframework.boot.autoconfigure.SpringBootApplication;
 
-import com.vaadin.flow.component.dependency.StyleSheet;
-import com.vaadin.flow.component.page.AppShellConfigurator;
-import com.vaadin.flow.component.page.Push;
-
 @SpringBootApplication
-@StyleSheet(Aura.STYLESHEET)
-@StyleSheet("styles.css") // Your custom styles
-@Push
-public class Application implements AppShellConfigurator {
+public class Application {
 
     public static void main(String[] args) {
         SpringApplication.run(Application.class, args);