Description

Fixed a YAML syntax error in docs/templates/brd-template.md that caused npm run lint:frontmatter to fail. The frontmatter values containing - (space-hyphen-space) and template variables {{...}} were interpreted as YAML block sequence indicators, triggering a "Block sequence entries are not allowed" parse error.

• Quoted title, description, and author frontmatter fields with double quotes to prevent YAML special character interpretation
• Updated ms.date from 2025-12-05 to 2026-01-28
• Added standard Copilot footer with markdownlint disable/enable comments

Related Issue(s)

Closes #331

Type of Change

Select all that apply:

Code & Documentation:

• Bug fix (non-breaking change fixing an issue)
• New feature (non-breaking change adding functionality)
• Breaking change (fix or feature causing existing functionality to change)
• Documentation update

Infrastructure & Configuration:

• GitHub Actions workflow
• Linting configuration (markdown, PowerShell, etc.)
• Security configuration
• DevContainer configuration
• Dependency update

AI Artifacts:

• Reviewed contribution with prompt-builder agent and addressed all feedback
• Copilot instructions (.github/instructions/*.instructions.md)
• Copilot prompt (.github/prompts/*.prompt.md)
• Copilot agent (.github/agents/*.agent.md)

Note for AI Artifact Contributors:

• Agents: Research, indexing/referencing other project (using standard VS Code GitHub Copilot/MCP tools), planning, and general implementation agents likely already exist. Review .github/agents/ before creating new ones.
• Model Versions: Only contributions targeting the latest Anthropic and OpenAI models will be accepted. Older model versions (e.g., GPT-3.5, Claude 3) will be rejected.
• See Agents Not Accepted and Model Version Requirements.

Other:

• Script/automation (.ps1, .sh, .py)
• Other (please describe):

Testing

• Ran npm run lint:frontmatter -- -Files "docs/templates/brd-template.md" → 0 errors, 0 warnings
• Ran npm run lint:md → 0 errors across 117 files
• Verified template variables remain intact for BRD generation workflows

Checklist

Required Checks

• Documentation is updated (if applicable)
• Files follow existing naming conventions
• Changes are backwards compatible (if applicable)
• Tests added for new functionality (if applicable)

AI Artifact Contributions

N/A - Not an AI artifact contribution

Required Automated Checks

The following validation commands must pass before merging:

• Markdown linting: npm run lint:md
• Spell checking: npm run spell-check
• Frontmatter validation: npm run lint:frontmatter
• Link validation: npm run lint:md-links
• PowerShell analysis: npm run lint:ps

Security Considerations

• This PR does not contain any sensitive or NDA information
• Any new dependencies have been reviewed for security issues
• Security-related scripts follow the principle of least privilege

Additional Notes

This fix follows the documented quoting pattern from prompts.md which shows double-quoted template variables as the correct style for YAML frontmatter.

📝 - Generated by Copilot