Claude Architect Lab

CI/CD Structured Output & Incremental Reviews

Advanced

Integrate Claude Code into CI/CD pipelines · Difficulty 3/5

0%
ci-cdstructured-outputincremental-reviewtest-generation
Prerequisites
CI/CD Integration with Claude Code

Production CI/CD integrations require structured output for automation and incremental review strategies to avoid duplicate findings.

Structured Output Pipeline

  • Claude Code runs with --output-format json --json-schema
  • CI pipeline parses the JSON output
  • Findings are posted as inline PR comments at the relevant line
  • Developers see actionable, positioned feedback

    • Without structured output, CI must parse natural language -- fragile and error-prone.

    Incremental Review Strategy

    When re-running reviews after new commits:

  • Include prior review findings in the prompt context
  • Instruct Claude to report only NEW or still-unaddressed issues
  • This prevents duplicate comments that erode developer trust

    • Test Generation Quality

    To avoid low-value test output:

  • Provide existing test files in context (prevents duplicate scenarios)
  • Document valuable test criteria in CLAUDE.md (what's worth testing)
  • List available fixtures and test utilities (prevents reinventing existing helpers)
  • Define testing standards (naming conventions, patterns like AAA)

    • Common CI/CD Workflows

    WorkflowApproachKey Consideration

    |----------|----------|-------------------|

    Pre-merge reviewSynchronous with -pNeeds low latency, separate session from author
    Test generation-p with existing tests in contextAvoid duplicating existing coverage
    Security auditScheduled, can use batch APITolerates latency, saves 50% cost

    Key Takeaways

    • ✓--output-format json with --json-schema enables automated inline PR comments
    • ✓Include prior findings to avoid duplicate comments on re-reviews
    • ✓Provide existing test files in context to prevent duplicate test suggestions
    • ✓Document testing standards and fixtures in CLAUDE.md for quality CI output

    Related Concepts

    Iterative Refinement Techniques

    Concrete input/output examples beat prose descriptions for communicating transformations