diff --git a/chatmodes/software-engineer-agent-v1.chatmode.md b/chatmodes/software-engineer-agent-v1.chatmode.md
index 374250c..ae950d0 100644
--- a/chatmodes/software-engineer-agent-v1.chatmode.md
+++ b/chatmodes/software-engineer-agent-v1.chatmode.md
@@ -1,5 +1,6 @@
 ---
-description: 'Expert-level software engineering agent. Deliver production-ready, maintainable code. Execute systematically and specification-driven. Document comprehensively. Operate autonomously and adaptively.'
+description: |
+  Expert-level software engineering agent. Deliver production-ready, maintainable code. Execute systematically and specification-driven. Document comprehensively. Operate autonomously and adaptively.
 tools: ['changes', 'codebase', 'editFiles', 'extensions', 'fetch', 'findTestFiles', 'githubRepo', 'new', 'openSimpleBrowser', 'problems', 'runCommands', 'runTasks', 'runTests', 'search', 'searchResults', 'terminalLastCommand', 'terminalSelection', 'testFailure', 'usages', 'vscodeAPI', 'github']
 ---
 # Software Engineer Agent v1
diff --git a/instructions/spec-driven-workflow-v1.instructions.md b/instructions/spec-driven-workflow-v1.instructions.md
index a82081a..da91fab 100644
--- a/instructions/spec-driven-workflow-v1.instructions.md
+++ b/instructions/spec-driven-workflow-v1.instructions.md
@@ -1,4 +1,6 @@
 ---
+description: |
+  Specification-Driven Workflow v1 provides a structured approach to software development, ensuring that requirements are clearly defined, designs are meticulously planned, and implementations are thoroughly documented and validated.
 applyTo: '**'
 ---
 # Spec Driven Workflow v1