@simpleapps-com/augur-skills 2026.3.30 → 2026.4.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.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@simpleapps-com/augur-skills",
3
- "version": "2026.03.30",
3
+ "version": "2026.04.2",
4
4
  "description": "Install curated Claude Code skills",
5
5
  "license": "MIT",
6
6
  "type": "module",
@@ -13,7 +13,7 @@ allowed-tools:
13
13
 
14
14
  IMPORTANT: MUST NOT create, edit, or delete anything in Basecamp without user permission.
15
15
 
16
- **Content format**: All write tools SHOULD use plain text with line breaks, NOT HTML. Basecamp returns HTML in responses but prefers plain text for creation.
16
+ **Content format**: All write tools MUST use plain text with line breaks, NOT HTML. Basecamp returns HTML in responses but prefers plain text for creation.
17
17
 
18
18
  ## Setup
19
19
 
@@ -20,7 +20,7 @@ This skill reads the project's `wiki/Deployment.md` and executes the steps defin
20
20
 
21
21
  ## Deployment Page Format
22
22
 
23
- Every project wiki SHOULD have a `Deployment.md` page with up to three sections:
23
+ Every project wiki MUST have a `Deployment.md` page with up to three sections:
24
24
 
25
25
  ```
26
26
  ## Submit
@@ -43,6 +43,12 @@ If you made changes and the user then runs `/submit`, the command starts fresh
43
43
 
44
44
  Do NOT ask for redundant confirmation inside `/submit` if the user just invoked it. The invocation is the approval. But each discrete git operation within the flow (commit, then push) should still be reported before execution.
45
45
 
46
+ ## Stash hygiene
47
+
48
+ MUST NOT leave stashes behind. If you stash changes (e.g., to switch branches), you MUST pop or drop the stash before the operation is complete. Orphaned stashes accumulate silently and confuse future work.
49
+
50
+ Better yet, avoid stashing entirely. If you need to create a branch from a different base, commit or stage work first, or create the branch before making changes. Stash is a last resort, not a workflow step.
51
+
46
52
  ## The Pattern
47
53
 
48
54
  **Do the work → report results → wait.**
@@ -139,7 +139,8 @@ Every project SHOULD configure `.claude/settings.local.json` with these deny rul
139
139
  {
140
140
  "env": {
141
141
  "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1",
142
- "CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY": "1"
142
+ "CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY": "1",
143
+ "CLAUDE_CODE_NO_FLICKER": "1"
143
144
  },
144
145
  "permissions": {
145
146
  "allow": [
@@ -157,18 +158,19 @@ Every project SHOULD configure `.claude/settings.local.json` with these deny rul
157
158
  "mcp__plugin_simpleapps_augur-api__*"
158
159
  ],
159
160
  "deny": [
160
- "Bash(cd:*)",
161
+ "Bash(awk:*)",
161
162
  "Bash(cat:*)",
162
- "Bash(sed:*)",
163
+ "Bash(cd:*)",
164
+ "Bash(find:*)",
165
+ "Bash(for:*)",
163
166
  "Bash(grep:*)",
164
- "Bash(sleep:*)",
167
+ "Bash(head:*)",
165
168
  "Bash(kill:*)",
166
169
  "Bash(pkill:*)",
167
- "Bash(find:*)",
168
- "Bash(head:*)",
169
- "Bash(tail:*)",
170
- "Bash(awk:*)",
171
- "Bash(rg:*)"
170
+ "Bash(rg:*)",
171
+ "Bash(sed:*)",
172
+ "Bash(sleep:*)",
173
+ "Bash(tail:*)"
172
174
  ]
173
175
  }
174
176
  }
@@ -176,16 +178,17 @@ Every project SHOULD configure `.claude/settings.local.json` with these deny rul
176
178
 
177
179
  Why each is denied:
178
180
 
179
- - **`cd`** — MUST NOT use in any Bash command, including compound commands (`cd /path && git`). Use `git -C repo` for git, path arguments for everything else. Compound cd+git commands trigger an unblockable Claude Code security prompt that interrupts the user even when `cd` is denied.
181
+ - **`awk`** — Use the Edit tool instead.
180
182
  - **`cat`** — Use the Read tool instead.
181
- - **`sed`** — Use the Edit tool instead.
182
- - **`grep`** — Use the Grep tool instead.
183
- - **`sleep`** — Unnecessary; use proper sequencing or background tasks.
183
+ - **`cd`** — MUST NOT use in any Bash command, including compound commands (`cd /path && git`). Use `git -C repo` for git, path arguments for everything else. Compound cd+git commands trigger an unblockable Claude Code security prompt that interrupts the user even when `cd` is denied.
184
184
  - **`find`** — Use the Glob tool instead.
185
+ - **`for`** — Shell loops are unnecessary; use dedicated tools or make multiple tool calls instead.
186
+ - **`grep`** — Use the Grep tool instead.
185
187
  - **`head`/`tail`** — Use the Read tool with `offset` and `limit` parameters instead.
186
- - **`awk`** — Use the Edit tool instead.
188
+ - **`kill`/`pkill`** — Use `TaskStop` to manage background processes. `TaskStop` cleanly shuts down the task and updates Claude Code's internal tracking.
187
189
  - **`rg`** — Use the Grep tool instead (it uses ripgrep internally).
188
- - **`kill`/`pkill`** — Use `TaskStop` to manage background processes. For internal tasks running in the background (dev servers, watchers, etc.), always use `TaskStop` instead of shell kill commands. `TaskStop` cleanly shuts down the task and updates Claude Code's internal tracking.
190
+ - **`sed`** — Use the Edit tool instead.
191
+ - **`sleep`** — Unnecessary; use proper sequencing or background tasks.
189
192
 
190
193
  ## Bin Scripts (PATH)
191
194
 
@@ -55,11 +55,9 @@ Do not install or configure tools without the user's approval. Flag what's missi
55
55
  - **No tests for changed code** — suggest vitest
56
56
  - **No pre-commit hooks** — suggest lefthook
57
57
 
58
- ## Own your scope
58
+ ## Own every issue
59
59
 
60
- Fix every issue in files you touched during this session. Context compaction erases your memory of earlier changes what looks pre-existing may be something you introduced. Err on the side of owning it.
61
-
62
- For failures in files you did not touch, report them as separate findings rather than fixing them inline. Fixing unrelated code is local optimization that delays shipping the actual task. The goal is zero issues in the work area, not unbounded cleanup of the entire codebase.
60
+ Fix every issue the checks find, regardless of which file it is in or who introduced it. There is no such thing as a "pre-existing issue" — context compaction erases your memory of earlier changes, so what looks pre-existing may be something you introduced. Even if you truly did not cause it, the goal is zero issues, not blame assignment. Fix it anyway.
63
61
 
64
62
  ## Resolve, never hide
65
63
 
@@ -126,11 +126,11 @@ The wikis are kept fresh by `/curate-wiki` runs across projects. Searching local
126
126
 
127
127
  ## Deployment Page
128
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.
129
+ Every project wiki MUST 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
130
 
131
131
  ## Testing Page
132
132
 
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.
133
+ Every project wiki MUST 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` MUST add testing knowledge learned during the session (new edge cases, failure patterns, test data) to the Testing page.
134
134
 
