@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
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@simpleapps-com/augur-skills",
3
- "version": "2026.03.18",
3
+ "version": "2026.03.19",
4
4
  "description": "Install curated Claude Code skills",
5
5
  "license": "MIT",
6
6
  "type": "module",
@@ -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 → /curate-wiki
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
- | Capture | `/curate-wiki` | Update wiki with session learnings, audit CLAUDE.md/rules |
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
- **Key principle:** each session generates knowledge. `/curate-wiki` captures it including new testing patterns, edge cases, and failure modes discovered during `/implement` and `/verify`. This grows the wiki's Testing.md page over time, making future `/verify` runs more thorough. This is the learning organization in action.
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