@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.
- package/package.json +1 -1
- package/skills/simpleapps/augur-packages/SKILL.md +163 -0
- package/skills/simpleapps/{workflow/basecamp.md → basecamp/SKILL.md} +17 -14
- package/skills/simpleapps/fyxer/SKILL.md +120 -6
- package/skills/simpleapps/github/SKILL.md +64 -21
- package/skills/simpleapps/project-defaults/SKILL.md +91 -0
- package/skills/simpleapps/wiki/SKILL.md +74 -0
- package/skills/simpleapps/workflow/SKILL.md +33 -5
- package/skills/simpleapps/.gitkeep +0 -0
- package/skills/simpleapps/fyxer/basecamp-index.md +0 -110
- package/skills/simpleapps/fyxer/basecamp.md +0 -91
- package/skills/simpleapps/github/issues-prs.md +0 -89
- package/skills/simpleapps/github/project-structure.md +0 -146
- package/skills/simpleapps/github/wiki-as-context.md +0 -161
- package/skills/simpleapps/github/wiki-maintenance.md +0 -71
- package/skills/simpleapps/workflow/github.md +0 -34
|
@@ -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
|