Files

Cassel 647cbec54f docs: update all documentation and add AI tooling configs

- Rewrite README.md with current architecture, features and stack
- Update docs/API.md with all current endpoints (corporate, BI, client 360)
- Update docs/ARCHITECTURE.md with cache, modular queries, services, ETL
- Update docs/GUIA-USUARIO.md for all roles (admin, corporate, agente)
- Add docs/INDEX.md documentation index
- Add PROJETO.md comprehensive project reference
- Add BI-CCC-Implementation-Guide.md
- Include AI agent configs (.claude, .agents, .gemini, _bmad)
- Add netbird VPN configuration
- Add status report

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

2026-03-19 13:29:03 -04:00

2.5 KiB

Raw Blame History

name, description, subagent, outputFile

name	description	subagent	outputFile
step-03c-subagent-maintainability	Subagent: Check test maintainability (readability, structure, DRY)	true	/tmp/tea-test-review-maintainability-{{timestamp}}.json

Subagent 3C: Maintainability Quality Check

SUBAGENT CONTEXT

This is an isolated subagent running in parallel with other quality dimension checks.

Your task: Analyze test files for MAINTAINABILITY violations only.

MANDATORY EXECUTION RULES

✅ Check MAINTAINABILITY only (not other quality dimensions)
✅ Output structured JSON to temp file
❌ Do NOT check determinism, isolation, coverage, or performance

SUBAGENT TASK

1. Identify Maintainability Violations

HIGH SEVERITY Violations:

Tests >100 lines (too complex)
No test.describe grouping
Duplicate test logic (copy-paste)
Unclear test names (no Given/When/Then structure)
Magic numbers/strings without constants

MEDIUM SEVERITY Violations:

Tests missing comments for complex logic
Inconsistent naming conventions
Excessive nesting (>3 levels)
Large setup/teardown blocks

LOW SEVERITY Violations:

Minor code style issues
Could benefit from helper functions
Inconsistent assertion styles

2. Calculate Maintainability Score

const severityWeights = { HIGH: 10, MEDIUM: 5, LOW: 2 };
const totalPenalty = violations.reduce((sum, v) => sum + severityWeights[v.severity], 0);
const score = Math.max(0, 100 - totalPenalty);

OUTPUT FORMAT

{
  "dimension": "maintainability",
  "score": 75,
  "max_score": 100,
  "grade": "C",
  "violations": [
    {
      "file": "tests/e2e/complex-flow.spec.ts",
      "line": 1,
      "severity": "HIGH",
      "category": "test-too-long",
      "description": "Test file is 250 lines - too complex to maintain",
      "suggestion": "Split into multiple smaller test files by feature area",
      "code_snippet": "test.describe('Complex flow', () => { /* 250 lines */ });"
    }
  ],
  "passed_checks": 10,
  "failed_checks": 5,
  "violation_summary": {
    "HIGH": 2,
    "MEDIUM": 2,
    "LOW": 1
  },
  "recommendations": [
    "Split large test files into smaller, focused files (<100 lines each)",
    "Add test.describe grouping for related tests",
    "Extract duplicate logic into helper functions"
  ],
  "summary": "Tests have maintainability issues - 5 violations (2 HIGH)"
}

EXIT CONDITION

Subagent completes when JSON output written to temp file.

Subagent terminates here.

2.5 KiB Raw Blame History