xdrs-core 0.28.4 → 0.30.0

package/.filedist-package.yml

@@ -11,9 +11,9 @@ sets:
       path: .
       symlinks:
         - source: .xdrs/**/skills/001-review
-          target: .github/skills
+          target: .agents/skills
         - source: .xdrs/**/skills/008-write-xdrs-doc
-          target: .github/skills
+          target: .agents/skills
       gitignore: false
 
   - selector:

package/.xdrs/_core/adrs/index.md

@@ -20,14 +20,14 @@ Foundational standards, principles, and guidelines.
 
 Step-by-step procedural guides for humans and AI agents.
 
-- [_core-adr-skill-001-review](principles/skills/001-review/SKILL.md) - **Review** — review code and files against Policies
-- [_core-adr-skill-002-write-policy](principles/skills/002-write-policy/SKILL.md) - **Write Policy** — create a new Policy document
-- [_core-adr-skill-003-write-skill](principles/skills/003-write-skill/SKILL.md) - **Write Skill** — create a new skill package
-- [_core-adr-skill-004-write-article](principles/skills/004-write-article/SKILL.md) - **Write Article** — create a new article document
-- [_core-adr-skill-005-write-research](principles/skills/005-write-research/SKILL.md) - **Write Research** — create a new research document
-- [_core-adr-skill-006-write-plan](principles/skills/006-write-plan/SKILL.md) - **Write Plan** — create a new plan document
-- [_core-adr-skill-007-write-presentation](principles/skills/007-write-presentation/SKILL.md) - **Write Presentation** — create Marp slide presentations for XDRS documents
-- [_core-adr-skill-008-write-xdrs-doc](principles/skills/008-write-xdrs-doc/SKILL.md) - **Write XDRS Doc** — router skill; infers document type and delegates to the appropriate authoring skill
+- [001-review](principles/skills/001-review/SKILL.md) - **Review** — review code and files against Policies
+- [002-write-policy](principles/skills/002-write-policy/SKILL.md) - **Write Policy** — create a new Policy document
+- [003-write-skill](principles/skills/003-write-skill/SKILL.md) - **Write Skill** — create a new skill package
+- [004-write-article](principles/skills/004-write-article/SKILL.md) - **Write Article** — create a new article document
+- [005-write-research](principles/skills/005-write-research/SKILL.md) - **Write Research** — create a new research document
+- [006-write-plan](principles/skills/006-write-plan/SKILL.md) - **Write Plan** — create a new plan document
+- [007-write-presentation](principles/skills/007-write-presentation/SKILL.md) - **Write Presentation** — create Marp slide presentations for XDRS documents
+- [008-write-xdrs-doc](principles/skills/008-write-xdrs-doc/SKILL.md) - **Write XDRS Doc** — router skill; infers document type and delegates to the appropriate authoring skill
 
 ## Articles
 

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

@@ -83,7 +83,7 @@ Examples:
 
 ```
 ---
-name: [scope]-[type]-skill-[number]-[skill-name]      # required: full identifier including scope and type; max 64 chars
+name: [number]-[skill-name]              # required: matches the folder name exactly; max 64 chars
 description: >            # required: what the skill does AND when to activate it; max 1024 chars
   Concise explanation of the skill and the situations in which an agent should load it.
 license: <license>        # optional
@@ -112,8 +112,8 @@ Known gotchas and how to handle them.
 ```
 
 Rules:
-- The `name` field MUST use the format `[scope]-[type]-skill-[number]-[skill-name]` (e.g., `_core-adr-skill-001-code-review`). This aligns skill identifiers with the Policy document identifier format, making every XDRS element consistently identifiable by scope and type.
-- The directory name MUST follow the format `[number]-[skill-name]` (e.g., `001-code-review`), which keeps the filesystem hierarchy simple while the `name:` field carries the full identifier.
+- The `name` field MUST match the folder name exactly (e.g., `001-code-review`). This keeps skill identifiers simple and aligned with the filesystem hierarchy.
+- The directory name MUST follow the format `[number]-[skill-name]` (e.g., `001-code-review`), matching the `name:` field.
 - `## Overview` SHOULD state the task objective, expected outcome, and relevant prerequisites or tools when they matter.
 - `## Instructions` SHOULD include verification steps or acceptance criteria at the end of the task, or at the end of major phases when partial validation matters.
 - For simple structure, flow, layout, or relationship indications, `SKILL.md` SHOULD prefer plain Markdown, tables, or ASCII art instead of external assets.

package/.xdrs/_core/adrs/principles/skills/001-review/SKILL.md

