Why does the skill limit the number of principles?

To maintain high signal-to-noise ratio, the skill includes density checks that warn you if you exceed 11-15 principles, preventing 'rule fatigue' and ensuring guidelines remain actionable.

Does it modify my source code automatically?

No. The skill is idempotent and requires explicit user approval for each proposed update, ensuring you retain full control over your project's governing principles.

What is 'principle drift' detection?

Drift detection identifies three types of changes: new implicit principles appearing in code, existing principles becoming stale, and principles that are naturally evolving over time.

What makes an articulated principle effective?

Each principle is structured with a name, statement, rationale, boundary (where it doesn't apply), and a concrete verification step to ensure it can be audited.

How does the skill discover new principles?

The skill follows extraction heuristics that scan CLAUDE.md, commit messages, and code patterns to identify candidate principles, which are then presented for user approval.

Project Principles Manager

Name: Project Principles Manager
Author: bcbeidel

bybcbeidel

•

生産性とワークフロー

Extract and maintain a structured source of truth for architectural principles and project guidelines within your repository.

The Principles skill automates the discovery, articulation, and maintenance of project-level principles to ensure long-term architectural integrity. It intelligently scans commit history, documentation, and code patterns to extract implicit rules, guiding users through a formalization process that includes rationale, boundaries, and concrete verification steps. By implementing automated drift detection, the skill identifies when the codebase has veered away from its stated philosophy or when new patterns have emerged, allowing teams to keep their project context synchronized with reality.

主な機能

01Formalized articulation with rationale and verification criteria

02Seamless integration with CLAUDE.md and repository context

03Drift detection to identify stale principles or new implicit behaviors

04Structural validation for principle density and internal contradictions

051 GitHub stars

06Automated principle extraction from git history, docs, and code patterns

ユースケース

01Aligning distributed teams on core architectural philosophies and constraints

02Auditing growing projects to prevent architectural regression and rule bloat

03Formalizing unwritten rules in a legacy codebase for new contributors

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add bcbeidel/wos principles

For use in Claude.ai and ChatGPT