complexity-guard

Audits architectural and system design documents for anti-patterns and complexity scoring.

142|24|Updated Jan 19, 2026
One-click install
npx skills add https://github.com/Haaaiawd/Antigravity-Workflow-System --skill complexity-guard
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: complexity-guard
Source: https://github.com/Haaaiawd/Antigravity-Workflow-System/tree/main/.agent/skills/complexity-guard
Command: npx skills add https://github.com/Haaaiawd/Antigravity-Workflow-System --skill complexity-guard

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill acts as a final gatekeeper, preventing the introduction of overly complex solutions, unnecessary dependencies, and speculative features into the project.

Core Features & Use Cases

  • RFC Auditing: Reviews architectural, task, and system design documents.
  • Anti-Pattern Detection: Checks against a blacklist of common design flaws.
  • Complexity Scoring: Assigns a complexity score and provides a clear verdict (APPROVE/REJECT).
  • Use Case: Before a new feature's design is merged, this Skill audits the proposed architecture to ensure it adheres to the principle of least complexity and avoids introducing new, unjustified dependencies.

Quick Start

Use the complexity-guard skill to audit the architecture overview file genesis/v1/02_ARCHITECTURE_OVERVIEW.md.

Frequently Asked Questions about complexity-guard

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

FAQPage Schema
How do I audit design documents for over-engineering and unnecessary complexity?

Audit design documents for over-engineering by checking them against a predefined blacklist of anti-patterns, YAGNI violations, and excessive dependencies to enforce simplicity. The skill reviews architectural proposals and assigns a complexity score to output a clear APPROVE or REJECT verdict.

What is YAGNI violation detection and how does it prevent resume-driven development?

YAGNI violation detection identifies speculative features and unjustified dependencies in technical proposals, stopping resume-driven development patterns. It acts as a gatekeeper to ensure new architecture adheres to the principle of least complexity before design merges.

Can I use this to review an architecture overview file before merging a new feature?

Yes, you can review an architecture overview file before merging a new feature by passing the specific design document path to the skill. It audits the proposed architecture against common design flaws to prevent introducing unnecessary complexity into the project.

How do I check if a technical proposal introduces excessive dependencies?

Check if a technical proposal introduces excessive dependencies by running an anti-pattern detection audit on the design file. The skill evaluates dependency management against a blacklist of design flaws and returns a complexity score to determine if the additions are justified.

What are the limitations of automated anti-pattern detection for RFC auditing?

A limitation of automated anti-pattern detection for RFC auditing is that it requires a review of specific design files against a predefined list of anti-patterns. It cannot dynamically discover novel architectural flaws outside its established blacklist or evaluate undocumented design rationale.