rysweet avatar

Philosophy Compliance Workflow

This is a systematic code review workflow that checks whether your implementation actually follows amplihack's core principles: ruthless simplicity, brick philosophy, and Zen minimalism. It walks through a structured five question analysis (Do we need this? What's simplest? Is it a self-contained brick? Can AI rebuild it from spec? Does complexity add value?) and generates a scored report with critical violations, warnings, and specific fix recommendations. Use it before merging, during architecture reviews, or when you suspect complexity creep. The scoring rubric is opinionated but clear, and the "regeneratable by AI" lens is an interesting forcing function for keeping module boundaries clean. Most valuable when you need someone to tell you that your eight-responsibility SessionManager should actually be three separate bricks.

skills.sh installs
136
GitHub stars
76
last updated
Aug 21, 2026

Install

$ npx -y skills add rysweet/amplihack --skill philosophy-compliance-workflow --agent claude-code

Installs into .claude/skills of the current project.

Files

Philosophy Compliance Workflow Skill

Purpose

Systematic philosophy compliance review that ensures all code and architecture aligns with amplihack's core principles: ruthless simplicity, brick philosophy, and Zen-like minimalism. This skill validates that implementations serve clear purposes without unnecessary complexity.

When to Use This Skill

USE FOR:

  • Architecture reviews before implementation
  • Code reviews for philosophy alignment
  • Refactoring validation (did we actually simplify?)
  • Module design verification
  • Pre-merge philosophy checks
  • Identifying over-engineering and complexity creep

AVOID FOR:

  • Functional bug fixes (not philosophy issues)
  • Performance optimization alone
  • Documentation updates
  • Pure syntax/style issues

Core Philosophy Principles

The Zen of Simple Code

  • Each line serves a clear purpose without embellishment
  • As simple as possible, but no simpler
  • Complex systems from simple, well-defined components
  • Handle what's needed now, not hypothetical futures

The Brick Philosophy

Sponsors

Details

Repository
github.com/rysweet/amplihack
Categories
Git & Pull Requests, Code Review & Quality, Automation & Workflows
First seen
Jun 3, 2026

More from rysweet/amplihack

All 58
1borghei avatardevops-workflow-engineerborghei/claude-skillsGenerate and optimize GitHub Actions CI/CD workflows. Use when designing workflows, planning multi-environment deployments, optimizing pipeline cost and runtime134skills.sh installs
2lvlup-sw avatardesign-invariantslvlup-sw/exarchosAudit a design proposal or diff against Exarchos's architectural invariants — event-sourcing integrity (INV-1), facade equivalence over shared dispatch core (IN132skills.sh installs
3zzci avatarpma-memzzci/skillsKnowledge management skill for capturing, classifying, searching, and syncing project knowledge. Use when storing learnings, syncing BKD issue outcomes, or retr132skills.sh installs
4browser-act avataramazon-competitor-analyzerbrowser-act/skillsScrapes Amazon product data from ASINs using browseract.com automation API and performs surgical competitive analysis. Compares specifications, pricing, review 129skills.sh installs
5everyinc avatarce-session-inventoryeveryinc/compound-engineering-pluginDiscover session files for a repo across Claude Code, Codex, and Cursor, and extract session metadata (timestamps, branch, cwd, size, platform). Invoked by sess129skills.sh installs
6cinience avataralicloud-skill-creatorcinience/alicloud-skillsCreate, migrate, and optimize skills for this alicloud-skills repository. Use whenever users ask to add a new skill, import an external skill, refactor skill st126skills.sh installs