xdrs-core 0.2.14 → 0.2.15

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.
@@ -8,5 +8,5 @@ This index lists all ADRs for the general scope, organized by subject.
8
8
 
9
9
  Foundational standards, principles, and guidelines.
10
10
 
11
- - [_general-adr-001](principles/001-xdr-standards.md) - **XDR standards** (includes XDR template)
12
- - [_general-adr-003](principles/003-skill-standards.md) - **Skill standards**
11
+ - [_core-adr-001](principles/001-xdr-standards.md) - **XDR standards** (includes XDR template)
12
+ - [_core-adr-003](principles/003-skill-standards.md) - **Skill standards**
@@ -1,4 +1,4 @@
1
- # _general-adr-001: XDR standards
1
+ # _core-adr-001: XDR standards
2
2
 
3
3
  ## Context and Problem Statement
4
4
 
@@ -28,7 +28,7 @@ Provides clear ownership by scope, predictable navigation, and reusable decision
28
28
  - Always the following folder structure:
29
29
  `.xdrs/[scope]/[type]/[subject]/[number]-[short-title].md`
30
30
  - **Scopes:**
31
- - examples: `business-x`, `business-y`, `team-43`, `_general`
31
+ - examples: `business-x`, `business-y`, `team-43`, `_core`
32
32
  - `_local` is a reserved scope for XDRs created locally to a specific project or repository. XDRs in `_local` must not be shared with or propagated to other contexts. This scope must always be placed in the lowest position in `.xdrs/index.md` so that its decisions override or extend any decisions from all higher-positioned scopes.
33
33
  - **Types:** `adrs`, `bdrs`, `edrs`
34
34
  - there can exist sufixes to the standard scope names (e.g: `business-x-mobileapp`, `business-y-servicedesk`)
@@ -111,7 +111,7 @@ In the end, state explicitly the question that needs to be answered. E.g: "Which
111
111
  **Examples:**
112
112
  - `.xdrs/business-x/edrs/devops/003-required-development-workflow.md`
113
113
  - `.xdrs/business-x/adrs/governance/010-security-and-secrets-management.md`
114
- - `.xdrs/_general/adrs/devops/001-multi-repo.md`
114
+ - `.xdrs/_core/adrs/devops/001-multi-repo.md`
115
115
 
116
116
  **XDR ID Examples:**
117
117
  - `business-x-adr-001` (not `ADR-business-x-001` or `business-x-adr-1`)
@@ -1,4 +1,4 @@
1
- # _general-adr-003: Skill standards
1
+ # _core-adr-003: Skill standards
2
2
 
3
3
  ## Context and Problem Statement
4
4
 
