Skip to content

a-pavithraa/springboot-skills-marketplace / plugins/springboot-architecture/skills/spring-boot-team-harness

spring-boot-team-harness

Verified

Use when a team wants every developer's coding agent (Claude Code or Codex) to follow the same rules and coding conventions on a Maven or Gradle Spring Boot 4 repository: setting up AGENTS.md, coding standards, guardrails, shared agent settings, or build and CI checks that agents must pass before code merges. It adds ./mvnw verify or ./gradlew build gates that fail on null-safety bugs (NullAway with JSpecify), module-boundary breaches (Spring Modulith), unknown or deprecated Boot property keys, Spring mistakes that compile (ArchUnit) and unformatted code, Claude Code and Codex hooks that run those gates before a turn ends, and a CI workflow.

FileKindSize
SKILL.mdskill md20.3 KB
assets/gradle/harness.gradleother5.4 KB
assets/observability/HandledFailureFilter.javaother2.1 KB
assets/observability/InstallOpenTelemetryAppender.javaother877 B
assets/observability/LogLeakCheck.javaother3.3 KB
assets/observability/application-observability-defaults.ymlconfig1.9 KB
assets/observability/application-observability.ymlconfig445 B
assets/observability/check_dashboards.pyscript3.4 KB
assets/observability/check_request.pyscript6.6 KB
assets/observability/compose.observability.ymlconfig704 B
assets/observability/dashboards/jvm-resources.jsonconfig7.7 KB
assets/observability/dashboards/service-health.jsonconfig10.7 KB
assets/observability/grafana-provider.yamlconfig133 B
assets/observability/logback-spring.xmlconfig736 B
assets/observability/observability.mdmarkdown7.4 KB
assets/pom/dependencies.xmlconfig236 B
assets/pom/managed-dependencies.xmlconfig355 B
assets/pom/modules-dependencies.xmlconfig269 B
assets/pom/observability-dependencies.xmlconfig833 B
assets/pom/plugins.xmlconfig2.2 KB
assets/pom/properties.xmlconfig642 B
assets/pom/rules-dependencies.xmlconfig268 B
assets/project/.claude/hooks/guard.shscript7.2 KB
assets/project/.claude/hooks/verify-on-stop.shscript11.9 KB
assets/project/.claude/settings.jsonconfig1.4 KB
assets/project/.codex/hooks.jsonconfig858 B
assets/project/.github/harness/check-file-size.shscript3.7 KB
assets/project/.github/harness/check-protected.shscript10.0 KB
assets/project/.github/workflows/harness-integrity.ymlconfig1.6 KB
assets/project/.github/workflows/verify.ymlconfig440 B
assets/project/.mvn/jvm.configother644 B
assets/project/AGENTS.mdmarkdown10.2 KB
assets/project/CLAUDE.mdmarkdown11 B
assets/project/REVIEW.mdmarkdown2.6 KB
assets/tests/BuildSetupTests.javaother19.6 KB
assets/tests/CodeRulesTests.javaother42.2 KB
assets/tests/ConfigurationKeysTests.javaother14.2 KB
assets/tests/ModuleBoundariesTests.javaother10.3 KB
assets/tests/UnusedCodeTests.javaother9.3 KB
assets/tests/archunit.propertiesother106 B
references/browser-verification.mdmarkdown18.1 KB
references/gates.mdmarkdown7.7 KB
scripts/apply_harness.pyscript59.6 KB
scripts/baseline.pyscript8.9 KB
scripts/report.pyscript6.1 KB

assets/gradle/harness.gradle

View on GitHub
// The team harness's build gates. apply_harness.py owns this file and updates it on a rerun while nobody has edited
// it; change a version or a rule by rerunning the harness, not here.
buildscript {
    repositories {
        gradlePluginPortal()
    }
    dependencies {
        classpath "net.ltgt.gradle:gradle-errorprone-plugin:5.2.0"
        // spotless:begin
        classpath "com.diffplug.spotless:spotless-plugin-gradle:8.11.0"
        // spotless:end
    }
}

apply plugin: net.ltgt.gradle.errorprone.ErrorPronePlugin

dependencies {
    implementation "org.jspecify:jspecify:1.0.1"
    errorprone "com.google.errorprone:error_prone_core:2.51.0"
    errorprone "com.uber.nullaway:nullaway:0.14.3"
    // modules:begin
    testImplementation platform("org.springframework.modulith:spring-modulith-bom:2.1.2")
    testImplementation "org.springframework.modulith:spring-modulith-starter-test"
    // modules:end
    // archunit:begin
    testImplementation "com.tngtech.archunit:archunit:1.5.1"
    // archunit:end
    // observability:begin
    implementation "org.springframework.boot:spring-boot-starter-actuator"
    implementation "org.springframework.boot:spring-boot-starter-opentelemetry"
    implementation "io.opentelemetry.instrumentation:opentelemetry-logback-appender-1.0:2.28.1-alpha"
    // observability:end
    // datasource-observation:begin
    implementation "net.ttddyy.observation:datasource-micrometer-spring-boot:2.3.0"
    // datasource-observation:end
}

