When should I run a philosophy review?

It is best used during architectural design phases, before merging complex pull requests, or when validating that a refactoring effort successfully reduced complexity.

What is an AI-regeneratability assessment?

It evaluates whether a module's specification and boundaries are clear enough for an AI agent to completely rebuild the component without breaking external connections.

How does this skill help prevent over-engineering?

It identifies 'future-proofing' patterns—code written for hypothetical future needs—and suggests simpler, more direct implementations that solve immediate problems.

What is the Brick Philosophy in this skill?

The Brick Philosophy treats modules as self-contained, isolated units with a single responsibility and clear public contracts, making them easily replaceable and regeneratable by AI.

Philosophy Compliance Workflow

Name: Philosophy Compliance Workflow
Author: rysweet

byrysweet

•

Productivity & Workflow

Enforces architectural integrity and radical simplicity through systematic code reviews based on the amplihack philosophy.

This skill serves as an automated philosophical conscience for development teams, ensuring all code and architecture adheres to 'ruthless simplicity' and 'brick' modularity. It systematically evaluates implementations for over-engineering, identifies 'future-proofing' traps, and validates that every module is self-contained and regeneratable. By providing a structured scoring rubric and actionable reports, it helps maintain a clean, minimal codebase that is easy for both humans and AI agents to understand and maintain.

Key Features

01Detection of 'future-proofing' and unnecessary abstraction layers.

0232 GitHub stars

03Verification of 'Brick Philosophy' for self-contained, isolated module design.

04AI-regeneratability assessment to ensure modules can be rebuilt from specifications.

05Automated philosophy compliance scoring (A-F) based on simplicity and modularity.

06Detailed review reports with prioritized action items for simplification.

Use Cases

01Pre-merge checks to ensure new modules follow the 'brick' organizational pattern.

02Reviewing architectural designs before implementation to prevent complexity creep.

03Validating refactoring efforts to ensure they actually simplify the codebase.

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add rysweet/amplihack philosophy-compliance-workflow

For use in Claude.ai and ChatGPT

Download Skill