golden-principleslisted

# Golden Principles Scan the repository for violations of mechanically enforced golden principles. Produces remediation instructions that agents can act on directly. Inspired by [OpenAI Harness Engineering](https://openai.com/index/harness-engineering/): > "We started encoding what we call 'golden principles' directly into the repository > and built a recurring cleanup process." ## Triggers | Trigger Phrase | Operation | |----------------|-----------| | `scan golden principles` | Full principle compliance scan | | `check principle compliance` | Scan with summary report | | `golden principle violations` | Scan and list violations | | `run garbage collection` | Deep scan with fix-up recommendations | | `audit principles` | Scan specific rules only | ## When to Use Use this skill when: - Preparing a PR for submission (catch violations early) - Running periodic garbage collection scans - Auditing a domain or directory for compliance - Adding new files to the repository Use `taste-lints` instead when: - Checking code-level invariants only (file size, naming, complexity) - Running pre-commit checks on staged files Use `quality-grades` instead when: - Grading domains across architectural layers - Producing quality trend reports ## Process 1. Run `python3 .claude/skills/golden-principles/scripts/scan_principles.py` with target 2. Review AGENT_REMEDIATION blocks in output 3. Apply suggested fixes 4. Re-run to confirm compliance ## Usage ```bash # Scan entire repository