xdrs-core 0.2.13 → 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.
- package/.xdrs/{_general → _core}/adrs/index.md +2 -2
- package/.xdrs/{_general → _core}/adrs/principles/001-xdr-standards.md +3 -3
- package/.xdrs/{_general → _core}/adrs/principles/003-skill-standards.md +3 -3
- package/.xdrs/{_general → _core}/adrs/principles/skills/001-xdr-lint/SKILL.md +2 -2
- package/.xdrs/{_general → _core}/edrs/index.md +1 -1
- package/.xdrs/{_general → _core}/edrs/principles/001-coding-agent-behavior.md +2 -2
- package/.xdrs/index.md +6 -11
- package/AGENTS.md +3 -3
- package/README.md +1 -1
- package/package.json +2 -2
|
@@ -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
|
-
- [
|
|
12
|
-
- [
|
|
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
|
-
#
|
|
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`, `
|
|
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/
|
|
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
|
-
#
|
|
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/
|
|
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
|
-
- [
|
|
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
|
-
- [
|
|
109
|
-
- [
|
|
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
|
-
- [
|
|
9
|
+
- [_core-edr-001](principles/001-coding-agent-behavior.md) - **AI coding agent behavior**
|
|
10
10
|
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
#
|
|
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/
|
|
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
|
-
###
|
|
9
|
+
### _core
|
|
10
10
|
|
|
11
|
-
|
|
11
|
+
Decisions about how XDRs work
|
|
12
|
+
[View general ADRs Index](_core/adrs/index.md)
|
|
12
13
|
|
|
13
|
-
|
|
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
|
-
###
|
|
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
|
-
-
|
|
7
|
-
-
|
|
8
|
-
-
|
|
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. `
|
|
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.
|
|
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.
|
|
23
|
+
"npmdata": "^0.14.0"
|
|
24
24
|
},
|
|
25
25
|
"npmdata": {
|
|
26
26
|
"sets": [
|