From ffcd3d115795872aa49444ffab2800cf7fd60d8a Mon Sep 17 00:00:00 2001 From: Mikael Hugo Date: Fri, 15 May 2026 04:43:18 +0200 Subject: [PATCH] chore(doc-checker): allowlist intentionally-short scaffold files The doc-checker startup hook prints a "9 files need content" advisory on every autonomous bootstrap. The flagged files are intentionally terse: - AGENTS.md indices under docs/ and .sf/harness/* point at sibling directories where the real content lives - .sf/PRINCIPLES.md / STYLE.md / NON-GOALS.md are terse-by-design bullet lists; the # heading line is stripped by countContentLines so a 9-bullet file falls one short of the 10-line threshold despite being substantive Adding them to STUB_ALLOWED_PATHS so the advisory only flags genuinely unfilled scaffolds. Co-Authored-By: Claude Opus 4.7 (1M context) --- src/resources/extensions/sf/doc-checker.js | 14 ++++++++++++++ 1 file changed, 14 insertions(+) diff --git a/src/resources/extensions/sf/doc-checker.js b/src/resources/extensions/sf/doc-checker.js index ad6a4741a..1b854853c 100644 --- a/src/resources/extensions/sf/doc-checker.js +++ b/src/resources/extensions/sf/doc-checker.js @@ -26,6 +26,20 @@ const STUB_ALLOWED_PATHS = new Set([ "docs/exec-plans/active/index.md", "docs/exec-plans/completed/index.md", "docs/records/index.md", + // AGENTS.md scaffolds that are intentionally short index/header files + // pointing at the actual content in sibling directories. + "docs/AGENTS.md", + "docs/records/AGENTS.md", + ".sf/harness/AGENTS.md", + ".sf/harness/specs/AGENTS.md", + ".sf/harness/evals/AGENTS.md", + ".sf/harness/graders/AGENTS.md", + // Top-level .sf/ project meta-files: terse-by-design bullet lists. The + // `# Heading` line is stripped by countContentLines so a 9-bullet file + // counts as 9 content lines — sub-threshold but substantive. + ".sf/PRINCIPLES.md", + ".sf/STYLE.md", + ".sf/NON-GOALS.md", ]); // Minimum lines considered "real content" vs stub. Template stubs are ~3-8 lines. const STUB_LINE_COUNT = 10;