@t275005746/gse 0.1.0 → 0.1.2

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.
Files changed (228) hide show
  1. package/.github/ISSUE_TEMPLATE/bug_report.yml +42 -42
  2. package/.github/ISSUE_TEMPLATE/change_request.yml +50 -50
  3. package/.github/ISSUE_TEMPLATE/config.yml +5 -5
  4. package/.github/PULL_REQUEST_TEMPLATE.md +38 -38
  5. package/.github/workflows/validate-gse.yml +33 -33
  6. package/.gse/README.md +18 -18
  7. package/.gse/gse-development-protocol.md +50 -50
  8. package/.gse/project-profile.md +29 -29
  9. package/.gse/quality-gates.md +25 -25
  10. package/.gse/releases/public-registry-publication-npm.md +49 -0
  11. package/.gse/releases/public-release-owner-required.md +65 -65
  12. package/.gse/releases/public-security-contact-owner-required.md +45 -45
  13. package/.gse/state.json +147 -27
  14. package/CHANGELOG.md +31 -15
  15. package/CONTRIBUTING.md +64 -64
  16. package/LICENSE +21 -21
  17. package/README.md +14 -7
  18. package/README.zh-CN.md +14 -7
  19. package/SECURITY.md +41 -41
  20. package/SKILL.md +32 -12
  21. package/SUPPORT.md +38 -38
  22. package/assets/marketplace/README.md +7 -7
  23. package/assets/marketplace/gse-listing.json +75 -75
  24. package/assets/templates/acceptance-execution-packet.md +73 -73
  25. package/assets/templates/adr.md +14 -14
  26. package/assets/templates/change-brief.md +16 -16
  27. package/assets/templates/design.md +18 -18
  28. package/assets/templates/dispatch-packet.md +100 -92
  29. package/assets/templates/evidence.md +15 -9
  30. package/assets/templates/execution-quality-pack.md +65 -65
  31. package/assets/templates/goal-map.md +21 -21
  32. package/assets/templates/host-adapter.md +48 -48
  33. package/assets/templates/host-ui-invocation-record.md +42 -42
  34. package/assets/templates/incident-review.md +60 -60
  35. package/assets/templates/public-channel-publication-record.md +49 -49
  36. package/assets/templates/public-ci-run-record.md +53 -53
  37. package/assets/templates/public-release-record.md +65 -65
  38. package/assets/templates/public-repository-settings-record.md +59 -59
  39. package/assets/templates/public-security-contact-record.md +45 -45
  40. package/assets/templates/release-trust-record.md +32 -32
  41. package/assets/templates/review.md +18 -18
  42. package/assets/templates/role-fallback-packet.md +49 -0
  43. package/assets/templates/spec.md +16 -16
  44. package/assets/templates/target-adoption-evidence.md +29 -29
  45. package/assets/templates/tasks.md +17 -17
  46. package/assets/templates/update-release-acceptance-record.md +58 -58
  47. package/examples/README.md +22 -22
  48. package/examples/agent-runtime-host/.claude/gse-adapter.md +6 -6
  49. package/examples/agent-runtime-host/.codex/gse-adapter.md +7 -7
  50. package/examples/agent-runtime-host/.gse/goal-map.md +7 -7
  51. package/examples/agent-runtime-host/.gse/project-profile.md +27 -27
  52. package/examples/agent-runtime-host/.gse/tooling.md +5 -5
  53. package/examples/agent-runtime-host/.mcp.json +9 -9
  54. package/examples/agent-runtime-host/AGENTS.md +5 -5
  55. package/examples/agent-runtime-host/README.md +10 -10
  56. package/examples/agent-runtime-host/docs/model-routing.md +5 -5
  57. package/examples/cli-tool/.gse/project-profile.md +21 -21
  58. package/examples/cli-tool/AGENTS.md +5 -5
  59. package/examples/cli-tool/README.md +12 -12
  60. package/examples/cli-tool/package.json +21 -21
  61. package/examples/small-app/.env.example +2 -2
  62. package/examples/small-app/.github/workflows/ci.yml +8 -8
  63. package/examples/small-app/AGENTS.md +5 -5
  64. package/examples/small-app/README.md +12 -12
  65. package/examples/small-app/package.json +26 -26
  66. package/examples/small-app/playwright.config.ts +4 -4
  67. package/package.json +52 -44
  68. package/references/adoption-recipes.md +171 -171
  69. package/references/agent-roles.md +42 -21
  70. package/references/architecture-health.md +101 -101
  71. package/references/benchmark-audit.md +73 -73
  72. package/references/commands.md +74 -45
  73. package/references/community-channels.md +46 -46
  74. package/references/compatibility.md +70 -70
  75. package/references/design-basis.md +38 -38
  76. package/references/domain-model.md +129 -129
  77. package/references/domain-quality-gates.md +75 -75
  78. package/references/drift-audit.md +81 -80
  79. package/references/evidence-taxonomy.md +145 -108
  80. package/references/file-ownership.md +97 -93
  81. package/references/final-form-roadmap.md +201 -0
  82. package/references/final-readiness.md +84 -84
  83. package/references/forward-test.md +133 -133
  84. package/references/goal-map.md +36 -36
  85. package/references/host-adapters.md +129 -101
  86. package/references/learning-system.md +42 -26
  87. package/references/maintenance-cadence.md +51 -0
  88. package/references/marketplace-discovery.md +46 -46
  89. package/references/model-routing.md +103 -103
  90. package/references/open-source-defaults.md +39 -39
  91. package/references/operating-model.md +52 -52
  92. package/references/packaging.md +277 -277
  93. package/references/project-agent-workspace.md +89 -89
  94. package/references/project-bootstrap.md +122 -122
  95. package/references/project-guards.md +52 -0
  96. package/references/project-profile.md +57 -57
  97. package/references/public-release.md +174 -174
  98. package/references/quality-gates.md +96 -89
  99. package/references/recovery.md +176 -176
  100. package/references/release-trust.md +43 -43
  101. package/references/release.md +126 -126
  102. package/references/review.md +141 -141
  103. package/references/role-dispatch-fallback.md +54 -0
  104. package/references/router.md +90 -90
  105. package/references/spec-workflow.md +66 -66
  106. package/references/task-levels.md +81 -81
  107. package/references/tool-adapters.md +80 -70
  108. package/scripts/audit-acceptance-execution-packet.mjs +133 -133
  109. package/scripts/audit-adoption-recipes.mjs +99 -99
  110. package/scripts/audit-change-lifecycle.mjs +77 -77
  111. package/scripts/audit-change-system.mjs +134 -134
  112. package/scripts/audit-ci-readiness.mjs +107 -107
  113. package/scripts/audit-close-gate-hardening.mjs +188 -0
  114. package/scripts/audit-close-gate.mjs +448 -262
  115. package/scripts/audit-command-adapters.mjs +91 -91
  116. package/scripts/audit-command-execution.mjs +212 -199
  117. package/scripts/audit-commands.mjs +7 -5
  118. package/scripts/audit-compatibility.mjs +149 -149
  119. package/scripts/audit-completion-plan-drill.mjs +230 -0
  120. package/scripts/audit-completion-readiness.mjs +290 -287
  121. package/scripts/audit-continue-preflight.mjs +234 -0
  122. package/scripts/audit-distribution.mjs +251 -251
  123. package/scripts/audit-domain-quality-gates.mjs +108 -108
  124. package/scripts/audit-evidence-levels.mjs +217 -0
  125. package/scripts/audit-evidence-placeholders.mjs +126 -126
  126. package/scripts/audit-evidence-review-queue.mjs +206 -0
  127. package/scripts/audit-final-acceptance-packet.mjs +9 -9
  128. package/scripts/audit-final-form-progress-report.mjs +19 -18
  129. package/scripts/audit-final-form-roadmap.mjs +157 -0
  130. package/scripts/audit-final-form-stale-copy.mjs +2 -2
  131. package/scripts/audit-final-readiness-promotion.mjs +255 -255
  132. package/scripts/audit-final-readiness.mjs +226 -226
  133. package/scripts/audit-fixtures.mjs +154 -154
  134. package/scripts/audit-fresh-session-readiness.mjs +177 -177
  135. package/scripts/audit-host-capabilities.mjs +237 -0
  136. package/scripts/audit-host-runtime-evidence-handoff.mjs +159 -159
  137. package/scripts/audit-host-runtime-invocation-drill.mjs +240 -240
  138. package/scripts/audit-host-runtime-invocations.mjs +254 -254
  139. package/scripts/audit-host-ui-invocation.mjs +132 -132
  140. package/scripts/audit-installed-sync.mjs +203 -0
  141. package/scripts/audit-learning-drift.mjs +292 -0
  142. package/scripts/audit-learning-promotion.mjs +351 -0
  143. package/scripts/audit-learning-system.mjs +24 -14
  144. package/scripts/audit-local-final-form-completion.mjs +11 -10
  145. package/scripts/audit-maintenance-cadence.mjs +139 -0
  146. package/scripts/audit-maintenance-snapshot.mjs +181 -0
  147. package/scripts/audit-marketplace-discovery.mjs +122 -122
  148. package/scripts/audit-npm-package-metadata.mjs +160 -154
  149. package/scripts/audit-npm-publish-dry-run.mjs +194 -166
  150. package/scripts/audit-npm-tarball-install.mjs +195 -189
  151. package/scripts/audit-open-source-defaults.mjs +92 -92
  152. package/scripts/audit-open-source-readiness.mjs +97 -97
  153. package/scripts/audit-owner-external-gate-kit.mjs +12 -11
  154. package/scripts/audit-project-guards.mjs +189 -0
  155. package/scripts/audit-project.mjs +144 -141
  156. package/scripts/audit-public-acceptance-command-dry-run-drill.mjs +203 -203
  157. package/scripts/audit-public-acceptance-handoff.mjs +10 -10
  158. package/scripts/audit-public-acceptance-readiness.mjs +222 -222
  159. package/scripts/audit-public-channel-publication.mjs +248 -248
  160. package/scripts/audit-public-ci-run.mjs +184 -184
  161. package/scripts/audit-public-collaboration-templates.mjs +98 -98
  162. package/scripts/audit-public-external-gate-probe.mjs +206 -206
  163. package/scripts/audit-public-release-checklist.mjs +17 -15
  164. package/scripts/audit-public-release-decision.mjs +201 -201
  165. package/scripts/audit-public-release-metadata.mjs +176 -176
  166. package/scripts/audit-public-repository-settings.mjs +237 -237
  167. package/scripts/audit-public-security-contact.mjs +171 -171
  168. package/scripts/audit-readme-docs.mjs +6 -4
  169. package/scripts/audit-recovery-readiness.mjs +98 -98
  170. package/scripts/audit-release-bundle.mjs +13 -11
  171. package/scripts/audit-release-owner-action-plan-drill.mjs +5 -4
  172. package/scripts/audit-release-owner-action-plan.mjs +10 -10
  173. package/scripts/audit-release-readiness.mjs +106 -106
  174. package/scripts/audit-release-status-manifest.mjs +4 -4
  175. package/scripts/audit-release-trust.mjs +62 -62
  176. package/scripts/audit-remote-distribution.mjs +266 -266
  177. package/scripts/audit-roadmap-consistency.mjs +234 -230
  178. package/scripts/audit-role-dispatch-fallback.mjs +212 -0
  179. package/scripts/audit-session-sync.mjs +127 -0
  180. package/scripts/audit-signing.mjs +147 -147
  181. package/scripts/audit-state-freshness.mjs +20 -14
  182. package/scripts/audit-state-repair.mjs +360 -0
  183. package/scripts/audit-target-adoption-evidence.mjs +117 -117
  184. package/scripts/audit-target-hardening-drills.mjs +267 -0
  185. package/scripts/audit-target-project.mjs +507 -507
  186. package/scripts/audit-tool-fallback-policy.mjs +180 -0
  187. package/scripts/audit-ui-browser-evidence-policy.mjs +191 -0
  188. package/scripts/audit-update-release-acceptance.mjs +136 -136
  189. package/scripts/audit-v1-target-validation.mjs +269 -269
  190. package/scripts/audit-validation-profiles.mjs +125 -123
  191. package/scripts/backfill-evidence-levels.mjs +98 -0
  192. package/scripts/check-encoding.mjs +72 -0
  193. package/scripts/close-change.mjs +116 -116
  194. package/scripts/discover-project-profile.mjs +307 -307
  195. package/scripts/generate-command-adapter.mjs +231 -231
  196. package/scripts/generate-continue-packet.mjs +1214 -0
  197. package/scripts/generate-final-acceptance-packet.mjs +188 -173
  198. package/scripts/generate-final-form-progress-report.mjs +191 -189
  199. package/scripts/generate-host-runtime-evidence-handoff.mjs +198 -191
  200. package/scripts/generate-maintenance-snapshot.mjs +216 -0
  201. package/scripts/generate-owner-external-gate-kit.mjs +295 -295
  202. package/scripts/generate-public-acceptance-handoff.mjs +168 -156
  203. package/scripts/generate-public-release-checklist.mjs +207 -207
  204. package/scripts/generate-release-bundle.mjs +505 -505
  205. package/scripts/generate-release-owner-action-plan.mjs +172 -171
  206. package/scripts/generate-release-status-manifest.mjs +199 -198
  207. package/scripts/generate-session-prompt.mjs +188 -188
  208. package/scripts/gse.mjs +67 -67
  209. package/scripts/init-change.mjs +265 -265
  210. package/scripts/init-project.mjs +793 -712
  211. package/scripts/install-gse.mjs +234 -234
  212. package/scripts/lib/evidence-placeholders.mjs +28 -28
  213. package/scripts/package-gse.mjs +174 -174
  214. package/scripts/probe-public-external-gates.mjs +167 -167
  215. package/scripts/record-host-invocation.mjs +151 -151
  216. package/scripts/record-learning.mjs +37 -8
  217. package/scripts/record-public-channel-publication.mjs +178 -178
  218. package/scripts/record-public-ci-run.mjs +180 -180
  219. package/scripts/record-public-release.mjs +175 -175
  220. package/scripts/record-public-repository-settings.mjs +209 -209
  221. package/scripts/record-public-security-contact.mjs +157 -157
  222. package/scripts/record-session-sync.mjs +87 -0
  223. package/scripts/run-gse-command.mjs +79 -47
  224. package/scripts/run-validation-profile.mjs +24 -5
  225. package/scripts/sign-gse-package.mjs +83 -83
  226. package/scripts/update-project-state.mjs +223 -223
  227. package/scripts/validate-gse.mjs +216 -0
  228. package/scripts/verify-gse-package.mjs +85 -85
