Build and Run

When to Use

• Confirm the codebase compiles, reproduce a runtime issue locally, or validate environment-dependent changes.

Rules

• Do not use production credentials or external services unless the user provides safe mocks/stubs.

• Use source setTestEnv.sh for local env needed by tests or the app.

• Prefer reproducible, minimal commands and capture key output lines.

Commands

• Compile: go build -v ./...

• Format: go fmt ./...

• Vet: go vet -v ./...

• Tidy deps: go mod tidy

• Run tests that reproduce an issue: source setTestEnv.sh && go test -run <TestName> ./pkg/path

• Start example app: cd example2/cmd/app && go run main.go (use with test env)

Output

• Result: success or failure.

• Key logs: first relevant error or stack lines.

• Minimal repro: 1-3 commands.

• Next steps: which logs/files to inspect or which mocks to add.

Examples

• "Does the project compile?" - run go build -v ./... and report.

• "Reproduce failing integration test X" - provide commands and first failing lines.

Related Skills

• test-runner , ci-orchestrator , fix-suggester

References

• AGENTS.md (build and run commands), setTestEnv.sh , llms.txt