@simpleapps-com/augur-skills 2026.3.18 → 2026.3.19
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/package.json
CHANGED
|
@@ -0,0 +1,62 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: deployment
|
|
3
|
+
description: Project deployment conventions — reads the wiki Deployment page and executes submit, deploy, or publish steps. Refuses to operate without a Deployment page.
|
|
4
|
+
user-invocable: false
|
|
5
|
+
allowed-tools:
|
|
6
|
+
- Read
|
|
7
|
+
- Glob
|
|
8
|
+
- Grep
|
|
9
|
+
- Bash
|
|
10
|
+
- Skill(git-safety)
|
|
11
|
+
- Skill(conventional-commits)
|
|
12
|
+
- Skill(github)
|
|
13
|
+
---
|
|
14
|
+
|
|
15
|
+
First, use Skill("git-safety") to load git guardrails.
|
|
16
|
+
|
|
17
|
+
# Deployment
|
|
18
|
+
|
|
19
|
+
This skill reads the project's `wiki/Deployment.md` and executes the steps defined there. Each project defines its own deployment workflow — this skill is the executor, the wiki is the config.
|
|
20
|
+
|
|
21
|
+
## Deployment Page Format
|
|
22
|
+
|
|
23
|
+
Every project wiki SHOULD have a `Deployment.md` page with up to three sections:
|
|
24
|
+
|
|
25
|
+
```
|
|
26
|
+
## Submit
|
|
27
|
+
How to commit and create a PR for review.
|
|
28
|
+
|
|
29
|
+
## Deploy
|
|
30
|
+
How to deploy to staging.
|
|
31
|
+
|
|
32
|
+
## Publish
|
|
33
|
+
How to release to production.
|
|
34
|
+
```
|
|
35
|
+
|
|
36
|
+
Not all projects need all three. Client sites may only have Submit and Deploy. Package repos may have all three.
|
|
37
|
+
|
|
38
|
+
## How It Works
|
|
39
|
+
|
|
40
|
+
1. Read `wiki/Deployment.md`
|
|
41
|
+
2. Find the section matching the requested action (Submit, Deploy, or Publish)
|
|
42
|
+
3. If the page or section is missing, **refuse to operate** — tell the user to run `/curate-wiki` to generate it
|
|
43
|
+
4. Execute the steps in that section, respecting git-safety at every git write operation
|
|
44
|
+
|
|
45
|
+
## Guard Rails
|
|
46
|
+
|
|
47
|
+
- MUST NOT guess deployment steps — only execute what the wiki defines
|
|
48
|
+
- MUST NOT operate if the Deployment page is missing or the relevant section is absent
|
|
49
|
+
- MUST load git-safety — every git write operation requires user approval
|
|
50
|
+
- `/publish` MUST complete the verification gate before executing (see below)
|
|
51
|
+
|
|
52
|
+
## Publish Verification Gate
|
|
53
|
+
|
|
54
|
+
Before executing any Publish steps, MUST:
|
|
55
|
+
|
|
56
|
+
1. Show the **current version** and the **proposed new version**
|
|
57
|
+
2. Show **what changes** are included since the last release (`git log` from last tag)
|
|
58
|
+
3. Show **CI/test status** if available (`gh run list` or local test run)
|
|
59
|
+
4. Present a summary: version transition, commit count, test status
|
|
60
|
+
5. Require the user to **explicitly confirm** the specific version going to production
|
|
61
|
+
|
|
62
|
+
This is not just git-safety. It is an active verification checklist — the user MUST see exactly what they are releasing and confirm that specific version.
|
|
@@ -124,6 +124,10 @@ The wikis are kept fresh by `/curate-wiki` runs across projects. Searching local
|
|
|
124
124
|
|
|
125
125
|
**What to search for:** testing patterns and checklists, architecture decisions, coding conventions, deployment procedures, and how specific features were implemented. Other sites have already solved many of the same problems — search before building from scratch.
|
|
126
126
|
|
|
127
|
+
## Deployment Page
|
|
128
|
+
|
|
129
|
+
Every project wiki SHOULD have a `Deployment.md` page with up to three sections: Submit, Deploy, and Publish. This page defines the project-specific steps that `/submit`, `/deploy`, and `/publish` commands execute. Run `/curate-wiki` to generate it from the codebase — the command scans CI workflows, package.json, deploy scripts, and asks the user about anything it cannot determine. See the `deployment` skill for the expected format.
|
|
130
|
+
|
|
127
131
|
## Testing Page
|
|
128
132
|
|
|
129
133
|
Every project wiki SHOULD have a `Testing.md` page. This is the E2E verification checklist that `/verify` uses to walk through the site in Chrome. The page grows over time — `/curate-wiki` SHOULD add testing knowledge learned during the session (new edge cases, failure patterns, test data) to the Testing page.
|
|
@@ -69,7 +69,7 @@ gh issue create --repo simpleapps-com/<repo> \
|
|
|
69
69
|
The full workflow from task to delivery, each step feeding the next:
|
|
70
70
|
|
|
71
71
|
```
|
|
72
|
-
/triage → /wip → /investigate → /discuss → /implement → /quality → /verify → /
|
|
72
|
+
/triage → /wip → /investigate → /discuss → /implement → /quality → /verify → /submit → /deploy → /publish
|
|
73
73
|
```
|
|
74
74
|
|
|
75
75
|
| Phase | Command | What happens |
|
|
@@ -81,9 +81,13 @@ The full workflow from task to delivery, each step feeding the next:
|
|
|
81
81
|
| Build | `/implement` | Execute the plan — code changes only, no commits |
|
|
82
82
|
| Code checks | `/quality` | Lint, typecheck, test, package freshness |
|
|
83
83
|
| Browser checks | `/verify` | Walk through wiki's Testing.md checklist in Chrome |
|
|
84
|
-
|
|
|
84
|
+
| Submit | `/submit` | Commit and create a PR for review |
|
|
85
|
+
| Stage | `/deploy` | Deploy to staging (merge PRs, trigger staging build) |
|
|
86
|
+
| Release | `/publish` | Version bump, tag, release to production (with verification) |
|
|
85
87
|
|
|
86
|
-
|
|
88
|
+
Not every task uses all steps. Most daily work ends at `/submit`. `/deploy` and `/publish` are used less frequently — `/publish` is intentionally rare and requires explicit verification of the exact version going to production.
|
|
89
|
+
|
|
90
|
+
The three shipping commands (`/submit`, `/deploy`, `/publish`) read project-specific steps from `wiki/Deployment.md`. They refuse to operate if the Deployment page is missing — run `/curate-wiki` to generate it from the codebase.
|
|
87
91
|
|
|
88
92
|
Commands like `/research` and `/discuss` can be used at any stage. `/quality`, `/verify`, `/curate-wiki`, and `/wiki-audit` can run independently.
|
|
89
93
|
|