@@ -1,42 +1,42 @@
1
- name: Bug report
2
- description: Report a reproducible GSE workflow, install, validation, or host-adapter issue.
3
- title: "[Bug]: "
4
- labels: ["bug", "needs-evidence"]
5
- body:
6
- - type: textarea
7
- id: outcome
8
- attributes:
9
- label: Outcome
10
- description: What should have happened?
11
- validations:
12
- required: true
13
- - type: textarea
14
- id: actual
15
- attributes:
16
- label: Actual behavior
17
- description: What happened instead?
18
- validations:
19
- required: true
20
- - type: textarea
21
- id: reproduce
22
- attributes:
23
- label: Reproduction
24
- description: Minimal commands, project shape, or host steps.
25
- placeholder: |
26
- node scripts/validate-gse.mjs --root . --json
27
- validations:
28
- required: true
29
- - type: textarea
30
- id: evidence
31
- attributes:
32
- label: Evidence
33
- description: Focused logs, audit output, host invocation record, or screenshots. Do not paste secrets.
34
- validations:
35
- required: true
36
- - type: textarea
37
- id: risk
38
- attributes:
39
- label: Risk and claim boundary
40
- description: Note whether this affects install, release, public CI, native slash commands, or host support claims.
41
- validations:
42
- required: true
1
+ name: Bug report
2
+ description: Report a reproducible GSE workflow, install, validation, or host-adapter issue.
3
+ title: "[Bug]: "
4
+ labels: ["bug", "needs-evidence"]
5
+ body:
6
+ - type: textarea
7
+ id: outcome
8
+ attributes:
9
+ label: Outcome
10
+ description: What should have happened?
11
+ validations:
12
+ required: true
13
+ - type: textarea
14
+ id: actual
15
+ attributes:
16
+ label: Actual behavior
17
+ description: What happened instead?
18
+ validations:
19
+ required: true
20
+ - type: textarea
21
+ id: reproduce
22
+ attributes:
23
+ label: Reproduction
24
+ description: Minimal commands, project shape, or host steps.
25
+ placeholder: |
26
+ node scripts/validate-gse.mjs --root . --json
27
+ validations:
28
+ required: true
29
+ - type: textarea
30
+ id: evidence
31
+ attributes:
32
+ label: Evidence
33
+ description: Focused logs, audit output, host invocation record, or screenshots. Do not paste secrets.
34
+ validations:
35
+ required: true
36
+ - type: textarea
37
+ id: risk
38
+ attributes:
39
+ label: Risk and claim boundary
40
+ description: Note whether this affects install, release, public CI, native slash commands, or host support claims.
41
+ validations:
42
+ required: true
@@ -1,50 +1,50 @@
1
- name: Change request
2
- description: Propose a GSE capability, adapter, gate, template, or workflow change.
3
- title: "[Change]: "
4
- labels: ["change", "needs-spec"]
5
- body:
6
- - type: textarea
7
- id: goal
8
- attributes:
9
- label: Goal
10
- description: What durable GSE capability should become true?
11
- validations:
12
- required: true
13
- - type: textarea
14
- id: spec
15
- attributes:
16
- label: Spec
17
- description: Outcome, scope, acceptance, evidence, risk, and next action.
18
- placeholder: |
19
- Outcome:
20
- Scope:
21
- Acceptance:
22
- Evidence:
23
- Risk:
24
- Next action:
25
- validations:
26
- required: true
27
- - type: dropdown
28
- id: level
29
- attributes:
30
- label: Task level
31
- options:
32
- - lite
33
- - standard
34
- - enterprise
35
- validations:
36
- required: true
37
- - type: textarea
38
- id: tools
39
- attributes:
40
- label: Tool or host impact
41
- description: Which hosts, scripts, adapters, CI, package, marketplace, or release gates are affected?
42
- validations:
43
- required: true
44
- - type: textarea
45
- id: evidence
46
- attributes:
47
- label: Proposed evidence
48
- description: Which focused audit, test, or external record would prove this?
49
- validations:
50
- required: true
1
+ name: Change request
2
+ description: Propose a GSE capability, adapter, gate, template, or workflow change.
3
+ title: "[Change]: "
4
+ labels: ["change", "needs-spec"]
5
+ body:
6
+ - type: textarea
7
+ id: goal
8
+ attributes:
9
+ label: Goal
10
+ description: What durable GSE capability should become true?
11
+ validations:
12
+ required: true
13
+ - type: textarea
14
+ id: spec
15
+ attributes:
16
+ label: Spec
17
+ description: Outcome, scope, acceptance, evidence, risk, and next action.
18
+ placeholder: |
19
+ Outcome:
20
+ Scope:
21
+ Acceptance:
22
+ Evidence:
23
+ Risk:
24
+ Next action:
25
+ validations:
26
+ required: true
27
+ - type: dropdown
28
+ id: level
29
+ attributes:
30
+ label: Task level
31
+ options:
32
+ - lite
33
+ - standard
34
+ - enterprise
35
+ validations:
36
+ required: true
37
+ - type: textarea
38
+ id: tools
39
+ attributes:
40
+ label: Tool or host impact
41
+ description: Which hosts, scripts, adapters, CI, package, marketplace, or release gates are affected?
42
+ validations:
43
+ required: true
44
+ - type: textarea
45
+ id: evidence
46
+ attributes:
47
+ label: Proposed evidence
48
+ description: Which focused audit, test, or external record would prove this?
49
+ validations:
50
+ required: true
@@ -1,5 +1,5 @@
1
- blank_issues_enabled: false
2
- contact_links:
3
- - name: Support boundary
4
- url: https://github.com/
5
- about: Read SUPPORT.md before filing broad usage questions. Replace this placeholder URL when the public repository URL is owner-approved.
1
+ blank_issues_enabled: false
2
+ contact_links:
3
+ - name: Support boundary
4
+ url: https://github.com/
5
+ about: Read SUPPORT.md before filing broad usage questions. Replace this placeholder URL when the public repository URL is owner-approved.
@@ -1,38 +1,38 @@
1
- ## Outcome
2
-
3
- What does this change make true for GSE users or maintainers?
4
-
5
- ## Scope
6
-
7
- Changed files or areas:
8
-
9
- -
10
-
11
- Out of scope:
12
-
13
- -
14
-
15
- ## Acceptance
16
-
17
- How should reviewers know this is complete?
18
-
19
- -
20
-
21
- ## Evidence
22
-
23
- Commands, logs, screenshots, or records:
24
-
25
- - [ ] `node scripts/validate-gse.mjs --root . --json`
26
- - [ ] Focused audit or test:
27
-
28
- ## Risk
29
-
30
- Residual risk, unsupported claims, migration notes, or rollback path:
31
-
32
- -
33
-
34
- ## Claim Boundary
35
-
36
- - [ ] This PR does not claim public release acceptance unless owner/public evidence is attached.
37
- - [ ] This PR does not claim host-native support unless a host invocation record is attached.
38
- - [ ] This PR does not duplicate `.gse/` policy in host-specific folders.
1
+ ## Outcome
2
+
3
+ What does this change make true for GSE users or maintainers?
4
+
5
+ ## Scope
6
+
7
+ Changed files or areas:
8
+
9
+ -
10
+
11
+ Out of scope:
12
+
13
+ -
14
+
15
+ ## Acceptance
16
+
17
+ How should reviewers know this is complete?
18
+
19
+ -
20
+
21
+ ## Evidence
22
+
23
+ Commands, logs, screenshots, or records:
24
+
25
+ - [ ] `node scripts/validate-gse.mjs --root . --json`
26
+ - [ ] Focused audit or test:
27
+
28
+ ## Risk
29
+
30
+ Residual risk, unsupported claims, migration notes, or rollback path:
31
+
32
+ -
33
+
34
+ ## Claim Boundary
35
+
36
+ - [ ] This PR does not claim public release acceptance unless owner/public evidence is attached.
37
+ - [ ] This PR does not claim host-native support unless a host invocation record is attached.
38
+ - [ ] This PR does not duplicate `.gse/` policy in host-specific folders.
@@ -1,33 +1,33 @@
1
- name: Validate GSE
2
-
3
- on:
4
- pull_request:
5
- push:
6
- branches:
7
- - main
8
- - master
9
- workflow_dispatch:
10
-
11
- jobs:
12
- validate:
13
- name: Validate skill package
14
- runs-on: ubuntu-latest
15
- timeout-minutes: 15
16
-
17
- steps:
18
- - name: Checkout
19
- uses: actions/checkout@v4
20
-
21
- - name: Setup Node.js
22
- uses: actions/setup-node@v4
23
- with:
24
- node-version: "20"
25
-
26
- - name: Run GSE validation
27
- run: node scripts/validate-gse.mjs --root . --skip-skill-validator --json
28
-
29
- - name: Audit final readiness boundaries
30
- run: node scripts/audit-final-readiness.mjs --root . --json
31
-
32
- - name: Audit final acceptance packet
33
- run: node scripts/audit-final-acceptance-packet.mjs --root . --json
1
+ name: Validate GSE
2
+
3
+ on:
4
+ pull_request:
5
+ push:
6
+ branches:
7
+ - main
8
+ - master
9
+ workflow_dispatch:
10
+
11
+ jobs:
12
+ validate:
13
+ name: Validate skill package
14
+ runs-on: ubuntu-latest
15
+ timeout-minutes: 15
16
+
17
+ steps:
18
+ - name: Checkout
19
+ uses: actions/checkout@v4
20
+
21
+ - name: Setup Node.js
22
+ uses: actions/setup-node@v4
23
+ with:
24
+ node-version: "20"
25
+
26
+ - name: Run GSE validation
27
+ run: node scripts/validate-gse.mjs --root . --skip-skill-validator --json
28
+
29
+ - name: Audit final readiness boundaries
30
+ run: node scripts/audit-final-readiness.mjs --root . --json
31
+
32
+ - name: Audit final acceptance packet
33
+ run: node scripts/audit-final-acceptance-packet.mjs --root . --json
package/.gse/README.md CHANGED
@@ -1,18 +1,18 @@
1
- # GSE Self-Development Workspace
2
-
3
- This folder tracks development of the GSE skill itself.
4
-
5
- Read order:
6
-
7
- 1. `SKILL.md`
8
- 2. `.gse/state.json`
9
- 3. `.gse/project-profile.md`
10
- 4. `.gse/goal-map.md`
11
- 5. `.gse/quality-gates.md`
12
- 6. `.gse/current-slice.md`
13
- 7. `.gse/gse-design-master-plan.md`
14
- 8. `.gse/evidence/index.jsonl`
15
-
16
- The canonical product plan is `.gse/gse-design-master-plan.md`.
17
-
18
- Keep this folder short and evidence-driven. Long command output belongs in terminal logs, not in roadmap files.
1
+ # GSE Self-Development Workspace
2
+
3
+ This folder tracks development of the GSE skill itself.
4
+
5
+ Read order:
6
+
7
+ 1. `SKILL.md`
8
+ 2. `.gse/state.json`
9
+ 3. `.gse/project-profile.md`
10
+ 4. `.gse/goal-map.md`
11
+ 5. `.gse/quality-gates.md`
12
+ 6. `.gse/current-slice.md`
13
+ 7. `.gse/gse-design-master-plan.md`
14
+ 8. `.gse/evidence/index.jsonl`
15
+
16
+ The canonical product plan is `.gse/gse-design-master-plan.md`.
17
+
18
+ Keep this folder short and evidence-driven. Long command output belongs in terminal logs, not in roadmap files.
@@ -1,50 +1,50 @@
1
- # GSE Development Protocol
2
-
3
- This file governs changes to the GSE skill itself.
4
-
5
- ## Purpose
6
-
7
- GSE development must be proactive. When improving this skill, do not wait for the user to discover missing workflow requirements through manual testing.
8
-
9
- ## Required Loop For GSE Changes
10
-
11
- 1. Read `SKILL.md`, `.gse/goal-map.md`, and `.gse/current-slice.md`.
12
- 2. Classify the GSE change: wording, reference, template, script, scaffold, adapter, validation, or release.
13
- 3. Run or update `references/benchmark-audit.md` for any non-trivial change.
14
- 4. Compare against verified mature sources before adding design goals.
15
- 5. Separate verified facts, design judgments, and open questions.
16
- 6. Prefer scripts/templates over prose when the behavior should be repeatable.
17
- 7. Validate the changed behavior with focused smoke tests.
18
- 8. Update `.gse/evidence/YYYY-MM-DD.md` and the short goal map status.
19
-
20
- ## Benchmark Sources To Check First
21
-
22
- - `skill-creator` for skill structure, progressive disclosure, validation, and forward testing.
23
- - `mattpocock/skills` snapshot for setup skill, router, domain docs, TDD, review, and architecture scan patterns.
24
- - `comet` for state machine, phase detection, OpenSpec/Superpowers split, verification, and archive rules.
25
- - `openspec-*` for proposal/design/tasks/spec lifecycle.
26
- - `agentic-engineering` for eval-first loop, decomposition, model routing, session strategy, and cost discipline.
27
- - `subagent-driven-development` for role isolation, dispatch packets, review loops, and no fake delegation.
28
- - `self-improvement` for reusable learning capture and promotion.
29
-
30
- ## Design Bar
31
-
32
- A GSE change should improve at least one of these:
33
-
34
- - New-agent startup success.
35
- - Long-project continuity.
36
- - Requirement completeness before implementation.
37
- - Evidence quality.
38
- - Tool efficiency without hard prerequisites.
39
- - Cross-agent portability.
40
- - Failure prevention or recovery.
41
- - Learning reuse.
42
-
43
- ## Anti-Patterns
44
-
45
- - Adding process because it sounds professional but does not prevent a real failure.
46
- - Copying a tool-specific folder layout as the portable source of truth.
47
- - Treating optional tools as required.
48
- - Claiming a benchmark source says something without reading it.
49
- - Letting GSE become only documentation with no scripts, templates, or validation.
50
-
1
+ # GSE Development Protocol
2
+
3
+ This file governs changes to the GSE skill itself.
4
+
5
+ ## Purpose
6
+
7
+ GSE development must be proactive. When improving this skill, do not wait for the user to discover missing workflow requirements through manual testing.
8
+
9
+ ## Required Loop For GSE Changes
10
+
11
+ 1. Read `SKILL.md`, `.gse/goal-map.md`, and `.gse/current-slice.md`.
12
+ 2. Classify the GSE change: wording, reference, template, script, scaffold, adapter, validation, or release.
13
+ 3. Run or update `references/benchmark-audit.md` for any non-trivial change.
14
+ 4. Compare against verified mature sources before adding design goals.
15
+ 5. Separate verified facts, design judgments, and open questions.
16
+ 6. Prefer scripts/templates over prose when the behavior should be repeatable.
17
+ 7. Validate the changed behavior with focused smoke tests.
18
+ 8. Update `.gse/evidence/YYYY-MM-DD.md` and the short goal map status.
19
+
20
+ ## Benchmark Sources To Check First
21
+
22
+ - `skill-creator` for skill structure, progressive disclosure, validation, and forward testing.
23
+ - `mattpocock/skills` snapshot for setup skill, router, domain docs, TDD, review, and architecture scan patterns.
24
+ - `comet` for state machine, phase detection, OpenSpec/Superpowers split, verification, and archive rules.
25
+ - `openspec-*` for proposal/design/tasks/spec lifecycle.
26
+ - `agentic-engineering` for eval-first loop, decomposition, model routing, session strategy, and cost discipline.
27
+ - `subagent-driven-development` for role isolation, dispatch packets, review loops, and no fake delegation.
28
+ - `self-improvement` for reusable learning capture and promotion.
29
+
30
+ ## Design Bar
31
+
32
+ A GSE change should improve at least one of these:
33
+
34
+ - New-agent startup success.
35
+ - Long-project continuity.
36
+ - Requirement completeness before implementation.
37
+ - Evidence quality.
38
+ - Tool efficiency without hard prerequisites.
39
+ - Cross-agent portability.
40
+ - Failure prevention or recovery.
41
+ - Learning reuse.
42
+
43
+ ## Anti-Patterns
44
+
45
+ - Adding process because it sounds professional but does not prevent a real failure.
46
+ - Copying a tool-specific folder layout as the portable source of truth.
47
+ - Treating optional tools as required.
48
+ - Claiming a benchmark source says something without reading it.
49
+ - Letting GSE become only documentation with no scripts, templates, or validation.
50
+
@@ -1,29 +1,29 @@
1
- # Project Profile
2
-
3
- ## Product
4
-
5
- GSE is a portable Goal-Spec-Evidence Engineering skill for long-running agent-assisted software projects.
6
-
7
- ## Canonical Plan
8
-
9
- - Master plan: `.gse/gse-design-master-plan.md`
10
- - Goal map: `.gse/goal-map.md`
11
- - Current slice: `.gse/current-slice.md`
12
- - Evidence index: `.gse/evidence/index.jsonl`
13
-
14
- ## Commands
15
-
16
- - Full validation: `node scripts/validate-gse.mjs --root <skill-root> --json`
17
- - Structural audit: `node scripts/audit-gse.mjs --root <skill-root> --json`
18
- - Change pack audit: `node scripts/audit-change-system.mjs --root <skill-root> --json`
19
- - Close gate: `node scripts/audit-close-gate.mjs --target <skill-root> --json`
20
-
21
- ## Tool Notes
22
-
23
- - This skill folder is not a git repository.
24
- - Use `py` instead of bare `python` for skill validator commands on this machine.
25
- - Keep OpenSpec, Superpowers, Comet, subagents, MCP, LSP, and browser automation optional unless current-session evidence proves they are available.
26
-
27
- ## Ownership
28
-
29
- Do not mark GSE v1.0 complete until configured target-project evidence confirms real consumption or an explicit owner acceptance policy replaces that requirement.
1
+ # Project Profile
2
+
3
+ ## Product
4
+
5
+ GSE is a portable Goal-Spec-Evidence Engineering skill for long-running agent-assisted software projects.
6
+
7
+ ## Canonical Plan
8
+
9
+ - Master plan: `.gse/gse-design-master-plan.md`
10
+ - Goal map: `.gse/goal-map.md`
11
+ - Current slice: `.gse/current-slice.md`
12
+ - Evidence index: `.gse/evidence/index.jsonl`
13
+
14
+ ## Commands
15
+
16
+ - Full validation: `node scripts/validate-gse.mjs --root <skill-root> --json`
17
+ - Structural audit: `node scripts/audit-gse.mjs --root <skill-root> --json`
18
+ - Change pack audit: `node scripts/audit-change-system.mjs --root <skill-root> --json`
19
+ - Close gate: `node scripts/audit-close-gate.mjs --target <skill-root> --json`
20
+
21
+ ## Tool Notes
22
+
23
+ - This skill folder is not a git repository.
24
+ - Use `py` instead of bare `python` for skill validator commands on this machine.
25
+ - Keep OpenSpec, Superpowers, Comet, subagents, MCP, LSP, and browser automation optional unless current-session evidence proves they are available.
26
+
27
+ ## Ownership
28
+
29
+ Do not mark GSE v1.0 complete until configured target-project evidence confirms real consumption or an explicit owner acceptance policy replaces that requirement.
@@ -1,25 +1,25 @@
1
- # Quality Gates
2
-
3
- ## Universal
4
-
5
- - One slice must have outcome, scope, acceptance, evidence, risk, and next action.
6
- - Do not claim external tools ran unless command output or host evidence proves it.
7
- - Keep `result`, `verified`, and `accepted` distinct.
8
- - Preserve optional adapters: GSE must work without OpenSpec, Superpowers, Comet, subagents, MCP, LSP, or browser tooling.
9
-
10
- ## GSE Skill Changes
11
-
12
- - Run `node scripts/validate-gse.mjs --root <skill-root> --json` before closing a GSE skill change.
13
- - For change/spec behavior, run `node scripts/audit-change-system.mjs --root <skill-root> --json`.
14
- - For README or command behavior, ensure the relevant audit remains wired into `scripts/validate-gse.mjs`.
15
- - Update `.gse/evidence/YYYY-MM-DD.md` and `.gse/evidence/index.jsonl` for verified slices.
16
-
17
- ## Target-Project Claims
18
-
19
- - Use `scripts/audit-target-project.mjs` before claiming a target project is GSE-ready.
20
- - Use `scripts/audit-close-gate.mjs` before saying a slice can close.
21
- - Real project adoption still needs project-specific tests, smokes, or owner acceptance according to that repo's rules.
22
-
23
- ## Release Boundary
24
-
25
- Local validation is not marketplace release, external install verification, CI publication, or owner acceptance.
1
+ # Quality Gates
2
+
3
+ ## Universal
4
+
5
+ - One slice must have outcome, scope, acceptance, evidence, risk, and next action.
6
+ - Do not claim external tools ran unless command output or host evidence proves it.
7
+ - Keep `result`, `verified`, and `accepted` distinct.
8
+ - Preserve optional adapters: GSE must work without OpenSpec, Superpowers, Comet, subagents, MCP, LSP, or browser tooling.
9
+
10
+ ## GSE Skill Changes
11
+
12
+ - Run `node scripts/validate-gse.mjs --root <skill-root> --json` before closing a GSE skill change.
13
+ - For change/spec behavior, run `node scripts/audit-change-system.mjs --root <skill-root> --json`.
14
+ - For README or command behavior, ensure the relevant audit remains wired into `scripts/validate-gse.mjs`.
15
+ - Update `.gse/evidence/YYYY-MM-DD.md` and `.gse/evidence/index.jsonl` for verified slices.
16
+
17
+ ## Target-Project Claims
18
+
19
+ - Use `scripts/audit-target-project.mjs` before claiming a target project is GSE-ready.
20
+ - Use `scripts/audit-close-gate.mjs` before saying a slice can close.
21
+ - Real project adoption still needs project-specific tests, smokes, or owner acceptance according to that repo's rules.
22
+
23
+ ## Release Boundary
24
+
25
+ Local validation is not marketplace release, external install verification, CI publication, or owner acceptance.
@@ -0,0 +1,49 @@
1
+ # Public Channel Publication Record
2
+
3
+ Publication status: accepted
4
+
5
+ Channel type: package-registry
6
+
7
+ Channel name: npm
8
+
9
+ Channel URL: https://www.npmjs.com/package/@t275005746/gse
10
+
11
+ Package or listing version: 0.1.0
12
+
13
+ Artifact digest: sha512-DcnRp6yZv/LjON/uowlze5yuV2JIAWfOD9GGQhVpIGX5IgmA7r9j2FkIDFT3n4abSZ5q/3SH7rh56gICFrml3Q==
14
+
15
+ Review or approval status: published
16
+
17
+ Evidence owner: t275005746
18
+
19
+ Evidence date: 2026-07-08
20
+
21
+ Evidence URL or run id: https://www.npmjs.com/package/@t275005746/gse
22
+
23
+ ## Verification
24
+
25
+ Verification command: node scripts/validate-gse.mjs --root . --json
26
+
27
+ Verification result: passed
28
+
29
+ ## Acceptance
30
+
31
+ Evidence status: accepted
32
+
33
+ Accepted by: 275005746
34
+
35
+ Accepted at: 2026-07-08
36
+
37
+ ## Boundaries
38
+
39
+ - Does this prove public registry publication? true
40
+ - Does this prove marketplace approval? unknown
41
+ - Does this prove installability from the channel? true
42
+
43
+ ## Residual Risk
44
+
45
+ - Public channel publication is not accepted until real external evidence is attached.
46
+
47
+ ## Next Action
48
+
49
+ - Attach public channel publication evidence and re-run final readiness.