symmetry

Enforce structural mirroring and signature consistency across parallel code paths.

28|3|Updated Feb 22, 2026

Search Tags:#code quality #consistency #refactoring #developer experience #crud #code symmetry

Ready to run

npx skills add https://github.com/oborchers/fractional-cto --skill symmetry

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: symmetry
Source: https://github.com/oborchers/fractional-cto/tree/main/pedantic-coder/skills/symmetry
Command: npx skills add https://github.com/oborchers/fractional-cto --skill symmetry

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill addresses the common issue of inconsistent code structure across similar operations, which increases cognitive load and maintenance costs. It enforces a consistent look and feel for parallel code paths.

Core Features & Use Cases

Enforces Code Consistency: Ensures functions performing analogous work have identical signatures, return shapes, and error handling patterns.
Improves Readability: Makes codebases easier to understand and navigate by establishing predictable patterns.
Use Case: When developing CRUD operations for different resources (e.g., users, products, orders), this Skill ensures that create_user, create_product, and create_order all follow the exact same structure, parameter order, and error handling.

Quick Start

Use the symmetry skill to review the consistency of the CRUD operations in the user service.

Frequently Asked Questions about symmetry

High-intent search queries and answers about installing and using this skill.

FAQPage Schema

How do I enforce consistent function signatures and return shapes across parallel CRUD operations?▼

Structural mirroring ensures analogous operations like create_user and create_product follow identical function signatures, parameter orders, and error handling patterns. This reduces cognitive load by making parallel code paths predictable across resources.

What is code symmetry and why does it matter for codebase readability?▼

Code symmetry is the practice of ensuring parallel code paths like event handlers and matching pairs maintain analogous structure across functions and modules. It improves readability by establishing predictable patterns that make codebases easier to navigate and understand.

How do I check if my event handlers and matching pairs have consistent error handling and naming?▼

You check for structural mirroring violations by reviewing function signatures, return shapes, error handling, naming, file structure, and test structure across matching pairs. This identifies inconsistencies in how analogous event handlers are implemented across modules.

Can I use this to review structural consistency for CRUD operations in a specific service?▼

Yes, you can review the consistency of CRUD operations in a specific service by analyzing whether functions performing analogous work like create, read, update, and delete maintain identical signatures and return shapes across different resources within that service.

What are common code symmetry violations to look for when refactoring parallel code paths?▼

Common violations include mismatched function signatures, inconsistent return shapes, divergent error handling patterns, unrelated naming conventions, and misaligned file or test structures across analogous operations that should mirror each other.

When should I not apply strict structural mirroring to parallel code paths?▼

Strict structural mirroring may not suit parallel code paths with fundamentally different operational requirements or domain constraints. Forcing identical structure on operations that handle distinct business logic or external dependencies can introduce unnecessary coupling and obscure genuine differences.