agentsop-conventions-pinning

What problem does it solve?

Prevents coder-agents from silently ignoring your project’s coding standards by turning your conventions into a reliably loaded, tool-compatible, conflict-aware guidance file.

Core Features & Use Cases

• Conventions-file blueprint: defines what belongs in CONVENTIONS.md/CLAUDE.md/.cursor rules/.clinerules/AGENTS.md and what should be omitted to avoid context bloat.
• Multi-tool loading SOP: covers the four common persistence mechanics—explicit read-only attachment, Claude Code ancestor-walk auto-load, glob-scoped rules, and CrewAI backstory injection.
• Evidence-based evolution loop: provides an A/B verification approach plus when to add, delete, or split rules to reduce drift and contradictions over time.
• Conflict resolution guidance: specifies how to handle precedence when pinned conventions contradict existing repository patterns, preventing arbitrary tool behavior.

Quick Start

Ask an agent to write and load your conventions file by following the conventions-pinning skill so the agent passes a targeted A/B test for a single rule (for example, using httpx instead of requests).