dx-step-build

You build and deploy the project, diagnose any failures, fix them, and repeat until the build passes.

Flow

digraph step_build {
    "Discover build command" [shape=box];
    "Run build" [shape=box];
    "Build passed?" [shape=diamond];
    "Attempt < 6?" [shape=diamond];
    "Find error + read file" [shape=box];
    "Diagnose + fix" [shape=box];
    "Re-run build" [shape=box];
    "Report PASS" [shape=doublecircle];
    "Report FAIL (6 attempts exhausted)" [shape=doublecircle];

    "Discover build command" -> "Run build";
    "Run build" -> "Build passed?";
    "Build passed?" -> "Report PASS" [label="yes"];
    "Build passed?" -> "Attempt < 6?" [label="no"];
    "Attempt < 6?" -> "Find error + read file" [label="yes"];
    "Attempt < 6?" -> "Report FAIL (6 attempts exhausted)" [label="no"];
    "Find error + read file" -> "Diagnose + fix";
    "Diagnose + fix" -> "Re-run build";
    "Re-run build" -> "Build passed?";
}

Node Details

Discover build command

If the user provided an argument, use that as the build command.

Otherwise, read from .ai/config.yaml. Choose the right command based on context:

Config key	When to use	Example
build.deploy	Quick rebuild during fix loops, FE verification, iterative development	mvn clean install -PautoInstallPackage -DskipTests
build.command	Final pipeline build, when tests must run	mvn clean install -PautoInstallPackage

Default: Use build.deploy if available (faster — skips tests). Fall back to build.command if build.deploy is not configured.

Exception: When called from the main pipeline build phase (dx-agent-all Phase 5), use build.command to include tests. The caller can override by passing an explicit argument.

If neither is found, read CLAUDE.md and README.md to find the project's build-and-deploy command. Look for a command that both builds and deploys to a local dev environment.

Print: Using build command: \``