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.
사용해야 할까요
품질 및 안전성
도구 정의와 프로토콜 준수에 대한 자동 분석을 기반으로 합니다.
컨텍스트 비용
이는 서버의 도구가 모델의 컨텍스트에 로드될 때마다 소비되는 대략적인 토큰 수입니다. 수치가 높을수록 다른 작업에 사용할 수 있는 주의가 줄어듭니다.
설치
원클릭 설치
`claude_desktop_config.json` 파일에 다음을 추가하세요:
{
"mcpServers": {
"nomos": {
"command": "npx",
"args": [
"@mgantlett/nomos"
]
}
}
}실행 가능한 패키지
4.30.0stdio4.30.0stdio원격 엔드포인트
https://sophialabs.ca/mcpstreamable-http할 수 있는 일
도구 목록
도구 (7)
🟢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).
입력 스키마
{
"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"
}
]
}출력 스키마
{
"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).
입력 스키마
{
"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"
}
]
}출력 스키마
{
"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).
입력 스키마
{
"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"
}
]
}출력 스키마
{
"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).
입력 스키마
{
"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"
}
]
}출력 스키마
{
"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).
입력 스키마
{
"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"
}
]
}출력 스키마
{
"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).
입력 스키마
{
"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"
}
]
}출력 스키마
{
"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).
입력 스키마
{
"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"
}
]
}출력 스키마
{
"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"
]
}커뮤니티
증거