@xiaolaichecks…fix/nlpm-ship-reference-frontmatter → master3 files · +15 −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.
Three reference command files in the ship/ plugin were missing YAML frontmatter entirely:
ship/commands/ship-deployment.mdship/commands/ship-ci-review-loop.mdship/commands/ship-error-handling.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 ship.md correctly references these as sub-documents, but the missing frontmatter creates ambiguity for the runtime.
Added minimal YAML frontmatter to each file:
---
description: "Reference: <purpose> for /ship — <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 ship.md declares the full tool budget). The descriptions clarify their role as sub-documents referenced by /ship.
Without this fix, users who attempt to invoke these files directly (e.g., /ship-deployment) get no useful feedback. The frontmatter makes Claude Code's behavior deterministic for these files.