xdrs-core 0.53.0 → 0.53.1

package/.xdrs/_core/adrs/principles/003-skill-standards.md

@@ -172,7 +172,7 @@ Rules:
 - `### Halt Conditions` MUST list this skill's specific stop-before-completing triggers, grounded in at least missing required input, dubious/ambiguous input, and insufficient agent confidence — distinct from `## Edge Cases` (activation/boundary conditions) and `## Anti-Patterns` (execution mistakes). A partial or empty result the skill still finishes and returns belongs in `### Outputs`, not `### Halt Conditions`.
 - `### User Interaction` is OPTIONAL: documents human-in-the-loop (HITL) exchanges during execution — a clarifying question or an approval gate — distinct from `### Halt Conditions` (which stop execution rather than pause-and-resume it) and `### Runtime Requirements` (static prerequisites, not an interactive exchange); omit the section entirely when the skill has none.
 - `### Runtime Requirements` is OPTIONAL: free-form bullets for tooling, network, or environment prerequisites beyond the LLM itself; omit the section entirely when none apply.
-- Every bullet in `#### Required`, `#### Optional`, `#### Contents`, `#### Changes`, `### Halt Conditions`, and `### User Interaction` MUST be under 10 words, or the section MUST contain a single "None" bullet instead.
+- Every bullet in `#### Required`, `#### Optional`, `#### Contents`, `#### Changes`, `### Halt Conditions`, and `### User Interaction` MUST be under 20 words, or the section MUST contain a single "None" bullet instead.
 - `## Anti-Patterns` is REQUIRED with a minimum of 3 entries, each naming a Mistake, Why it happens, and the correct approach Instead, grounded in real observed issues rather than theoretical ones. Keep it distinct from `## Edge Cases`: Edge Cases are activation/boundary conditions, Anti-Patterns are execution mistakes.
 - Key recommendations MAY be tagged `[PROVEN]`, `[RECOMMENDED]`, or `[EXPERIMENTAL]` when a skill offers several viable approaches at different confidence levels.
 - For diagram format preferences and non-Markdown asset rules, see [`_core-adr-policy-020`](020-media-and-asset-standards.md).

package/.xdrs/_core/adrs/principles/skills/write-skill/SKILL.md

@@ -111,29 +111,29 @@ metadata:
 
 #### Required
 
-[Bare-minimum bullets needed to invoke the skill, or a single "None" bullet. Each <10 words.]
+[Bare-minimum bullets needed to invoke the skill, or a single "None" bullet. Each <20 words.]
 
 #### Optional
 
-[Extra helpful-context bullets, or a single "None" bullet. Each <10 words.]
+[Extra helpful-context bullets, or a single "None" bullet. Each <20 words.]
 
 ### Outputs
 
 #### Contents
 
-[End-objective files/chat text produced, or a single "None" bullet. Each <10 words. Append "(<N words)" or "(uncapped: <reason>)" to natural-language items not capped in a template or step, e.g. "Release notes (<300 words)". Code and structured data get no marker.]
+[End-objective files/chat text produced, or a single "None" bullet. Each <20 words. Append "(<N words)" or "(uncapped: <reason>)" to natural-language items not capped in a template or step, e.g. "Release notes (<300 words)". Code and structured data get no marker.]
 
 #### Changes
 
-[End-objective external system mutations, or a single "None" bullet. Each <10 words.]
+[End-objective external system mutations, or a single "None" bullet. Each <20 words.]
 
 ### Halt Conditions
 
