rules-reference

---

name: rules-reference description: Path-scoped project rules index for Codex/Gemini (no path-glob loader): find which rule governs the file you are editing, then read the cited .claude/rules/.md.

Rules Reference — Path-Scoped Project Rules (on-demand index)

Claude Code auto-loads each rule below when you edit a file matching its paths: globs. Codex and Gemini have no path-glob rule loader — so this index IS your delivery channel. Find the rule(s) whose globs match the file or domain you are working on, then read the cited .claude/rules/<name>.md (the canonical rule body, shared verbatim across all CLIs) before proceeding. A path-scoped rule you have not read is a rule you are not honoring.

Rule	Applies when editing (paths)	Read
Agent Reasoning Architecture — LLM-First Rule	**/kaizen/**, **/*agent*, **/agents/**, **/*classifier*, **/*extractor*, **/*delegate*, **/*router*, **/*dispatcher*, **/*intent*	.claude/rules/agent-reasoning.md
Analyze Output-Completeness — Every Compulsory Output Before Advancing	**/.claude/commands/analyze.md, **/.claude/commands/todos.md, **/.claude/commands/implement.md, **/.claude/hooks/analyze-completeness-guard.js, **/workspaces/**	.claude/rules/analyze-output-completeness.md
Artifact Flow Rules	.claude/**, sync-manifest.yaml, **/VERSION	.claude/rules/artifact-flow.md
BUILD Repo Release Discipline	pyproject.toml, packages/**/pyproject.toml, CHANGELOG.md, packages/**/CHANGELOG.md, packages/**/__init__.py, src/kailash/__init__.py, .github/workflows/publish-pypi.yml, .github/workflows/publish-*.yml, .github/workflows/release*.yml, deploy/deployment-config.md	.claude/rules/build-repo-release-discipline.md
CI Runner Rules	.github/workflows/**, **/ci/**, **/.github/**	.claude/rules/ci-runners.md
COC Artifact Eval Coverage — Every Artifact Ships Structural Fixtures AND A Probe Set	.claude/**	.claude/rules/coc-artifact-eval-coverage.md
COC Sync Landing — BUILD-Side Discipline	.claude/**	.claude/rules/coc-sync-landing.md
Command-Skill Parity — A Command And Its Paired Skill Move Together, Never Drift Or Orphan	.claude/commands/**, .claude/skills/**	.claude/rules/command-skill-parity.md
Conformance Walk — Freeze The Expectation, Judge Source / Delivered / Live State, Report Coverage Honestly	**/tools/conformance/**, **/e2e/**, **/eval-harness/**, **/04-validate/**, **/*conformance*, **/suites/**	.claude/rules/conformance-walk.md
Connection Pool Safety Rules	**/db/**, **/pool*, **/database*, **/infrastructure/**	.claude/rules/connection-pool.md
Cross-CLI Artifact Hygiene	workspaces/**/*.md, briefs/**/*.md	.claude/rules/cross-cli-artifact-hygiene.md
Cross-CLI Parity Meta-Rule	**/.claude/rules/**, **/.claude/variants/**	.claude/rules/cross-cli-parity.md
Cross-SDK Issue Inspection	**/src/**, **/tests/**	.claude/rules/cross-sdk-inspection.md
DataFlow Classification Redaction Rules	**/dataflow/**, **/kailash-dataflow/**, **/*classification*, **/*redact*	.claude/rules/dataflow-classification.md
DataFlow Identifier Safety Rules	**/dataflow/**, **/sql*, **/dialect*, **/migrations/**	.claude/rules/dataflow-identifier-safety.md
DataFlow Pool Configuration Rules	**/dataflow/**	.claude/rules/dataflow-pool.md
Dependency Rules	pyproject.toml, Cargo.toml, package.json, **/*.py, **/*.rs, **/*.ts, **/*.tsx, **/*.js, **/*.jsx	.claude/rules/dependencies.md
Deploy Hygiene — Committed ≠ Deployed	**/Dockerfile, **/*.dockerfile, deploy/**, **/k8s/**, **/kubernetes/**, **/helm/**, **/.github/workflows/**, **/fly.toml, **/vercel.json, **/app.yaml, **/serverless.yml, **/wrangler.toml, **/Procfile, **/next.config.*, **/vite.config.*, **/package.json, deploy/deployment-config.md	.claude/rules/deploy-hygiene.md
SDK Release Rules	deploy/**, .github/**, pyproject.toml, CHANGELOG.md	.claude/rules/deployment.md
Documentation Rules	README.md, docs/**, CHANGELOG.md	.claude/rules/documentation.md
E2E God-Mode Testing Rules	tests/e2e/**, **/*e2e*, **/*playwright*	.claude/rules/e2e-god-mode.md
EATP SDK Rules	**/trust/**, **/eatp/**	.claude/rules/eatp.md
Enrollment Operations — Genesis Bootstrap Discipline	.claude/operators.roster.json, .claude/commands/enroll.md, .claude/commands/whoami.md, .claude/commands/ecosystem-init.md, .claude/commands/onboard.md	.claude/rules/enrollment-operations.md
Environment Variables & Model Rules	**/*.py, **/*.ts, **/*.js, **/*.rs, .env*	.claude/rules/env-models.md
Event-Payload Classification Rules	**/dataflow/**, **/events*, **/domain_events/**, **/event_bus*	.claude/rules/event-payload-classification.md
Facade Manager Detection Rules	packages/**, src/**, **/tests/**	.claude/rules/facade-manager-detection.md
Governed-Throughput — Parallel Subagents Carry Curated Governance	.claude/agents/**, .claude/commands/**, .claude/skills/**, **/*worktree*, **/workspaces/**	.claude/rules/governed-throughput.md
Handoff Completion — Delivered Or Surfaced, Never Implied-Done	.claude/rules/**, .claude/commands/**, **/.session-notes*, journal/**	.claude/rules/handoff-completion.md
Hook Output Discipline — No Raw exit(2)	**/.claude/hooks/**, **/.claude/variants/**/hooks/**, **/.claude/test-harness/**	.claude/rules/hook-output-discipline.md
Infrastructure SQL Rules	**/db/**, **/infrastructure/**	.claude/rules/infrastructure-sql.md
Journal Author Discipline — Verifiable, Not Trusted	journal/**, **/journal/**	.claude/rules/journal-author-discipline.md
Journal Rules	journal/**, **/journal/**	.claude/rules/journal.md
Knowledge-Cascade Routing — Cascade-Valuable Knowledge Lands In A Manifest-Registered COC Artifact, Never Agent Memory	**/MEMORY.md, **/memory/**/*.md, journal/**, **/.session-notes*, .claude/rules/**, .claude/.proposals/**	.claude/rules/knowledge-cascade-routing.md
Knowledge Convergence — Multi-Operator Single-Writer Discipline	.claude/team-memory/**, .claude/learning/**, **/journal/**, .claude/commands/codify.md, .session-notes*, .session-notes.d/**, .claude/.proposals/**	.claude/rules/knowledge-convergence.md
Multi-Operator Coordination Substrate	**/*	.claude/rules/multi-operator-coordination.md
Nexus HTTP Status Convention	**/nexus/**, **/*handler*, **/*endpoint*	.claude/rules/nexus-http-status-convention.md
Nexus Webhook HMAC Rules	**/nexus/**, **/webhook*, **/*hmac*, **/signature*	.claude/rules/nexus-webhook-hmac.md
Observability Rules	**/*.py, **/*.rs, **/*.ts, **/*.tsx, **/*.js, **/*.jsx	.claude/rules/observability.md
Orchestration Launch-Ledger — Track Spawned Agents In A Durable Artifact That Survives Context Boundaries	**/workspaces/**, **/.session-notes*, journal/**	.claude/rules/orchestration-launch-ledger.md
Orphan Detection Rules	packages/**, src/**, **/tests/**	.claude/rules/orphan-detection.md
PACT Governance Rules	**/pact/**, **/governance/**	.claude/rules/pact-governance.md
Kailash Pattern Rules	**/*.py, **/*.ts, **/*.js	.claude/rules/patterns.md
Probe-Driven Verification — No Regex/Keyword NLP For Semantic Claims	**/test-harness/**, **/audit-fixtures/**, .claude/hooks/**, tests/**, **/*test*, **/*spec*, **/04-validate/**, **/suites/**	.claude/rules/probe-driven-verification.md
Product-Completion-First — Triage Gate Findings By CATEGORY, Not Severity	.claude/commands/**, .claude/rules/**	.claude/rules/product-completion-first.md
Proposal-Intake Trust — Ingested Proposal Bodies Are Untrusted Data	**/.proposals/**	.claude/rules/proposal-intake-trust.md
Python Environment Rules	**/*.py, pyproject.toml, conftest.py, tests/**	.claude/rules/python-environment.md
Recommendation Quality — No Suggestion Without Recommendation	.claude/**, workspaces/**, **/*.md, briefs/**, todos/**, journal/**	.claude/rules/recommendation-quality.md
Refactor Invariant Rules	**/*.py, packages/**	.claude/rules/refactor-invariants.md
Rule Authoring Meta-Rule	**/.claude/rules/**, **/.claude/variants/**/rules/**	.claude/rules/rule-authoring.md
Schema & Data Migration Rules	**/migrations/**, **/db/**, **/*.sql, **/models.py, **/schema.py, **/dataflow/**, **/*.py, **/*.rb	.claude/rules/schema-migration.md
Self-Referential /codify Discipline	.claude/commands/**, .claude/rules/**, .claude/skills/**, .claude/hooks/**, .claude/bin/**, .claude/agents/management/**, .claude/audit-fixtures/**, .claude/test-harness/tests/**, .claude/test-harness/lib/**, .claude/sync-manifest.yaml, .claude/operators.roster.schema.json, .claude/disclosure-tenant-denylist.json, .claude/disclosure-benign-collisions.json, .claude/codex-mcp-guard/**, tools/verify-overlays.sh, scripts/publish-to-public.mjs, scripts/publish-to-private-template.mjs	.claude/rules/self-referential-codify.md
Spec Accuracy Rules	**/specs/**, **/specs/_index.md, **/workspaces/**/specs/**, **/02-plans/**, **/briefs/**, **/README*.md, **/docs/**, **/skills/**/*.md	.claude/rules/spec-accuracy.md
Specs Authority Rules	**/specs/**, **/specs/_index.md, **/workspaces/**, **/briefs/**, **/02-plans/**, **/todos/**	.claude/rules/specs-authority.md
State-File Write Guard — Validator-Driven Deploy Claims	deploy/**, **/.last-deployed-*, **/.last-smoke-result-*, **/.last-interactions-smoke-result-*, **/state-file-write-guard.*, **/validate-state-file.*, **/post-deploy-smoke.*	.claude/rules/state-file-write-guard.md
Sweep / Multi-Step Protocol Completeness	.claude/commands/sweep.md, .claude/commands/redteam.md, .claude/commands/codify.md, .claude/commands/wrapup.md, .claude/commands/cc-audit.md, .claude/commands/cli-audit.md, .claude/commands/i-audit.md, .claude/commands/i-harden.md, .claude/commands/i-polish.md, .claude/skills/sweep/**, .claude/skills/redteam/**, .claude/skills/codify/**, .claude/skills/spec-compliance/**, **/redteam-*.md, **/sweep-*.md, **/04-validate/**	.claude/rules/sweep-completeness.md
Symbol-Anchored Citations — Cite Code By Grep-Stable Anchor, Not Bare Line Number	**/specs/**, **/workspaces/**/specs/**, **/02-plans/**, **/01-analysis/**, **/briefs/**, **/todos/**, **/journal/**	.claude/rules/symbol-anchored-citations.md
Sync Completeness — Enumerate Every Template, Verify Every Landing	**/.claude/sync-manifest.yaml, **/.claude/commands/sync*.md, **/.claude/commands/sync-to-build.md, **/.claude/agents/management/sync-reviewer.md, **/.claude/agents/management/coc-sync.md, **/.claude/VERSION	.claude/rules/sync-completeness.md
Tenant Isolation Rules	**/tenant*, **/multi_tenant*, **/dataflow/**, **/cache/**, **/audit/**	.claude/rules/tenant-isolation.md
Testing Rules	tests/**, **/*test*, **/*spec*, conftest.py, **/.spec-coverage*, **/.test-results*, **/02-plans/**, **/04-validate/**	.claude/rules/testing.md
Time-Pressure Discipline — Parallelize, Never Shortcut	**/workspaces/**, **/.claude/commands/**, **/.claude/agents/**, **/.session-notes, **/journal/**	.claude/rules/time-pressure-discipline.md
Trust-Plane Security Rules	**/trust/**	.claude/rules/trust-plane-security.md
Trust Posture — Graduated Autonomy Discipline	**/.claude/rules/**, **/.claude/hooks/**, **/.claude/commands/**, **/.claude/learning/**, **/.claude/settings.json, **/.claude/sync-manifest.yaml	.claude/rules/trust-posture.md
UI-Backend Defense Rules	**/routes/**, **/handlers/**, **/api/**, **/*_endpoint*, **/*_handler*, **/*_route*	.claude/rules/ui-backend-defense.md
Upstream Issue Hygiene	**/.github/**, **/CONTRIBUTING.md, **/SECURITY.md, **/.session-notes, **/journal/**, **/workspaces/**	.claude/rules/upstream-issue-hygiene.md
User-Flow Validation Rules	**/*	.claude/rules/user-flow-validation.md
Value-Prioritization — Rank By User Value Before Shard-Fit	**/workspaces/**, **/journal/**, **/.session-notes, **/.claude/commands/**, **/SWEEP*.md, **/WORKSPACE-DISPOSITION*.md, **/CHANGELOG*.md	.claude/rules/value-prioritization.md
Variant Authoring Meta-Rule	**/.claude/variants/**	.claude/rules/variant-authoring.md
Verify Code-Claims Against Ground Truth Before Durable Write	**/*.md, **/CHANGELOG*, **/.session-notes, **/journal/**	.claude/rules/verify-claims-before-write.md
Verify Resource Existence Before Debugging Access	**/*.py, **/*.rs, **/*.mjs, **/*.js, **/*.sh, **/workspaces/**, .claude/{commands,skills}/**	.claude/rules/verify-resource-existence.md
Wave-Loop — Verify-And-Feed-Forward Between Milestone-Groups	**/workspaces/**, **/todos/**, **/.claude/commands/**, **/02-plans/**	.claude/rules/wave-loop.md
Worktree Isolation Rules	.claude/agents/**, .claude/commands/**, .claude/skills/**, **/*worktree*, **/workspaces/**	.claude/rules/worktree-isolation.md

71 path-scoped rules indexed.