fission-ai__openspec/openspec/changes/improve-agent-instruction-usability/tasks.md

1. Instruction redesign

• 1.1 Draft a quick-reference section that surfaces file templates and formatting rules at the top of openspec/AGENTS.md.
• 1.2 Reorganize the workflow narrative with inline examples and progressive disclosure for advanced topics.

2. Templates and checklists

• 2.1 Add copy/paste templates for proposal, tasks, design, and spec delta files.
• 2.2 Insert a pre-validation checklist capturing common lint failures before running openspec validate.

3. Documentation updates

• 3.1 Update supporting docs or README pointers so contributors find the redesigned instructions.
• 3.2 Confirm examples and references stay in sync with the new scaffold command guidance.