@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 +1 -1
- package/skills/simpleapps/basecamp/SKILL.md +1 -1
- package/skills/simpleapps/deployment/SKILL.md +1 -1
- package/skills/simpleapps/git-safety/SKILL.md +6 -0
- package/skills/simpleapps/project-defaults/SKILL.md +18 -15
- package/skills/simpleapps/quality/SKILL.md +2 -4
- package/skills/simpleapps/wiki/SKILL.md +2 -2
- package/skills/simpleapps/work-habits/SKILL.md +10 -2
- package/skills/simpleapps/writing-style/SKILL.md +6 -0
package/package.json
CHANGED
|
@@ -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
|
|
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
|
|
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(
|
|
161
|
+
"Bash(awk:*)",
|
|
161
162
|
"Bash(cat:*)",
|
|
162
|
-
"Bash(
|
|
163
|
+
"Bash(cd:*)",
|
|
164
|
+
"Bash(find:*)",
|
|
165
|
+
"Bash(for:*)",
|
|
163
166
|
"Bash(grep:*)",
|
|
164
|
-
"Bash(
|
|
167
|
+
"Bash(head:*)",
|
|
165
168
|
"Bash(kill:*)",
|
|
166
169
|
"Bash(pkill:*)",
|
|
167
|
-
"Bash(
|
|
168
|
-
"Bash(
|
|
169
|
-
"Bash(
|
|
170
|
-
"Bash(
|
|
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
|
-
- **`
|
|
181
|
+
- **`awk`** — Use the Edit tool instead.
|
|
180
182
|
- **`cat`** — Use the Read tool instead.
|
|
181
|
-
- **`
|
|
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
|
-
- **`
|
|
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
|
-
- **`
|
|
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
|
|
58
|
+
## Own every issue
|
|
59
59
|
|
|
60
|
-
Fix every issue
|
|
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
|
|
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
|
|
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
|
-
|
|
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
|
|
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.
|