OpenSpec Authoring Patterns

Trigger Keywords: openspec, proposal, change-id, tasks.md, spec delta, requirement, scenario, validation, archive

Agent Integration: Used by spec-writer and planning agents when creating or updating OpenSpec proposals, tasks, and spec files.

Metadata & Frontmatter

• Proposals/Tasks: include Change ID, Status, Date, and Author near the top.
• Specs: start with # Spec: <Title> plus capability/status/related lines.
• Use verb-led, kebab-case change-id (e.g., add-doc-spec-writer-agent).
• Keep managed instruction blocks intact when present.

Required Section Ordering

• proposal.md: Executive Summary → Background → Goals → Scope/Non-Goals → Approach → Risks & Mitigations → Validation → Open Questions.
• tasks.md: Overview → Phase/Task grouping with checklists; include validation notes where possible.
• spec.md (delta): Overview → ## ADDED|MODIFIED|REMOVED Requirements → Scenarios per requirement with Given/When/Then.