Skip to content

Add detections/ registry for stable cross-project rule-ID linkage #207

@eeee2345

Description

@eeee2345

Following the techniques data/ registry that landed via #48#68, proposing a parallel structure for detection coverage maintained by upstream projects.

Context: I opened PR #187 in March with the wrong shape, cross-cutting README edits inside several technique folders that would have mixed external detection references into SAFE-MCP-owned content. I self-closed it on 2026-05-12 because that form would have made SAFE-MCP responsible for upstream rule correctness, which is the wrong boundary. This issue proposes a different shape.

The ask

A new top-level detections/ directory. One YAML file per SAFE-T ID that has external detection coverage, listing upstream rule references with maintainer-of-record:

# detections/SAFE-T1102.yaml
safe_t_id: SAFE-T1102
detections:
  - project: atr
    rule_id: ATR-2026-00125
    version: ">=2.2.0"
    maintainer: eeee2345
    last_validated: 2026-05-16
  - project: sigma
    rule_id: <sigma-rule-id>
    version: ">=1.0.0"
    maintainer: <github-handle>
    last_validated: <date>

SAFE-MCP records the pointer. Upstream projects own correctness. A short validator script checks links resolve and versions are valid semver ranges.

Why this is low-risk for the project

SAFE-MCP does not maintain upstream rule correctness, only the listing. Each entry carries a GitHub handle as maintainer-of-record, so stale entries have an owner to bump or remove. Semver ranges make version drift visible. The validator can run in CI on every PR to detections/. New entries do not block taxonomy releases. ATR itself is MIT-licensed throughout, so the listed references carry no IP friction; other contributing projects would self-declare their license in the entry if needed.

Preparation

ATR has shipped rule packs to: Microsoft Agent Governance Toolkit (PRs #908 and #1277, both merged), Cisco AI Defense skill-scanner (PRs #79 and #99, both merged), MISP/CIRCL (misp-taxonomies #323 and misp-galaxy #1207, both merged by @adulau), Gen Digital Sage (PR #33, merged by @vaclavbelak), OWASP Agent-Security-Regression-Harness (PR #74, merged by @mertsatilmaz), precize Agentic Top10 (PR #14, merged). Current state: v2.2.2 / 425 rules / npm 30-day downloads 4,664. Existing cross-mapping to SAFE-MCP at https://github.com/Agent-Threat-Rule/agent-threat-rules/blob/main/docs/SAFE-MCP-MAPPING.md covers 78/85 techniques.

Offer

If the shape works, I will draft the directory schema + validator PR, replicating the #48#68 pattern. I can populate the initial entries from the existing 78-technique mapping, marked clearly as community-contributed and not blocking SAFE-MCP releases.

If this is not a fit, that is fine. The ATR namespace is stable so any future link from SAFE-MCP resolves cleanly. No further bumps from me.

@fkautz, flagging since the data/ registry pattern from #48 came from your input.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type
    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions