From 85fc96b284ac51a012ab95104f9112043905bf36 Mon Sep 17 00:00:00 2001
From: Manfred Riem <15701806+mnriem@users.noreply.github.com>
Date: Mon, 11 May 2026 09:27:02 -0500
Subject: [PATCH] docs: align Articles IV-V language with existing article
 style

Replace 'clarification pipeline' tooling references with
principle-effect language matching Articles I-III and VII-IX.
---
 spec-driven.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/spec-driven.md b/spec-driven.md
index 3b4a852f8..621e55a98 100644
--- a/spec-driven.md
+++ b/spec-driven.md
@@ -329,7 +329,7 @@ All requirements MUST be:
 - Traceable: mapped from user stories through tasks to implementation
 ```
 
-This article drives the clarification, checklist, and analysis pipeline. Before planning begins, specifications are scanned for ambiguity across functional scope, data modeling, interaction flows, and edge cases. "Unit tests for English" validate requirement quality rather than implementation correctness. Cross-artifact consistency checks catch coverage gaps, terminology drift, and duplicate or conflicting requirements before any code is written.
+This forces the LLM to treat requirement quality as a first-class engineering concern. Before planning begins, specifications must be scanned for ambiguity across functional scope, data modeling, interaction flows, and edge cases. "Unit tests for English" validate requirement quality rather than implementation correctness. Cross-artifact consistency checks catch coverage gaps, terminology drift, and duplicate or conflicting requirements before any code is written.
 
 #### Article V: Non-Functional Standards
 
@@ -343,7 +343,7 @@ Non-functional requirements MUST be specified for:
 - Accessibility: interaction standards for all user interfaces
 ```
 
-Without this article, LLMs default to functional-only implementations—code that works but cannot be monitored, secured, or maintained in production. The clarification pipeline explicitly scans for non-functional coverage gaps, and checklists can target specific quality dimensions to ensure these concerns are captured in requirements before implementation begins.
+Without this article, LLMs default to functional-only implementations—code that works but cannot be monitored, secured, or maintained in production. Specifications must explicitly address non-functional coverage gaps, and quality checklists can target specific dimensions to ensure these concerns are captured in requirements before implementation begins.
 
 #### Article VI: Governance and Versioning