@rvdbreemen/adr-kit-opencode 0.52.0 → 0.53.0
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/.claude-plugin/plugin.json +29 -29
- package/README.md +865 -850
- package/bin/adr +0 -0
- package/bin/adr-audit +0 -0
- package/bin/adr-context +0 -0
- package/bin/adr-discover +0 -0
- package/bin/adr-doctor +0 -0
- package/bin/adr-generate-scripts +0 -0
- package/bin/adr-grill-signal +0 -0
- package/bin/adr-guardian +0 -0
- package/bin/adr-index +0 -0
- package/bin/adr-judge +0 -0
- package/bin/adr-judge-precommit +0 -0
- package/bin/adr-lint +0 -0
- package/bin/adr-mcp +96 -4
- package/bin/adr-migrate +0 -0
- package/bin/adr-quality +0 -0
- package/bin/adr-readiness +0 -0
- package/bin/adr-readiness-ci +0 -0
- package/bin/adr-related +0 -0
- package/bin/adr-renumber +254 -254
- package/bin/adr-retire +0 -0
- package/bin/adr-settings +0 -0
- package/bin/adr-status +0 -0
- package/bin/adr-suggest +0 -0
- package/bin/adr-watch +0 -0
- package/bin/adr_doctor_probes.py +2 -0
- package/bin/bump-version +0 -0
- package/clients/workflows.json +229 -229
- package/hooks/__init__.py +1 -1
- package/hooks/adapters/__init__.py +13 -13
- package/hooks/adapters/claude.py +27 -27
- package/hooks/adapters/codex.py +26 -26
- package/hooks/adapters/copilot.py +11 -11
- package/hooks/adr-hook.py +128 -128
- package/hooks/adr_hook_core.py +843 -843
- package/hooks/adr_pr_guard.py +367 -367
- package/instructions/ADR-guide.md +101 -48
- package/instructions/adr.coding.md +82 -82
- package/instructions/adr.review.md +182 -182
- package/opencode/plugin.ts +1 -4
- package/package.json +5 -2
- package/schemas/adr-context-probes.schema.json +56 -56
- package/schemas/adr-enforcement.schema.json +57 -57
- package/schemas/adr-frontmatter.schema.json +144 -144
- package/schemas/adr-index.schema.json +276 -276
- package/schemas/adr-kit-config.schema.json +371 -371
- package/schemas/adr-readiness.schema.json +41 -41
- package/schemas/client-capabilities.schema.json +503 -503
- package/schemas/client-certification.schema.json +101 -101
- package/schemas/doctor-output.schema.json +92 -92
- package/skills/adr/SKILL.md +780 -780
- package/skills/audit/SKILL.md +103 -103
- package/skills/context/SKILL.md +77 -77
- package/skills/grill/SKILL.md +84 -84
- package/skills/grill/agents/openai.yaml +4 -4
- package/skills/guardian/SKILL.md +316 -316
- package/skills/init/SKILL.md +499 -499
- package/skills/install-hooks/SKILL.md +154 -154
- package/skills/judge/SKILL.md +168 -168
- package/skills/lint/SKILL.md +321 -321
- package/skills/migrate/SKILL.md +313 -313
- package/skills/related/SKILL.md +62 -62
- package/skills/retire/SKILL.md +41 -41
- package/skills/review/SKILL.md +167 -167
- package/skills/settings/SKILL.md +73 -73
- package/skills/setup/SKILL.md +128 -128
- package/skills/supersede/SKILL.md +136 -136
- package/skills/upgrade/SKILL.md +273 -273
- package/templates/adr-kit-guide.md +354 -354
- package/templates/adr-template.canonical.md +115 -115
- package/templates/adr-template.madr.md +131 -131
- package/templates/adr-template.md +131 -131
- package/templates/adr-template.nygard.md +111 -111
- package/templates/cc-settings/guardian-hook-entry.json +9 -9
- package/templates/githooks/pre-commit +1 -1
- package/templates/github-workflows/adr-audit.yml +58 -58
- package/templates/github-workflows/adr-guardian-audit.yml +133 -133
- package/templates/github-workflows/adr-index-check.yml +30 -30
- package/templates/github-workflows/adr-judge.yml +31 -31
- package/templates/github-workflows/adr-readiness.yml +18 -18
- package/templates/validate_adr_template.py +38 -38
- package/templates/validate_adr_template.sh +74 -74
|
@@ -1,115 +1,115 @@
|
|
|
1
|
-
---
|
|
2
|
-
id: "ADR-NNN"
|
|
3
|
-
title: "Short Imperative Title"
|
|
4
|
-
status: "Proposed"
|
|
5
|
-
date: "YYYY-MM-DD"
|
|
6
|
-
binding: false
|
|
7
|
-
gate: null
|
|
8
|
-
documents_shipped: false
|
|
9
|
-
verified_in: []
|
|
10
|
-
supersedes: []
|
|
11
|
-
superseded_by: null
|
|
12
|
-
format: "canonical"
|
|
13
|
-
topics: []
|
|
14
|
-
aliases: []
|
|
15
|
-
components: []
|
|
16
|
-
symbols: []
|
|
17
|
-
context_scope: "selective"
|
|
18
|
-
---
|
|
19
|
-
|
|
20
|
-
<!-- markdownlint-disable MD025 -->
|
|
21
|
-
|
|
22
|
-
# ADR-NNN Short Imperative Title
|
|
23
|
-
|
|
24
|
-
## Status
|
|
25
|
-
|
|
26
|
-
Proposed, YYYY-MM-DD.
|
|
27
|
-
|
|
28
|
-
## Status History
|
|
29
|
-
|
|
30
|
-
```yaml
|
|
31
|
-
status_history:
|
|
32
|
-
- date: YYYY-MM-DD
|
|
33
|
-
status: Proposed
|
|
34
|
-
changed_by: user@example.com
|
|
35
|
-
reason: Initial proposal
|
|
36
|
-
changed_via: adr-kit
|
|
37
|
-
```
|
|
38
|
-
|
|
39
|
-
## Context
|
|
40
|
-
|
|
41
|
-
State the problem, constraints, and concrete evidence.
|
|
42
|
-
|
|
43
|
-
## Decision
|
|
44
|
-
|
|
45
|
-
State one concrete chosen approach and its rationale.
|
|
46
|
-
|
|
47
|
-
## Decision Contract
|
|
48
|
-
|
|
49
|
-
### Must
|
|
50
|
-
|
|
51
|
-
- State required implementation constraints.
|
|
52
|
-
|
|
53
|
-
### Must Not
|
|
54
|
-
|
|
55
|
-
- State prohibited implementation choices.
|
|
56
|
-
|
|
57
|
-
### Exceptions
|
|
58
|
-
|
|
59
|
-
- State explicit exceptions, or `None`.
|
|
60
|
-
|
|
61
|
-
### Verification
|
|
62
|
-
|
|
63
|
-
- Name the test, command, or source anchor that verifies this decision.
|
|
64
|
-
|
|
65
|
-
## Alternatives Considered
|
|
66
|
-
|
|
67
|
-
- **Alternative A.** Rejection reason.
|
|
68
|
-
- **Alternative B.** Rejection reason.
|
|
69
|
-
|
|
70
|
-
## Consequences
|
|
71
|
-
|
|
72
|
-
**Positive:**
|
|
73
|
-
|
|
74
|
-
- Expected benefit.
|
|
75
|
-
|
|
76
|
-
**Negative:**
|
|
77
|
-
|
|
78
|
-
- Accepted cost or risk and its mitigation.
|
|
79
|
-
|
|
80
|
-
## Open Questions
|
|
81
|
-
|
|
82
|
-
List unresolved human decisions as unchecked tasks. Accepted ADRs must have no
|
|
83
|
-
unresolved items.
|
|
84
|
-
|
|
85
|
-
Answer them with `bin/adr answer`, which rewrites an item as
|
|
86
|
-
`- [x] <question> — **Answered <date> by <signer>:** <answer>`. A checked item
|
|
87
|
-
is resolved, so it no longer blocks acceptance and stays in the record. Do not
|
|
88
|
-
delete an answered question: the reasoning is what a future reader needs in
|
|
89
|
-
order to re-evaluate the decision.
|
|
90
|
-
|
|
91
|
-
## Related Decisions
|
|
92
|
-
|
|
93
|
-
- None.
|
|
94
|
-
|
|
95
|
-
## References
|
|
96
|
-
|
|
97
|
-
- Add at least one verifiable local or external reference.
|
|
98
|
-
|
|
99
|
-
## Enforcement
|
|
100
|
-
|
|
101
|
-
Delete this optional section when the decision has no machine-checkable surface.
|
|
102
|
-
|
|
103
|
-
```json
|
|
104
|
-
{
|
|
105
|
-
"forbid_pattern": [
|
|
106
|
-
{
|
|
107
|
-
"pattern": "\\bForbiddenSymbol\\b",
|
|
108
|
-
"path_glob": "src/**/*.py",
|
|
109
|
-
"message": "Use AllowedSymbol instead."
|
|
110
|
-
}
|
|
111
|
-
],
|
|
112
|
-
"forbid_import": [],
|
|
113
|
-
"require_pattern": []
|
|
114
|
-
}
|
|
115
|
-
```
|
|
1
|
+
---
|
|
2
|
+
id: "ADR-NNN"
|
|
3
|
+
title: "Short Imperative Title"
|
|
4
|
+
status: "Proposed"
|
|
5
|
+
date: "YYYY-MM-DD"
|
|
6
|
+
binding: false
|
|
7
|
+
gate: null
|
|
8
|
+
documents_shipped: false
|
|
9
|
+
verified_in: []
|
|
10
|
+
supersedes: []
|
|
11
|
+
superseded_by: null
|
|
12
|
+
format: "canonical"
|
|
13
|
+
topics: []
|
|
14
|
+
aliases: []
|
|
15
|
+
components: []
|
|
16
|
+
symbols: []
|
|
17
|
+
context_scope: "selective"
|
|
18
|
+
---
|
|
19
|
+
|
|
20
|
+
<!-- markdownlint-disable MD025 -->
|
|
21
|
+
|
|
22
|
+
# ADR-NNN Short Imperative Title
|
|
23
|
+
|
|
24
|
+
## Status
|
|
25
|
+
|
|
26
|
+
Proposed, YYYY-MM-DD.
|
|
27
|
+
|
|
28
|
+
## Status History
|
|
29
|
+
|
|
30
|
+
```yaml
|
|
31
|
+
status_history:
|
|
32
|
+
- date: YYYY-MM-DD
|
|
33
|
+
status: Proposed
|
|
34
|
+
changed_by: user@example.com
|
|
35
|
+
reason: Initial proposal
|
|
36
|
+
changed_via: adr-kit
|
|
37
|
+
```
|
|
38
|
+
|
|
39
|
+
## Context
|
|
40
|
+
|
|
41
|
+
State the problem, constraints, and concrete evidence.
|
|
42
|
+
|
|
43
|
+
## Decision
|
|
44
|
+
|
|
45
|
+
State one concrete chosen approach and its rationale.
|
|
46
|
+
|
|
47
|
+
## Decision Contract
|
|
48
|
+
|
|
49
|
+
### Must
|
|
50
|
+
|
|
51
|
+
- State required implementation constraints.
|
|
52
|
+
|
|
53
|
+
### Must Not
|
|
54
|
+
|
|
55
|
+
- State prohibited implementation choices.
|
|
56
|
+
|
|
57
|
+
### Exceptions
|
|
58
|
+
|
|
59
|
+
- State explicit exceptions, or `None`.
|
|
60
|
+
|
|
61
|
+
### Verification
|
|
62
|
+
|
|
63
|
+
- Name the test, command, or source anchor that verifies this decision.
|
|
64
|
+
|
|
65
|
+
## Alternatives Considered
|
|
66
|
+
|
|
67
|
+
- **Alternative A.** Rejection reason.
|
|
68
|
+
- **Alternative B.** Rejection reason.
|
|
69
|
+
|
|
70
|
+
## Consequences
|
|
71
|
+
|
|
72
|
+
**Positive:**
|
|
73
|
+
|
|
74
|
+
- Expected benefit.
|
|
75
|
+
|
|
76
|
+
**Negative:**
|
|
77
|
+
|
|
78
|
+
- Accepted cost or risk and its mitigation.
|
|
79
|
+
|
|
80
|
+
## Open Questions
|
|
81
|
+
|
|
82
|
+
List unresolved human decisions as unchecked tasks. Accepted ADRs must have no
|
|
83
|
+
unresolved items.
|
|
84
|
+
|
|
85
|
+
Answer them with `bin/adr answer`, which rewrites an item as
|
|
86
|
+
`- [x] <question> — **Answered <date> by <signer>:** <answer>`. A checked item
|
|
87
|
+
is resolved, so it no longer blocks acceptance and stays in the record. Do not
|
|
88
|
+
delete an answered question: the reasoning is what a future reader needs in
|
|
89
|
+
order to re-evaluate the decision.
|
|
90
|
+
|
|
91
|
+
## Related Decisions
|
|
92
|
+
|
|
93
|
+
- None.
|
|
94
|
+
|
|
95
|
+
## References
|
|
96
|
+
|
|
97
|
+
- Add at least one verifiable local or external reference.
|
|
98
|
+
|
|
99
|
+
## Enforcement
|
|
100
|
+
|
|
101
|
+
Delete this optional section when the decision has no machine-checkable surface.
|
|
102
|
+
|
|
103
|
+
```json
|
|
104
|
+
{
|
|
105
|
+
"forbid_pattern": [
|
|
106
|
+
{
|
|
107
|
+
"pattern": "\\bForbiddenSymbol\\b",
|
|
108
|
+
"path_glob": "src/**/*.py",
|
|
109
|
+
"message": "Use AllowedSymbol instead."
|
|
110
|
+
}
|
|
111
|
+
],
|
|
112
|
+
"forbid_import": [],
|
|
113
|
+
"require_pattern": []
|
|
114
|
+
}
|
|
115
|
+
```
|
|
@@ -1,131 +1,131 @@
|
|
|
1
|
-
---
|
|
2
|
-
id: "ADR-NNN"
|
|
3
|
-
title: "Short Imperative Title"
|
|
4
|
-
status: "Proposed"
|
|
5
|
-
date: "YYYY-MM-DD"
|
|
6
|
-
binding: false
|
|
7
|
-
gate: null
|
|
8
|
-
documents_shipped: false
|
|
9
|
-
verified_in: []
|
|
10
|
-
supersedes: []
|
|
11
|
-
superseded_by: null
|
|
12
|
-
format: "madr"
|
|
13
|
-
topics: []
|
|
14
|
-
aliases: []
|
|
15
|
-
components: []
|
|
16
|
-
symbols: []
|
|
17
|
-
context_scope: "selective"
|
|
18
|
-
---
|
|
19
|
-
|
|
20
|
-
<!-- markdownlint-disable MD025 -->
|
|
21
|
-
|
|
22
|
-
# ADR-NNN Short Imperative Title
|
|
23
|
-
|
|
24
|
-
## Status
|
|
25
|
-
|
|
26
|
-
Proposed, YYYY-MM-DD.
|
|
27
|
-
|
|
28
|
-
## Status History
|
|
29
|
-
|
|
30
|
-
```yaml
|
|
31
|
-
status_history:
|
|
32
|
-
- date: YYYY-MM-DD
|
|
33
|
-
status: Proposed
|
|
34
|
-
changed_by: user@example.com
|
|
35
|
-
reason: Initial proposal
|
|
36
|
-
changed_via: adr-kit
|
|
37
|
-
```
|
|
38
|
-
|
|
39
|
-
## Context and Problem Statement
|
|
40
|
-
|
|
41
|
-
State the problem, constraints, and concrete evidence.
|
|
42
|
-
|
|
43
|
-
## Decision Drivers
|
|
44
|
-
|
|
45
|
-
* Driver one.
|
|
46
|
-
* Driver two.
|
|
47
|
-
|
|
48
|
-
## Considered Options
|
|
49
|
-
|
|
50
|
-
* Option A.
|
|
51
|
-
* Option B.
|
|
52
|
-
* Do nothing, when it is a realistic option.
|
|
53
|
-
|
|
54
|
-
## Decision Outcome
|
|
55
|
-
|
|
56
|
-
Chosen option: **Option A**, because state the decisive rationale.
|
|
57
|
-
|
|
58
|
-
### Confirmation
|
|
59
|
-
|
|
60
|
-
State how implementation of the decision will be verified.
|
|
61
|
-
|
|
62
|
-
## Decision Contract
|
|
63
|
-
|
|
64
|
-
### Must
|
|
65
|
-
|
|
66
|
-
* State required implementation constraints.
|
|
67
|
-
|
|
68
|
-
### Must Not
|
|
69
|
-
|
|
70
|
-
* State prohibited implementation choices.
|
|
71
|
-
|
|
72
|
-
### Exceptions
|
|
73
|
-
|
|
74
|
-
* State explicit exceptions, or `None`.
|
|
75
|
-
|
|
76
|
-
### Verification
|
|
77
|
-
|
|
78
|
-
* Name the test, command, or source anchor that verifies this decision.
|
|
79
|
-
|
|
80
|
-
## Consequences
|
|
81
|
-
|
|
82
|
-
### Positive
|
|
83
|
-
|
|
84
|
-
* Expected benefit.
|
|
85
|
-
|
|
86
|
-
### Negative
|
|
87
|
-
|
|
88
|
-
* Accepted cost or risk and its mitigation.
|
|
89
|
-
|
|
90
|
-
## Pros and Cons of the Options
|
|
91
|
-
|
|
92
|
-
### Option A
|
|
93
|
-
|
|
94
|
-
* Good, because ...
|
|
95
|
-
* Bad, because ...
|
|
96
|
-
|
|
97
|
-
### Option B
|
|
98
|
-
|
|
99
|
-
* Good, because ...
|
|
100
|
-
* Bad, because ...
|
|
101
|
-
|
|
102
|
-
## Open Questions
|
|
103
|
-
|
|
104
|
-
List unresolved human decisions as unchecked tasks. Accepted ADRs must have no
|
|
105
|
-
unresolved items.
|
|
106
|
-
|
|
107
|
-
Answer them with `bin/adr answer`, which rewrites an item as
|
|
108
|
-
`- [x] <question> — **Answered <date> by <signer>:** <answer>`. A checked item
|
|
109
|
-
is resolved, so it no longer blocks acceptance and stays in the record. Do not
|
|
110
|
-
delete an answered question: the reasoning is what a future reader needs in
|
|
111
|
-
order to re-evaluate the decision.
|
|
112
|
-
|
|
113
|
-
## Related Decisions
|
|
114
|
-
|
|
115
|
-
* None.
|
|
116
|
-
|
|
117
|
-
## References
|
|
118
|
-
|
|
119
|
-
* Add at least one verifiable local or external reference.
|
|
120
|
-
|
|
121
|
-
## Enforcement
|
|
122
|
-
|
|
123
|
-
Delete this optional section when the decision has no machine-checkable surface.
|
|
124
|
-
|
|
125
|
-
```json
|
|
126
|
-
{
|
|
127
|
-
"forbid_pattern": [],
|
|
128
|
-
"forbid_import": [],
|
|
129
|
-
"require_pattern": []
|
|
130
|
-
}
|
|
131
|
-
```
|
|
1
|
+
---
|
|
2
|
+
id: "ADR-NNN"
|
|
3
|
+
title: "Short Imperative Title"
|
|
4
|
+
status: "Proposed"
|
|
5
|
+
date: "YYYY-MM-DD"
|
|
6
|
+
binding: false
|
|
7
|
+
gate: null
|
|
8
|
+
documents_shipped: false
|
|
9
|
+
verified_in: []
|
|
10
|
+
supersedes: []
|
|
11
|
+
superseded_by: null
|
|
12
|
+
format: "madr"
|
|
13
|
+
topics: []
|
|
14
|
+
aliases: []
|
|
15
|
+
components: []
|
|
16
|
+
symbols: []
|
|
17
|
+
context_scope: "selective"
|
|
18
|
+
---
|
|
19
|
+
|
|
20
|
+
<!-- markdownlint-disable MD025 -->
|
|
21
|
+
|
|
22
|
+
# ADR-NNN Short Imperative Title
|
|
23
|
+
|
|
24
|
+
## Status
|
|
25
|
+
|
|
26
|
+
Proposed, YYYY-MM-DD.
|
|
27
|
+
|
|
28
|
+
## Status History
|
|
29
|
+
|
|
30
|
+
```yaml
|
|
31
|
+
status_history:
|
|
32
|
+
- date: YYYY-MM-DD
|
|
33
|
+
status: Proposed
|
|
34
|
+
changed_by: user@example.com
|
|
35
|
+
reason: Initial proposal
|
|
36
|
+
changed_via: adr-kit
|
|
37
|
+
```
|
|
38
|
+
|
|
39
|
+
## Context and Problem Statement
|
|
40
|
+
|
|
41
|
+
State the problem, constraints, and concrete evidence.
|
|
42
|
+
|
|
43
|
+
## Decision Drivers
|
|
44
|
+
|
|
45
|
+
* Driver one.
|
|
46
|
+
* Driver two.
|
|
47
|
+
|
|
48
|
+
## Considered Options
|
|
49
|
+
|
|
50
|
+
* Option A.
|
|
51
|
+
* Option B.
|
|
52
|
+
* Do nothing, when it is a realistic option.
|
|
53
|
+
|
|
54
|
+
## Decision Outcome
|
|
55
|
+
|
|
56
|
+
Chosen option: **Option A**, because state the decisive rationale.
|
|
57
|
+
|
|
58
|
+
### Confirmation
|
|
59
|
+
|
|
60
|
+
State how implementation of the decision will be verified.
|
|
61
|
+
|
|
62
|
+
## Decision Contract
|
|
63
|
+
|
|
64
|
+
### Must
|
|
65
|
+
|
|
66
|
+
* State required implementation constraints.
|
|
67
|
+
|
|
68
|
+
### Must Not
|
|
69
|
+
|
|
70
|
+
* State prohibited implementation choices.
|
|
71
|
+
|
|
72
|
+
### Exceptions
|
|
73
|
+
|
|
74
|
+
* State explicit exceptions, or `None`.
|
|
75
|
+
|
|
76
|
+
### Verification
|
|
77
|
+
|
|
78
|
+
* Name the test, command, or source anchor that verifies this decision.
|
|
79
|
+
|
|
80
|
+
## Consequences
|
|
81
|
+
|
|
82
|
+
### Positive
|
|
83
|
+
|
|
84
|
+
* Expected benefit.
|
|
85
|
+
|
|
86
|
+
### Negative
|
|
87
|
+
|
|
88
|
+
* Accepted cost or risk and its mitigation.
|
|
89
|
+
|
|
90
|
+
## Pros and Cons of the Options
|
|
91
|
+
|
|
92
|
+
### Option A
|
|
93
|
+
|
|
94
|
+
* Good, because ...
|
|
95
|
+
* Bad, because ...
|
|
96
|
+
|
|
97
|
+
### Option B
|
|
98
|
+
|
|
99
|
+
* Good, because ...
|
|
100
|
+
* Bad, because ...
|
|
101
|
+
|
|
102
|
+
## Open Questions
|
|
103
|
+
|
|
104
|
+
List unresolved human decisions as unchecked tasks. Accepted ADRs must have no
|
|
105
|
+
unresolved items.
|
|
106
|
+
|
|
107
|
+
Answer them with `bin/adr answer`, which rewrites an item as
|
|
108
|
+
`- [x] <question> — **Answered <date> by <signer>:** <answer>`. A checked item
|
|
109
|
+
is resolved, so it no longer blocks acceptance and stays in the record. Do not
|
|
110
|
+
delete an answered question: the reasoning is what a future reader needs in
|
|
111
|
+
order to re-evaluate the decision.
|
|
112
|
+
|
|
113
|
+
## Related Decisions
|
|
114
|
+
|
|
115
|
+
* None.
|
|
116
|
+
|
|
117
|
+
## References
|
|
118
|
+
|
|
119
|
+
* Add at least one verifiable local or external reference.
|
|
120
|
+
|
|
121
|
+
## Enforcement
|
|
122
|
+
|
|
123
|
+
Delete this optional section when the decision has no machine-checkable surface.
|
|
124
|
+
|
|
125
|
+
```json
|
|
126
|
+
{
|
|
127
|
+
"forbid_pattern": [],
|
|
128
|
+
"forbid_import": [],
|
|
129
|
+
"require_pattern": []
|
|
130
|
+
}
|
|
131
|
+
```
|