@simpleapps-com/augur-skills 2026.3.15 → 2026.3.16
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
|
@@ -16,12 +16,15 @@ All projects live under `~/projects/` in two groups:
|
|
|
16
16
|
~/projects/
|
|
17
17
|
├── simpleapps/ # Internal repos (augur-*, shared infra)
|
|
18
18
|
│ └── <repo-name>/
|
|
19
|
-
|
|
20
|
-
|
|
19
|
+
├── clients/ # Client site repos
|
|
20
|
+
│ └── <site-name>/
|
|
21
|
+
└── workspaces/ # VSCode/Cursor workspace files
|
|
22
|
+
└── <project-name>.code-workspace
|
|
21
23
|
```
|
|
22
24
|
|
|
23
25
|
- Internal repos go in `~/projects/simpleapps/`
|
|
24
26
|
- Client site repos go in `~/projects/clients/`
|
|
27
|
+
- Workspace files go in `~/projects/workspaces/` — one `.code-workspace` per project
|
|
25
28
|
|
|
26
29
|
## Project Directory Layout
|
|
27
30
|
|
|
@@ -36,7 +39,7 @@ Every project MUST use this layout:
|
|
|
36
39
|
├── wiki/ # Wiki repo (simpleapps-com/<name>.wiki.git)
|
|
37
40
|
├── wip/ # Work-in-progress files (not in git)
|
|
38
41
|
├── tmp/ # Temporary files (not in git)
|
|
39
|
-
└── .simpleapps/ #
|
|
42
|
+
└── .simpleapps/ # Config, credentials, site profile (not in git)
|
|
40
43
|
```
|
|
41
44
|
|
|
42
45
|
The parent `{project}/` is NOT a git repo — it keeps code and wiki side-by-side. The git repo is always at `repo/`. Use `git -C repo` for git operations from the project root.
|
|
@@ -49,17 +52,70 @@ The parent `{project}/` is NOT a git repo — it keeps code and wiki side-by-sid
|
|
|
49
52
|
| Repo `.claude/CLAUDE.md` | `repo/` | Quick reference + wiki links |
|
|
50
53
|
| Active task context | `wip/` | `{issue-number}-{short-desc}.md` files |
|
|
51
54
|
| Temporary files | `tmp/` | Throwaway files, scratch space, build artifacts |
|
|
52
|
-
|
|
|
53
|
-
| Global secrets | `~/.simpleapps/` | Shared credentials across all projects |
|
|
55
|
+
| SimpleApps config | `.simpleapps/` | Settings, site profile, credentials (see below) |
|
|
54
56
|
|
|
55
57
|
**WIP**: Research, plans, decisions, test results. MUST NOT contain secrets, final docs, or code.
|
|
56
58
|
|
|
57
|
-
**Credentials**: Project-level (`.simpleapps/`) overrides user-level (`~/.simpleapps/`). MUST NOT be committed.
|
|
58
|
-
|
|
59
59
|
## Plugin Rules
|
|
60
60
|
|
|
61
61
|
The plugin ships rule templates in `plugins/simpleapps/rules/` that MUST exist in every project's `repo/.claude/rules/`. Rules are always loaded into context — they enforce baseline guardrails (like git safety) without depending on a skill being invoked. The `/project-init` command copies missing rules from the plugin into the project.
|
|
62
62
|
|
|
63
|
+
## .simpleapps/ Configuration
|
|
64
|
+
|
|
65
|
+
Two scopes, project overrides user:
|
|
66
|
+
|
|
67
|
+
```
|
|
68
|
+
~/.simpleapps/ # User global
|
|
69
|
+
├── settings.json # Config (projectRoot, orgName)
|
|
70
|
+
├── basecamp.json # Basecamp MCP credentials
|
|
71
|
+
└── augur-api.json # Augur API MCP credentials
|
|
72
|
+
|
|
73
|
+
{project}/.simpleapps/ # Project (gitignored)
|
|
74
|
+
├── settings.json # Project config overrides
|
|
75
|
+
├── site.json # Site profile (defaults, PII, auth)
|
|
76
|
+
├── basecamp.json # Project basecamp overrides (if needed)
|
|
77
|
+
└── augur-api.json # Project augur-api overrides (if needed)
|
|
78
|
+
```
|
|
79
|
+
|
|
80
|
+
### File types
|
|
81
|
+
|
|
82
|
+
| File | Scope | Purpose | Read by |
|
|
83
|
+
|------|-------|---------|---------|
|
|
84
|
+
| `settings.json` | Global + project | Infrastructure config | All skills via project-defaults |
|
|
85
|
+
| `site.json` | Project only | Site profile — defaults, search terms, PII, auth | Skills needing site context |
|
|
86
|
+
| `basecamp.json` | Global + project | Basecamp MCP credentials | Basecamp MCP server |
|
|
87
|
+
| `augur-api.json` | Global + project | Augur API MCP credentials | Augur API MCP server |
|
|
88
|
+
|
|
89
|
+
### settings.json
|
|
90
|
+
|
|
91
|
+
```json
|
|
92
|
+
{
|
|
93
|
+
"projectRoot": "~/projects"
|
|
94
|
+
}
|
|
95
|
+
```
|
|
96
|
+
|
|
97
|
+
Resolution: read `{project}/.simpleapps/settings.json` first, fall back to `~/.simpleapps/settings.json`, fall back to defaults. Field-level override — project wins for any field it defines.
|
|
98
|
+
|
|
99
|
+
### site.json
|
|
100
|
+
|
|
101
|
+
One per client project. Consistent structure across all sites — same fields, different values. Replaces the old `{siteId}.json` pattern.
|
|
102
|
+
|
|
103
|
+
```json
|
|
104
|
+
{
|
|
105
|
+
"siteId": "...",
|
|
106
|
+
"siteName": "...",
|
|
107
|
+
"auth": { },
|
|
108
|
+
"defaults": { }
|
|
109
|
+
}
|
|
110
|
+
```
|
|
111
|
+
|
|
112
|
+
### Rules
|
|
113
|
+
|
|
114
|
+
- MUST NOT commit `.simpleapps/` to git — contains PII and credentials
|
|
115
|
+
- MUST NOT save site data to wiki or memory — PII
|
|
116
|
+
- MUST NOT create `{siteId}.json` files — use `site.json` instead
|
|
117
|
+
- If old `{siteId}.json` files exist, `/project-init` will flag them for migration to `site.json`
|
|
118
|
+
|
|
63
119
|
## Symlink Setup
|
|
64
120
|
|
|
65
121
|
The repo contains `.claude/rules/` and `.claude/commands/` with project-specific rules and commands. To make these active from the project root (without starting Claude Code inside `repo/`), symlink them into the project-level `.claude/` folder:
|