@xiaolaichecks…fix/nlpm-audit-project-reference-frontmatter → master2 files · +10 −0updated 1mo agoAutomated audit: This PR was generated by NLPM, a natural language programming linter, running via claude-code-action. Please evaluate the diff on its merits.
Two reference command files in the audit-project/ plugin were missing YAML frontmatter entirely:
audit-project/commands/audit-project-agents.mdaudit-project/commands/audit-project-github.mdClaude Code requires a YAML frontmatter block (with at minimum a description field) to register and describe command files. Without it, Claude Code may enumerate these files as commands but cannot describe them, and standalone invocation fails silently. The parent audit-project.md correctly references these as phase sub-documents, but the missing frontmatter creates ambiguity for the runtime.
Added minimal YAML frontmatter to each file:
---
description: "Reference: <purpose> for /audit-project — <detail>. Not a standalone command."
allowed-tools: []
---
The allowed-tools: [] explicitly marks these as internal reference documents that don't need direct tool access (the parent audit-project.md declares the full tool budget including Task, Bash, Read, etc.). The descriptions clarify their role as phase sub-documents referenced by /audit-project.
Without this fix, users who attempt to invoke these files directly get no useful feedback. With frontmatter, Claude Code can at minimum describe them and their relationship to the parent command.