@t275005746/gse 0.1.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/.github/ISSUE_TEMPLATE/bug_report.yml +42 -0
- package/.github/ISSUE_TEMPLATE/change_request.yml +50 -0
- package/.github/ISSUE_TEMPLATE/config.yml +5 -0
- package/.github/PULL_REQUEST_TEMPLATE.md +38 -0
- package/.github/workflows/validate-gse.yml +33 -0
- package/.gse/README.md +18 -0
- package/.gse/gse-development-protocol.md +50 -0
- package/.gse/project-profile.md +29 -0
- package/.gse/quality-gates.md +25 -0
- package/.gse/releases/public-channel-publication-pending.md +49 -0
- package/.gse/releases/public-ci-run-pending.md +53 -0
- package/.gse/releases/public-release-owner-required.md +65 -0
- package/.gse/releases/public-repository-settings-owner-required.md +59 -0
- package/.gse/releases/public-security-contact-owner-required.md +45 -0
- package/.gse/state.json +27 -0
- package/CHANGELOG.md +24 -0
- package/CONTRIBUTING.md +64 -0
- package/LICENSE +21 -0
- package/README.md +236 -0
- package/README.zh-CN.md +236 -0
- package/SECURITY.md +41 -0
- package/SKILL.md +148 -0
- package/SUPPORT.md +38 -0
- package/agents/openai.yaml +4 -0
- package/assets/marketplace/README.md +7 -0
- package/assets/marketplace/gse-listing.json +75 -0
- package/assets/templates/acceptance-execution-packet.md +73 -0
- package/assets/templates/adr.md +14 -0
- package/assets/templates/change-brief.md +16 -0
- package/assets/templates/design.md +18 -0
- package/assets/templates/dispatch-packet.md +104 -0
- package/assets/templates/evidence.md +14 -0
- package/assets/templates/execution-quality-pack.md +65 -0
- package/assets/templates/goal-map.md +21 -0
- package/assets/templates/host-adapter.md +48 -0
- package/assets/templates/host-ui-invocation-record.md +42 -0
- package/assets/templates/incident-review.md +60 -0
- package/assets/templates/public-channel-publication-record.md +49 -0
- package/assets/templates/public-ci-run-record.md +53 -0
- package/assets/templates/public-release-record.md +65 -0
- package/assets/templates/public-repository-settings-record.md +59 -0
- package/assets/templates/public-security-contact-record.md +45 -0
- package/assets/templates/release-trust-record.md +32 -0
- package/assets/templates/review.md +18 -0
- package/assets/templates/spec.md +16 -0
- package/assets/templates/target-adoption-evidence.md +29 -0
- package/assets/templates/tasks.md +17 -0
- package/assets/templates/update-release-acceptance-record.md +58 -0
- package/examples/README.md +22 -0
- package/examples/agent-runtime-host/.claude/gse-adapter.md +6 -0
- package/examples/agent-runtime-host/.codex/gse-adapter.md +7 -0
- package/examples/agent-runtime-host/.gse/goal-map.md +7 -0
- package/examples/agent-runtime-host/.gse/project-profile.md +27 -0
- package/examples/agent-runtime-host/.gse/tooling.md +5 -0
- package/examples/agent-runtime-host/.mcp.json +9 -0
- package/examples/agent-runtime-host/AGENTS.md +5 -0
- package/examples/agent-runtime-host/README.md +10 -0
- package/examples/agent-runtime-host/docs/model-routing.md +5 -0
- package/examples/cli-tool/.gse/project-profile.md +21 -0
- package/examples/cli-tool/AGENTS.md +5 -0
- package/examples/cli-tool/README.md +12 -0
- package/examples/cli-tool/package.json +21 -0
- package/examples/small-app/.env.example +2 -0
- package/examples/small-app/.github/workflows/ci.yml +8 -0
- package/examples/small-app/AGENTS.md +5 -0
- package/examples/small-app/README.md +12 -0
- package/examples/small-app/package.json +26 -0
- package/examples/small-app/playwright.config.ts +4 -0
- package/package.json +53 -0
- package/references/adoption-recipes.md +171 -0
- package/references/agent-roles.md +49 -0
- package/references/architecture-health.md +101 -0
- package/references/benchmark-audit.md +73 -0
- package/references/commands.md +295 -0
- package/references/community-channels.md +46 -0
- package/references/compatibility.md +70 -0
- package/references/design-basis.md +38 -0
- package/references/domain-model.md +129 -0
- package/references/domain-quality-gates.md +75 -0
- package/references/drift-audit.md +81 -0
- package/references/evidence-taxonomy.md +123 -0
- package/references/file-ownership.md +107 -0
- package/references/final-readiness.md +84 -0
- package/references/forward-test.md +133 -0
- package/references/goal-map.md +36 -0
- package/references/host-adapters.md +119 -0
- package/references/learning-system.md +35 -0
- package/references/marketplace-discovery.md +46 -0
- package/references/model-routing.md +103 -0
- package/references/open-source-defaults.md +39 -0
- package/references/operating-model.md +52 -0
- package/references/packaging.md +277 -0
- package/references/project-agent-workspace.md +89 -0
- package/references/project-bootstrap.md +122 -0
- package/references/project-profile.md +57 -0
- package/references/public-release.md +174 -0
- package/references/quality-gates.md +100 -0
- package/references/recovery.md +176 -0
- package/references/release-trust.md +43 -0
- package/references/release.md +126 -0
- package/references/review.md +141 -0
- package/references/router.md +90 -0
- package/references/spec-workflow.md +66 -0
- package/references/task-levels.md +81 -0
- package/references/tool-adapters.md +73 -0
- package/scripts/audit-acceptance-execution-packet.mjs +133 -0
- package/scripts/audit-adoption-recipes.mjs +99 -0
- package/scripts/audit-adoption.mjs +154 -0
- package/scripts/audit-change-lifecycle.mjs +77 -0
- package/scripts/audit-change-system.mjs +134 -0
- package/scripts/audit-ci-readiness.mjs +107 -0
- package/scripts/audit-close-gate.mjs +323 -0
- package/scripts/audit-command-adapters.mjs +91 -0
- package/scripts/audit-command-execution.mjs +210 -0
- package/scripts/audit-commands.mjs +117 -0
- package/scripts/audit-compatibility.mjs +149 -0
- package/scripts/audit-completion-readiness.mjs +292 -0
- package/scripts/audit-distribution.mjs +251 -0
- package/scripts/audit-domain-quality-gates.mjs +108 -0
- package/scripts/audit-evidence-placeholders.mjs +126 -0
- package/scripts/audit-final-acceptance-packet.mjs +148 -0
- package/scripts/audit-final-form-progress-report.mjs +161 -0
- package/scripts/audit-final-form-stale-copy.mjs +221 -0
- package/scripts/audit-final-readiness-promotion.mjs +255 -0
- package/scripts/audit-final-readiness.mjs +226 -0
- package/scripts/audit-fixtures.mjs +154 -0
- package/scripts/audit-fresh-session-readiness.mjs +177 -0
- package/scripts/audit-gse.mjs +275 -0
- package/scripts/audit-host-adapters.mjs +119 -0
- package/scripts/audit-host-runtime-evidence-handoff.mjs +159 -0
- package/scripts/audit-host-runtime-invocation-drill.mjs +240 -0
- package/scripts/audit-host-runtime-invocations.mjs +254 -0
- package/scripts/audit-host-ui-invocation.mjs +132 -0
- package/scripts/audit-learning-system.mjs +103 -0
- package/scripts/audit-local-final-form-completion.mjs +131 -0
- package/scripts/audit-marketplace-discovery.mjs +122 -0
- package/scripts/audit-npm-package-metadata.mjs +155 -0
- package/scripts/audit-npm-publish-dry-run.mjs +169 -0
- package/scripts/audit-npm-tarball-install.mjs +191 -0
- package/scripts/audit-open-source-defaults.mjs +92 -0
- package/scripts/audit-open-source-readiness.mjs +97 -0
- package/scripts/audit-owner-external-gate-kit.mjs +218 -0
- package/scripts/audit-project.mjs +323 -0
- package/scripts/audit-public-acceptance-command-dry-run-drill.mjs +203 -0
- package/scripts/audit-public-acceptance-handoff.mjs +142 -0
- package/scripts/audit-public-acceptance-readiness.mjs +224 -0
- package/scripts/audit-public-channel-publication.mjs +248 -0
- package/scripts/audit-public-ci-run.mjs +184 -0
- package/scripts/audit-public-collaboration-templates.mjs +98 -0
- package/scripts/audit-public-external-gate-probe.mjs +206 -0
- package/scripts/audit-public-release-checklist.mjs +133 -0
- package/scripts/audit-public-release-decision.mjs +201 -0
- package/scripts/audit-public-release-metadata.mjs +176 -0
- package/scripts/audit-public-repository-settings.mjs +237 -0
- package/scripts/audit-public-security-contact.mjs +171 -0
- package/scripts/audit-readme-docs.mjs +185 -0
- package/scripts/audit-recovery-readiness.mjs +98 -0
- package/scripts/audit-release-bundle.mjs +251 -0
- package/scripts/audit-release-owner-action-plan-drill.mjs +277 -0
- package/scripts/audit-release-owner-action-plan.mjs +164 -0
- package/scripts/audit-release-readiness.mjs +106 -0
- package/scripts/audit-release-status-manifest.mjs +165 -0
- package/scripts/audit-release-trust.mjs +62 -0
- package/scripts/audit-remote-distribution.mjs +266 -0
- package/scripts/audit-roadmap-consistency.mjs +235 -0
- package/scripts/audit-signing.mjs +147 -0
- package/scripts/audit-state-freshness.mjs +113 -0
- package/scripts/audit-target-adoption-evidence.mjs +117 -0
- package/scripts/audit-target-project.mjs +507 -0
- package/scripts/audit-update-release-acceptance.mjs +136 -0
- package/scripts/audit-v1-target-validation.mjs +269 -0
- package/scripts/audit-validation-profiles.mjs +125 -0
- package/scripts/close-change.mjs +116 -0
- package/scripts/discover-project-profile.mjs +307 -0
- package/scripts/forward-test-gse.mjs +146 -0
- package/scripts/generate-command-adapter.mjs +231 -0
- package/scripts/generate-final-acceptance-packet.mjs +181 -0
- package/scripts/generate-final-form-progress-report.mjs +205 -0
- package/scripts/generate-host-adapter.mjs +73 -0
- package/scripts/generate-host-runtime-evidence-handoff.mjs +206 -0
- package/scripts/generate-owner-external-gate-kit.mjs +295 -0
- package/scripts/generate-public-acceptance-handoff.mjs +168 -0
- package/scripts/generate-public-release-checklist.mjs +207 -0
- package/scripts/generate-release-bundle.mjs +505 -0
- package/scripts/generate-release-owner-action-plan.mjs +172 -0
- package/scripts/generate-release-status-manifest.mjs +200 -0
- package/scripts/generate-session-prompt.mjs +188 -0
- package/scripts/gse.mjs +67 -0
- package/scripts/init-change.mjs +265 -0
- package/scripts/init-project.mjs +785 -0
- package/scripts/install-gse.mjs +234 -0
- package/scripts/lib/evidence-placeholders.mjs +28 -0
- package/scripts/package-gse.mjs +174 -0
- package/scripts/probe-public-external-gates.mjs +167 -0
- package/scripts/record-host-invocation.mjs +151 -0
- package/scripts/record-learning.mjs +137 -0
- package/scripts/record-public-channel-publication.mjs +178 -0
- package/scripts/record-public-ci-run.mjs +180 -0
- package/scripts/record-public-release.mjs +175 -0
- package/scripts/record-public-repository-settings.mjs +209 -0
- package/scripts/record-public-security-contact.mjs +157 -0
- package/scripts/run-gse-command.mjs +538 -0
- package/scripts/run-validation-profile.mjs +146 -0
- package/scripts/sign-gse-package.mjs +83 -0
- package/scripts/update-project-state.mjs +223 -0
- package/scripts/validate-gse.mjs +1168 -0
- package/scripts/verify-gse-package.mjs +85 -0
package/SKILL.md
ADDED
|
@@ -0,0 +1,148 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: gse
|
|
3
|
+
description: Use GSE (Goal-Spec-Evidence Engineering) to initialize, operate, audit, or improve a commercial-grade agentic engineering workflow for long-running software projects. Use when starting or standardizing a project, planning complex work, coordinating multiple coding agents, creating goal maps/specs/evidence gates, setting project quality gates, or converting ad hoc development into a durable workflow across Codex, Claude Code, Hermes, WorkBuddy, and similar agents.
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# GSE - Goal-Spec-Evidence Engineering
|
|
7
|
+
|
|
8
|
+
GSE is a lightweight, tool-adaptive engineering operating model for AI-agent-assisted software projects.
|
|
9
|
+
|
|
10
|
+
Core loop:
|
|
11
|
+
|
|
12
|
+
```text
|
|
13
|
+
Goal -> Spec -> Execute -> Evidence -> Learn
|
|
14
|
+
```
|
|
15
|
+
|
|
16
|
+
Default stance: keep the workflow as light as the task allows and as rigorous as the risk requires.
|
|
17
|
+
|
|
18
|
+
## Start Here
|
|
19
|
+
|
|
20
|
+
1. Use `references/router.md` to select the GSE route.
|
|
21
|
+
2. Classify the task level using `references/task-levels.md`.
|
|
22
|
+
3. If the user writes `/gse ...` or `gse: ...`, route through `references/commands.md`.
|
|
23
|
+
4. For human-facing setup or overview, use `README.md` and `README.zh-CN.md`.
|
|
24
|
+
5. If the project has `.gse/README.md`, read it before making changes.
|
|
25
|
+
6. If the project has `.gse/state.json`, read it as the machine-readable project phase, current slice, tool status, last evidence, and residual-risk summary.
|
|
26
|
+
7. If the project lacks `.gse/`, offer or run `node <skill>/scripts/init-project.mjs --target <project-root>`.
|
|
27
|
+
The default is `--mode auto`; use `--mode lite`, `--mode standard`, or `--mode enterprise` when the owner wants a specific scaffold.
|
|
28
|
+
8. Read or create `.gse/project-profile.md` for project-specific standards, commands, tools, and permissions.
|
|
29
|
+
9. For project adoption drift, run `node <skill>/scripts/audit-target-project.mjs --target <project-root>` before claiming a target project is GSE-ready.
|
|
30
|
+
10. Use `references/operating-model.md` for the workflow and `references/tool-adapters.md` for optional tool routing.
|
|
31
|
+
11. Use `references/host-adapters.md` when host-specific folders, hooks, skills, MCP, subagents, or runtime adapters are involved.
|
|
32
|
+
12. For GSE improvements, run `references/benchmark-audit.md` to proactively find missing skill coverage.
|
|
33
|
+
13. Before declaring GSE skill changes complete, run `node <skill>/scripts/validate-gse.mjs --root <skill>`.
|
|
34
|
+
14. Before declaring completion, check `references/quality-gates.md`.
|
|
35
|
+
15. Record reusable lessons using `references/learning-system.md`.
|
|
36
|
+
|
|
37
|
+
Portable command helpers:
|
|
38
|
+
|
|
39
|
+
- Short CLI wrapper: `node <skill>/scripts/gse.mjs status --target <project-root> --json`
|
|
40
|
+
- Short continuation prompt: `node <skill>/scripts/generate-session-prompt.mjs --target <project-root>`
|
|
41
|
+
- Portable command runner: `node <skill>/scripts/run-gse-command.mjs --target <project-root> --command "/gse continue"`
|
|
42
|
+
- Validation profile runner: `node <skill>/scripts/run-validation-profile.mjs --target <project-root> --profile lite|standard|enterprise|release`
|
|
43
|
+
- Command execution audit: `node <skill>/scripts/audit-command-execution.mjs --root <skill> --profile lite|full`
|
|
44
|
+
- Close readiness check: `node <skill>/scripts/audit-close-gate.mjs --target <project-root>`
|
|
45
|
+
- GSE owner/external action list: `node <skill>/scripts/run-gse-command.mjs --target <skill> --command "/gse owner-actions" --json --compact`
|
|
46
|
+
- Owner/external live evidence probe: `node <skill>/scripts/run-gse-command.mjs --target <skill> --command "/gse probe --public-repo-url <url>" --json`
|
|
47
|
+
- Release bundle dry-run/write route: `node <skill>/scripts/run-gse-command.mjs --target <skill> --command "/gse release" --json`
|
|
48
|
+
- Package dry-run/write route: `node <skill>/scripts/run-gse-command.mjs --target <skill> --command "/gse package" --json`
|
|
49
|
+
- Install dry-run/write route: `node <skill>/scripts/run-gse-command.mjs --target <skill> --command "/gse install --source <package-dir> --install-target <install-skill-dir>" --json`
|
|
50
|
+
- Public release checklist route: `node <skill>/scripts/run-gse-command.mjs --target <skill> --command "/gse public-release" --json`
|
|
51
|
+
- Learning capture route: `node <skill>/scripts/run-gse-command.mjs --target <project-root> --command "/gse learn --summary <lesson>" --execute --json`
|
|
52
|
+
- Existing project state/index update: `node <skill>/scripts/update-project-state.mjs --target <project-root>`
|
|
53
|
+
- Change spec pack: `node <skill>/scripts/init-change.mjs --target <project-root> --change-id <id> --level lite|standard|enterprise`
|
|
54
|
+
- Public release record: `node <skill>/scripts/record-public-release.mjs --root <project-root> --license-status owner-required`
|
|
55
|
+
- Release bundle: `node <skill>/scripts/generate-release-bundle.mjs --root <skill> --label <release-label> --out <bundle-dir>`
|
|
56
|
+
- Owner/external gate kit: `node <skill>/scripts/generate-owner-external-gate-kit.mjs --root <skill-or-project>`
|
|
57
|
+
|
|
58
|
+
## Required Questions Before Adding Process
|
|
59
|
+
|
|
60
|
+
For every new GSE artifact, rule, or gate, answer briefly:
|
|
61
|
+
|
|
62
|
+
- Is this step necessary for this task level?
|
|
63
|
+
- Can it be shorter?
|
|
64
|
+
- Can it be automated?
|
|
65
|
+
- Can it degrade by project scale?
|
|
66
|
+
- Is it friendly to future agents with limited context?
|
|
67
|
+
- Does it prevent a real failure or improve quality measurably?
|
|
68
|
+
|
|
69
|
+
If the answer is weak, defer the artifact or make it optional.
|
|
70
|
+
|
|
71
|
+
## Evidence Rules
|
|
72
|
+
|
|
73
|
+
- Do not state unverified tool behavior as fact. Label inferred behavior as an assumption.
|
|
74
|
+
- Prefer local tool help, installed skill docs, project files, official docs, and focused experiments as evidence.
|
|
75
|
+
- If a tool is unavailable, use the markdown fallback and say which enhancement was skipped.
|
|
76
|
+
- Do not require OpenSpec, Comet, Superpowers, subagents, LSP, or browser automation. Use them when available and appropriate.
|
|
77
|
+
|
|
78
|
+
## Minimal Outputs
|
|
79
|
+
|
|
80
|
+
For normal work, always keep these five fields visible:
|
|
81
|
+
|
|
82
|
+
```text
|
|
83
|
+
Outcome:
|
|
84
|
+
Scope:
|
|
85
|
+
Acceptance:
|
|
86
|
+
Evidence:
|
|
87
|
+
Next action:
|
|
88
|
+
```
|
|
89
|
+
|
|
90
|
+
For long-running projects, bind the work to `.gse/goal-map.md` or the project's existing goal map.
|
|
91
|
+
|
|
92
|
+
## Reference Routing
|
|
93
|
+
|
|
94
|
+
- Project bootstrap: `references/project-bootstrap.md`
|
|
95
|
+
- Command semantics: `references/commands.md`
|
|
96
|
+
- Project adoption recipes: `references/adoption-recipes.md`
|
|
97
|
+
- Validation profile runner: `scripts/run-validation-profile.mjs`, `scripts/audit-validation-profiles.mjs`
|
|
98
|
+
- Target project doctor: `scripts/audit-target-project.mjs`
|
|
99
|
+
- Route selection: `references/router.md`
|
|
100
|
+
- Project-specific standards and tools: `references/project-profile.md`
|
|
101
|
+
- Project-local agent workspace: `references/project-agent-workspace.md`
|
|
102
|
+
- Host-specific adapters: `references/host-adapters.md`, `references/compatibility.md`
|
|
103
|
+
- Benchmark and gap audit: `references/benchmark-audit.md`
|
|
104
|
+
- Task level selection: `references/task-levels.md`
|
|
105
|
+
- Goal maps: `references/goal-map.md`
|
|
106
|
+
- Specs and change folders: `references/spec-workflow.md`
|
|
107
|
+
- Agent roles and ownership: `references/agent-roles.md`, `references/file-ownership.md`
|
|
108
|
+
- Tool acceleration and model routing: `references/tool-adapters.md`, `references/model-routing.md`
|
|
109
|
+
- Review protocol: `references/review.md`
|
|
110
|
+
- Architecture health scans: `references/architecture-health.md`
|
|
111
|
+
- Quality gates: `references/quality-gates.md`
|
|
112
|
+
- Domain quality gates: `references/domain-quality-gates.md`
|
|
113
|
+
- Release workflow: `references/release.md`
|
|
114
|
+
- Public release metadata: `references/public-release.md`
|
|
115
|
+
- Open-source defaults: `references/open-source-defaults.md`
|
|
116
|
+
- Community channels: `references/community-channels.md`
|
|
117
|
+
- Public release decision audit: `scripts/audit-public-release-decision.mjs`
|
|
118
|
+
- Public CI run: `scripts/record-public-ci-run.mjs`, `scripts/audit-public-ci-run.mjs`
|
|
119
|
+
- Public security contact: `scripts/record-public-security-contact.mjs`, `scripts/audit-public-security-contact.mjs`
|
|
120
|
+
- Public repository settings: `scripts/record-public-repository-settings.mjs`, `scripts/audit-public-repository-settings.mjs`
|
|
121
|
+
- Public channel publication: `scripts/record-public-channel-publication.mjs`, `scripts/audit-public-channel-publication.mjs`
|
|
122
|
+
- Public acceptance doctor: `scripts/audit-public-acceptance-readiness.mjs`
|
|
123
|
+
- Public external gate probe: `scripts/probe-public-external-gates.mjs`, `scripts/audit-public-external-gate-probe.mjs`
|
|
124
|
+
- Public acceptance handoff: `scripts/generate-public-acceptance-handoff.mjs`, `scripts/audit-public-acceptance-handoff.mjs`
|
|
125
|
+
- Owner/external gate kit: `scripts/generate-owner-external-gate-kit.mjs`, `scripts/audit-owner-external-gate-kit.mjs`
|
|
126
|
+
- Release status manifest: `scripts/generate-release-status-manifest.mjs`, `scripts/audit-release-status-manifest.mjs`
|
|
127
|
+
- Release owner action plan: `scripts/generate-release-owner-action-plan.mjs`, `scripts/audit-release-owner-action-plan.mjs`
|
|
128
|
+
- Release owner action plan drill: `scripts/audit-release-owner-action-plan-drill.mjs`
|
|
129
|
+
- Public release checklist: `scripts/generate-public-release-checklist.mjs`, `scripts/audit-public-release-checklist.mjs`
|
|
130
|
+
- Final-form progress report: `scripts/generate-final-form-progress-report.mjs`, `scripts/audit-final-form-progress-report.mjs`
|
|
131
|
+
- Packaging and maintenance: `references/packaging.md`
|
|
132
|
+
- CI readiness: `.github/workflows/validate-gse.yml`, `scripts/audit-ci-readiness.mjs`
|
|
133
|
+
- Public collaboration templates: `.github/PULL_REQUEST_TEMPLATE.md`, `.github/ISSUE_TEMPLATE/`, `scripts/audit-public-collaboration-templates.mjs`
|
|
134
|
+
- Release trust and key custody: `references/release-trust.md`
|
|
135
|
+
- Marketplace discovery: `references/marketplace-discovery.md`
|
|
136
|
+
- Host UI invocation record: `assets/templates/host-ui-invocation-record.md`
|
|
137
|
+
- Host runtime invocation records: `scripts/record-host-invocation.mjs`, `scripts/audit-host-runtime-invocations.mjs`
|
|
138
|
+
- Host runtime invocation drill: `scripts/audit-host-runtime-invocation-drill.mjs`
|
|
139
|
+
- Host runtime evidence handoff: `scripts/generate-host-runtime-evidence-handoff.mjs`, `scripts/audit-host-runtime-evidence-handoff.mjs`
|
|
140
|
+
- Final readiness matrix: `references/final-readiness.md`, `scripts/audit-final-readiness.mjs`
|
|
141
|
+
- Final readiness promotion: `scripts/audit-final-readiness-promotion.mjs`
|
|
142
|
+
- Final acceptance packet: `scripts/generate-final-acceptance-packet.mjs`, `scripts/audit-final-acceptance-packet.mjs`
|
|
143
|
+
- Recovery and handoff: `references/recovery.md`
|
|
144
|
+
- Forward testing: `references/forward-test.md`
|
|
145
|
+
- Learning loop: `references/learning-system.md`
|
|
146
|
+
- Learning capture: `scripts/record-learning.mjs`, `scripts/audit-learning-system.mjs`
|
|
147
|
+
- Drift audit: `references/drift-audit.md`
|
|
148
|
+
- Design basis and source boundaries: `references/design-basis.md`
|
package/SUPPORT.md
ADDED
|
@@ -0,0 +1,38 @@
|
|
|
1
|
+
# Support
|
|
2
|
+
|
|
3
|
+
Use this file to decide where to start when GSE behavior is confusing, incomplete, or blocked.
|
|
4
|
+
|
|
5
|
+
## First Checks
|
|
6
|
+
|
|
7
|
+
Run:
|
|
8
|
+
|
|
9
|
+
```text
|
|
10
|
+
node scripts/validate-gse.mjs --root <gse-root> --json
|
|
11
|
+
```
|
|
12
|
+
|
|
13
|
+
For a target project using GSE, run:
|
|
14
|
+
|
|
15
|
+
```text
|
|
16
|
+
node scripts/audit-target-project.mjs --target <project-root> --json
|
|
17
|
+
node scripts/generate-session-prompt.mjs --target <project-root>
|
|
18
|
+
node scripts/audit-close-gate.mjs --target <project-root> --json
|
|
19
|
+
```
|
|
20
|
+
|
|
21
|
+
For package or install issues, run:
|
|
22
|
+
|
|
23
|
+
```text
|
|
24
|
+
node scripts/audit-distribution.mjs --root <gse-root> --json
|
|
25
|
+
node scripts/audit-remote-distribution.mjs --root <gse-root> --json
|
|
26
|
+
```
|
|
27
|
+
|
|
28
|
+
## What To Include In A Support Request
|
|
29
|
+
|
|
30
|
+
- GSE root path or installed package path.
|
|
31
|
+
- Target project path, if any.
|
|
32
|
+
- Command run and the compact JSON summary.
|
|
33
|
+
- Whether the problem is skill usage, project scaffold, package/install, host adapter, release, or evidence gating.
|
|
34
|
+
- Whether optional tools such as OpenSpec, Comet, Superpowers, LSP, browser automation, MCP, or subagents were actually available.
|
|
35
|
+
|
|
36
|
+
## Community
|
|
37
|
+
|
|
38
|
+
GateHub (`https://gatehub.top/`) supports GSE development and contributor coordination.
|
|
@@ -0,0 +1,7 @@
|
|
|
1
|
+
# Marketplace Metadata
|
|
2
|
+
|
|
3
|
+
This folder contains portable discovery metadata for publishing or listing GSE in a skill, plugin, or agent-workflow catalog.
|
|
4
|
+
|
|
5
|
+
The metadata is intentionally host-neutral. It describes what GSE is, how to validate it, which entrypoints matter, and which host capabilities still require separate runtime evidence.
|
|
6
|
+
|
|
7
|
+
Do not add maintainer secrets, local machine paths, private project names, or unverified marketplace approval claims here.
|
|
@@ -0,0 +1,75 @@
|
|
|
1
|
+
{
|
|
2
|
+
"schemaVersion": 1,
|
|
3
|
+
"name": "gse",
|
|
4
|
+
"displayName": "GSE",
|
|
5
|
+
"tagline": "Goal-Spec-Evidence Engineering for long-running agentic software projects.",
|
|
6
|
+
"summary": "Goal-Spec-Evidence workflow skill for AI coding agents that turns ad hoc development into goal maps, scoped specs, focused execution, evidence gates, and reusable learning.",
|
|
7
|
+
"categories": [
|
|
8
|
+
"agentic engineering",
|
|
9
|
+
"software development workflow",
|
|
10
|
+
"spec-driven development",
|
|
11
|
+
"AI coding agents",
|
|
12
|
+
"project governance"
|
|
13
|
+
],
|
|
14
|
+
"keywords": [
|
|
15
|
+
"GSE",
|
|
16
|
+
"Goal-Spec-Evidence",
|
|
17
|
+
"agentic engineering",
|
|
18
|
+
"spec-driven development",
|
|
19
|
+
"SDD",
|
|
20
|
+
"AI coding agent workflow",
|
|
21
|
+
"evidence gates",
|
|
22
|
+
"goal map",
|
|
23
|
+
"project scaffolding",
|
|
24
|
+
"OpenSpec-style changes",
|
|
25
|
+
"Superpowers-style execution"
|
|
26
|
+
],
|
|
27
|
+
"hostSupport": [
|
|
28
|
+
{
|
|
29
|
+
"host": "Codex-style agents",
|
|
30
|
+
"status": "documented",
|
|
31
|
+
"adapter": ".codex/gse-command.md",
|
|
32
|
+
"notes": "Portable runner and pointer adapter are verified; project-level native slash-command execution is host-specific."
|
|
33
|
+
},
|
|
34
|
+
{
|
|
35
|
+
"host": "Claude Code-style agents",
|
|
36
|
+
"status": "documented",
|
|
37
|
+
"adapter": ".claude/commands/gse.md",
|
|
38
|
+
"notes": "Generated command file shape is verified in fixtures; real host invocation requires host runtime evidence."
|
|
39
|
+
},
|
|
40
|
+
{
|
|
41
|
+
"host": "Custom agent runtimes",
|
|
42
|
+
"status": "documented",
|
|
43
|
+
"adapter": "runtime-specific bridge",
|
|
44
|
+
"notes": "Runtime capabilities should be verified inside the target project before being marked verified."
|
|
45
|
+
}
|
|
46
|
+
],
|
|
47
|
+
"entrypoints": [
|
|
48
|
+
"SKILL.md",
|
|
49
|
+
"package.json",
|
|
50
|
+
"README.md",
|
|
51
|
+
"README.zh-CN.md",
|
|
52
|
+
"scripts/init-project.mjs",
|
|
53
|
+
"scripts/run-gse-command.mjs",
|
|
54
|
+
"scripts/validate-gse.mjs",
|
|
55
|
+
"scripts/audit-npm-package-metadata.mjs",
|
|
56
|
+
"scripts/audit-npm-tarball-install.mjs"
|
|
57
|
+
],
|
|
58
|
+
"verification": [
|
|
59
|
+
"node scripts/validate-gse.mjs --root . --json",
|
|
60
|
+
"node scripts/audit-npm-package-metadata.mjs --root . --json",
|
|
61
|
+
"node scripts/audit-marketplace-discovery.mjs --root . --json",
|
|
62
|
+
"node scripts/audit-host-ui-invocation.mjs --root . --json"
|
|
63
|
+
],
|
|
64
|
+
"distribution": {
|
|
65
|
+
"packageScript": "scripts/package-gse.mjs",
|
|
66
|
+
"installScript": "scripts/install-gse.mjs",
|
|
67
|
+
"signingScript": "scripts/sign-gse-package.mjs",
|
|
68
|
+
"trustPolicy": "references/release-trust.md"
|
|
69
|
+
},
|
|
70
|
+
"boundaries": [
|
|
71
|
+
"GSE is not a hosted service.",
|
|
72
|
+
"GSE does not require OpenSpec, Superpowers, Comet, MCP, LSP, browser automation, or subagents.",
|
|
73
|
+
"Marketplace approval, maintainer identity, and native host UI invocation require separate evidence."
|
|
74
|
+
]
|
|
75
|
+
}
|
|
@@ -0,0 +1,73 @@
|
|
|
1
|
+
# Acceptance Execution Packet
|
|
2
|
+
|
|
3
|
+
Use this packet when GSE needs external acceptance evidence instead of another structural audit.
|
|
4
|
+
|
|
5
|
+
Choose exactly one path per packet.
|
|
6
|
+
|
|
7
|
+
```text
|
|
8
|
+
Acceptance path: fresh-session | owner-approved project write
|
|
9
|
+
Target project or session:
|
|
10
|
+
Purpose:
|
|
11
|
+
Required inputs:
|
|
12
|
+
Allowed files:
|
|
13
|
+
Forbidden files:
|
|
14
|
+
Allowed commands:
|
|
15
|
+
Forbidden commands:
|
|
16
|
+
Expected output:
|
|
17
|
+
Evidence record path:
|
|
18
|
+
Acceptance gate:
|
|
19
|
+
Accepted by:
|
|
20
|
+
Stop conditions:
|
|
21
|
+
Residual risk if incomplete:
|
|
22
|
+
Next action after completion:
|
|
23
|
+
```
|
|
24
|
+
|
|
25
|
+
## Fresh-Session Path
|
|
26
|
+
|
|
27
|
+
Use when a separate session, thread, host worker, or equivalent can run the GSE continuation path without hidden conversation history.
|
|
28
|
+
|
|
29
|
+
Required inputs:
|
|
30
|
+
|
|
31
|
+
- `SKILL.md`
|
|
32
|
+
- `.gse/gse-design-master-plan.md`
|
|
33
|
+
- `.gse/goal-map.md`
|
|
34
|
+
- `.gse/current-slice.md`
|
|
35
|
+
- `references/forward-test.md`
|
|
36
|
+
- `references/evidence-taxonomy.md`
|
|
37
|
+
|
|
38
|
+
Acceptance gate: the separate session identifies the current slice, states outcome/scope/acceptance/evidence/risk/next action, runs or describes the smallest valid verification, and records `Accepted by: fresh-session` only if it actually executed the packet.
|
|
39
|
+
|
|
40
|
+
## Owner-Approved Project Write Path
|
|
41
|
+
|
|
42
|
+
Use when a target project owner explicitly allows GSE to write project-local `.gse/` adoption or update artifacts.
|
|
43
|
+
|
|
44
|
+
Required inputs:
|
|
45
|
+
|
|
46
|
+
- Project owner approval text or issue/task link.
|
|
47
|
+
- Target project rule file such as `AGENTS.md`, `CLAUDE.md`, or README.
|
|
48
|
+
- `references/adoption-recipes.md`
|
|
49
|
+
- `assets/templates/target-adoption-evidence.md`
|
|
50
|
+
- `assets/templates/update-release-acceptance-record.md`
|
|
51
|
+
|
|
52
|
+
Default allowed files:
|
|
53
|
+
|
|
54
|
+
- `.gse/README.md`
|
|
55
|
+
- `.gse/project-profile.md`
|
|
56
|
+
- `.gse/goal-map.md`
|
|
57
|
+
- `.gse/quality-gates.md`
|
|
58
|
+
- `.gse/tooling.md`
|
|
59
|
+
- `.gse/evidence/YYYY-MM-DD.md`
|
|
60
|
+
|
|
61
|
+
Default forbidden files:
|
|
62
|
+
|
|
63
|
+
- Source code, lockfiles, secrets, generated outputs, screenshots, build artifacts, and unrelated host config.
|
|
64
|
+
|
|
65
|
+
Acceptance gate: the owner-approved project record exists, project-local verification ran, residual risks are recorded, and the owner or named policy accepts the verified record.
|
|
66
|
+
|
|
67
|
+
## Anti-Overclaim Rules
|
|
68
|
+
|
|
69
|
+
- Do not write `Accepted by: fresh-session` unless a separate session actually ran the packet.
|
|
70
|
+
- Do not write `Accepted by: owner` unless owner approval is explicit and recorded.
|
|
71
|
+
- Do not treat a generated packet, local validation, fixture audit, or read-only discovery as acceptance.
|
|
72
|
+
- Do not expand allowed files or commands without updating the packet and recording why.
|
|
73
|
+
- If a stop condition occurs, record `Evidence status: not ready` or `verified` with `Accepted by: not accepted`.
|
|
@@ -0,0 +1,104 @@
|
|
|
1
|
+
# Dispatch Packet
|
|
2
|
+
|
|
3
|
+
Use this when assigning work to a real subagent, another human/agent session, or a sequential role simulation in the main session.
|
|
4
|
+
|
|
5
|
+
Do not require this packet for tiny single-agent edits. Use it when delegation, role separation, file ownership, or review evidence matters.
|
|
6
|
+
|
|
7
|
+
## Execution Mode
|
|
8
|
+
|
|
9
|
+
- Mode: real-subagent | sequential-role | handoff-session
|
|
10
|
+
- Host/tool used:
|
|
11
|
+
- Tool status: verified | documented | unknown | unavailable
|
|
12
|
+
- If not real-subagent, state fallback reason:
|
|
13
|
+
|
|
14
|
+
## Role
|
|
15
|
+
|
|
16
|
+
- Role: Coordinator | Product Analyst | Architect | Code Locator | Builder | Reviewer | QA | Docs/Evidence | Other:
|
|
17
|
+
- Skill focus:
|
|
18
|
+
- Model/tool preference, if project-approved:
|
|
19
|
+
|
|
20
|
+
## Objective
|
|
21
|
+
|
|
22
|
+
- Outcome:
|
|
23
|
+
- Scope:
|
|
24
|
+
- Non-goals:
|
|
25
|
+
- User-visible impact:
|
|
26
|
+
|
|
27
|
+
## Required Context
|
|
28
|
+
|
|
29
|
+
Read these first:
|
|
30
|
+
|
|
31
|
+
1.
|
|
32
|
+
2.
|
|
33
|
+
3.
|
|
34
|
+
|
|
35
|
+
Do not read:
|
|
36
|
+
|
|
37
|
+
- Generated outputs:
|
|
38
|
+
- Historical logs:
|
|
39
|
+
- Unrelated modules:
|
|
40
|
+
|
|
41
|
+
Known assumptions:
|
|
42
|
+
|
|
43
|
+
- Verified facts:
|
|
44
|
+
- Design judgments:
|
|
45
|
+
- Open questions:
|
|
46
|
+
|
|
47
|
+
## File Ownership
|
|
48
|
+
|
|
49
|
+
- Allowed files:
|
|
50
|
+
- Forbidden files:
|
|
51
|
+
- Read-only files:
|
|
52
|
+
- Shared files requiring coordinator review:
|
|
53
|
+
- Pre-existing dirty files:
|
|
54
|
+
- Release condition:
|
|
55
|
+
|
|
56
|
+
Follow `references/file-ownership.md`. Do not overwrite user or unrelated agent changes.
|
|
57
|
+
|
|
58
|
+
## Task Instructions
|
|
59
|
+
|
|
60
|
+
- Steps to perform:
|
|
61
|
+
- Existing patterns to follow:
|
|
62
|
+
- Constraints:
|
|
63
|
+
- Performance/security/accessibility/privacy notes:
|
|
64
|
+
|
|
65
|
+
## Expected Output
|
|
66
|
+
|
|
67
|
+
Return a concise report with:
|
|
68
|
+
|
|
69
|
+
- Status: DONE | DONE_WITH_CONCERNS | NEEDS_CONTEXT | BLOCKED
|
|
70
|
+
- Files inspected:
|
|
71
|
+
- Files changed:
|
|
72
|
+
- Summary of work:
|
|
73
|
+
- Verification run:
|
|
74
|
+
- Evidence produced:
|
|
75
|
+
- Residual risks:
|
|
76
|
+
- Questions or blockers:
|
|
77
|
+
|
|
78
|
+
## Verification
|
|
79
|
+
|
|
80
|
+
- Required focused test/smoke/check:
|
|
81
|
+
- Acceptable evidence level: result | verified | accepted
|
|
82
|
+
- What proves success:
|
|
83
|
+
- What would fail the task:
|
|
84
|
+
|
|
85
|
+
## Stop Conditions
|
|
86
|
+
|
|
87
|
+
Stop and report `NEEDS_CONTEXT` or `BLOCKED` if:
|
|
88
|
+
|
|
89
|
+
- Required context is missing or contradictory.
|
|
90
|
+
- Allowed files are insufficient for the requested change.
|
|
91
|
+
- Target files contain unrelated dirty changes that make merging unsafe.
|
|
92
|
+
- A tool claimed by the packet is unavailable.
|
|
93
|
+
- The task requires broader architecture or product judgment than assigned.
|
|
94
|
+
|
|
95
|
+
## Review Requirements
|
|
96
|
+
|
|
97
|
+
- Spec compliance review required: yes | no
|
|
98
|
+
- Code quality review required: yes | no
|
|
99
|
+
- QA/evidence review required: yes | no
|
|
100
|
+
- Coordinator integration required: yes | no
|
|
101
|
+
|
|
102
|
+
## Notes For Sequential Fallback
|
|
103
|
+
|
|
104
|
+
When no real subagent tool exists, use this packet as a role checklist in the main session. Say that no real delegation occurred if reporting delegation status matters. Keep role boundaries honest.
|
|
@@ -0,0 +1,65 @@
|
|
|
1
|
+
# Execution Quality Pack
|
|
2
|
+
|
|
3
|
+
Use this when a change needs explicit execution skills, tool routing, quality gates, and review boundaries.
|
|
4
|
+
|
|
5
|
+
## Task Profile
|
|
6
|
+
|
|
7
|
+
- Level: lite | standard | enterprise
|
|
8
|
+
- Change type:
|
|
9
|
+
- User-visible impact:
|
|
10
|
+
- Data/security/release impact:
|
|
11
|
+
|
|
12
|
+
## Required Skills Or Roles
|
|
13
|
+
|
|
14
|
+
| Role / Skill | Purpose | Required | Evidence |
|
|
15
|
+
|---|---|---|---|
|
|
16
|
+
| Coordinator | Scope, final judgment, integration | yes | plan/state/evidence |
|
|
17
|
+
| Code Locator | Files, symbols, existing tests | when code changes | search/LSP notes |
|
|
18
|
+
| Builder | Bounded implementation | when files change | diff + focused check |
|
|
19
|
+
| QA / Verification | Focused proof | yes | command/browser/API smoke |
|
|
20
|
+
| Reviewer | Spec, quality, architecture, security | risk-based | review notes |
|
|
21
|
+
|
|
22
|
+
## Tool Routing
|
|
23
|
+
|
|
24
|
+
| Tool | Use When | Status | Fallback |
|
|
25
|
+
|---|---|---|---|
|
|
26
|
+
| rg / rg --files | Code and doc location | recommended | shell listing |
|
|
27
|
+
| LSP / index | Large or typed codebase | unknown | rg + existing tests |
|
|
28
|
+
| Browser / Playwright | UI or user-visible flow | unknown | component/API smoke plus notes |
|
|
29
|
+
| OpenSpec | Capability/API/state contract change | optional | .gse/changes/ markdown |
|
|
30
|
+
| Comet | Full lifecycle change | optional | GSE phase/status files |
|
|
31
|
+
| Superpowers | Complex staged execution/review | optional | GSE roles + quality gates |
|
|
32
|
+
| Subagents | Parallel bounded work | unknown | sequential role execution |
|
|
33
|
+
|
|
34
|
+
## Quality Gates Selected
|
|
35
|
+
|
|
36
|
+
```text
|
|
37
|
+
Universal:
|
|
38
|
+
Code:
|
|
39
|
+
UI:
|
|
40
|
+
API/state:
|
|
41
|
+
Security/privacy:
|
|
42
|
+
Performance/cost:
|
|
43
|
+
Resilience/recovery:
|
|
44
|
+
Release/operations:
|
|
45
|
+
```
|
|
46
|
+
|
|
47
|
+
## Evidence Plan
|
|
48
|
+
|
|
49
|
+
```text
|
|
50
|
+
Focused command:
|
|
51
|
+
Browser/API smoke:
|
|
52
|
+
Manual inspection:
|
|
53
|
+
Not run and why:
|
|
54
|
+
Evidence status: result | verified | accepted | not ready
|
|
55
|
+
```
|
|
56
|
+
|
|
57
|
+
## Review And Closure
|
|
58
|
+
|
|
59
|
+
- Spec compliance:
|
|
60
|
+
- Code quality:
|
|
61
|
+
- Architecture/ownership:
|
|
62
|
+
- Residual risk:
|
|
63
|
+
- Close gate command:
|
|
64
|
+
- Next action:
|
|
65
|
+
|
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
# Goal Map
|
|
2
|
+
|
|
3
|
+
Updated: YYYY-MM-DD
|
|
4
|
+
|
|
5
|
+
## North Star
|
|
6
|
+
|
|
7
|
+
## Current Focus
|
|
8
|
+
|
|
9
|
+
- Priority:
|
|
10
|
+
- Active slice:
|
|
11
|
+
- Next action:
|
|
12
|
+
|
|
13
|
+
## Goal Nodes
|
|
14
|
+
|
|
15
|
+
| ID | Goal | Status | Priority | Evidence | Next Slice |
|
|
16
|
+
|---|---|---|---|---|---|
|
|
17
|
+
|
|
18
|
+
## Risks
|
|
19
|
+
|
|
20
|
+
## Next 3 Slices
|
|
21
|
+
|
|
@@ -0,0 +1,48 @@
|
|
|
1
|
+
# Host Adapter
|
|
2
|
+
|
|
3
|
+
## Host
|
|
4
|
+
|
|
5
|
+
- Name:
|
|
6
|
+
- Adapter path:
|
|
7
|
+
- Maintainer:
|
|
8
|
+
- Last checked:
|
|
9
|
+
|
|
10
|
+
## Source Of Truth
|
|
11
|
+
|
|
12
|
+
Portable workflow source: `.gse/`
|
|
13
|
+
|
|
14
|
+
Read first:
|
|
15
|
+
|
|
16
|
+
1. `.gse/project-profile.md`
|
|
17
|
+
2. `.gse/goal-map.md`
|
|
18
|
+
3. `.gse/quality-gates.md`
|
|
19
|
+
4. Relevant `.gse/changes/` or `.gse/evidence/` files
|
|
20
|
+
|
|
21
|
+
## Verified Capabilities
|
|
22
|
+
|
|
23
|
+
| Capability | Command/config | Status | Evidence |
|
|
24
|
+
|---|---|---|---|
|
|
25
|
+
| Project rules | - | unknown | - |
|
|
26
|
+
| Skills/commands | - | unknown | - |
|
|
27
|
+
| Subagents | - | unknown | - |
|
|
28
|
+
| MCP/tools | - | unknown | - |
|
|
29
|
+
| LSP/index | - | unknown | - |
|
|
30
|
+
| Browser/UI verification | - | unknown | - |
|
|
31
|
+
| CI/build/test | - | unknown | - |
|
|
32
|
+
|
|
33
|
+
## Host-Specific Start
|
|
34
|
+
|
|
35
|
+
Describe the shortest host-specific instruction that makes this host read `.gse/` first.
|
|
36
|
+
|
|
37
|
+
## Safety And Permissions
|
|
38
|
+
|
|
39
|
+
- Secrets:
|
|
40
|
+
- Write-capable tools:
|
|
41
|
+
- Destructive commands:
|
|
42
|
+
- Network/external services:
|
|
43
|
+
|
|
44
|
+
## Drift Check
|
|
45
|
+
|
|
46
|
+
- Check cadence:
|
|
47
|
+
- What must stay in `.gse/`:
|
|
48
|
+
- What may stay host-specific:
|