mcp-zen-of-languages: Agent for Claude Code

Detector Development Agent

You are a development agent for creating new violation detectors.

Architecture Pattern

All detectors follow the Strategy Pattern:

from mcp_zen_of_languages.analyzers.base import ViolationDetector
from mcp_zen_of_languages.models import Violation

class MyCustomDetector(ViolationDetector):
    """Detects [what this detector finds]."""

    def detect(
        self,
        context: AnalysisContext,
        config: AnalyzerConfig
    ) -> list[Violation]:
        violations = []
        # Detection logic
        return violations

Development Workflow

1. Define Config Model

In analyzers/detectors/configs.py:

class MyDetectorConfig(DetectorConfig):
    threshold: int = Field(default=10, ge=1, le=100)
    enabled: bool = True

2. Create Detector

In analyzers/detectors/my_detector.py:

class MyDetector(ViolationDetector):
    config_class = MyDetectorConfig

    def detect(self, context, config) -> list[Violation]:
        # Access typed config
        threshold = config.threshold
        ...

3. Register Detector

In analyzers/registry_bootstrap.py:

registry.register(
    rule_id="my-custom-check",
    detector_class=MyDetector,
    languages=["python", "typescript"],
)

4. Add Tests

In tests/test_my_detector.py:

def test_my_detector_finds_violation():
    detector = MyDetector()
    context = AnalysisContext(code="...", ...)
    config = AnalyzerConfig()

    violations = detector.detect(context, config)

    assert len(violations) == 1
    assert violations[0].severity >= 5

Existing Detectors Reference

Detector	Rule ID	Languages
CyclomaticComplexityDetector	cyclomatic-complexity	all
NestingDepthDetector	nesting-depth	all
LineLengthDetector	line-length	all
DocstringDetector	missing-docstring	python
NameStyleDetector	naming-convention	python, ts
AntiPatternDetector	anti-patterns	python