[](https://polish-open-source.pl/en/latest)

About

MIT licensed universal project rules for coding agents.

This repository contains ready-to-use rule sets inspired by well-known books on software design, architecture, refactoring, legacy code, reliability, and data-intensive systems.

For editor-specific setup in Codex, Claude Code, and Cursor, see [USAGE.md](docs/USAGE.md). It covers always-on vs on-demand usage, skills, scoped rules, MCP or RAG patterns, and the preferred setup for each editor.

Each rule set is released in three tool-agnostic Markdown versions:

• mini: the recommended version for most real task use
• nano: the compact fallback for very tight context budgets
• full: the canonical complete source and reference version

For constructive criticism from Reddit, see [CRITICISM.md](docs/CRITICISM.md).

For release history, see [CHANGELOG.md](CHANGELOG.md).

Release Matrix

Metrics:

• lines: physical line count from wc -l
• rules: Markdown list items counted with the deterministic release convention
• size: raw bytes from wc -c

| Rule Set | Full file | Full lines | Full rul