@@ -1,8 +1,9 @@
 ---
-name: _core-adr-skill-001-review
+name: 001-review
 description: >
-  Reviews code changes or files against applicable Policies and reports violations as structured findings. 
-  Activate this skill when the user asks to review, lint, or audit code or Policies, or when you identify a need to check compliance with Policies during implementation.
+   Reviews code changes, xdrs docs or any other files against applicable Policies and reports violations as structured findings.
+   Activate this skill when the user asks to review, lint, audit, check, verify, validate, or assess any files or Policies, or when checking whether a document or implementation is consistent with, compliant with, or conforms to a standard or Policy.
+   Also activate when you identify a need to check compliance with Policies during implementation.
 metadata:
   author: flaviostutz
   version: "1.0"

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

@@ -1,5 +1,5 @@
 ---
-name: _core-adr-skill-002-write-policy
+name: 002-write-policy
 description: >
   Creates a new Policy interactively: selects type, scope, subject, and writes a focused, conflict-checked policy document.
   Activate this skill when the user asks to create, add, or write a new Policy (ADR, BDR, or EDR).

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

@@ -1,5 +1,5 @@
 ---
-name: _core-adr-skill-003-write-skill
+name: 003-write-skill
 description: >
   Creates a new skill package following XDRS skill standards: determines type, scope, subject, and number;
   then writes a focused SKILL.md with correct frontmatter, phased instructions, examples, and edge cases.
@@ -45,7 +45,7 @@ Quick test:
 
 **Skill number** — scan `.xdrs/[scope]/[type]/[subject]/skills/` for the highest existing number and increment by 1. Never reuse numbers from deleted skills.
 
-**Skill name** — `[scope]-[type]-skill-[number]-[short-kebab-case-description]`, max 64 characters total. The directory name is `[number]-[short-kebab-case-description]`.
+**Skill name** — `[number]-[short-kebab-case-description]`, max 64 characters total. The directory name matches the `name` field exactly.
 
 ### Phase 3: Research Existing Skills and Related Policies
 
@@ -60,7 +60,7 @@ Use the mandatory agentskills format:
 
 ```
 ---
-name: [scope]-[type]-skill-[number]-[skill-name]
+name: [number]-[skill-name]
 description: >
   [What the skill does AND exactly when an agent should activate it. Max 1024 chars.]
 metadata:
@@ -118,10 +118,10 @@ If any check fails, revise before continuing.
 ### Phase 6: Write Files
 
 1. Create the skill file at `.xdrs/[scope]/[type]/[subject]/skills/[number]-[skill-name]/SKILL.md`.
-2. Create a symlink at `.github/skills/[number]-[skill-name]` so VS Code picks it up immediately:
+2. Create a symlink at `.agents/skills/[number]-[skill-name]` so VS Code picks it up immediately:
    ```
