xdrs-core 0.17.0 → 0.17.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.xdrs/_core/adrs/principles/skills/001-lint/001-lint.test.int.report +1 -1
- package/.xdrs/_core/adrs/principles/skills/002-write-xdr/002-write-xdr.test.int.report +1 -2
- package/.xdrs/_core/adrs/principles/skills/003-write-skill/003-write-skill.test.int.report +3 -2
- package/.xdrs/_core/adrs/principles/skills/003-write-skill/SKILL.md +2 -2
- package/.xdrs/_core/adrs/principles/skills/004-write-article/004-write-article.test.int.report +5 -1
- package/README.md +3 -3
- package/package.json +1 -2
|
@@ -3,12 +3,11 @@
|
|
|
3
3
|
"result": "success",
|
|
4
4
|
"contextFiles": [
|
|
5
5
|
".xdrs/_core/adrs/index.md",
|
|
6
|
-
".xdrs/_core/adrs/principles/001-xdrs-core.md",
|
|
7
6
|
".xdrs/_core/adrs/principles/002-xdr-standards.md",
|
|
8
7
|
".xdrs/_core/adrs/principles/skills/002-write-xdr/SKILL.md",
|
|
9
8
|
".xdrs/index.md",
|
|
10
9
|
"AGENTS.md"
|
|
11
10
|
],
|
|
12
|
-
"contextHash": "
|
|
11
|
+
"contextHash": "808c78ca2f4aeb670c7503766a37dc1a"
|
|
13
12
|
}
|
|
14
13
|
}
|
|
@@ -2,12 +2,13 @@
|
|
|
2
2
|
"Create a skill with instructions on how -a7079882": {
|
|
3
3
|
"result": "success",
|
|
4
4
|
"contextFiles": [
|
|
5
|
-
".xdrs/_core/adrs/
|
|
5
|
+
".xdrs/_core/adrs/index.md",
|
|
6
6
|
".xdrs/_core/adrs/principles/003-skill-standards.md",
|
|
7
7
|
".xdrs/_core/adrs/principles/skills/003-write-skill/SKILL.md",
|
|
8
|
+
".xdrs/_core/bdrs/index.md",
|
|
8
9
|
".xdrs/index.md",
|
|
9
10
|
"AGENTS.md"
|
|
10
11
|
],
|
|
11
|
-
"contextHash": "
|
|
12
|
+
"contextHash": "a9dd40b6bf1d4913cca7638a5b34820c"
|
|
12
13
|
}
|
|
13
14
|
}
|
|
@@ -116,10 +116,10 @@ If any check fails, revise before continuing.
|
|
|
116
116
|
### Phase 6: Write Files
|
|
117
117
|
|
|
118
118
|
1. Create the skill file at `.xdrs/[scope]/[type]/[subject]/skills/[number]-[skill-name]/SKILL.md`.
|
|
119
|
-
2. Create a
|
|
119
|
+
2. Create a symlink at `.github/skills/[number]-[skill-name]` so VS Code picks it up immediately:
|
|
120
120
|
```
|
|
121
121
|
mkdir -p .github/skills/[number]-[skill-name]
|
|
122
|
-
ln
|
|
122
|
+
ln -s ../../.xdrs/[scope]/[type]/[subject]/skills/[number]-[skill-name] .github/skills/[number]-[skill-name]
|
|
123
123
|
```
|
|
124
124
|
|
|
125
125
|
### Constraints
|
package/.xdrs/_core/adrs/principles/skills/004-write-article/004-write-article.test.int.report
CHANGED
|
@@ -5,12 +5,16 @@
|
|
|
5
5
|
".xdrs/_core/adrs/index.md",
|
|
6
6
|
".xdrs/_core/adrs/principles/001-xdrs-core.md",
|
|
7
7
|
".xdrs/_core/adrs/principles/002-xdr-standards.md",
|
|
8
|
+
".xdrs/_core/adrs/principles/003-skill-standards.md",
|
|
8
9
|
".xdrs/_core/adrs/principles/004-article-standards.md",
|
|
10
|
+
".xdrs/_core/adrs/principles/006-research-standards.md",
|
|
11
|
+
".xdrs/_core/adrs/principles/007-plan-standards.md",
|
|
12
|
+
".xdrs/_core/adrs/principles/008-xdr-standards-structured.md",
|
|
9
13
|
".xdrs/_core/adrs/principles/articles/001-xdrs-overview.md",
|
|
10
14
|
".xdrs/_core/adrs/principles/skills/004-write-article/SKILL.md",
|
|
11
15
|
".xdrs/index.md",
|
|
12
16
|
"AGENTS.md"
|
|
13
17
|
],
|
|
14
|
-
"contextHash": "
|
|
18
|
+
"contextHash": "3be2670eaae626887f9cd7ee8a8e5f6d"
|
|
15
19
|
}
|
|
16
20
|
}
|
package/README.md
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# xdr-standards
|
|
2
2
|
|
|
3
|
-
XDRs (eXtended Decision Records) is a standard for organizing Architectural (ADR), Business (BDR), and Engineering (EDR) decision records so that AI agents and humans can reliably find and follow them. Each XDR package bundles
|
|
3
|
+
XDRs (eXtended Decision Records) is a standard for organizing Architectural (ADR), Business (BDR), and Engineering (EDR) decision records so that AI agents and humans can reliably find and follow them. Each XDR package bundles five document types: Decision Records (the source of truth), Research (exploratory backing), Skills (step-by-step procedural guides), Articles (synthetic overviews), and Plans (ephemeral execution guidance).
|
|
4
4
|
|
|
5
5
|
> **Note:** This repository contains a minimum set of standards and very basic set of ADRs that describe the proposed decisions structure. It is intended to be used as a foundation that other projects can reference, extend, or install as a dependency in order to bootstrap and create their own XDRs.
|
|
6
6
|
|
|
@@ -66,7 +66,7 @@ The folder layout, file naming, and document format are designed so that AI agen
|
|
|
66
66
|
- Each XDR is a small, focused Markdown file (target under 1300 words), covering one decision.
|
|
67
67
|
- The canonical index per scope and type lists all XDRs with short descriptions, enabling agents to identify relevant records without reading every file.
|
|
68
68
|
- The root index at `.xdrs/index.md` provides a single entry point for discovery.
|
|
69
|
-
- XDR metadata gives agents a first-pass filter: check `
|
|
69
|
+
- XDR metadata gives agents a first-pass filter: check `valid-from` for the convergence date, then check `applied-to`, and finally the decision text itself to confirm the decision should be used in the current context. All documents present in the collection are considered active.
|
|
70
70
|
- Decisions cross-reference each other by XDR ID rather than duplicating content, keeping individual files concise.
|
|
71
71
|
- Subject folders reduce the search space when a query maps to a known domain.
|
|
72
72
|
|
|
@@ -166,7 +166,7 @@ The `lint` command reads `./.xdrs/**` from the given workspace path and checks c
|
|
|
166
166
|
- plan `Expected end date:` field presence and ISO date format
|
|
167
167
|
- canonical index presence and link consistency
|
|
168
168
|
- root index coverage for all discovered canonical indexes
|
|
169
|
-
- XDR metadata section placement and `
|
|
169
|
+
- XDR metadata section placement and `valid-from` / `applied-to` field format
|
|
170
170
|
- local markdown links between XDR documents, skills, articles, researches, and plans (excluding fenced code blocks)
|
|
171
171
|
- local image and `assets/` links resolving inside the sibling `assets/` folder for each document
|
|
172
172
|
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "xdrs-core",
|
|
3
|
-
"version": "0.17.
|
|
3
|
+
"version": "0.17.1",
|
|
4
4
|
"description": "A standard way to organize Decision Records (XDRs) across scopes, subjects, and teams so that AI agents can reliably query and follow them.",
|
|
5
5
|
"repository": {
|
|
6
6
|
"type": "git",
|
|
@@ -14,7 +14,6 @@
|
|
|
14
14
|
],
|
|
15
15
|
"license": "MIT",
|
|
16
16
|
"main": "lib/index.js",
|
|
17
|
-
"types": "lib/index.d.ts",
|
|
18
17
|
"exports": {
|
|
19
18
|
".": "./lib/index.js"
|
|
20
19
|
},
|