create-agdf 0.8.7 → 0.9.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/bin/create-agdf.js +67 -8
- package/generated/.github/skills/agdf-brownfield-analysis/SKILL.md +6 -2
- package/generated/.github/skills/agdf-clean-implementation-review/SKILL.md +9 -1
- package/generated/.github/skills/agdf-code-review/SKILL.md +9 -1
- package/generated/.github/skills/agdf-delivery-closeout/SKILL.md +5 -1
- package/generated/.github/skills/agdf-delivery-path-search/SKILL.md +5 -1
- package/generated/.github/skills/agdf-gate-check/SKILL.md +12 -5
- package/generated/.github/skills/agdf-qa-gate/SKILL.md +12 -2
- package/generated/.github/skills/agdf-release-or/SKILL.md +7 -2
- package/generated/.github/skills/agdf-runtime-contract.md +11 -812
- package/generated/.github/skills/agdf-task-plan-review/SKILL.md +10 -1
- package/generated/.github/skills/contracts/closeout.md +29 -0
- package/generated/.github/skills/contracts/context-graph.md +48 -0
- package/generated/.github/skills/contracts/control-scaffold.md +109 -0
- package/generated/.github/skills/contracts/gate-transition.md +134 -0
- package/generated/.github/skills/contracts/interaction.md +370 -0
- package/generated/.github/skills/contracts/modes.md +91 -0
- package/generated/.github/skills/contracts/quality.md +100 -0
- package/generated/.opencode/AGDF.md +9 -1
- package/generated/.opencode/agdf-runtime-contract.md +11 -812
- package/generated/.opencode/contracts/closeout.md +29 -0
- package/generated/.opencode/contracts/context-graph.md +48 -0
- package/generated/.opencode/contracts/control-scaffold.md +109 -0
- package/generated/.opencode/contracts/gate-transition.md +134 -0
- package/generated/.opencode/contracts/interaction.md +370 -0
- package/generated/.opencode/contracts/modes.md +91 -0
- package/generated/.opencode/contracts/quality.md +100 -0
- package/generated/.opencode/skills/agdf-brownfield-analysis/SKILL.md +6 -2
- package/generated/.opencode/skills/agdf-clean-implementation-review/SKILL.md +9 -1
- package/generated/.opencode/skills/agdf-code-review/SKILL.md +9 -1
- package/generated/.opencode/skills/agdf-delivery-closeout/SKILL.md +5 -1
- package/generated/.opencode/skills/agdf-delivery-path-search/SKILL.md +5 -1
- package/generated/.opencode/skills/agdf-gate-check/SKILL.md +12 -5
- package/generated/.opencode/skills/agdf-qa-gate/SKILL.md +12 -2
- package/generated/.opencode/skills/agdf-release-or/SKILL.md +7 -2
- package/generated/.opencode/skills/agdf-task-plan-review/SKILL.md +10 -1
- package/generated/AGENTS.md +9 -1
- package/generated/plugins/agdf/.codex-plugin/plugin.json +4 -4
- package/generated/plugins/agdf/meta/agdf-agent-router.md +9 -1
- package/generated/plugins/agdf/meta/agdf-plugin.definition.json +14 -8
- package/generated/plugins/agdf/meta/agdf-runtime-contract.md +11 -812
- package/generated/plugins/agdf/meta/contracts/closeout.md +29 -0
- package/generated/plugins/agdf/meta/contracts/context-graph.md +48 -0
- package/generated/plugins/agdf/meta/contracts/control-scaffold.md +109 -0
- package/generated/plugins/agdf/meta/contracts/gate-transition.md +134 -0
- package/generated/plugins/agdf/meta/contracts/interaction.md +370 -0
- package/generated/plugins/agdf/meta/contracts/modes.md +91 -0
- package/generated/plugins/agdf/meta/contracts/quality.md +100 -0
- package/generated/plugins/agdf/skills/brownfield-analysis/SKILL.md +6 -2
- package/generated/plugins/agdf/skills/clean-implementation-review/SKILL.md +9 -1
- package/generated/plugins/agdf/skills/code-review/SKILL.md +9 -1
- package/generated/plugins/agdf/skills/delivery-closeout/SKILL.md +5 -1
- package/generated/plugins/agdf/skills/delivery-path-search/SKILL.md +5 -1
- package/generated/plugins/agdf/skills/gate-check/SKILL.md +12 -5
- package/generated/plugins/agdf/skills/qa-gate/SKILL.md +12 -2
- package/generated/plugins/agdf/skills/release-or/SKILL.md +7 -2
- package/generated/plugins/agdf/skills/task-plan-review/SKILL.md +10 -1
- package/package.json +1 -1
|
@@ -13,7 +13,11 @@ The search is advisory and read-only. Canonical AGDF `agdf-gate-check` remains t
|
|
|
13
13
|
|
|
14
14
|
## Runtime Contract
|
|
15
15
|
|
|
16
|
-
Use
|
|
16
|
+
Use these focused runtime-contract modules:
|
|
17
|
+
|
|
18
|
+
- `../../contracts/control-scaffold.md`
|
|
19
|
+
- `../../contracts/gate-transition.md`
|
|
20
|
+
- `../../contracts/quality.md`
|
|
17
21
|
|
|
18
22
|
## Trigger
|
|
19
23
|
|
|
@@ -18,8 +18,14 @@ Determine the earliest blocking user approval gate and derive:
|
|
|
18
18
|
This skill must not create later artefacts such as PRD, SD, TP, CD, CR, QA, or UAT when the gate does not allow them.
|
|
19
19
|
|
|
20
20
|
## Runtime Contract
|
|
21
|
-
Use
|
|
22
|
-
|
|
21
|
+
Use these focused runtime-contract modules:
|
|
22
|
+
|
|
23
|
+
- `../../contracts/gate-transition.md`
|
|
24
|
+
- `../../contracts/interaction.md`
|
|
25
|
+
- `../../contracts/control-scaffold.md`
|
|
26
|
+
- `../../contracts/modes.md`
|
|
27
|
+
- `../../contracts/quality.md`
|
|
28
|
+
The canonical gate order and transition model live only in `../../contracts/gate-transition.md`. This skill evaluates the current state against that model; it must not maintain a second complete gate table.
|
|
23
29
|
|
|
24
30
|
## Agent-Native Control Path
|
|
25
31
|
|
|
@@ -69,7 +75,7 @@ For a ready `gate_approval`:
|
|
|
69
75
|
7. Distinguish internal process steps from user decisions in natural language. For example, after `Approval: TP`, say that pre-implementation Brownfield Analysis runs next and that no further user action is required now; do not expose `next_user_gate: none` or `user_action_required: no`, and do not ask for a second approval for Brownfield Analysis.
|
|
70
76
|
8. Ask exactly one question that names the selected `run_id` and `current_gate`.
|
|
71
77
|
9. Offer options in stable order: exact `Approval: <GateName>`, localized revise and localized decline. Add explicit cancel only where supported after decline; otherwise host dismissal maps to cancel. Never preselect, skip, auto-submit or reorder an option.
|
|
72
|
-
10. Use the surface adapter declared in the canonical plugin definition only when it can wait for deliberate input without auto-resolution
|
|
78
|
+
10. Use the surface adapter declared in the canonical plugin definition only when it can wait for deliberate input without auto-resolution and can transport `exact_option_value` or `separate_label_and_value`; never invoke a `decorated_label_only` adapter. Otherwise request the same exact approval in concise text.
|
|
73
79
|
11. Render both cards once in that single complete assistant message. Never merge, reverse, omit or duplicate them; the action heading does not replace either card. If the native attempt is unavailable or not applied, continue to exact text without repeating either card.
|
|
74
80
|
12. Re-run gate evaluation for the same run and expected gate after the response and immediately before persistence.
|
|
75
81
|
13. Reject a missing artefact, ambiguous or wrong run, wrong gate, stale expected gate, timeout/default, hook-supplied answer, agent message, technical permission outcome or plan approval.
|
|
@@ -88,7 +94,7 @@ For the transition card, use the complete resolved locale pack. The initial Germ
|
|
|
88
94
|
|
|
89
95
|
The primary option is derived exactly as `Approval: <GateName>` from the evaluated current gate; only explanatory copy and non-authoritative outcome labels are localized. Concrete localized copy belongs to the user-facing interaction layer or the approved delivery artefact, not to English runtime rules.
|
|
90
96
|
|
|
91
|
-
Make exactly one native-attempt for the ready gate. If the host does not render,
|
|
97
|
+
Make exactly one native-attempt for the eligible ready gate. If the host does not render,
|
|
92
98
|
apply or safely return the native question on that attempt, switch immediately
|
|
93
99
|
to the exact textual approval. Do not ask the user to request the buttons again
|
|
94
100
|
and do not create a retry loop or simulated control.
|
|
@@ -102,7 +108,7 @@ only after fresh run/gate/artefact revalidation; never retry automatically.
|
|
|
102
108
|
|
|
103
109
|
Surface behavior:
|
|
104
110
|
|
|
105
|
-
- Codex: invoke the native short-question/request-user-input control
|
|
111
|
+
- Codex: invoke the native short-question/request-user-input control only when preflight proves `exact_option_value` or `separate_label_and_value`, and omit auto-resolution. The canonical `decorated_label_only` capability must use exact text without invoking the adapter. `Approval: <GateName> (Recommended)` is never a valid option or approval.
|
|
106
112
|
- Claude Code: invoke `AskUserQuestion` on the first eligible attempt only when no timeout can auto-continue and no hook supplies `answers` or `updatedInput`; if it is not rendered or applied, use exact text immediately. Claude permissions and `ExitPlanMode` remain separate.
|
|
107
113
|
- OpenCode: use built-in `question` when permitted. Preserve explicit `permission.question` denial and use exact text in that case. `once`, `always`, `reject` and auto mode never become gate input.
|
|
108
114
|
- Other, unavailable or non-interactive surfaces: use exact textual approval and wait for a new explicit user response.
|
|
@@ -232,6 +238,7 @@ from the same snapshot and are shown exactly once.
|
|
|
232
238
|
|
|
233
239
|
If this skill creates or updates control artefacts, do not paste full file bodies into the chat.
|
|
234
240
|
List paths, summarize the decision, name the blocker or approval needed, and keep the durable content in the files.
|
|
241
|
+
See the Runtime Contract §Chat and Tool-Call Discipline for tool-call batching and skill output compaction rules.
|
|
235
242
|
|
|
236
243
|
## Forbidden
|
|
237
244
|
This skill must not:
|
|
@@ -22,7 +22,11 @@ It answers:
|
|
|
22
22
|
- whether blockers, critical risks, or missing evidence remain
|
|
23
23
|
|
|
24
24
|
## Runtime Contract
|
|
25
|
-
Use
|
|
25
|
+
Use these focused runtime-contract modules:
|
|
26
|
+
|
|
27
|
+
- `../../contracts/quality.md`
|
|
28
|
+
- `../../contracts/context-graph.md`
|
|
29
|
+
- `../../contracts/gate-transition.md`
|
|
26
30
|
|
|
27
31
|
QA-specific `decision` is exactly `pass | revise | block`.
|
|
28
32
|
`pass` is allowed only when TP coverage, Brownfield fit, solution integrity, and relevant documentation/Context Graph impact are sufficiently evidenced.
|
|
@@ -100,7 +104,13 @@ Use this shape:
|
|
|
100
104
|
- impact_codes:
|
|
101
105
|
```
|
|
102
106
|
|
|
103
|
-
If Context Graph impact is relevant, include the fields from `../../
|
|
107
|
+
If Context Graph impact is relevant, include the fields from `../../contracts/context-graph.md`.
|
|
108
|
+
|
|
109
|
+
### Compact Chat Output
|
|
110
|
+
|
|
111
|
+
At `pass`: one line — `QA: pass — <one-line summary>`. Reference the durable QA report
|
|
112
|
+
path. Do not show the Quality Readiness projection or evidence inventory in chat.
|
|
113
|
+
At `revise`/`block`: show the decisive dimension, reason and next action.
|
|
104
114
|
|
|
105
115
|
## Decision Guidance
|
|
106
116
|
- `pass`: required TP tasks are done, evidence is strong, no blocking Brownfield or solution-integrity risk remains.
|
|
@@ -25,7 +25,12 @@ It reports:
|
|
|
25
25
|
- whether further quality follow-up or a separate delivery closeout is useful
|
|
26
26
|
|
|
27
27
|
## Runtime Contract
|
|
28
|
-
Use
|
|
28
|
+
Use these focused runtime-contract modules:
|
|
29
|
+
|
|
30
|
+
- `../../contracts/closeout.md`
|
|
31
|
+
- `../../contracts/quality.md`
|
|
32
|
+
- `../../contracts/context-graph.md`
|
|
33
|
+
- `../../contracts/control-scaffold.md`
|
|
29
34
|
|
|
30
35
|
OR-specific output must make gate status, delivered and intentionally not delivered content, missing approvals, missing evidence, risks, retained fallbacks, and the next permissible step visible.
|
|
31
36
|
When `.agdf/control/` is present, persist or link the OR under `.agdf/control/artefacts/<key>/OR.md` and reference it from the selected canonical `RUN_STATE.md` or `MASTER_BACKLOG.md` when it is steering-relevant.
|
|
@@ -118,7 +123,7 @@ Use a compact structure:
|
|
|
118
123
|
- quality_outlook:
|
|
119
124
|
```
|
|
120
125
|
|
|
121
|
-
When Context Graph impact is relevant, include the fields from `../../
|
|
126
|
+
When Context Graph impact is relevant, include the fields from `../../contracts/context-graph.md`.
|
|
122
127
|
Include `context_graph_reconciliation` whenever Context Graph impact is present. If the value is `open_gap`, required next step must resolve or explicitly retain that gap before commit-ready or release-ready handoff.
|
|
123
128
|
|
|
124
129
|
## Forbidden
|
|
@@ -19,7 +19,11 @@ For each relevant task, this skill determines:
|
|
|
19
19
|
This skill provides TP coverage. It is not the final QA decision.
|
|
20
20
|
|
|
21
21
|
## Runtime Contract
|
|
22
|
-
Use
|
|
22
|
+
Use these focused runtime-contract modules:
|
|
23
|
+
|
|
24
|
+
- `../../contracts/quality.md`
|
|
25
|
+
- `../../contracts/context-graph.md`
|
|
26
|
+
- `../../contracts/gate-transition.md`
|
|
23
27
|
|
|
24
28
|
TP-specific output must evaluate every relevant `task_id` with completion status, AC coverage, evidence, missing evidence, and QA-relevant gaps.
|
|
25
29
|
If `context_graph_required_action` is not `none`, the affected task is complete only if follow-up, evidence, or an intentionally open gap is visible.
|
|
@@ -105,6 +109,11 @@ Evidence confidence:
|
|
|
105
109
|
- `medium`
|
|
106
110
|
- `low`
|
|
107
111
|
|
|
112
|
+
### Compact Chat Output
|
|
113
|
+
|
|
114
|
+
At `pass`: one line — `TP Review: pass — <X>/<total> tasks fully_done`.
|
|
115
|
+
At `revise`/`block`: show incomplete tasks with missing evidence.
|
|
116
|
+
|
|
108
117
|
## Forbidden
|
|
109
118
|
This skill must not:
|
|
110
119
|
|
package/generated/AGENTS.md
CHANGED
|
@@ -67,7 +67,15 @@ Never jump directly from `Approval: UR`, implicit consent, or a generic "start"
|
|
|
67
67
|
## Runtime Contract
|
|
68
68
|
For repeated output, gate, Quality Contract and Context Graph rules, use:
|
|
69
69
|
|
|
70
|
-
`
|
|
70
|
+
- `contracts/gate-transition.md` for gate terms, Brownfield routing and transition rules
|
|
71
|
+
- `contracts/interaction.md` for status cards, approval orientation and native interaction
|
|
72
|
+
- `contracts/modes.md` for delivery-mode boundaries
|
|
73
|
+
- `contracts/quality.md` for quality and output discipline
|
|
74
|
+
- `contracts/context-graph.md` for persistence and reconciliation
|
|
75
|
+
- `contracts/control-scaffold.md` for run state, CLI verification and Delivery Map
|
|
76
|
+
- `contracts/closeout.md` for relevant-run and closeout boundaries
|
|
77
|
+
|
|
78
|
+
`agdf-runtime-contract.md` remains the compatibility manifest for these modules.
|
|
71
79
|
|
|
72
80
|
Skills may include short reminders, but they must not carry a second complete rule or code table.
|
|
73
81
|
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "agdf",
|
|
3
|
-
"version": "0.
|
|
4
|
-
"description": "
|
|
3
|
+
"version": "0.9.0",
|
|
4
|
+
"description": "Operating system for governed AI-assisted delivery.",
|
|
5
5
|
"author": {
|
|
6
6
|
"name": "Arndt Gold",
|
|
7
7
|
"url": "https://agdf.iself.eu"
|
|
@@ -20,8 +20,8 @@
|
|
|
20
20
|
"hooks": "./hooks/hooks.json",
|
|
21
21
|
"interface": {
|
|
22
22
|
"displayName": "AI Governance & Delivery Framework",
|
|
23
|
-
"shortDescription": "
|
|
24
|
-
"longDescription": "AI Governance & Delivery Framework (AGDF) brings an operating system for governed AI-assisted delivery
|
|
23
|
+
"shortDescription": "Operating system for governed AI-assisted delivery.",
|
|
24
|
+
"longDescription": "AI Governance & Delivery Framework (AGDF) brings an operating system for governed AI-assisted delivery, combining workflow skills, control templates and machine-readable repository checks for gate decisions, Brownfield analysis, task-plan review, QA decisions, durable run state and auditable delivery closeout.",
|
|
25
25
|
"developerName": "Arndt Gold",
|
|
26
26
|
"category": "Productivity",
|
|
27
27
|
"capabilities": [
|
|
@@ -68,7 +68,15 @@ Never jump directly from `Approval: UR`, implicit consent, or a generic "start"
|
|
|
68
68
|
## Runtime Contract
|
|
69
69
|
For repeated output, gate, Quality Contract and Context Graph rules, use:
|
|
70
70
|
|
|
71
|
-
`
|
|
71
|
+
- `contracts/gate-transition.md` for gate terms, Brownfield routing and transition rules
|
|
72
|
+
- `contracts/interaction.md` for status cards, approval orientation and native interaction
|
|
73
|
+
- `contracts/modes.md` for delivery-mode boundaries
|
|
74
|
+
- `contracts/quality.md` for quality and output discipline
|
|
75
|
+
- `contracts/context-graph.md` for persistence and reconciliation
|
|
76
|
+
- `contracts/control-scaffold.md` for run state, CLI verification and Delivery Map
|
|
77
|
+
- `contracts/closeout.md` for relevant-run and closeout boundaries
|
|
78
|
+
|
|
79
|
+
`agdf-runtime-contract.md` remains the compatibility manifest for these modules.
|
|
72
80
|
|
|
73
81
|
Skills may include short reminders, but they must not carry a second complete rule or code table.
|
|
74
82
|
|
|
@@ -1,13 +1,13 @@
|
|
|
1
1
|
{
|
|
2
2
|
"schemaVersion": 1,
|
|
3
3
|
"id": "agdf",
|
|
4
|
-
"version": "0.
|
|
4
|
+
"version": "0.9.0",
|
|
5
5
|
"displayName": "AI Governance & Delivery Framework",
|
|
6
6
|
"developerName": "Arndt Gold",
|
|
7
|
-
"description": "
|
|
7
|
+
"description": "Operating system for governed AI-assisted delivery.",
|
|
8
8
|
"claudeDescription": "AI Governance & Delivery Framework (AGDF) brings an operating system for governed AI-assisted delivery to Claude Code, combining workflow skills, control templates and machine-readable repository checks for gate decisions, Brownfield analysis, task-plan review, QA decisions, durable run state and auditable closeout.",
|
|
9
|
-
"shortDescription": "
|
|
10
|
-
"longDescription": "AI Governance & Delivery Framework (AGDF) brings an operating system for governed AI-assisted delivery
|
|
9
|
+
"shortDescription": "Operating system for governed AI-assisted delivery.",
|
|
10
|
+
"longDescription": "AI Governance & Delivery Framework (AGDF) brings an operating system for governed AI-assisted delivery, combining workflow skills, control templates and machine-readable repository checks for gate decisions, Brownfield analysis, task-plan review, QA decisions, durable run state and auditable delivery closeout.",
|
|
11
11
|
"homepage": "https://agdf.iself.eu",
|
|
12
12
|
"repository": "https://github.com/arndtgold/ai-native-governance-delivery-framework",
|
|
13
13
|
"license": "Apache-2.0",
|
|
@@ -44,7 +44,13 @@
|
|
|
44
44
|
},
|
|
45
45
|
"claude": {
|
|
46
46
|
"skillPrefix": "",
|
|
47
|
-
"agentRouter": "meta/agdf-agent-router.md"
|
|
47
|
+
"agentRouter": "meta/agdf-agent-router.md",
|
|
48
|
+
"defaultPrompt": [
|
|
49
|
+
"Assess whether AGDF is proportionate for this repository and request before proposing any implementation. Explain AGDF's purpose and practical benefits, weigh governance overhead against the project's delivery risk, and recommend the lightest suitable path — or explicitly advise against AGDF where it would add more process than value.",
|
|
50
|
+
"Start this request under AGDF governance.",
|
|
51
|
+
"Create durable AGDF control state for this repository.",
|
|
52
|
+
"Close this delivery run with an auditable AGDF report."
|
|
53
|
+
]
|
|
48
54
|
},
|
|
49
55
|
"copilot": {
|
|
50
56
|
"skillPrefix": "agdf-",
|
|
@@ -97,7 +103,7 @@
|
|
|
97
103
|
"decline"
|
|
98
104
|
],
|
|
99
105
|
"dismissOutcome": "cancel",
|
|
100
|
-
"approvalValueTransport": "
|
|
106
|
+
"approvalValueTransport": "exact_option_value",
|
|
101
107
|
"waitSafety": "deliberate_no_auto_resolution",
|
|
102
108
|
"authorizationPath": "exact_text",
|
|
103
109
|
"technicalPermissionOwner": "codex_host"
|
|
@@ -112,7 +118,7 @@
|
|
|
112
118
|
"decline"
|
|
113
119
|
],
|
|
114
120
|
"dismissOutcome": "cancel",
|
|
115
|
-
"approvalValueTransport": "
|
|
121
|
+
"approvalValueTransport": "exact_option_value",
|
|
116
122
|
"waitSafety": "deliberate_no_auto_resolution",
|
|
117
123
|
"authorizationPath": "exact_text",
|
|
118
124
|
"technicalPermissionOwner": "claude_host"
|
|
@@ -127,7 +133,7 @@
|
|
|
127
133
|
"decline"
|
|
128
134
|
],
|
|
129
135
|
"dismissOutcome": "cancel",
|
|
130
|
-
"approvalValueTransport": "
|
|
136
|
+
"approvalValueTransport": "exact_option_value",
|
|
131
137
|
"waitSafety": "deliberate_no_auto_resolution",
|
|
132
138
|
"authorizationPath": "exact_text",
|
|
133
139
|
"technicalPermissionOwner": "opencode_host"
|