135
135
  A good Testing page covers: test tiers (automated vs manual), test data (items, accounts, cards), and an E2E checklist organized by page area (homepage, listing, detail, cart, checkout, etc.). Each checklist item is a concrete, verifiable condition — not vague ("works") but specific ("price shows $9.26").
136
136
 
@@ -38,7 +38,13 @@ When debugging in the browser, MUST check for error overlays (red error pill/bad
38
38
 
39
39
  ## Verify your own work
40
40
 
41
- Run tests, check output, compare results. YOU MUST NOT mark work complete without verification. If you can't verify, say so.
41
+ Code that compiles is not code that works. After making changes, verify they actually work:
42
+
43
+ 1. Run tests (`pnpm test` or equivalent)
44
+ 2. If the project has a Testing page in the wiki, suggest `/verify` to walk through the E2E checklist in the browser
45
+ 3. If you changed UI, check it visually — load the page in Chrome and confirm it looks right
46
+
47
+ YOU MUST NOT mark work complete without verification. Suggesting `/submit` or `/quality` before verifying the code works is backwards — broken code that passes lint is still broken code. Verify first, then let the user decide next steps.
42
48
 
43
49
  ## Own every issue you find
44
50
 
@@ -50,7 +56,9 @@ Use TodoRead/TodoWrite on multi-step tasks. Mark items in-progress before starti
50
56
 
51
57
  ## Never prompt for git actions
52
58
 
53
- MUST NOT ask "want me to commit?", "should I submit?", or any variation after completing work. The user will say "commit", `/submit`, or equivalent when ready. During multi-step implementation, asking to commit between steps interrupts the flow and adds noise. Report what was done and stop.
59
+ MUST NOT ask "want me to commit?", "should I submit?", "ready for a PR?", "want me to push?", or ANY variation after completing work. Do not hint at it either — "if you're happy with this, you can run /submit" is the same thing with extra words. The user knows their own workflow. They will say "commit", `/submit`, or equivalent when they are ready.
60
+
61
+ After completing work: report what changed, suggest `/verify` if untested, then stop. That is the entire post-work protocol. No git prompts. No shipping suggestions.
54
62
 
55
63
  ## Know when to stop and ask
56
64
 
@@ -60,6 +60,12 @@ Every token costs time, money, and cognitive load. Be concise without losing cla
60
60
 
61
61
  Default to brief. Expand only when the reader cannot infer meaning from context. Two sentences that answer the question beat two pages that fill the context window.
62
62
 
63
+ ## List Ordering
64
+
65
+ Lists with no inherent order (deny rules, config arrays, feature lists, bullet-point explanations) MUST be sorted alphabetically. Alphabetical order makes items easier to find and minimizes git diffs — new entries slot into a predictable position instead of appending at the end.
66
+
67
+ Applies to JSON arrays, markdown bullet lists, table rows, and any unordered collection.
68
+
63
69
  ## Code Style
64
70
 
65
71
  Use descriptive variable and function names. Abbreviations save keystrokes but cost readability — the human reviewing your output MUST be able to understand the code without deciphering names.