Skip to content

Add detection content validation and linting workflow #53

Description

@egrexsec

Objective

Introduce lightweight validation for canonical detection briefs so DetLab-DAC can enforce documentation-first detection quality before content is merged.

Rationale

DetLab-DAC should not feel like loose markdown around queries. A validation workflow would reinforce the core positioning: telemetry assumptions, ATT&CK mapping, triage guidance, and implementation parity are part of the detection artifact.

Scope

  • Define required frontmatter fields for canonical detection briefs.
  • Validate required markdown sections such as summary, telemetry, ATT&CK, implementations, false positives, triage, and validation notes.
  • Add a CI-friendly script or test that runs against detections/examples.
  • Document how contributors run validation locally.

Acceptance criteria

  • Invalid detection artifacts fail validation with actionable messages.
  • Existing examples either pass or have tracked follow-up gaps.
  • README or CONTRIBUTING links to the validation workflow.
  • The workflow stays documentation-focused and does not require a live SIEM.

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions