@simpleapps-com/augur-skills 2026.3.12 → 2026.3.13
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
|
@@ -70,10 +70,14 @@ The augur packages exist to share common code across ALL Node projects. When you
|
|
|
70
70
|
|
|
71
71
|
The goal is to grow the packages over time so sites write less custom code.
|
|
72
72
|
|
|
73
|
+
## augur-doctor
|
|
74
|
+
|
|
75
|
+
`augur-doctor` ships with `@simpleapps-com/augur-config`. It checks version alignment, latest versions, and platform standard conformance. Run via `pnpm augur-doctor .` from the site directory — pre-approved, no permission prompt. For full documentation, see the augur-packages wiki page `guide-site-assessment.md` (use the cross-project wiki path from `simpleapps:wiki`).
|
|
76
|
+
|
|
73
77
|
## Platform Standards
|
|
74
78
|
|
|
75
79
|
- **Icons:** `react-icons/lu`
|
|
76
80
|
- **Tailwind:** v4, CSS-first
|
|
77
81
|
- **Validation:** Valibot (not Zod, not Yup)
|
|
78
82
|
- **Auth:** NextAuth 5 via package auth factory
|
|
79
|
-
- **Reference site:**
|
|
83
|
+
- **Reference site:** Ask the user which site to reference. Use `Grep`, `Glob`, and `Read` with the project path (see `simpleapps:project-defaults` for layout). MUST NOT use `find`, `grep`, or other shell commands.
|
|
@@ -17,8 +17,8 @@ MUST run each Bash command as a separate, simple call. MUST NOT chain commands w
|
|
|
17
17
|
Wrong: `git -C repo status && pnpm typecheck && pnpm test`
|
|
18
18
|
Right: Three separate Bash calls, one per command.
|
|
19
19
|
|
|
20
|
-
Wrong: `pnpm --filter
|
|
21
|
-
Right: `pnpm --filter
|
|
20
|
+
Wrong: `pnpm --filter <site> run typecheck 2>&1; echo "EXIT: $?"`
|
|
21
|
+
Right: `pnpm --filter <site> run typecheck` — the Bash tool already captures stderr and exit codes. Never add `2>&1`, `; echo $?`, or other shell plumbing — it triggers permission prompts for no benefit.
|
|
22
22
|
|
|
23
23
|
Wrong: `gh issue close 367 --repo org/repo --comment "$(< tmp/file.txt)" 2>&1`
|
|
24
24
|
Right: Write the comment to a tmp file, then use two separate calls:
|
|
@@ -48,13 +48,13 @@ MUST NOT use `node -e` or `python -c` to run inline scripts — these trigger pe
|
|
|
48
48
|
|
|
49
49
|
## Cross-Project Searching
|
|
50
50
|
|
|
51
|
-
When looking at another project's code
|
|
51
|
+
When looking at another project's code, use dedicated tools with the project path — MUST NOT use shell commands:
|
|
52
52
|
|
|
53
|
-
Wrong: `find
|
|
54
|
-
Right: `Grep(pattern: "pattern", path: "
|
|
53
|
+
Wrong: `find {path}/repo -name "*.ts" -exec grep -l "pattern" {} \; 2>/dev/null | head -10`
|
|
54
|
+
Right: `Grep(pattern: "pattern", path: "{path}/repo", glob: "*.ts")`
|
|
55
55
|
|
|
56
|
-
Wrong: `ls
|
|
57
|
-
Right: `Glob(pattern: "
|
|
56
|
+
Wrong: `ls {path}/repo/src/components/`
|
|
57
|
+
Right: `Glob(pattern: "{path}/repo/src/components/**/*")`
|
|
58
58
|
|
|
59
59
|
All project paths are known and predictable (see `simpleapps:wiki` Cross-Project Wiki Access). MUST NOT search the filesystem with `find` or download from the internet — just use the dedicated tool with the known path.
|
|
60
60
|
|
|
@@ -122,7 +122,7 @@ Target repos:
|
|
|
122
122
|
| Shared frontend packages | `simpleapps-com/augur-packages` |
|
|
123
123
|
| TypeScript API SDK | `simpleapps-com/augur-api` |
|
|
124
124
|
|
|
125
|
-
Example cross-link in issue body: `Upstream: simpleapps-com/augur#44` or `Local impact: simpleapps-com
|
|
125
|
+
Example cross-link in issue body: `Upstream: simpleapps-com/augur#44` or `Local impact: simpleapps-com/<site>#3`
|
|
126
126
|
|
|
127
127
|
## Pull Requests
|
|
128
128
|
|
|
@@ -15,12 +15,9 @@ All projects live under `~/projects/` in two groups:
|
|
|
15
15
|
```
|
|
16
16
|
~/projects/
|
|
17
17
|
├── simpleapps/ # Internal repos (augur-*, shared infra)
|
|
18
|
-
│
|
|
19
|
-
│ ├── augur-packages/
|
|
20
|
-
│ └── augur/
|
|
18
|
+
│ └── <repo-name>/
|
|
21
19
|
└── clients/ # Client site repos
|
|
22
|
-
|
|
23
|
-
└── directsupplyinc/
|
|
20
|
+
└── <site-name>/
|
|
24
21
|
```
|
|
25
22
|
|
|
26
23
|
- Internal repos go in `~/projects/simpleapps/`
|
|
@@ -90,27 +90,15 @@ If in doubt, it belongs in the wiki. The cost of putting shared knowledge in mem
|
|
|
90
90
|
|
|
91
91
|
## Cross-Project Wiki Access
|
|
92
92
|
|
|
93
|
-
All
|
|
94
|
-
|
|
95
|
-
| Project type | Wiki path |
|
|
96
|
-
|-------------|-----------|
|
|
97
|
-
| Client sites | `~/projects/clients/<site-name>/wiki/` |
|
|
98
|
-
| Internal repos | `~/projects/simpleapps/<repo-name>/wiki/` |
|
|
99
|
-
|
|
100
|
-
**Reference site:** `~/projects/clients/ampro-online/` is the reference implementation. When you need to see how something was done, check its wiki and repo first.
|
|
101
|
-
|
|
102
|
-
**Key wikis to consult:**
|
|
103
|
-
- `~/projects/simpleapps/augur-packages/wiki/` — shared package conventions, API surfaces, component patterns
|
|
104
|
-
- `~/projects/simpleapps/augur-skills/wiki/` — plugin and skill authoring conventions
|
|
105
|
-
- `~/projects/clients/ampro-online/wiki/` — reference site patterns, real-world usage examples
|
|
93
|
+
All projects follow the same directory layout (see `simpleapps:project-defaults`). Every project's wiki is at a predictable path relative to the project root: `{project}/wiki/`. When the user asks you to check another project's wiki or code, use the project-defaults layout to find it.
|
|
106
94
|
|
|
107
95
|
**Before reading another project's wiki, pull the latest:**
|
|
108
|
-
`git -C
|
|
96
|
+
`git -C {path-to-project}/wiki pull`
|
|
109
97
|
|
|
110
98
|
**MUST use dedicated tools for cross-project access — MUST NOT use shell commands:**
|
|
111
|
-
- Read files: `Read("
|
|
112
|
-
- Search code: `Grep(pattern: "...", path: "
|
|
113
|
-
- Find files: `Glob(pattern: "
|
|
99
|
+
- Read files: `Read("{path-to-project}/wiki/Page.md")`
|
|
100
|
+
- Search code: `Grep(pattern: "...", path: "{path-to-project}/repo")`
|
|
101
|
+
- Find files: `Glob(pattern: "{path-to-project}/repo/**/*.ts")`
|
|
114
102
|
|
|
115
103
|
MUST NOT use `find`, `grep`, `cat`, `ls`, or any shell command to explore other projects. The paths are known — use the dedicated tools directly.
|
|
116
104
|
|