What is the Anti-Accretion Rule?

The Anti-Accretion Rule is a strict constraint requiring that the total line count of a design document must be less than or equal to its original count after a critique, preventing documentation bloat.

What signals does it look for to identify over-engineering?

It scans for excessive configuration options, complex plugin architectures, multiple layers of abstraction for single use cases, and 'future-proofing' descriptions that lack immediate utility.

How does Intent Critique handle missing design elements?

If a critical design element is missing, the skill outputs a 'Gap Flag' for future discussion rather than automatically adding content, maintaining the focus on simplification.

What is the purpose of the Devil's Advocate feature?

It employs an independent subagent with no prior discussion context to evaluate the design from a fresh perspective, identifying risks that the primary developer might have overlooked.

Intent Critique

Name: Intent Critique
Author: ArcBlock

byArcBlock

•

Productivity & Workflow

Refines design quality by enforcing architectural simplicity and eliminating over-engineering through the Anti-Accretion rule.

Intent Critique is a specialized tool for Intent-Driven Development (IDD) designed to evaluate design documentation for architectural bloat and premature abstraction. It operates on a strict 'net-reduction' principle where any revision must result in fewer lines of text than the original, ensuring that complexity is actively removed rather than accumulated. By focusing on YAGNI (You Ain't Gonna Need It) principles and interactive stakeholder discussion, it helps developers distill their system designs into their most essential, maintainable, and cost-effective forms.

Key Features

01Convergence Checking: Triggers deep architectural reviews for frequently modified design files to ensure design stability.

02Multi-Dimensional Scanning: Detects over-engineering, premature abstractions, and hidden implementation complexities.

03Interactive Refinement: Guides users through step-by-step simplification prompts rather than making unilateral changes.

047 GitHub stars

05Anti-Accretion Enforcement: Ensures documentation line counts never increase during the critique process.

06Devil's Advocate Mode: Utilizes a context-free subagent to provide unbiased evaluations of design risks.

Use Cases

01Pruning legacy design documents to align with MVP (Minimum Viable Product) requirements.

02Identifying architectural risks and unnecessary abstractions in complex system specifications.

03Simplifying bloated software architectures before implementation begins.

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add arcblock/idd intent-critique

For use in Claude.ai and ChatGPT

Download Skill