manage-rules

What problem does it solve?

Projects with many rule templates and profiles struggle to pick, preview, and apply the right set of technical rules for a given project profile. This skill automates detection of the active profile, analyzes template YAML frontmatter, and produces a transparent recommendation report so maintainers can review before applying changes.

Core Features & Use Cases

• Profile detection and validation: auto-detects project profile from docs/project-profile.md or .claude/profiles/*.json and validates frontmatter.
• Template analysis and filtering: scans .claude/guides/rules/templates/, extracts profiles/category/tags from YAML frontmatter, and filters by include/exclude patterns.
• Framework-only protection: detects and excludes templates marked framework-only to avoid leaking framework maintenance rules into projects.
• Preview and safe apply: generates a three-part recommendation report (.claude/rules-recommendation.md), supports dry-run preview and interactive confirmation, and copies matched templates into .claude/rules/ while preserving structure.
• Use cases: project initialization, framework sync, manual rule regeneration, and CI scaffolding adjustments.

Quick Start

Run the manage-rules command to auto-detect your profile, generate the recommendation report, review the suggested rules, and confirm to copy the selected templates into .claude/rules/.