Nomos - Deterministic Git & AST Governance for AI Coding Agents

Live GitHub repo AST X-Ray, 42 coding-agent DoD gates, Git worktree guards & brownfield baselines.

¿Debería usar esto?

Calidad y seguridad

A
Calidad de la descripción
100%
Integridad del esquema
93%
Calidad de los nombres
86%
Riesgo de envenenamiento
100%
Coincidencia de permisos
100%
Cumplimiento del protocolo
100%

Basado en el análisis automatizado de las definiciones de herramientas y el cumplimiento del protocolo.

Costo de contexto

~2,665Tokens (definiciones de herramientas)
~3.1 KBTamaño de respuesta típico
Impacto significativo en la atención (2.08% del contexto de 128k)

Este es el número aproximado de tokens que se consumen cada vez que las herramientas del servidor se cargan en el contexto de un modelo. Los recuentos más altos reducen la atención disponible para otras tareas.

Instalar

Instalación con un clic

Agrega esto a tu archivo `claude_desktop_config.json`:

{
  "mcpServers": {
    "nomos": {
      "command": "npx",
      "args": [
        "@mgantlett/nomos"
      ]
    }
  }
}

Paquetes ejecutables

npm@mgantlett/nomos4.30.0stdio
pypinomos-cli4.30.0stdio

Puntos de conexión remotos

https://sophialabs.ca/mcpstreamable-http

Qué puede hacer

Inventario de herramientas

Herramientas (7)

🟢 Solo lectura🟡 Escritura🔴 Eliminación⚪ Desconocido
🟢search_nomos_corpus(query, section)

Search Nomos Engineering Handbook chapters, Empirical Field Dispatches, Open-Core Architecture Specs, and CLI reference by keyword. Example: query='worktree isolation', section='handbook' finds chapters on Git worktrees. Use when looking up conceptual architecture, empirical benchmarks, or CLI flags. Do NOT use when inspecting a specific G-* gate or ERR_* code (use inspect_dod_gates or diagnose_nomos_error instead) or comparing external tools (use compare_governance_approaches instead).

Esquema de entrada

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Keywords or engineering problem phrase to search across the public Nomos corpus.",
      "minLength": 2,
      "maxLength": 160,
      "examples": [
        "worktree isolation",
        "mutation testing",
        "CapBAC IFC"
      ]
    },
    "section": {
      "type": "string",
      "description": "Corpus subset filter (defaults to all).",
      "enum": [
        "all",
        "handbook",
        "dispatches",
        "specs",
        "cli"
      ],
      "default": "all"
    }
  },
  "required": [
    "query"
  ],
  "additionalProperties": false,
  "examples": [
    {
      "query": "worktree isolation",
      "section": "handbook"
    }
  ]
}

Esquema de salida

{
  "type": "object",
  "properties": {
    "summary": {
      "type": "string",
      "description": "Deterministic Markdown response summary."
    },
    "canonicalUrl": {
      "type": "string",
      "description": "Canonical documentation or twin URL for citation."
    },
    "query": {
      "type": "string",
      "description": "Normalized search query."
    },
    "matchCount": {
      "type": "integer",
      "description": "Number of top corpus matches returned."
    }
  },
  "required": [
    "summary",
    "canonicalUrl",
    "query",
    "matchCount"
  ]
}
🟢inspect_dod_gates(gate_id, law, category)

List and filter the 42 compiled Go and Tree-sitter AST Definition of Done quality gates, 7 Canonical Laws, and sandbox rules. Example: gate_id='G-16' or law=7 returns matching gate invariants. Use when browsing gate invariants by G-* ID, Law 1..7, or category. Do NOT use when troubleshooting a raw verify error log or ERR_* failure (use diagnose_nomos_error instead).

Esquema de entrada

