From 580a0c95a47e6070c18ac3e6c8b9c65ee0e2c590 Mon Sep 17 00:00:00 2001 From: sim Date: Thu, 13 Aug 2026 05:18:33 -0400 Subject: [PATCH] docs(#3309): update FEATURES.md's Health Validation requirements MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit REQ-HEALTH-05 said --repair auto-fixes recoverable issues without qualification — now inaccurate since DESTRUCTIVE-risk remedies are reported but never auto-applied. Adds REQ-HEALTH-06 for --backfill, previously unmentioned in this requirements register. --- docs/FEATURES.md | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/docs/FEATURES.md b/docs/FEATURES.md index b4477d59c..894dc496e 100644 --- a/docs/FEATURES.md +++ b/docs/FEATURES.md @@ -644,7 +644,7 @@ ### 19. Health Validation -**Command:** `/gsd-health [--repair]` +**Command:** `/gsd-health [--repair] [--backfill]` **Purpose:** Validate `.planning/` directory integrity and auto-repair issues. @@ -653,7 +653,8 @@ - REQ-HEALTH-02: System MUST validate configuration consistency - REQ-HEALTH-03: System MUST detect orphaned plans without summaries - REQ-HEALTH-04: System MUST check phase numbering and roadmap sync -- REQ-HEALTH-05: `--repair` flag MUST auto-fix recoverable issues +- REQ-HEALTH-05: `--repair` flag MUST auto-fix recoverable issues except DESTRUCTIVE-risk ones, which it MUST report but never auto-apply +- REQ-HEALTH-06: `--backfill` flag MUST synthesize missing MILESTONES.md entries from archived milestone snapshots ---