Configuration & Tips

Configuration & Tips

Default run

arxo analyze --fail-fast
# Or with a config file
arxo analyze --config .arxo.ci.yaml --fail-fast

Custom config

Create .arxo.ci.yaml to tune metrics and policy:

metrics:
  - id: agent_architecture
  - id: openclaw_architecture

policy:
  invariants:
    - metric: agent_architecture.overall_agent_health
      op: ">="
      value: 0.7
      message: "Agent architecture health below threshold"
    - metric: agent_architecture.safety_protocol_score
      op: ">="
      value: 80
      message: "Safety protocol score too low"

Use in CI:

arxo analyze --config .arxo.ci.yaml

See Agent Architecture scoring and keys and Policy and CI Gates.

Performance

Cache analysis results

# GitHub Actions
- uses: actions/cache@v3
  with:
    path: ~/.cache/arxo
    key: arxo-${{ hashFiles('**/*.ts') }}

Exclude unnecessary files

data:
  import_graph:
    exclude:
      - "**/node_modules/**"
      - "**/dist/**"
      - "**/test/**"

Notifications

Slack

#!/bin/bash
STATUS=$(arxo analyze --format json --output report.json && echo "success" || echo "failure")
if [ "$STATUS" = "failure" ]; then
  VIOLATIONS=$(jq '.violations | length' report.json)
  curl -X POST -H 'Content-type: application/json' \
    --data "{\"text\":\"❌ Architecture violations: $VIOLATIONS\"}" \
    $SLACK_WEBHOOK_URL
fi

Microsoft Teams

if ! arxo analyze; then
  curl -H 'Content-Type: application/json' \
    -d '{
      "@type": "MessageCard",
      "title": "Architecture Violations",
      "text": "CI build failed due to architecture violations"
    }' \
    $TEAMS_WEBHOOK_URL
fi

Next steps

• CI/CD Integration — Overview
• Configuration — Full config reference