{
  "type": "object",
  "properties": {
    "gate_id": {
      "type": "string",
      "description": "Optional gate identifier such as G-01 or G-16.",
      "minLength": 2,
      "maxLength": 16,
      "examples": [
        "G-01",
        "G-16"
      ]
    },
    "law": {
      "type": "integer",
      "description": "Optional Canonical Law number from 1 through 7.",
      "minimum": 1,
      "maximum": 7,
      "examples": [
        2,
        3,
        7
      ]
    },
    "category": {
      "type": "string",
      "description": "Optional gate category filter.",
      "enum": [
        "ast",
        "phase",
        "sandbox",
        "security",
        "testing"
      ]
    }
  },
  "additionalProperties": false,
  "examples": [
    {
      "gate_id": "G-16"
    },
    {
      "law": 2,
      "category": "ast"
    }
  ]
}

Esquema de salida

{
  "type": "object",
  "properties": {
    "summary": {
      "type": "string",
      "description": "Deterministic Markdown response summary."
    },
    "canonicalUrl": {
      "type": "string",
      "description": "Canonical documentation or twin URL for citation."
    },
    "totalGates": {
      "type": "integer",
      "description": "Total compiled quality gates in Nomos."
    },
    "matchedCount": {
      "type": "integer",
      "description": "Number of gates matching the filter."
    }
  },
  "required": [
    "summary",
    "canonicalUrl",
    "totalGates",
    "matchedCount"
  ]
}
🟢recommend_adoption_plan(languages, repo_loc, ci_provider, airgapped)

Retrieve a read-only 4-step Nomos rollout guide (X-Ray baseline, stealth Branch Guard, CI SARIF, and isolated Git worktrees) tailored to repository LOC, languages, and air-gap constraints. Example: languages=['go','typescript'], repo_loc=120000 returns a phased brownfield guide. Use when planning rollout steps for a team or monorepo. Do NOT use when previewing raw nomos.yaml and CI workflow templates (use scaffold_nomos_config instead).

Esquema de entrada

{
  "type": "object",
  "properties": {
    "languages": {
      "type": "array",
      "items": {
        "type": "string",
        "description": "Programming language slug.",
        "minLength": 1,
        "maxLength": 32
      },
      "maxItems": 12,
      "description": "Primary programming languages in the repository.",
      "examples": [
        [
          "go",
          "typescript",
          "python"
        ]
      ]
    },
    "repo_loc": {
      "type": "integer",
      "description": "Approximate repository lines of code.",
      "minimum": 0,
      "maximum": 50000000,
      "default": 50000,
      "examples": [
        50000,
        250000
      ]
    },
    "ci_provider": {
      "type": "string",
      "description": "Target CI pipeline platform.",
      "enum": [
        "github",
        "gitlab",
        "other"
      ],
      "default": "github"
    },
    "airgapped": {
      "type": "boolean",
      "default": false,
      "description": "Set true for zero-egress air-gapped local GPU environments."
    }
  },
  "additionalProperties": false,
  "examples": [
    {
      "languages": [
        "go",
        "typescript"
      ],
      "repo_loc": 120000,
      "ci_provider": "github"
    }
  ]
}

Esquema de salida

{
  "type": "object",
  "properties": {
    "summary": {
      "type": "string",
      "description": "Deterministic Markdown response summary."
    },
    "canonicalUrl": {
      "type": "string",
      "description": "Canonical documentation or twin URL for citation."
    },
    "airgapped": {
      "type": "boolean",
      "description": "Whether air-gapped silicon guidance was included."
    },
    "stepCount": {
      "type": "integer",
      "description": "Number of progressive rollout stages."
    }
  },
  "required": [
    "summary",
    "canonicalUrl",
    "airgapped",
    "stepCount"
  ]
}
🟢compare_governance_approaches(focus)

Compare Nomos deterministically against pre-commit hooks, SonarQube, ESLint, PR review bots (CodeRabbit, Greptile), prompt wrappers, and static CLAUDE.md / AGENTS.md / .cursorrules files. Example: focus='SonarQube' returns side-by-side trade-offs. Use when evaluating tool trade-offs or answering 'how is Nomos different from X'. Do NOT use when searching general Handbook tutorials (use search_nomos_corpus instead).

