paragon

What problem does it solve?

PARAGON is a unified enforcement system that ensures all code changes comply with strict engineering standards for code quality, stack compliance, and evidence-based development. It automates code reviews, prevents common anti-patterns, and maintains architectural integrity.

Core Features & Use Cases

• 14 Blocking Guards: Enforces rules against unsafe Bash, forbidden files/imports (e.g., Docker, jest.mock, z.infer), any types, mocking, and assumption language in code.
• Advisory Guards: Warns about potential issues like missing flake patterns, undeclared ports, and throw statements for expected errors, guiding best practices.
• Verification-First Philosophy: Integrates with the "verification-first" approach, demanding explicit test evidence for all claims about code behavior, eliminating speculative language.
• Use Case: A developer attempts to commit code that uses jest.mock(). This skill, via a pre-commit hook, will block the commit and explain why mocking is forbidden, guiding the developer to use real service containers instead, ensuring architectural consistency.

Quick Start

Verify the current repository's compliance with all PARAGON guards by running the 'just verify-paragon' command.