@@ -39,7 +39,7 @@ Quick test:
39
39
  ```
40
40
 
41
41
  Examples:
42
- - `.xdrs/_general/adrs/principles/skills/001-code-review/SKILL.md`
42
+ - `.xdrs/_core/adrs/principles/skills/001-code-review/SKILL.md`
43
43
  - `.xdrs/business-x/edrs/devops/skills/001-ci-pipeline-debug/SKILL.md`
44
44
  - `.xdrs/_local/adrs/principles/skills/001-my-nice-skill/SKILL.md`
45
45
 
@@ -108,4 +108,4 @@ skills-ref validate .xdrs/[scope]/[type]/[subject]/skills/[number]-[skill-name]
108
108
  - [agentskills specification](https://agentskills.io/specification)
109
109
  - [agentskills/agentskills repository](https://github.com/agentskills/agentskills)
110
110
  - [skills-ref validation library](https://github.com/agentskills/agentskills/tree/main/skills-ref)
111
- - [_general-adr-001 - XDR standards](001-xdr-standards.md)
111
+ - [_core-adr-001 - XDR standards](001-xdr-standards.md)
@@ -105,6 +105,6 @@ produces structured findings report.
105
105
 
106
106
  ## References
107
107
 
108
- - [_general-adr-001 - XDR standards](../../001-xdr-standards.md)
109
- - [_general-adr-003 - Skill standards](../../003-skill-standards.md)
108
+ - [_core-adr-001 - XDR standards](../../001-xdr-standards.md)
109
+ - [_core-adr-003 - Skill standards](../../003-skill-standards.md)
110
110
 
@@ -6,5 +6,5 @@ General engineering decisions covering cross-business standards and practices. A
6
6
 
7
7
  Foundational standards, principles, and guidelines.
8
8
 
9
- - [_general-edr-001](principles/001-coding-agent-behavior.md) - **AI coding agent behavior**
9
+ - [_core-edr-001](principles/001-coding-agent-behavior.md) - **AI coding agent behavior**
10
10
 
@@ -1,4 +1,4 @@
1
- # _general-edr-001: AI coding agent behavior
1
+ # _core-edr-001: AI coding agent behavior
2
2
 
3
3
  ## Context and Problem Statement
4
4
 
@@ -17,7 +17,7 @@ Clear behavior standards ensure consistency through EDR compliance, maintain cod
17
17
  **Mandatory behaviors for AI coding agents:**
18
18
 
19
19
  1. **Always consult XDRs before making implementation decisions**
20
- - Follow coding agent behavior and decision hierarchy rules in [.xdrs/_general/edrs/principles/001-coding-agent-behavior.md](.xdrs/_general/edrs/principles/001-coding-agent-behavior.md)
20
+ - Follow coding agent behavior and decision hierarchy rules in [.xdrs/_core/edrs/principles/001-coding-agent-behavior.md](.xdrs/_core/edrs/principles/001-coding-agent-behavior.md)
21
21
  - Search for XDRs in [.xdrs/index.md](.xdrs/index.md) during design, plan and implementation steps
22
22
  - Follow XDRs as the source of truth for all decisions and procedures
23
23
 
package/.xdrs/index.md CHANGED
@@ -6,24 +6,19 @@ This index points to all type- and scope-specific XDR indexes. XDRs (Decision Re
6
6
 
7
7
  XDRs in scopes listed last override the ones listed first
8
8
 
9
- ### ADRs - general
9
+ ### _core
10
10
 
11
- General architectural decisions covering cross-business standards and practices.
11
+ Decisions about how XDRs work
12
+ [View general ADRs Index](_core/adrs/index.md)
12
13
 
13
- [View general ADRs Index](_general/adrs/index.md)
14
-
15
- ### EDRs - general
16
-
17
- General engineering decisions covering cross-business standards and practices.
18
-
19
- [View general EDRs Index](_general/edrs/index.md)
14
+ Decisions about how XDRs work
15
+ [View general EDRs Index](_core/edrs/index.md)
20
16
 
21
17
  ---
22
18
 
23
- ### EDRs - agentkit
19
+ ### agentkit
24
20
 
25
21
  General engineering decisions from agentkit scope
26
-
27
22
  [View agentkit EDRs Index](agentkit/edrs/index.md)
28
23
 
29
24
  ---
package/AGENTS.md CHANGED
@@ -3,9 +3,9 @@
3
3
  **Purpose:** This file is intentionally brief. All project decisions and working instructions are captured as XDRs.
4
4
 
5
5
  1. **Always consult XDRs before making implementation decisions**
6
- - Follow coding agent behavior and decision hierarchy rules in [.xdrs/_general/edrs/principles/001-coding-agent-behavior.md](.xdrs/_general/edrs/principles/001-coding-agent-behavior.md)
7
- - Search for XDRs in [.xdrs/index.md](.xdrs/index.md) during design, plan and implementation steps
8
- - Follow XDRs as the source of truth for all decisions and procedures
6
+ - You MUST follow coding agent behavior and decision hierarchy rules in [.xdrs/_core/edrs/principles/001-coding-agent-behavior.md](.xdrs/_core/edrs/principles/001-coding-agent-behavior.md)
7
+ - You MUST search and follow XDRs in [.xdrs/index.md](.xdrs/index.md) during design, plan, implementation, test and review steps
8
+ - You MUST follow XDRs as the source of truth for all decisions and procedures
9
9
 
10
10
  2. **Verify all work with build, tests and linting before completion**
11
11
  - Always run `make build`, `make lint-fix` and `make test` at the end of the implementation
package/README.md CHANGED
@@ -28,7 +28,7 @@ This project defines a standard for organizing XDRs that satisfies the following
28
28
 
29
29
  ### Multi-scope support
30
30
 
31
- Different teams at different organizational levels make decisions that apply to different audiences. XDRs are organized by scope (e.g. `_general`, `business-x`, `business-y-mobileapp`) so that each team owns its own decision space. Scopes can extend or override decisions from broader scopes, with explicit precedence rules: scopes listed later in an index override those listed earlier.
31
+ Different teams at different organizational levels make decisions that apply to different audiences. XDRs are organized by scope (e.g. `_core`, `business-x`, `business-y-mobileapp`) so that each team owns its own decision space. Scopes can extend or override decisions from broader scopes, with explicit precedence rules: scopes listed later in an index override those listed earlier.
32
32
 
33
33
  ### Subject grouping
34
34
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "xdrs-core",
3
- "version": "0.2.14",
3
+ "version": "0.2.15",
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",
@@ -20,7 +20,7 @@
20
20
  "bin/npmdata.js"
21
21
  ],
22
22
  "dependencies": {
23
- "npmdata": "^0.13.4"
23
+ "npmdata": "^0.14.0"
24
24
  },
25
25
  "npmdata": {
26
26
  "sets": [