Esquema de entrada

{
  "type": "object",
  "properties": {
    "focus": {
      "type": "string",
      "description": "Optional comparison dimension or tool name filter.",
      "minLength": 2,
      "maxLength": 80,
      "examples": [
        "SonarQube",
        "pre-commit",
        "test-tampering",
        "brownfield"
      ]
    }
  },
  "additionalProperties": false,
  "examples": [
    {
      "focus": "SonarQube"
    }
  ]
}

Esquema de salida

{
  "type": "object",
  "properties": {
    "summary": {
      "type": "string",
      "description": "Deterministic Markdown response summary."
    },
    "canonicalUrl": {
      "type": "string",
      "description": "Canonical documentation or twin URL for citation."
    },
    "dimensionCount": {
      "type": "integer",
      "description": "Number of comparison dimensions returned."
    }
  },
  "required": [
    "summary",
    "canonicalUrl",
    "dimensionCount"
  ]
}
🟢xray_github_repo(repo)

Inspect a public GitHub repository via read-only static Tree-sitter AST analysis (<= 100MB source archive, strictly read-only) to retrieve its AI Hangover Score (0-100), complexity hotspots, and Day-0 baseline preview. Example: repo='go-chi/chi' returns the AST scorecard for go-chi/chi. Use when auditing a public GitHub owner/repo URL. Do NOT use when checking private repositories (private codebases require local CLI inspection via @mgantlett/nomos).

Esquema de entrada

{
  "type": "object",
  "properties": {
    "repo": {
      "type": "string",
      "description": "Public GitHub owner/repo slug or full https://github.com/<owner>/<repo> URL.",
      "minLength": 3,
      "maxLength": 200,
      "examples": [
        "go-chi/chi",
        "spf13/cobra",
        "mgantlett/nomos"
      ]
    }
  },
  "required": [
    "repo"
  ],
  "additionalProperties": false,
  "examples": [
    {
      "repo": "go-chi/chi"
    }
  ]
}

Esquema de salida

{
  "type": "object",
  "properties": {
    "summary": {
      "type": "string",
      "description": "Deterministic Markdown response summary."
    },
    "canonicalUrl": {
      "type": "string",
      "description": "Canonical documentation or twin URL for citation."
    },
    "repo": {
      "type": "string",
      "description": "Normalized owner/repo slug."
    },
    "hangoverScore": {
      "type": "integer",
      "description": "Composite 0-100 AI Hangover structural debt score."
    },
    "grade": {
      "type": "string",
      "description": "Structural health grade."
    }
  },
  "required": [
    "summary",
    "canonicalUrl",
    "repo"
  ]
}
🟢diagnose_nomos_error(error_code, error_log)

Look up any Nomos ERR_* failure code, TC-AGT-* vector, or nomos verify gate rejection to retrieve its root cause and non-bypassing AST remediation. Example: error_code='ERR_CROSS_PLANE_MUTATION' returns the remediation guide. Use when troubleshooting a verify failure or pre-commit hook error. Do NOT use when browsing the full catalog of 42 gates by Law or category without an error (use inspect_dod_gates instead).

Esquema de entrada

{
  "type": "object",
  "properties": {
    "error_code": {
      "type": "string",
      "minLength": 3,
      "maxLength": 80,
      "description": "Optional ERR_* identifier such as ERR_CROSS_PLANE_MUTATION or ERR_COGNITIVE_DEBT.",
      "examples": [
        "ERR_CROSS_PLANE_MUTATION",
        "ERR_COGNITIVE_DEBT",
        "ERR_TRIVIAL_PASS_SHIM"
      ]
    },
    "error_log": {
      "type": "string",
      "minLength": 3,
      "maxLength": 2000,
      "description": "Optional raw error message, gate name, or pre-commit output snippet.",
      "examples": [
        "AntiShimGate: hollow TODO stub",
        "PlaneSeparationGate"
      ]
    }
  },
  "additionalProperties": false,
  "examples": [
    {
      "error_code": "ERR_CROSS_PLANE_MUTATION"
    }
  ]
}

