@simpleapps-com/augur-skills 0.0.18 → 0.0.21

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.
@@ -1,71 +0,0 @@
1
- # Wiki Maintenance
2
-
3
- Guidance for agents editing wiki content. Applies to all `wiki/*.md` files across all projects.
4
-
5
- ## Verify Before You Write
6
-
7
- Cross-check wiki claims against the codebase before updating. Staleness-prone sections:
8
-
9
- - Package versions (`package.json` is the source of truth)
10
- - File counts and file inventories (files get added/deleted)
11
- - CI/CD workflow status (workflows get added/modified)
12
- - TODO items and "not yet built" markers (things get done)
13
- - Export lists and API surfaces (code changes)
14
-
15
- **Never echo what the wiki already says.** Read the code, then write the wiki.
16
-
17
- ## Patterns, Not Details
18
-
19
- The wiki documents **conventions and principles**. The code is the source of truth for specifics.
20
-
21
- - No hardcoded counts ("22 components", "14 hooks" — these change)
22
- - No exhaustive lists of every type, hook, component, or export by name
23
- - No pinned version numbers for peer dependencies
24
- - Instead: describe the pattern, give 1-2 examples, point to source code for the current list
25
-
26
- ## Naming Conventions
27
-
28
- Follow the project's existing convention:
29
-
30
- - **Site wikis**: PascalCase with hyphens (`Getting-Started.md`, `Architecture.md`)
31
- - **Package wikis**: Prefix-based sections (`guide-*.md` for users, `design-*.md` for contributors)
32
-
33
- Check `Home.md` or `_Sidebar.md` to confirm the convention before creating new pages.
34
-
35
- ## Keep Indexes Current
36
-
37
- When adding or removing pages, MUST update:
38
-
39
- - `Home.md` / `README.md` (index tables)
40
- - `_Sidebar.md` (navigation)
41
- - `llms.txt` (if present)
42
-
43
- ## Tagging for Lead-Site Wikis
44
-
45
- The lead site wiki (e.g., ampro-online) serves as both site documentation and platform reference. Tag sections:
46
-
47
- - **(platform pattern)** — guidance all sites SHOULD follow
48
- - **(site-specific)** — this site's particular values, replace with your own
49
-
50
- This tells agents working on other sites what to replicate vs customize.
51
-
52
- ## Dual-Audience Framing
53
-
54
- Lead site wikis serve two audiences:
55
-
56
- 1. Developers/agents working on **that site**
57
- 2. Developers/agents building or migrating **other sites**
58
-
59
- Write for both: document current reality AND provide guidance others can follow.
60
-
61
- ## Git Workflow
62
-
63
- The wiki is a separate git repo at `wiki/`. No branch protection, no PRs, no changesets.
64
-
65
- ```bash
66
- git -C wiki add -A
67
- git -C wiki commit -m "docs: describe the change"
68
- git -C wiki push
69
- ```
70
-
71
- Wiki repos typically use `master` as the default branch.
@@ -1,34 +0,0 @@
1
- # Basecamp → GitHub Cross-Linking
2
-
3
- When a client request in Basecamp needs development work, create a GitHub issue and cross-link them.
4
-
5
- ## Creating Issues from Basecamp Todos
6
-
7
- Before creating an issue, gather context from Basecamp (see `basecamp.md` for full MCP tool reference):
8
- 1. Use `get_todo` to read the Basecamp todo and summarize the client request
9
- 2. Use `list_documents` + `get_document` to find the project's **site-info** document for siteId and domain name. If no site-info document exists, ask the user to create one in Basecamp.
10
-
11
- See the `simpleapps:github` skill for `gh` CLI usage and org conventions.
12
-
13
- Issue template for Basecamp-linked issues:
14
-
15
- ```bash
16
- gh issue create --repo simpleapps-com/<repo> \
17
- --title "<brief technical title>" \
18
- --body "## Basecamp
19
- <basecamp_todo_url>
20
-
21
- ## Client
22
- <client/project name> — <domain> (siteId: <siteId>)
23
-
24
- ## Summary
25
- <technical summary of what needs to be done>
26
-
27
- ## Acceptance Criteria
28
- - [ ] <criteria from the Basecamp request>"
29
- ```
30
-
31
- ## Cross-Linking
32
-
33
- - Include the Basecamp todo URL in the GitHub issue body (under a `## Basecamp` heading)
34
- - After creating the issue, provide the GitHub issue URL to the user so they can add it to the Basecamp todo comments