Prompt file imported from cdalsoniii/brightpath-coder (
.cursor/commands/system-health-audit.md). Copyright stays with the author.
System Health Audit
Verify that the entire agent/skill/rule/command ecosystem is healthy and all 20 concerns have active coverage.
Steps
-
Agent Health Check:
- List all agents in
.cursor/agents/ - For each agent, verify:
- Trigger patterns match existing file paths in the codebase
- Referenced skills exist in
.cursor/skills/ - Referenced rules exist in
.cursor/rules/ - Referenced plans exist in
.cursor/plans/
- Report orphaned references
- List all agents in
-
Skill Health Check:
- List all skills in
.cursor/skills/ - For each skill, verify:
- SKILL.md exists and has valid frontmatter
- Referenced rules exist
- Glob patterns are not empty
- Report unused skills (not referenced by any agent)
- List all skills in
-
Rule Health Check:
- List all rules in
.cursor/rules/ - For each rule, verify:
- Valid frontmatter (description, globs)
- Glob patterns match existing files (if file-scoped)
- Report orphaned rules (not referenced by any agent or skill)
- List all rules in
-
Command Health Check:
- List all commands in
.cursor/commands/ - For each command, verify:
- Valid frontmatter
- Referenced rules/skills/agents exist
- Report orphaned commands
- List all commands in
-
Concern Coverage Matrix:
- Using rule 130 (concern-trigger-registry), verify each of the 20 concerns:
- Has at least one agent with matching trigger patterns
- Has at least one verification command
- Has at least one backing skill or rule
- Report uncovered concerns
- Using rule 130 (concern-trigger-registry), verify each of the 20 concerns:
-
Overlap Detection:
- Identify agents with identical trigger patterns (potential duplication)
- Verify differentiated agents (code-review-specialist vs code-reviewer, etc.) have distinct trigger scopes
-
Generate Health Report:
# System Health Audit — [date] ## Summary - Agents: N total, N healthy, N with issues - Skills: N total, N referenced, N orphaned - Rules: N total, N applied, N orphaned - Commands: N total - Concerns: N/20 fully covered ## Issues ... ## Recommendations ...
References
.cursor/rules/130-concern-trigger-registry.mdc