Esquema de salida

{
  "type": "object",
  "properties": {
    "summary": {
      "type": "string",
      "description": "Deterministic Markdown remediation summary."
    },
    "canonicalUrl": {
      "type": "string",
      "description": "Canonical gate reference URL."
    },
    "query": {
      "type": "string",
      "description": "Combined error query string."
    },
    "matchedCodes": {
      "type": "array",
      "items": {
        "type": "object"
      },
      "description": "Matched ERR_* diagnostics."
    },
    "matchedGates": {
      "type": "array",
      "items": {
        "type": "object"
      },
      "description": "Related compiled gates."
    },
    "docsUrl": {
      "type": "string",
      "description": "Gate catalog documentation URL."
    }
  },
  "required": [
    "summary",
    "canonicalUrl",
    "query",
    "matchedCodes",
    "matchedGates",
    "docsUrl"
  ]
}
🟢scaffold_nomos_config(project_name, languages, mode, ci_provider)

Preview read-only nomos.yaml configuration text, 4-line GitHub Actions SARIF workflow text, and Day-0 onboarding commands without modifying files. Example: project_name='payments-api', mode='local' returns template text. Use when retrieving ready-to-paste YAML config and CI workflow templates. Do NOT use when requesting a strategic rollout recommendation by LOC or air-gap posture (use recommend_adoption_plan instead).

Esquema de entrada

{
  "type": "object",
  "properties": {
    "project_name": {
      "type": "string",
      "minLength": 1,
      "maxLength": 48,
      "default": "my-service",
      "description": "Repository or project slug.",
      "examples": [
        "payments-api",
        "core-monorepo"
      ]
    },
    "languages": {
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 32
      },
      "maxItems": 12,
      "description": "Target languages in the repository.",
      "examples": [
        [
          "typescript",
          "go",
          "python"
        ]
      ]
    },
    "mode": {
      "type": "string",
      "enum": [
        "branch",
        "local",
        "worktrees"
      ],
      "default": "branch",
      "description": "Onboarding mode: branch (default), local (stealth .git/info/exclude), or worktrees."
    },
    "ci_provider": {
      "type": "string",
      "enum": [
        "github",
        "gitlab"
      ],
      "default": "github",
      "description": "CI platform for verification workflow output (defaults to github)."
    }
  },
  "additionalProperties": false,
  "examples": [
    {
      "project_name": "payments-api",
      "languages": [
        "go",
        "typescript"
      ],
      "mode": "local"
    }
  ]
}

Esquema de salida

{
  "type": "object",
  "properties": {
    "summary": {
      "type": "string",
      "description": "Deterministic Markdown configuration bundle."
    },
    "canonicalUrl": {
      "type": "string",
      "description": "Canonical quickstart URL."
    },
    "project": {
      "type": "string",
      "description": "Sanitized project slug."
    },
    "mode": {
      "type": "string",
      "description": "Selected isolation mode."
    },
    "ciProvider": {
      "type": "string",
      "description": "Selected CI provider."
    },
    "nomosYaml": {
      "type": "string",
      "description": "Generated nomos.yaml template."
    },
    "ciWorkflowYaml": {
      "type": "string",
      "description": "Generated CI pipeline YAML."
    },
    "dayZeroCommands": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Day-0 CLI bootstrap commands."
    }
  },
  "required": [
    "summary",
    "canonicalUrl",
    "project",
    "mode",
    "ciProvider",
    "nomosYaml",
    "ciWorkflowYaml",
    "dayZeroCommands"
  ]
}

Comunidad

Califica este servidor

Evidencia

Observaciones recientes

verificadoversión no registrada7 herramientas