Add id, name, and description as standard frontmatter fields

[Copilot]

Standardizes id, name, and description as optional metadata fields across all frontmatter types (tasks, rules, commands) to enable consistent tracking and documentation.

Changes

• Frontmatter structs: Added three optional string fields to TaskFrontMatter, RuleFrontMatter, and CommandFrontMatter

  • id: unique identifier for external system tracking
  • name: human-readable display name
  • description: purpose and functionality description

• Tests: Extended existing test coverage and added new CommandFrontMatter tests following table-driven pattern

• Documentation: Updated SPECIFICATION.md and docs/reference/file-formats.md with field definitions and examples

• Examples: Demonstrated usage in example files for all three types

Usage

---
id: task-12345
name: Fix Authentication Bug
description: Resolve critical login flow issue affecting enterprise users
task_name: fix-auth-bug
languages:
  - go
---

# Fix Authentication Bug
...

All fields are metadata-only and do not affect matching, filtering, or selection behavior. Fully backward compatible - existing files require no changes.

Original prompt

Let's make ID, name and description standard frontmatter.

---

✨ Let Copilot coding agent set things up for you — coding agent works faster and does higher quality work when set up for your repo.

[Copilot]

Pull request overview

This PR standardizes optional metadata fields across frontmatter types by adding id, name, and description fields to TaskFrontMatter, RuleFrontMatter, and CommandFrontMatter. These fields are metadata-only and do not affect task matching, rule filtering, or command selection, maintaining full backward compatibility.

Changes:

• Added three optional string fields (id, name, description) to Task, Rule, and Command frontmatter structs with proper YAML/JSON tags and documentation comments
• Extended test coverage with new table-driven test cases for all three types, including a new comprehensive test file for CommandFrontMatter
• Updated SPECIFICATION.md and docs/reference/file-formats.md with detailed field definitions, examples, and usage notes
• Added example files demonstrating the new fields for tasks, rules, and commands

Reviewed changes

Copilot reviewed 9 out of 9 changed files in this pull request and generated no comments.

Show a summary per file

File	Description
pkg/codingcontext/markdown/frontmatter.go	Added id, name, and description fields to TaskFrontMatter, CommandFrontMatter, and RuleFrontMatter structs with documentation
pkg/codingcontext/markdown/frontmatter_task_test.go	Extended tests to validate new standard fields in both Marshal and Unmarshal operations
pkg/codingcontext/markdown/frontmatter_rule_test.go	Added test cases for new standard fields in rule frontmatter
pkg/codingcontext/markdown/frontmatter_command_test.go	New comprehensive test file for CommandFrontMatter following table-driven pattern
SPECIFICATION.md	Added field definitions, renumbered existing sections, and updated summary tables
docs/reference/file-formats.md	Documented all three new fields for tasks, commands, and rules with examples and usage notes
examples/agents/tasks/example-with-standard-fields.md	Updated to demonstrate new metadata fields
examples/agents/rules/example-rule-with-standard-fields.md	New example file demonstrating rule metadata fields
examples/agents/commands/example-command-with-standard-fields.md	New example file demonstrating command metadata fields