tasks.named("compileJava") {
    // Error Prone needs it on JDK 21 (21.0.8 or later); JDK 25 does this by default.
    options.compilerArgs += ["-XDaddTypeAnnotationsToSymbol=true"]
    // javac stops at 100 errors, which hides the rest of a codebase's NullAway findings.
    options.compilerArgs += ["-Xmaxerrs", "100000"]
    options.errorprone {
        excludedPaths = ".*/build/generated/.*"
        check("NullAway", net.ltgt.gradle.errorprone.CheckSeverity.ERROR)
        option("{{NULLAWAY_OPTION}}", "{{NULLAWAY_VALUE}}")
        option("NullAway:JSpecifyMode", "true")
    }
}
// Tests routinely dereference response bodies, so NullAway checks main code only.
tasks.named("compileTestJava") {
    options.errorprone.enabled = false
}

// The Stop hook formats only the session's files: -PharnessFiles=a.java,b.java.
def harnessFiles = providers.gradleProperty("harnessFiles").orNull
// spotless:begin
apply plugin: com.diffplug.gradle.spotless.SpotlessPlugin

spotless {
    java {
        target(harnessFiles ? harnessFiles.split(",") as List : "src/*/java/**/*.java")
        palantirJavaFormat("2.102.0")
        removeUnusedImports()
    }
}
// spotless:end
// own-spotless:begin
// The build's own Spotless formats; the harness narrows it to the session's files for the Stop hook only.
if (harnessFiles) {
    spotless {
        java {
            target(harnessFiles.split(",") as List)
        }
    }
}
// own-spotless:end

// BuildSetupTests reads the dependencies this build declares from here, in Maven scope terms, since a Gradle build
// file can't be read from Java.
def declaredScopes = [api: "compile", implementation: "compile", compileOnly: "provided", runtimeOnly: "runtime",
                      developmentOnly: "runtime", testImplementation: "test", testCompileOnly: "test",
                      testRuntimeOnly: "test"]
def declared = providers.provider {
    declaredScopes.findAll { name, scope -> configurations.findByName(name) }.collectMany { name, scope ->
        configurations.getByName(name).dependencies.withType(ExternalModuleDependency).collect { dependency ->
            "${scope} ${dependency.group}:${dependency.name}".toString()
        }
    }.join("\n")
}
def declaredReport = layout.buildDirectory.file("harness/declared-dependencies.txt")
def declaredDependencies = tasks.register("harnessDeclaredDependencies") {
    inputs.property("declared", declared)
    outputs.file(declaredReport)
    doLast {
        def report = declaredReport.get().asFile
        report.parentFile.mkdirs()
        report.text = declared.get() + "\n"
    }
}

// The gates the Stop hook runs: the ones that need no Docker. A test class the project lacks is skipped.
tasks.register("harnessCheck", Test) {
    description = "Runs the harness's fast gates."
    group = "verification"
    testClassesDirs = sourceSets.test.output.classesDirs
    classpath = sourceSets.test.runtimeClasspath
    filter {
        failOnNoMatchingTests = false
        ["CodeRulesTests", "ConfigurationKeysTests", "BuildSetupTests", "ModuleBoundariesTests", "ModularityTests",
         "ArchUnitTests", "ArchitectureRulesTest"].each { includeTestsMatching("*.${it}") }
    }
}

// Only baseline.py passes -Pharness.record=true: it records today's violations as accepted.
def recordViolations = providers.gradleProperty("harness.record").map { it == "true" }.orElse(false)
tasks.withType(Test).configureEach {
    useJUnitPlatform()
    dependsOn(declaredDependencies)
    systemProperty "harness.buildFile", "{{BUILD_FILE}}"
    systemProperty "harness.declaredDependencies", declaredReport.get().asFile.absolutePath
    if (recordViolations.get()) {
        systemProperty "archunit.freeze.store.default.allowStoreCreation", "true"
        systemProperty "modulith.store.record", "true"
    }
    // The failure messages say how to fix each rule, so they must reach the console, also under -q.
    testLogging {
        events "failed"
        exceptionFormat "full"
        quiet {
            events "failed"
            exceptionFormat "full"
        }
    }
}
reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 323kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 323kUpdated Claude CodeCodexVerifiedInstall
executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is availableStars: 323kUpdated Claude CodeCodexVerifiedInstall