Show HN: Manage coding norms across your AI agents

Norms, a new open-source tool, lets developers define coding rules once in Markdown and sync them across AI coding agents, generating rule files for AGENTS.md, CLAUDE.md, .cursor/rules/norms.mdc, and .github/copilot-instructions.md. The tool, installable via curl or PowerShell, supports commands like norms init, propose, sync, and check, and is designed to ensure all coding agents follow consistent repo-level instructions.

Define your coding rules once, store them in Git, and make every coding agent follow them. Norms stores repo-level instructions as Markdown in .norms/ , resolves them, and generates the rule files each coding agent expects. In practice, you’ll usually manage norms through your coding agent. After installing Norms and running norms init in your current repo, just tell your agent to add or update a norm. It will write the norm, sync the generated rule files, and follow the updated instructions from then on. You can also manage norms directly from the CLI with norms propose and norms sync . And because norms are just Markdown, you can always edit them by hand. Each norm has a stable id, optional path scopes, and one clear instruction. For example, .norms/norms/testing/integration.md : --- id: testing.integration applies to: - "packages/ " --- Test behavior Cover user-visible behavior with integration tests. Norms can encode any reusable instruction you want agents to follow. Because norms are just Markdown, they can also include images, diagrams, links, code snippets, tables, and other supporting context. For example: - “All new API endpoints must include an integration test.” - “Use uv for Python dependencies; don’t add requirements.txt.” - “Keep React components under 300 lines and move shared state into hooks.” - “Every merge request must explain what changed, why, and how it was tested.” - “All buttons on this website should glow red like in this picture.” On macOS or Linux: curl -fsSL https://raw.githubusercontent.com/gsttm/norms/main/install.sh | sh On Windows, run PowerShell: irm https://raw.githubusercontent.com/gsttm/norms/main/install.ps1 | iex Both installers verify release checksums and optionally install the VS Code extension. git clone git@github.com:gsttm/norms.git cd norms bun install bun test bun run build ./dist/norms.js --help In a development checkout, invoke Norms through ./dist/norms.js . Building does not install the released norms command. Norm Markdown lives in .norms/norms/ and .norms/assets/ stores referenced files. norms sync generates AGENTS.md , CLAUDE.md , .cursor/rules/norms.mdc , and .github/copilot-instructions.md . Edit .norms/ , never generated adapters. | Command | Purpose | |---|---| norms init | Initialize Norms, starter meta-norms, and existing agent instructions. | norms list | List active norms and sources. | norms context path | Return norms applicable to a path. | norms explain <path | Explain scope matches and declared conflicts. | norms lint path... | Emit deterministic context for evaluation by your agent. | norms status | Show sync and Git state. | norms propose | Create or update a local norm. | norms sync | Restore pinned imports offline and generate agent adapters. | norms sync --update | Fetch configured refs and update import pins. | norms check | Validate config, norms, lockfile, and adapters. | norms review | Commit, push, and open a GitHub or GitLab review. | Add --json for machine-readable output. Norms currently outputs only AGENTS.md , CLAUDE.md , .cursor/rules/norms.mdc , and .github/copilot-instructions.md .