-   mkdir -p .github/skills
-   ln -s ../../.xdrs/[scope]/[type]/[subject]/skills/[number]-[skill-name] .github/skills/[number]-[skill-name]
+   mkdir -p .agents/skills
+   ln -s ../../.xdrs/[scope]/[type]/[subject]/skills/[number]-[skill-name] .agents/skills/[number]-[skill-name]
    ```
 3. Evaluate whether the scope index at `.xdrs/[scope]/index.md` should be updated to reflect the new skill. If the scope index does not exist, create it following article standards and the scope index rules in `_core-adr-policy-001`.
 

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

@@ -1,5 +1,5 @@
 ---
-name: _core-adr-skill-004-write-article
+name: 004-write-article
 description: >
    Creates a new article document following XDRS article standards: selects scope, type, subject, and number; then writes a focused synthetic text that combines and links multiple Policies, Research documents, and Skills around a topic. Activate this skill when the user asks to create, add, or write a new article, guide, or overview document within an XDRS project.
 metadata:

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

@@ -1,5 +1,5 @@
 ---
-name: _core-adr-skill-005-write-research
+name: 005-write-research
 description: >
   Creates a new research document following XDRS research standards: selects scope, type, subject, and number;
   then writes an IMRAD-based study with enough evidence and method detail to stand on its own as a technical paper.

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

@@ -1,5 +1,5 @@
 ---
-name: _core-adr-skill-006-write-plan
+name: 006-write-plan
 description: >
   Creates a new plan document following XDRS plan standards: selects scope, type, subject, and number;
   then writes a focused execution plan with problem context, proposed solution, approach, milestones, and deliverables.

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

@@ -1,5 +1,5 @@
 ---
-name: _core-adr-skill-007-write-presentation
+name: 007-write-presentation
 description: >
   Creates a Marp slide presentation for an existing XDRS document (policy, research, article, or plan).
   Activate this skill when the user asks to create slides, a presentation, or a slide deck for an XDRS document.

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

@@ -1,5 +1,5 @@
 ---
-name: _core-adr-skill-008-write-xdrs-doc
+name: 008-write-xdrs-doc
 description: >
   Use when writing documents such as decisions, policies, skills, procedures, research, plans, articles, or presentations.
   Activate this skill when the user asks to create or write any XDRS element.

package/.xdrs/_core/index.md

@@ -39,13 +39,13 @@ Slide presentations that support XDRS documents follow [_core-adr-policy-009](ad
 
 The `_core` scope ships with seven skills that automate the most common framework operations:
 
-- **_core-adr-skill-001-review** reviews code and files against applicable Policies
-- **_core-adr-skill-002-write-policy** guides creation of a new Policy document
-- **_core-adr-skill-003-write-skill** guides creation of a new skill package
-- **_core-adr-skill-004-write-article** guides creation of a new article
-- **_core-adr-skill-005-write-research** guides creation of a new research document
-- **_core-adr-skill-006-write-plan** guides creation of a new execution plan
-- **_core-adr-skill-007-write-presentation** guides creation of Marp slide presentations
+- **001-review** reviews code and files against applicable Policies
+- **002-write-policy** guides creation of a new Policy document
+- **003-write-skill** guides creation of a new skill package
+- **004-write-article** guides creation of a new article
+- **005-write-research** guides creation of a new research document
+- **006-write-plan** guides creation of a new execution plan
+- **007-write-presentation** guides creation of Marp slide presentations
 
 ### Getting started
 

package/lib/lint.js

@@ -474,8 +474,7 @@ function lintSkillsDirectory(xdrsRoot, scopeName, typeName, subjectName, skillsP
       if (!skillFm.name) {
         errors.push(`SKILL.md frontmatter must include a non-empty name field: ${toDisplayPath(skillFilePath)}`);
       } else {
-        const typeId = TYPE_TO_ID[typeName].split('-')[0]; // 'adr', 'bdr', or 'edr'
-        const expectedSkillName = `${scopeName}-${typeId}-skill-${number}-${match[2]}`;
+        const expectedSkillName = `${number}-${match[2]}`;
         if (skillFm.name !== expectedSkillName) {
           errors.push(`Skill frontmatter name must be "${expectedSkillName}": ${toDisplayPath(skillFilePath)}`);
         }

package/lib/lint.test.js

@@ -304,7 +304,7 @@ test('reports unknown frontmatter fields in SKILL.md files', () => {
     ]),
     '.xdrs/_local/adrs/principles/skills/001-check-links/SKILL.md': [
       '---',
-      'name: _local-adr-skill-001-check-links',
+      'name: 001-check-links',
       'description: Test skill document',
       'unknown-field: some value',
       '---',
@@ -333,7 +333,7 @@ test('accepts all known frontmatter fields in SKILL.md files', () => {
     ]),
     '.xdrs/_local/adrs/principles/skills/001-check-links/SKILL.md': [
       '---',
-      'name: _local-adr-skill-001-check-links',
+      'name: 001-check-links',
       'description: Test skill document',
       'license: MIT',
       'metadata:',
@@ -491,7 +491,7 @@ test('allows child directory relative non-asset links in XDRS element documents'
   });
   const skillDir = path.join(workspaceRoot, '.xdrs/_local/adrs/principles/skills/001-review');
   fs.mkdirSync(skillDir, { recursive: true });
-  fs.writeFileSync(path.join(skillDir, 'SKILL.md'), '---\nname: _local-adr-skill-001-review\ndescription: test skill\n---\n# Skill');
+  fs.writeFileSync(path.join(skillDir, 'SKILL.md'), '---\nname: 001-review\ndescription: test skill\n---\n# Skill');
 
   const result = lintWorkspace(workspaceRoot);
 
@@ -857,7 +857,7 @@ function xdrDocument(body) {
 function skillDocument(body) {
   return [
     '---',
-    'name: _local-adr-skill-001-check-links',
+    'name: 001-check-links',
     'description: Test skill document',
     '---',
     '',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "xdrs-core",
-  "version": "0.28.4",
+  "version": "0.30.0",
   "description": "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",
@@ -30,7 +30,7 @@
     "jest": "^29.7.0"
   },
   "dependencies": {
-    "filedist": "^0.35.0",
+    "filedist": "^0.35.2",
     "ignore": "^7.0.5",
     "minimatch": "^10.2.5"
   },