-[This skill's specific stop-before-completing triggers, or a single "None" bullet. Each <10 words.]
+[This skill's specific stop-before-completing triggers, or a single "None" bullet. Each <20 words.]
 
 ### User Interaction
 
-[Optional. Human-in-the-loop exchanges during execution: clarifying questions or approval gates, or a single "None" bullet. Each <10 words. Omit the whole section if none apply.]
+[Optional. Human-in-the-loop exchanges during execution: clarifying questions or approval gates, or a single "None" bullet. Each <20 words. Omit the whole section if none apply.]
 
 ### Runtime Requirements
 
@@ -189,7 +189,7 @@ Before writing files, verify:
 4. **Duplication**: Does this overlap an existing skill? If yes, revise.
 5. **References**: Are all related XDRs and skills linked, including the cases where the skill operationalizes multiple XDRs?
 6. **Anti-Patterns**: Does the skill include at least 3 genuine, domain-specific `## Anti-Patterns` entries (not generic filler)?
-7. **Required sections**: Does `## Overview` contain nested `### Inputs` (Required/Optional bullets), `### Outputs` (Contents/Changes bullets), and `### Halt Conditions` listing this skill's specific stop triggers — each bullet under 10 words or a single "None"?
+7. **Required sections**: Does `## Overview` contain nested `### Inputs` (Required/Optional bullets), `### Outputs` (Contents/Changes bullets), and `### Halt Conditions` listing this skill's specific stop triggers — each bullet under 20 words or a single "None"?
 8. **Meta-policy compliance**: Run the shared module at `.xdrs/_core/adrs/principles/skills/.assets/meta-policy-compliance.md`. Substitute `[DOCUMENT]` with `skill`.
 9. **Output caps**: Does every natural-language content the skill generates (files, messages, questions, summaries, external posts) have exactly one "<N words" cap or "(uncapped: <reason>)" marker, with code and structured data unmarked?
 

package/lib/lint.js

@@ -1443,7 +1443,7 @@ function lintSkillNestedSubsections(content, filePath, errors) {
 
 /**
  * Validates a bullet-list section's item shape: either a single "None" bullet, or one-or-more
- * bullets each under 10 words, per _core-adr-policy-003. No-op when the range has no bullets
+ * bullets each under 20 words, per _core-adr-policy-003. No-op when the range has no bullets
  * at all (an empty required section is reported by other checks).
  */
 function lintBulletWordCountSection(lines, ignoredLines, start, end, label, filePath, errors) {
@@ -1468,14 +1468,14 @@ function lintBulletWordCountSection(lines, ignoredLines, start, end, label, file
 
   for (const bullet of bullets) {
     const wordCount = countWords(bullet);
-    if (wordCount >= 10) {
-      errors.push(`${label} bullet must be under 10 words or a single "None" (found ${wordCount}): ${toDisplayPath(filePath)} [_core-adr-policy-003]`);
+    if (wordCount >= 20) {
+      errors.push(`${label} bullet must be under 20 words or a single "None" (found ${wordCount}): ${toDisplayPath(filePath)} [_core-adr-policy-003]`);
     }
   }
 }
 
 /**
- * Validates the item word-count rule (single "None" bullet, or one-or-more sub-10-word
+ * Validates the item word-count rule (single "None" bullet, or one-or-more sub-20-word
  * bullets) across "### Inputs" -> "#### Required"/"#### Optional", "### Outputs" ->
  * "#### Contents"/"#### Changes", "### Halt Conditions", and "### User Interaction" (only
  * when present, since it is optional). All 4 subsections live inside "## Overview", per

package/lib/lint.test.js

@@ -457,23 +457,23 @@ test('passes SKILL.md with valid None bullets in Inputs, Outputs, and Halt Condi
 
   const result = lintWorkspace(workspaceRoot);
 
-  expect(result.errors.join('\n')).not.toContain('must be under 10 words or a single "None"');
+  expect(result.errors.join('\n')).not.toContain('must be under 20 words or a single "None"');
 });
 
-test('reports SKILL.md bullet over 10 words in #### Required', () => {
+test('reports SKILL.md bullet over 20 words in #### Required', () => {
   const workspaceRoot = createWorkspace('skill-required-bullet-too-long', {
     '.xdrs/index.md': rootIndex(),
     '.xdrs/_local/adrs/index.md': localAdrIndex([
       '- [check-links](principles/skills/check-links/SKILL.md) - Check links'
     ]),
     '.xdrs/_local/adrs/principles/skills/check-links/SKILL.md': fullSkillDocument({
-      inputsRequired: '- A file path that is way too long to fit under the ten word limit',
+      inputsRequired: '- A file path description that is way too long to fit under the twenty word limit because it keeps adding extra words',
     }),
   });
 
   const result = lintWorkspace(workspaceRoot);
 
-  expect(result.errors.join('\n')).toContain('Skill "### Inputs" -> "#### Required" bullet must be under 10 words');
+  expect(result.errors.join('\n')).toContain('Skill "### Inputs" -> "#### Required" bullet must be under 20 words');
 });
 
 test('passes SKILL.md when both optional sections are omitted', () => {
@@ -535,20 +535,20 @@ test('passes SKILL.md with a long free-form Runtime Requirements bullet', () =>
   expect(result.errors.join('\n')).not.toContain('### Runtime Requirements');
 });
 
-test('reports SKILL.md User Interaction bullet over 10 words', () => {
+test('reports SKILL.md User Interaction bullet over 20 words', () => {
   const workspaceRoot = createWorkspace('skill-user-interaction-bullet-too-long', {
     '.xdrs/index.md': rootIndex(),
     '.xdrs/_local/adrs/index.md': localAdrIndex([
       '- [check-links](principles/skills/check-links/SKILL.md) - Check links'
     ]),
     '.xdrs/_local/adrs/principles/skills/check-links/SKILL.md': fullSkillDocument({
-      userInteraction: '- A clarifying question that is much too long to fit under the ten word limit',
+      userInteraction: '- A clarifying question that is much too long to fit under the twenty word limit because it keeps adding extra words',
     }),
   });
 
   const result = lintWorkspace(workspaceRoot);
 
-  expect(result.errors.join('\n')).toContain('Skill "### User Interaction" bullet must be under 10 words');
+  expect(result.errors.join('\n')).toContain('Skill "### User Interaction" bullet must be under 20 words');
 });
 
 test('reports SKILL.md top-level sections out of template order', () => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "xdrs-core",
-  "version": "0.53.0",
+  "version": "0.53.1",
   "description": "XDRS (eXtensible Decision Record System): a framework to structure, compile and distribute Architectural (ADR), Business (BDR), and Engineering (EDR) decision records contents so that AI agents and humans can reliably find and use them with hierarchical scopes and controlled rollout in the format of distributable versioned packages.",
   "repository": {
     "type": "git",