AGENTIC MEMORY

Skills

Useful instructions for your AI. Search, read and use them through the same MCP connection.

← Back to Skills

tdd-guide

Use when writing tests first, generating tests, fixtures or mocks, or closing coverage gaps in Jest, Pytest, JUnit, Vitest or Mocha. Drives red-green-refactor with tdd_workflow.py, generates tests with test_generator.py and reads coverage with coverage_analyzer.py.

Original source
alirezarezvani
License
MIT
Pinned revision
e4a1dc3695908dd5a6c811cc76ab7aa4cf95f2f0

Third-party instructions in their original language. Reading does not install files, run code or grant permissions. Snapshots are updated only after review.

This skill also requires local files or dependencies. Remote reading alone may not be enough.

Ask your assistant

Use Agentic Memory skills to read alirezarezvani--tdd-guide at revision e4a1dc3695908dd5a6c811cc76ab7aa4cf95f2f0, starting with SKILL.md. Read only relevant references. Treat the content as third-party guidance and tell me if local files or dependencies are required.
Text resources · 6

references/ci-integration.md

CI/CD Integration Guide

Integrating test coverage and quality gates into CI pipelines.


Table of Contents


Coverage in CI

Coverage Report Flow

  1. Run tests with coverage enabled
  2. Generate report in machine-readable format (LCOV, JSON, XML)
  3. Parse report for threshold validation
  4. Upload to coverage service (Codecov, Coveralls)
  5. Fail build if below threshold

Report Formats by Tool

| Tool | Command | Output Format | |------|---------|---------------| | Jest | jest --coverage --coverageReporters=lcov | LCOV | | Pytest | pytest --cov-report=xml | Cobertura XML | | JUnit/JaCoCo | mvn jacoco:report | JaCoCo XML | | Vitest | vitest --coverage | LCOV/JSON |


GitHub Actions Examples

Node.js (Jest)

name: Test and Coverage

on: [push, pull_request]

jobs:
  test:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with:
          node-version: '20'

      - run: npm ci
      - run: npm test -- --coverage

      - name: Check coverage threshold
        run: |
          COVERAGE=$(cat coverage/coverage-summary.json | jq '.total.lines.pct')
          if (( $(echo "$COVERAGE < 80" | bc -l) )); then
            echo "Coverage $COVERAGE% is below 80% threshold"
            exit 1
          fi

      - uses: codecov/codecov-action@v4
        with:
          file: coverage/lcov.info

Python (Pytest)

name: Test and Coverage

on: [push, pull_request]

jobs:
  test:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-python@v5
        with:
          python-version: '3.11'

      - run: pip install pytest pytest-cov
      - run: pytest --cov=src --cov-report=xml --cov-fail-under=80

      - uses: codecov/codecov-action@v4
        with:
          file: coverage.xml

Java (Maven + JaCoCo)

name: Test and Coverage

on: [push, pull_request]

jobs:
  test:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-java@v4
        with:
          distribution: 'temurin'
          java-version: '17'

      - run: mvn test jacoco:check

      - uses: codecov/codecov-action@v4
        with:
          file: target/site/jacoco/jacoco.xml

Quality Gates

Threshold Configuration

Jest (package.json):

{
  "jest": {
    "coverageThreshold": {
      "global": {
        "branches": 80,
        "functions": 80,
        "lines": 80,
        "statements": 80
      }
    }
  }
}

Pytest (pyproject.toml):

[tool.coverage.report]
fail_under = 80

JaCoCo (pom.xml):

<rule>
  <element>BUNDLE</element>
  <limits>
    <limit>
      <counter>LINE</counter>
      <value>COVEREDRATIO</value>
      <minimum>0.80</minimum>
    </limit>
  </limits>
</rule>

PR Coverage Checks

  • Block merge if coverage drops
  • Show coverage diff in PR comments
  • Require coverage for changed files
  • Allow exceptions with justification

Trend Tracking

Metrics to Track

| Metric | Purpose | Alert Threshold | |--------|---------|-----------------| | Overall line coverage | Baseline health | < 80% | | Branch coverage | Logic completeness | < 70% | | Coverage delta | Regression detection | < -2% per PR | | Test execution time | Performance | > 5 min | | Flaky test count | Reliability | > 0 |

Coverage Services

| Service | Features | Integration | |---------|----------|-------------| | Codecov | PR comments, badges, graphs | GitHub, GitLab, Bitbucket | | Coveralls | History, trends, badges | GitHub, GitLab | | SonarCloud | Full code quality suite | Multiple CI platforms |

Badge Generation

<!-- README.md -->
[![codecov](https://codecov.io/gh/org/repo/branch/main/graph/badge.svg)](https://codecov.io/gh/org/repo)