Critical Rules — Development agent for Claude Code
Check tldr-swinton invariants before changing imports, outputs, compatibility surfaces, or tests.
How to install Critical Rules
Installs to ~/.claude/agents/mistakeknot-tldr-swinton-critical-rules.md
mkdir -p ~/.claude/agents && curl -fsSL https://raw.githubusercontent.com/mistakeknot/tldr-swinton/HEAD/agents/critical-rules.md -o ~/.claude/agents/mistakeknot-tldr-swinton-critical-rules.md Restart Claude Code, or start a new session, for it to be picked up.
What Critical Rules does
name: tldrs-critical-rules description: Check tldr-swinton invariants before changing imports, outputs, compatibility surfaces, or tests.
Critical Rules
Import Convention
All internal imports MUST use relative imports:
# CORRECT
from .hybrid_extractor import HybridExtractor
from .ast_extractor import FunctionInfo
# WRONG - imports from old llm-tldr package
from tldr.hybrid_extractor import HybridExtractor
Language Field Required
When creating `FunctionInfo` fo
Alternatives in Development
- Gitnexus Synthesis Critic — GitNexus final review synthesis critic 45.8k ★
- Tend — Tend the Allium garden 3.7k ★
- Mack — Automation Specialist 296 ★
Full documentation available on GitHub
View Source RepositoryRelated Agents
Related Projects
Check downstream projects and synchronization requirements before changing public tldr-swinton formats or capa
MCP Server
Reference the tldr-swinton MCP surface when changing tools, schemas, costs, or server behavior.
Domain Logic Auditor
Independently validate specialized domain logic and critical calculations against intended rules, invariants,
Python Sidecar Specialist
Use for the Python sidecars on both surfaces: the verify checks (syntax, imports, statement mapping, coverage.
Fixture Profile Run
Run the factory tests on the two fixture profiles ("monorepo" and "single package") and report pass or fail pe
Rephraser
Rephrases plain user statements into structured intent JSON. Surfaces a clarifying question only when absolute
Related Skills
Audit E2e
Audit end-to-end test coverage of critical Playwright paths. Identifies missing flows, flaky tests, slow suite
API Contract Audit
Inventory every API endpoint that surfaces a field to clients BEFORE dropping, renaming, or semantically chang
Critical Thinking
A Claude skill for end-of-session critical thinking reviews. Surfaces unverified claims, missing perspectives,