Commit ceb8c47
authored
fix(skills): tighten strict-tier cite-only licensing in ADR standards (#1859)
# Pull Request
## Description
This PR tightened the strict-tier cite-only licensing posture of the ADR
standards so that the project's published architecture-decision guidance
no longer reproduces third-party copyrighted text. It resolved three
strict-tier audit findings on the main branch.
The IEEE 42010 reference in the *adr-author* standards excerpts was
reduced to a strict cite-only form. The bullet now carries the precise
designator *ISO/IEC/IEEE 42010:2022*, the official standard title, the
ISO catalog URL, and an explicit "cite only; do not quote" qualifier,
replacing the weaker prior phrasing.
The Y-Statement formula in *adr-standards.instructions.md* previously
reproduced the published six-slot sentence verbatim. It was replaced
with an original HVE rendering of the same six-slot structure, and the
attribution blockquote was corrected to credit Olaf Zimmermann and Uwe
Zdun for the concept while clarifying that the template wording is HVE's
own and not a reproduction of the published sentence.
The matching Y-Statement slot description in the *adr-author* standards
excerpts was reworded into the project's own phrasing so the skill
reference stays aligned with the instructions and retains the Zimmermann
and Zdun citation without echoing the source text.
## Related Issue(s)
Closes #1858
## Type of Change
**Code & Documentation:**
* [x] Documentation update
**AI Artifacts:**
* [x] Copilot instructions (`.github/instructions/*.instructions.md`)
* [x] Copilot skill (`.github/skills/*/SKILL.md`)
## Testing
Ran the relevant validation suite against the edited files: frontmatter
validation (560 files, 0 errors), skill structure validation (21 skills,
0 errors), collection metadata validation (13 collections, 0 errors),
and plugin validation (13 collections, 0 errors). The edited files
produced no markdown lint output; the only `lint:md` failures are
pre-existing and unrelated, in `evals/results/subagent-stimuli/`.
## Checklist
### Required Checks
* [x] Documentation is updated (if applicable)
* [x] Files follow existing naming conventions
* [x] Changes are backwards compatible (if applicable)
### Required Automated Checks
* [x] Frontmatter validation: `npm run lint:frontmatter`
* [x] Skill structure validation: `npm run validate:skills`
## Security Considerations
* [x] This PR does not contain any sensitive or NDA information
## Additional Notes
The plugin and extension copies of these instruction and skill files are
relative symlinks to the sources, so the edits propagate automatically
and require no regenerated output. Follow-on items identified during the
audit but out of scope here include reconciling the audit M-6 wording,
the separate BRD strict-tier remediation thread, and normalizing the
Nygard cite-only separator.1 parent 2ad24fd commit ceb8c47
5 files changed
Lines changed: 24 additions & 23 deletions
File tree
- .github
- instructions/project-planning
- skills/project-planning/adr-author
- references
- scripts/agents/activation-harness
Lines changed: 1 addition & 0 deletions
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
26 | 26 | | |
27 | 27 | | |
28 | 28 | | |
| 29 | + | |
29 | 30 | | |
30 | 31 | | |
31 | 32 | | |
| |||
Lines changed: 3 additions & 3 deletions
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
98 | 98 | | |
99 | 99 | | |
100 | 100 | | |
101 | | - | |
| 101 | + | |
102 | 102 | | |
103 | 103 | | |
104 | 104 | | |
105 | | - | |
| 105 | + | |
106 | 106 | | |
107 | 107 | | |
108 | 108 | | |
| |||
210 | 210 | | |
211 | 211 | | |
212 | 212 | | |
213 | | - | |
| 213 | + | |
214 | 214 | | |
215 | 215 | | |
216 | 216 | | |
| |||
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
37 | 37 | | |
38 | 38 | | |
39 | 39 | | |
40 | | - | |
| 40 | + | |
41 | 41 | | |
42 | 42 | | |
43 | 43 | | |
| |||
Lines changed: 2 additions & 2 deletions
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
26 | 26 | | |
27 | 27 | | |
28 | 28 | | |
29 | | - | |
| 29 | + | |
30 | 30 | | |
31 | 31 | | |
32 | 32 | | |
| |||
52 | 52 | | |
53 | 53 | | |
54 | 54 | | |
55 | | - | |
| 55 | + | |
56 | 56 | | |
57 | 57 | | |
58 | 58 | | |
| |||
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
2 | 2 | | |
3 | 3 | | |
4 | 4 | | |
5 | | - | |
| 5 | + | |
6 | 6 | | |
7 | 7 | | |
8 | 8 | | |
9 | 9 | | |
10 | 10 | | |
11 | 11 | | |
12 | 12 | | |
13 | | - | |
| 13 | + | |
14 | 14 | | |
15 | 15 | | |
16 | 16 | | |
17 | 17 | | |
18 | 18 | | |
19 | 19 | | |
20 | | - | |
| 20 | + | |
21 | 21 | | |
22 | 22 | | |
23 | 23 | | |
24 | 24 | | |
25 | | - | |
| 25 | + | |
26 | 26 | | |
27 | 27 | | |
28 | 28 | | |
| |||
38 | 38 | | |
39 | 39 | | |
40 | 40 | | |
41 | | - | |
| 41 | + | |
42 | 42 | | |
43 | 43 | | |
44 | 44 | | |
45 | | - | |
| 45 | + | |
46 | 46 | | |
47 | 47 | | |
48 | 48 | | |
49 | 49 | | |
50 | 50 | | |
51 | 51 | | |
52 | | - | |
| 52 | + | |
53 | 53 | | |
54 | 54 | | |
55 | 55 | | |
56 | 56 | | |
57 | | - | |
| 57 | + | |
58 | 58 | | |
59 | 59 | | |
60 | 60 | | |
| |||
70 | 70 | | |
71 | 71 | | |
72 | 72 | | |
73 | | - | |
| 73 | + | |
74 | 74 | | |
75 | 75 | | |
76 | 76 | | |
77 | | - | |
| 77 | + | |
78 | 78 | | |
79 | 79 | | |
80 | 80 | | |
81 | 81 | | |
82 | 82 | | |
83 | 83 | | |
84 | 84 | | |
85 | | - | |
| 85 | + | |
86 | 86 | | |
87 | 87 | | |
88 | | - | |
| 88 | + | |
89 | 89 | | |
90 | 90 | | |
91 | 91 | | |
92 | 92 | | |
93 | | - | |
| 93 | + | |
94 | 94 | | |
95 | 95 | | |
96 | 96 | | |
| |||
106 | 106 | | |
107 | 107 | | |
108 | 108 | | |
109 | | - | |
| 109 | + | |
110 | 110 | | |
111 | 111 | | |
112 | 112 | | |
113 | | - | |
| 113 | + | |
114 | 114 | | |
115 | 115 | | |
116 | 116 | | |
| |||
122 | 122 | | |
123 | 123 | | |
124 | 124 | | |
125 | | - | |
| 125 | + | |
126 | 126 | | |
127 | 127 | | |
128 | | - | |
| 128 | + | |
129 | 129 | | |
130 | 130 | | |
0 commit comments