@drunkcoding/agents-and-skills 0.0.44 → 0.0.46
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/.claude-plugin/marketplace.json +2 -47
- package/README.md +3 -6
- package/package.json +4 -1
- package/plugins/multica-tool/.claude-plugin/plugin.json +1 -1
- package/plugins/multica-tool/scripts/lib.mjs +53 -4
- package/plugins/multica-tool/scripts/multica-export.mjs +170 -50
- package/plugins/multica-tool/scripts/multica-import.mjs +209 -27
- package/plugins/multica-tool/skills/export/SKILL.md +91 -22
- package/plugins/multica-tool/skills/import/SKILL.md +24 -9
- package/plugins/multica-tool/skills/sync/SKILL.md +1 -1
- package/plugins/plugin-validator/.claude-plugin/plugin.json +1 -1
- package/plugins/html-effectiveness/.claude-plugin/plugin.json +0 -17
- package/plugins/html-effectiveness/README.md +0 -28
- package/plugins/html-effectiveness/agents/report-builder.md +0 -66
- package/plugins/html-effectiveness/assets/base.css +0 -51
- package/plugins/html-effectiveness/assets/base.js +0 -11
- package/plugins/html-effectiveness/assets/charts.js +0 -1
- package/plugins/html-effectiveness/assets/components.css +0 -10
- package/plugins/html-effectiveness/commands/html-report.md +0 -13
- package/plugins/html-effectiveness/docs/template-gallery.md +0 -28
- package/plugins/html-effectiveness/package.json +0 -6
- package/plugins/html-effectiveness/scripts/_tmp.js +0 -37
- package/plugins/html-effectiveness/scripts/catalog.js +0 -47
- package/plugins/html-effectiveness/scripts/extract.js +0 -104
- package/plugins/html-effectiveness/scripts/mustache.js +0 -90
- package/plugins/html-effectiveness/scripts/render.js +0 -176
- package/plugins/html-effectiveness/skills/html-effectiveness/SKILL.md +0 -94
- package/plugins/html-effectiveness/templates/01-exploration-code-approaches.html.tmpl +0 -400
- package/plugins/html-effectiveness/templates/02-exploration-visual-designs.html.tmpl +0 -456
- package/plugins/html-effectiveness/templates/03-code-review-pr.html.tmpl +0 -581
- package/plugins/html-effectiveness/templates/04-code-understanding.html.tmpl +0 -443
- package/plugins/html-effectiveness/templates/05-design-system.html.tmpl +0 -578
- package/plugins/html-effectiveness/templates/06-component-variants.html.tmpl +0 -557
- package/plugins/html-effectiveness/templates/07-prototype-animation.html.tmpl +0 -417
- package/plugins/html-effectiveness/templates/08-prototype-interaction.html.tmpl +0 -363
- package/plugins/html-effectiveness/templates/09-slide-deck.html.tmpl +0 -535
- package/plugins/html-effectiveness/templates/10-svg-illustrations.html.tmpl +0 -444
- package/plugins/html-effectiveness/templates/11-status-report.html.tmpl +0 -152
- package/plugins/html-effectiveness/templates/12-incident-report.html.tmpl +0 -547
- package/plugins/html-effectiveness/templates/13-flowchart-diagram.html.tmpl +0 -361
- package/plugins/html-effectiveness/templates/14-research-feature-explainer.html.tmpl +0 -348
- package/plugins/html-effectiveness/templates/15-research-concept-explainer.html.tmpl +0 -334
- package/plugins/html-effectiveness/templates/16-implementation-plan.html.tmpl +0 -657
- package/plugins/html-effectiveness/templates/17-pr-writeup.html.tmpl +0 -553
- package/plugins/html-effectiveness/templates/18-editor-triage-board.html.tmpl +0 -541
- package/plugins/html-effectiveness/templates/19-editor-feature-flags.html.tmpl +0 -627
- package/plugins/html-effectiveness/templates/20-editor-prompt-tuner.html.tmpl +0 -687
- package/plugins/html-effectiveness/templates/manifest.json +0 -441
- package/plugins/team-share/.claude-plugin/plugin.json +0 -18
- package/plugins/team-share/README.md +0 -46
- package/plugins/team-share/agents/team-share.md +0 -53
- package/plugins/team-share/commands/team-share.md +0 -4
- package/plugins/team-share/skills/claude-config/SKILL.md +0 -143
- package/plugins/team-share/skills/codegraph-setup/SKILL.md +0 -81
- package/plugins/team-share/skills/understand-setup/SKILL.md +0 -115
- package/plugins/tech-graph/.claude-plugin/plugin.json +0 -17
- package/plugins/tech-graph/README.md +0 -66
- package/plugins/tech-graph/agents/tech-graph.md +0 -97
- package/plugins/tech-graph/commands/tech-graph.md +0 -13
- package/plugins/tech-graph/scripts/check-deps.sh +0 -55
- package/plugins/tech-graph/skills/tech-graph/LICENSE +0 -21
- package/plugins/tech-graph/skills/tech-graph/README.md +0 -555
- package/plugins/tech-graph/skills/tech-graph/README.zh.md +0 -514
- package/plugins/tech-graph/skills/tech-graph/SKILL.md +0 -263
- package/plugins/tech-graph/skills/tech-graph/agents/openai.yaml +0 -4
- package/plugins/tech-graph/skills/tech-graph/assets/samples/sample-style1-flat.png +0 -0
- package/plugins/tech-graph/skills/tech-graph/assets/samples/sample-style2-dark.png +0 -0
- package/plugins/tech-graph/skills/tech-graph/assets/samples/sample-style3-blueprint.png +0 -0
- package/plugins/tech-graph/skills/tech-graph/assets/samples/sample-style4-notion.png +0 -0
- package/plugins/tech-graph/skills/tech-graph/assets/samples/sample-style5-glass.png +0 -0
- package/plugins/tech-graph/skills/tech-graph/assets/samples/sample-style6-claude.png +0 -0
- package/plugins/tech-graph/skills/tech-graph/assets/samples/sample-style7-openai.png +0 -0
- package/plugins/tech-graph/skills/tech-graph/fixtures/agent-memory-types-style4.json +0 -181
- package/plugins/tech-graph/skills/tech-graph/fixtures/api-flow-style7.json +0 -40
- package/plugins/tech-graph/skills/tech-graph/fixtures/mem0-style1.json +0 -297
- package/plugins/tech-graph/skills/tech-graph/fixtures/microservices-style3.json +0 -64
- package/plugins/tech-graph/skills/tech-graph/fixtures/multi-agent-style5.json +0 -45
- package/plugins/tech-graph/skills/tech-graph/fixtures/system-architecture-style6.json +0 -48
- package/plugins/tech-graph/skills/tech-graph/fixtures/tool-call-style2.json +0 -182
- package/plugins/tech-graph/skills/tech-graph/package.json +0 -42
- package/plugins/tech-graph/skills/tech-graph/references/diagram-types.md +0 -171
- package/plugins/tech-graph/skills/tech-graph/references/icons.md +0 -406
- package/plugins/tech-graph/skills/tech-graph/references/style-1-flat-icon.md +0 -108
- package/plugins/tech-graph/skills/tech-graph/references/style-2-dark-terminal.md +0 -107
- package/plugins/tech-graph/skills/tech-graph/references/style-3-blueprint.md +0 -113
- package/plugins/tech-graph/skills/tech-graph/references/style-4-notion-clean.md +0 -95
- package/plugins/tech-graph/skills/tech-graph/references/style-5-glassmorphism.md +0 -125
- package/plugins/tech-graph/skills/tech-graph/references/style-6-claude-official.md +0 -209
- package/plugins/tech-graph/skills/tech-graph/references/style-7-openai.md +0 -215
- package/plugins/tech-graph/skills/tech-graph/references/style-diagram-matrix.md +0 -135
- package/plugins/tech-graph/skills/tech-graph/references/svg-layout-best-practices.md +0 -100
- package/plugins/tech-graph/skills/tech-graph/references/svg-to-png.md +0 -115
- package/plugins/tech-graph/skills/tech-graph/scripts/README.md +0 -269
- package/plugins/tech-graph/skills/tech-graph/scripts/generate-diagram.sh +0 -181
- package/plugins/tech-graph/skills/tech-graph/scripts/generate-from-template.py +0 -1587
- package/plugins/tech-graph/skills/tech-graph/scripts/test-all-styles.sh +0 -143
- package/plugins/tech-graph/skills/tech-graph/scripts/validate-svg.sh +0 -306
- package/plugins/tech-graph/skills/tech-graph/templates/agent-architecture.svg +0 -28
- package/plugins/tech-graph/skills/tech-graph/templates/architecture.svg +0 -23
- package/plugins/tech-graph/skills/tech-graph/templates/comparison-matrix.svg +0 -14
- package/plugins/tech-graph/skills/tech-graph/templates/data-flow.svg +0 -28
- package/plugins/tech-graph/skills/tech-graph/templates/er-diagram.svg +0 -21
- package/plugins/tech-graph/skills/tech-graph/templates/flowchart.svg +0 -21
- package/plugins/tech-graph/skills/tech-graph/templates/sequence.svg +0 -20
- package/plugins/tech-graph/skills/tech-graph/templates/state-machine.svg +0 -20
- package/plugins/tech-graph/skills/tech-graph/templates/timeline.svg +0 -19
- package/plugins/tech-graph/skills/tech-graph/templates/use-case.svg +0 -21
|
@@ -1,143 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: claude-config
|
|
3
|
-
description: Write a shareable .claude/settings.json from the maintainer's enabled plugins and marketplaces, scaffold CLAUDE.md when missing, inject the Understand-Anything code-research section, and stage the result. Idempotent — safe to re-run.
|
|
4
|
-
allowed-tools: Bash, Read, Write, Edit
|
|
5
|
-
---
|
|
6
|
-
|
|
7
|
-
# claude-config
|
|
8
|
-
|
|
9
|
-
Set up repo-level Claude Code configuration for teammates.
|
|
10
|
-
|
|
11
|
-
## Preconditions (stop on any failure)
|
|
12
|
-
|
|
13
|
-
```bash
|
|
14
|
-
git rev-parse --is-inside-work-tree || { echo "ERROR: not a git repo"; exit 1; }
|
|
15
|
-
command -v jq || echo "MISSING: jq — install it (brew install jq / apt install jq / choco install jq) before continuing"
|
|
16
|
-
```
|
|
17
|
-
|
|
18
|
-
If not a git repo or `jq` is missing → report and STOP. Do not partially apply.
|
|
19
|
-
|
|
20
|
-
Check current branch and warn if on a protected branch:
|
|
21
|
-
|
|
22
|
-
```bash
|
|
23
|
-
BRANCH=$(git rev-parse --abbrev-ref HEAD)
|
|
24
|
-
case "$BRANCH" in
|
|
25
|
-
main|master|develop|dev)
|
|
26
|
-
echo "⚠️ You are on branch '$BRANCH'. Consider switching to a feature branch before continuing."
|
|
27
|
-
;;
|
|
28
|
-
esac
|
|
29
|
-
```
|
|
30
|
-
|
|
31
|
-
## Step 1 — Merge plugin + marketplace settings
|
|
32
|
-
|
|
33
|
-
Copy only `enabledPlugins` and `extraKnownMarketplaces` from the maintainer's user settings into the repo settings. Do NOT copy `hooks`, `permissions`, `env`, or any key with absolute paths.
|
|
34
|
-
|
|
35
|
-
```bash
|
|
36
|
-
USER_SETTINGS="$HOME/.claude/settings.json"
|
|
37
|
-
REPO_SETTINGS=".claude/settings.json"
|
|
38
|
-
|
|
39
|
-
mkdir -p .claude
|
|
40
|
-
[ -f "$REPO_SETTINGS" ] || echo '{}' > "$REPO_SETTINGS"
|
|
41
|
-
|
|
42
|
-
jq -s '
|
|
43
|
-
.[0] as $repo | .[1] as $user
|
|
44
|
-
| $repo
|
|
45
|
-
+ { enabledPlugins: (($repo.enabledPlugins // {}) + ($user.enabledPlugins // {})) }
|
|
46
|
-
+ { extraKnownMarketplaces: (($repo.extraKnownMarketplaces // {}) + ($user.extraKnownMarketplaces // {})) }
|
|
47
|
-
' "$REPO_SETTINGS" "$USER_SETTINGS" > "$REPO_SETTINGS.tmp" && mv "$REPO_SETTINGS.tmp" "$REPO_SETTINGS"
|
|
48
|
-
|
|
49
|
-
jq '{enabledPlugins, extraKnownMarketplaces}' "$REPO_SETTINGS"
|
|
50
|
-
```
|
|
51
|
-
|
|
52
|
-
Inspect the result: flag any marketplace URL that looks private (contains org names, auth tokens, or is not a well-known public registry).
|
|
53
|
-
|
|
54
|
-
## Step 2 — Scaffold CLAUDE.md if missing
|
|
55
|
-
|
|
56
|
-
```bash
|
|
57
|
-
if [ -f CLAUDE.md ]; then
|
|
58
|
-
echo "✅ CLAUDE.md already exists — skipping."
|
|
59
|
-
else
|
|
60
|
-
echo "📝 CLAUDE.md not found — installing claude-code-setup plugin to scaffold it…"
|
|
61
|
-
claude plugin install claude-code-setup@claude-plugins-official
|
|
62
|
-
if [ -f CLAUDE.md ]; then
|
|
63
|
-
echo "✅ CLAUDE.md created by claude-code-setup."
|
|
64
|
-
else
|
|
65
|
-
echo "⚠️ claude-code-setup did not produce CLAUDE.md — create it manually or commit a template first."
|
|
66
|
-
fi
|
|
67
|
-
fi
|
|
68
|
-
```
|
|
69
|
-
|
|
70
|
-
## Step 3 — Inject Understand-Anything section into CLAUDE.md
|
|
71
|
-
|
|
72
|
-
Append only when the section marker is absent (idempotent guard):
|
|
73
|
-
|
|
74
|
-
```bash
|
|
75
|
-
if grep -qF '## Code research with Understand-Anything' CLAUDE.md 2>/dev/null; then
|
|
76
|
-
echo "✅ Understand-Anything section already in CLAUDE.md — skipping."
|
|
77
|
-
else
|
|
78
|
-
cat >> CLAUDE.md << 'UASECTION'
|
|
79
|
-
|
|
80
|
-
## Code research with Understand-Anything
|
|
81
|
-
|
|
82
|
-
This project uses the [Understand-Anything](https://github.com/Egonex-AI/Understand-Anything) plugin to maintain an interactive knowledge graph of the codebase. **Always prefer these commands over raw file-by-file exploration when doing code research:**
|
|
83
|
-
|
|
84
|
-
| Goal | Command |
|
|
85
|
-
|------|---------|
|
|
86
|
-
| Explore the full codebase graph | `/understand` |
|
|
87
|
-
| Ask a free-form question about the code | `/understand-chat <question>` |
|
|
88
|
-
| Deep-dive into a specific file or function | `/understand-explain <path/symbol>` |
|
|
89
|
-
| See impact of your current changes before committing | `/understand-diff` |
|
|
90
|
-
| Open the interactive visual dashboard | `/understand-dashboard` |
|
|
91
|
-
| Extract business-domain knowledge (domains, flows, steps) | `/understand-domain` |
|
|
92
|
-
| Generate an onboarding guide for new teammates | `/understand-onboard` |
|
|
93
|
-
| Generate or refresh wiki knowledge under `docs/wiki` | `/understand-knowledge docs/wiki` |
|
|
94
|
-
|
|
95
|
-
The knowledge graph lives in `.understand-anything/knowledge-graph.json` and is kept up-to-date automatically on every commit (auto-update is enabled). Re-run `/understand` after large refactors to force a rebuild, and `/understand-knowledge docs/wiki` to refresh the wiki.
|
|
96
|
-
UASECTION
|
|
97
|
-
echo "✅ Understand-Anything section appended to CLAUDE.md."
|
|
98
|
-
fi
|
|
99
|
-
```
|
|
100
|
-
|
|
101
|
-
Mirror to AGENTS.md / MIRRORS.md if they exist:
|
|
102
|
-
|
|
103
|
-
```bash
|
|
104
|
-
for f in AGENTS.md MIRRORS.md; do
|
|
105
|
-
if [ -f "$f" ] && ! grep -qF '## Code research with Understand-Anything' "$f" 2>/dev/null; then
|
|
106
|
-
cat >> "$f" << 'UASECTION'
|
|
107
|
-
|
|
108
|
-
## Code research with Understand-Anything
|
|
109
|
-
|
|
110
|
-
This project uses the [Understand-Anything](https://github.com/Egonex-AI/Understand-Anything) plugin to maintain an interactive knowledge graph of the codebase. **Always prefer these commands over raw file-by-file exploration when doing code research:**
|
|
111
|
-
|
|
112
|
-
| Goal | Command |
|
|
113
|
-
|------|---------|
|
|
114
|
-
| Explore the full codebase graph | `/understand` |
|
|
115
|
-
| Ask a free-form question about the code | `/understand-chat <question>` |
|
|
116
|
-
| Deep-dive into a specific file or function | `/understand-explain <path/symbol>` |
|
|
117
|
-
| See impact of your current changes before committing | `/understand-diff` |
|
|
118
|
-
| Open the interactive visual dashboard | `/understand-dashboard` |
|
|
119
|
-
| Extract business-domain knowledge (domains, flows, steps) | `/understand-domain` |
|
|
120
|
-
| Generate an onboarding guide for new teammates | `/understand-onboard` |
|
|
121
|
-
| Generate or refresh wiki knowledge under `docs/wiki` | `/understand-knowledge docs/wiki` |
|
|
122
|
-
|
|
123
|
-
The knowledge graph lives in `.understand-anything/knowledge-graph.json` and is kept up-to-date automatically on every commit (auto-update is enabled). Re-run `/understand` after large refactors to force a rebuild, and `/understand-knowledge docs/wiki` to refresh the wiki.
|
|
124
|
-
UASECTION
|
|
125
|
-
echo "✅ Section also appended to $f."
|
|
126
|
-
fi
|
|
127
|
-
done
|
|
128
|
-
```
|
|
129
|
-
|
|
130
|
-
## Step 4 — Stage
|
|
131
|
-
|
|
132
|
-
```bash
|
|
133
|
-
git add .claude/settings.json CLAUDE.md
|
|
134
|
-
for f in AGENTS.md MIRRORS.md; do [ -f "$f" ] && git add "$f"; done
|
|
135
|
-
git status
|
|
136
|
-
```
|
|
137
|
-
|
|
138
|
-
## Done — report
|
|
139
|
-
|
|
140
|
-
- Which plugins/marketplaces were written to `.claude/settings.json` (flag any private ones).
|
|
141
|
-
- `CLAUDE.md` status: already existed vs created; Understand-Anything section added vs already present.
|
|
142
|
-
- `AGENTS.md` / `MIRRORS.md` status (if applicable).
|
|
143
|
-
- Files staged. Remind: **review then commit yourself.**
|
|
@@ -1,81 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: codegraph-setup
|
|
3
|
-
description: Install the CodeGraph CLI, wire it to the local project via MCP (codegraph install --target=auto --location=local), and initialise the current project (codegraph init). Works on macOS, Linux, and Windows (Git Bash / PowerShell). Idempotent — skips install if codegraph is already in PATH.
|
|
4
|
-
allowed-tools: Bash
|
|
5
|
-
---
|
|
6
|
-
|
|
7
|
-
# codegraph-setup
|
|
8
|
-
|
|
9
|
-
Install CodeGraph and initialise it for this project.
|
|
10
|
-
|
|
11
|
-
## Precondition
|
|
12
|
-
|
|
13
|
-
Must be inside a git repo:
|
|
14
|
-
|
|
15
|
-
```bash
|
|
16
|
-
git rev-parse --is-inside-work-tree || { echo "ERROR: not a git repo — run this from your project root"; exit 1; }
|
|
17
|
-
```
|
|
18
|
-
|
|
19
|
-
## Step 1 — Install CLI if not present (OS-aware, idempotent)
|
|
20
|
-
|
|
21
|
-
Run this as a single bash block so variables persist:
|
|
22
|
-
|
|
23
|
-
```bash
|
|
24
|
-
if command -v codegraph >/dev/null 2>&1; then
|
|
25
|
-
echo "✅ codegraph already installed: $(codegraph --version 2>/dev/null || echo 'version unknown')"
|
|
26
|
-
echo "Skipping install — proceeding to wire and init."
|
|
27
|
-
else
|
|
28
|
-
if command -v uname >/dev/null 2>&1; then
|
|
29
|
-
_OS=$(uname -s)
|
|
30
|
-
else
|
|
31
|
-
_OS="Windows"
|
|
32
|
-
fi
|
|
33
|
-
|
|
34
|
-
case "$_OS" in
|
|
35
|
-
Darwin|Linux)
|
|
36
|
-
curl -fsSL https://raw.githubusercontent.com/colbymchenry/codegraph/main/install.sh | sh
|
|
37
|
-
;;
|
|
38
|
-
*)
|
|
39
|
-
_PS=$(command -v pwsh 2>/dev/null || command -v powershell 2>/dev/null)
|
|
40
|
-
if [ -n "$_PS" ]; then
|
|
41
|
-
"$_PS" -Command "irm https://raw.githubusercontent.com/colbymchenry/codegraph/main/install.ps1 | iex"
|
|
42
|
-
else
|
|
43
|
-
echo "ERROR: cannot detect OS or find PowerShell."
|
|
44
|
-
echo "Install manually: https://github.com/colbymchenry/codegraph#installation"
|
|
45
|
-
exit 1
|
|
46
|
-
fi
|
|
47
|
-
;;
|
|
48
|
-
esac
|
|
49
|
-
|
|
50
|
-
command -v codegraph >/dev/null 2>&1 || { echo "ERROR: codegraph install failed — not found in PATH after install"; exit 1; }
|
|
51
|
-
echo "✅ codegraph installed: $(codegraph --version 2>/dev/null || echo 'version unknown')"
|
|
52
|
-
fi
|
|
53
|
-
```
|
|
54
|
-
|
|
55
|
-
Note: on Windows with Git Bash, `uname -s` returns `MINGW64_NT-*` or similar, which falls through to the `*)` case and attempts PowerShell. This is correct behaviour.
|
|
56
|
-
|
|
57
|
-
## Step 3 — Wire to your AI tool
|
|
58
|
-
|
|
59
|
-
Register the CodeGraph MCP server for this project (auto-detects AI tool; config written to project-local settings):
|
|
60
|
-
|
|
61
|
-
```bash
|
|
62
|
-
codegraph install --target=auto --location=local
|
|
63
|
-
```
|
|
64
|
-
|
|
65
|
-
This makes CodeGraph's context tools available inside your AI tool's sessions.
|
|
66
|
-
|
|
67
|
-
## Step 4 — Initialise the project
|
|
68
|
-
|
|
69
|
-
Build the code knowledge graph for this repo:
|
|
70
|
-
|
|
71
|
-
```bash
|
|
72
|
-
codegraph init
|
|
73
|
-
```
|
|
74
|
-
|
|
75
|
-
This creates a local SQLite index of symbols, dependencies, and cross-file relationships.
|
|
76
|
-
|
|
77
|
-
## Done — report
|
|
78
|
-
|
|
79
|
-
- Install: new install vs already present (version).
|
|
80
|
-
- Wire: `codegraph install` output.
|
|
81
|
-
- Init: `codegraph init` output, any errors.
|
|
@@ -1,115 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: understand-setup
|
|
3
|
-
description: Install the Understand-Anything plugin, build the knowledge graph with auto-update enabled, generate docs/wiki, git-lfs track the graph, and stage all artefacts. Idempotent — safe to re-run.
|
|
4
|
-
argument-hint: "[--force] [--language <lang>] (passed through to /understand)"
|
|
5
|
-
allowed-tools: Bash, Read, Write, Edit, Skill
|
|
6
|
-
---
|
|
7
|
-
|
|
8
|
-
# understand-setup
|
|
9
|
-
|
|
10
|
-
Install Understand-Anything and build the knowledge graph for this repo.
|
|
11
|
-
|
|
12
|
-
## Preconditions (stop on any failure)
|
|
13
|
-
|
|
14
|
-
```bash
|
|
15
|
-
git rev-parse --is-inside-work-tree || { echo "ERROR: not a git repo"; exit 1; }
|
|
16
|
-
command -v git-lfs || echo "MISSING: git-lfs — install it (brew install git-lfs / apt install git-lfs) before continuing"
|
|
17
|
-
command -v jq || echo "MISSING: jq — install it (brew install jq / apt install jq / choco install jq) before continuing"
|
|
18
|
-
```
|
|
19
|
-
|
|
20
|
-
If not a git repo, or `git-lfs`/`jq` are missing → report and STOP. Do not partially apply.
|
|
21
|
-
|
|
22
|
-
Check current branch and warn if on a protected branch:
|
|
23
|
-
|
|
24
|
-
```bash
|
|
25
|
-
BRANCH=$(git rev-parse --abbrev-ref HEAD)
|
|
26
|
-
case "$BRANCH" in
|
|
27
|
-
main|master|develop|dev)
|
|
28
|
-
echo "⚠️ You are on branch '$BRANCH'. Consider switching to a feature branch first."
|
|
29
|
-
;;
|
|
30
|
-
esac
|
|
31
|
-
```
|
|
32
|
-
|
|
33
|
-
## Step 1 — Install the plugin
|
|
34
|
-
|
|
35
|
-
Install via the Claude Code plugin system (idempotent):
|
|
36
|
-
|
|
37
|
-
```
|
|
38
|
-
/plugin marketplace add Egonex-AI/Understand-Anything
|
|
39
|
-
/plugin install understand-anything
|
|
40
|
-
```
|
|
41
|
-
|
|
42
|
-
After install, confirm `understand-anything@understand-anything` appears in `.claude/settings.json`:
|
|
43
|
-
|
|
44
|
-
```bash
|
|
45
|
-
jq '.enabledPlugins["understand-anything@understand-anything"]' .claude/settings.json 2>/dev/null || echo "⚠️ understand-anything not found in .claude/settings.json — teammates may need to install manually."
|
|
46
|
-
```
|
|
47
|
-
|
|
48
|
-
## Step 2 — Build / refresh the knowledge graph
|
|
49
|
-
|
|
50
|
-
Run the skill **in the main thread** (it dispatches its own analyzer subagents — do not wrap it in a subagent):
|
|
51
|
-
|
|
52
|
-
```
|
|
53
|
-
/understand --auto-update $ARGUMENTS
|
|
54
|
-
```
|
|
55
|
-
|
|
56
|
-
- `--auto-update` writes `{"autoUpdate": true}` to `.understand-anything/config.json`.
|
|
57
|
-
- If a graph already exists, `/understand` runs incrementally. Pass `--force` (via `$ARGUMENTS`) to rebuild from scratch.
|
|
58
|
-
|
|
59
|
-
After it finishes, confirm these files exist:
|
|
60
|
-
|
|
61
|
-
```bash
|
|
62
|
-
test -f .understand-anything/knowledge-graph.json && echo "✅ knowledge-graph.json" || echo "❌ knowledge-graph.json missing"
|
|
63
|
-
test -f .understand-anything/meta.json && echo "✅ meta.json" || echo "❌ meta.json missing"
|
|
64
|
-
jq '.autoUpdate' .understand-anything/config.json 2>/dev/null | grep -q true && echo "✅ autoUpdate: true" || echo "❌ autoUpdate not set"
|
|
65
|
-
```
|
|
66
|
-
|
|
67
|
-
## Step 3 — Initialize the docs wiki
|
|
68
|
-
|
|
69
|
-
```bash
|
|
70
|
-
mkdir -p docs/wiki
|
|
71
|
-
```
|
|
72
|
-
|
|
73
|
-
Run wiki generation in the main thread:
|
|
74
|
-
|
|
75
|
-
```
|
|
76
|
-
/understand-knowledge docs/wiki
|
|
77
|
-
```
|
|
78
|
-
|
|
79
|
-
After it finishes, confirm `docs/wiki/` contains generated files:
|
|
80
|
-
|
|
81
|
-
```bash
|
|
82
|
-
ls docs/wiki/ | head -5 || echo "❌ docs/wiki is empty or missing"
|
|
83
|
-
```
|
|
84
|
-
|
|
85
|
-
## Step 4 — Ignore scratch outputs, git-lfs track, and stage
|
|
86
|
-
|
|
87
|
-
Append scratch paths to .gitignore (idempotent):
|
|
88
|
-
|
|
89
|
-
```bash
|
|
90
|
-
for p in ".understand-anything/intermediate/" ".understand-anything/tmp/" ".understand-anything/diff-overlay.json"; do
|
|
91
|
-
grep -qxF "$p" .gitignore 2>/dev/null || echo "$p" >> .gitignore
|
|
92
|
-
done
|
|
93
|
-
```
|
|
94
|
-
|
|
95
|
-
Track large graph files with git-lfs (harmless for small graphs):
|
|
96
|
-
|
|
97
|
-
```bash
|
|
98
|
-
git lfs install
|
|
99
|
-
git lfs track ".understand-anything/*.json"
|
|
100
|
-
```
|
|
101
|
-
|
|
102
|
-
Stage all artefacts:
|
|
103
|
-
|
|
104
|
-
```bash
|
|
105
|
-
git add .gitattributes .gitignore .understand-anything/ docs/wiki/
|
|
106
|
-
git status
|
|
107
|
-
git lfs ls-files
|
|
108
|
-
```
|
|
109
|
-
|
|
110
|
-
## Done — report
|
|
111
|
-
|
|
112
|
-
- Graph status: created vs incrementally updated; `autoUpdate` on/off.
|
|
113
|
-
- Wiki status: `docs/wiki/` created vs already existed; generation successful vs failed.
|
|
114
|
-
- Staged files; LFS-tracked files confirmed.
|
|
115
|
-
- Remind: **review then commit yourself.**
|
|
@@ -1,17 +0,0 @@
|
|
|
1
|
-
{
|
|
2
|
-
"name": "tech-graph",
|
|
3
|
-
"version": "0.0.44",
|
|
4
|
-
"description": "Step-by-step wizard for generating technical diagrams as SVG+PNG.",
|
|
5
|
-
"author": {
|
|
6
|
-
"name": "steven"
|
|
7
|
-
},
|
|
8
|
-
"keywords": [
|
|
9
|
-
"diagram",
|
|
10
|
-
"svg",
|
|
11
|
-
"architecture",
|
|
12
|
-
"uml",
|
|
13
|
-
"flowchart",
|
|
14
|
-
"sequence",
|
|
15
|
-
"er"
|
|
16
|
-
]
|
|
17
|
-
}
|
|
@@ -1,66 +0,0 @@
|
|
|
1
|
-
# tech-graph
|
|
2
|
-
|
|
3
|
-
Step-by-step wizard for generating technical diagrams (architecture, flowchart, sequence, UML-class, ER, agent-loop, concept-map) as SVG + PNG. Delegates rendering to the upstream [`fireworks-tech-graph`](https://github.com/yizhiyanhua-ai/fireworks-tech-graph) skill (vendored here under `skills/tech-graph/`).
|
|
4
|
-
|
|
5
|
-
## Install
|
|
6
|
-
|
|
7
|
-
From inside Claude Code:
|
|
8
|
-
|
|
9
|
-
```text
|
|
10
|
-
/plugin marketplace add <user>/agents-and-skills
|
|
11
|
-
/plugin install tech-graph@drunkcoding
|
|
12
|
-
```
|
|
13
|
-
|
|
14
|
-
Then run `/tech-graph` (or `/tech-graph "auth flow"` to seed a topic).
|
|
15
|
-
|
|
16
|
-
## Renderer Dependency
|
|
17
|
-
|
|
18
|
-
The plugin needs ONE of these on your system (cairosvg recommended):
|
|
19
|
-
|
|
20
|
-
| Renderer | Install |
|
|
21
|
-
|----------|---------|
|
|
22
|
-
| `cairosvg` | `pip install cairosvg` (Python ≥ 3.8) |
|
|
23
|
-
| `rsvg-convert` | macOS: `brew install librsvg` / Debian: `apt-get install librsvg2-bin` |
|
|
24
|
-
| `puppeteer` | `npm install -g puppeteer` (heavy; last resort) |
|
|
25
|
-
|
|
26
|
-
Probe + auto-select:
|
|
27
|
-
|
|
28
|
-
```bash
|
|
29
|
-
bash plugins/tech-graph/scripts/check-deps.sh
|
|
30
|
-
```
|
|
31
|
-
|
|
32
|
-
The script writes the selected renderer name to `skills/tech-graph/.renderer` and skips re-probing on later runs.
|
|
33
|
-
|
|
34
|
-
## Wizard Steps
|
|
35
|
-
|
|
36
|
-
1. Purpose — exec-summary / engineering-review ★ / docs / blog / debug-thinking
|
|
37
|
-
2. Type — architecture ★ / flowchart / sequence / UML-class / ER / agent-loop / concept-map
|
|
38
|
-
3. Style — one of 7 (recommended ★ based on purpose × type)
|
|
39
|
-
4. Format — SVG ★ / PNG / both
|
|
40
|
-
5. Density — minimal / standard ★ / detailed
|
|
41
|
-
6. Confirm — render or edit a previous step
|
|
42
|
-
|
|
43
|
-
Mid-wizard you may say: `redo step 3`, `change style`, or `cancel`.
|
|
44
|
-
|
|
45
|
-
## Output
|
|
46
|
-
|
|
47
|
-
- Default outdir: `./diagrams/`
|
|
48
|
-
- Filename: `<topic-slug>-<type>-<style>.svg` (collisions → `-2`, `-3`, …)
|
|
49
|
-
|
|
50
|
-
## Optional — draw.io MCP
|
|
51
|
-
|
|
52
|
-
This plugin does **not** bundle draw.io's MCP server. If you want it available alongside, add this to `~/.claude/settings.json` or your project's `.mcp.json`:
|
|
53
|
-
|
|
54
|
-
```json
|
|
55
|
-
{
|
|
56
|
-
"mcpServers": {
|
|
57
|
-
"drawio": { "type": "http", "url": "https://mcp.draw.io/mcp" }
|
|
58
|
-
}
|
|
59
|
-
}
|
|
60
|
-
```
|
|
61
|
-
|
|
62
|
-
The `tech-graph` subagent does **not** depend on this MCP — it is purely opt-in.
|
|
63
|
-
|
|
64
|
-
## Upstream Sync
|
|
65
|
-
|
|
66
|
-
See `../../CONTRIBUTING.md` at the repo root for the `git subtree pull` workflow.
|
|
@@ -1,97 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: tech-graph
|
|
3
|
-
description: Step-by-step wizard for generating technical diagrams (architecture, flowchart, sequence, UML, ER, agent-loop, concept-map) as SVG/PNG via the fireworks-tech-graph skill.
|
|
4
|
-
tools: Read, Write, Edit, Bash, Glob, Grep
|
|
5
|
-
model: sonnet
|
|
6
|
-
---
|
|
7
|
-
|
|
8
|
-
# Tech-Graph Wizard
|
|
9
|
-
|
|
10
|
-
You are a diagram wizard. Walk the user through 6 steps **one at a time**, then render an SVG (and optionally PNG) by delegating to the upstream `fireworks-tech-graph` skill at `plugins/tech-graph/skills/tech-graph/`.
|
|
11
|
-
|
|
12
|
-
## Workflow
|
|
13
|
-
|
|
14
|
-
Six-step wizard (purpose → type → style → format → density → confirm), then the render protocol below. Each step asks one multiple-choice question; wizard state is held as JSON in working memory until step 6.
|
|
15
|
-
|
|
16
|
-
## Output
|
|
17
|
-
|
|
18
|
-
An SVG (and optionally PNG) written to `<outdir>/<topic-slug>-<type>-<style>.svg`. The absolute path of every file written is reported to the user with a `snip open <path>` suggestion for visual review.
|
|
19
|
-
|
|
20
|
-
## Hard Rules
|
|
21
|
-
|
|
22
|
-
1. **One question per message.** Always multiple-choice. Mark the default with `★`.
|
|
23
|
-
2. Never skip a step unless the user explicitly says "use defaults".
|
|
24
|
-
3. Maintain wizard state in your working memory as JSON:
|
|
25
|
-
```json
|
|
26
|
-
{ "topic": "", "purpose": "", "type": "", "style": "", "format": "", "density": "", "filename": "", "outdir": "./diagrams" }
|
|
27
|
-
```
|
|
28
|
-
4. Defer reading the upstream `SKILL.md`, `references/`, `templates/` until step 6 (confirmation). At step 6, Read them, then author SVG content.
|
|
29
|
-
5. **Fail fast on missing renderer.** Before authoring SVG, run `bash plugins/tech-graph/scripts/check-deps.sh`. If exit != 0, quote the script's stderr verbatim to the user and halt. Do not write any SVG.
|
|
30
|
-
6. Never edit anything under `plugins/tech-graph/skills/tech-graph/` — that path is a git subtree and must stay verbatim.
|
|
31
|
-
|
|
32
|
-
## The 6 Steps
|
|
33
|
-
|
|
34
|
-
### Step 1 — Purpose / audience
|
|
35
|
-
Ask: "What is this diagram for?"
|
|
36
|
-
Options:
|
|
37
|
-
- (a) exec-summary
|
|
38
|
-
- (b) engineering-review ★
|
|
39
|
-
- (c) docs
|
|
40
|
-
- (d) blog
|
|
41
|
-
- (e) debug-thinking
|
|
42
|
-
|
|
43
|
-
### Step 2 — Diagram type
|
|
44
|
-
Ask: "What type of diagram?"
|
|
45
|
-
Options:
|
|
46
|
-
- (a) architecture ★
|
|
47
|
-
- (b) flowchart
|
|
48
|
-
- (c) sequence
|
|
49
|
-
- (d) UML-class
|
|
50
|
-
- (e) ER
|
|
51
|
-
- (f) agent-loop
|
|
52
|
-
- (g) concept-map
|
|
53
|
-
|
|
54
|
-
### Step 3 — Style
|
|
55
|
-
Read `plugins/tech-graph/skills/tech-graph/references/` for the 7 upstream style references. Recommend one based on `(purpose, type)` and present all 7 with the recommendation marked `★`.
|
|
56
|
-
|
|
57
|
-
### Step 4 — Format
|
|
58
|
-
Ask: "Output format?"
|
|
59
|
-
Options:
|
|
60
|
-
- (a) SVG ★
|
|
61
|
-
- (b) PNG
|
|
62
|
-
- (c) both
|
|
63
|
-
|
|
64
|
-
### Step 5 — Complexity / density
|
|
65
|
-
Ask: "How dense should it be?"
|
|
66
|
-
Options:
|
|
67
|
-
- (a) minimal
|
|
68
|
-
- (b) standard ★
|
|
69
|
-
- (c) detailed
|
|
70
|
-
|
|
71
|
-
### Step 6 — Confirm
|
|
72
|
-
Show the user the full state summary, plus the resolved `filename` and `outdir`. Filename pattern: `<topic-slug>-<type>-<style>.svg`. If the file exists, append `-2`, `-3`, …
|
|
73
|
-
Options: (a) yes — render, (b) edit step N, (c) cancel.
|
|
74
|
-
|
|
75
|
-
## Render Protocol (after step 6 = yes)
|
|
76
|
-
|
|
77
|
-
1. `bash plugins/tech-graph/scripts/check-deps.sh` — abort on failure (rule 5).
|
|
78
|
-
2. Read upstream `SKILL.md` and the template files for the chosen `type`/`style`.
|
|
79
|
-
3. Author the SVG content following the upstream style reference and density hint, then either:
|
|
80
|
-
- Write SVG directly to `<outdir>/<filename>`, OR
|
|
81
|
-
- Use `python3 plugins/tech-graph/skills/tech-graph/scripts/generate-from-template.py <type> <out.svg> '<json>'` when a template applies.
|
|
82
|
-
4. Validate + export PNG (when format=PNG or both):
|
|
83
|
-
`bash plugins/tech-graph/skills/tech-graph/scripts/generate-diagram.sh -t <type> -s <style> -o <out.svg>`
|
|
84
|
-
5. Report the absolute path of every file written. Suggest the user run `snip open <path>` for visual review.
|
|
85
|
-
|
|
86
|
-
## Re-entry
|
|
87
|
-
|
|
88
|
-
Accept these at any point:
|
|
89
|
-
- "redo step N" — return to step N keeping all other state.
|
|
90
|
-
- "change style" — return to step 3.
|
|
91
|
-
- "cancel" — discard state and stop.
|
|
92
|
-
|
|
93
|
-
## Failure Handling
|
|
94
|
-
|
|
95
|
-
- Missing renderer → quote the `check-deps.sh` stderr verbatim, halt.
|
|
96
|
-
- Upstream script non-zero exit → quote the script's stderr verbatim, halt; do not write a partial SVG.
|
|
97
|
-
- Invalid SVG (validation failure) → quote validator output, halt, do not export PNG.
|
|
@@ -1,13 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
description: Step-by-step wizard for generating technical diagrams (SVG/PNG).
|
|
3
|
-
argument-hint: [optional one-line topic]
|
|
4
|
-
---
|
|
5
|
-
|
|
6
|
-
Dispatch the `tech-graph` subagent using the Agent tool. Pass `$ARGUMENTS` (which may be empty) as the initial topic seed in the subagent prompt.
|
|
7
|
-
|
|
8
|
-
Subagent dispatch prompt template:
|
|
9
|
-
|
|
10
|
-
> Run the tech-graph wizard. Initial topic seed: `$ARGUMENTS`.
|
|
11
|
-
> Walk the user through all 6 steps even when a seed is provided. Use multiple-choice options with the marked default (★). Maintain wizard state as JSON in your working memory across turns. Do not skip steps unless the user explicitly says "use defaults".
|
|
12
|
-
|
|
13
|
-
Do not perform any rendering or file generation in the main thread — the subagent owns the full wizard and the render call.
|
|
@@ -1,55 +0,0 @@
|
|
|
1
|
-
#!/usr/bin/env bash
|
|
2
|
-
# check-deps.sh — probe SVG→PNG renderers for tech-graph plugin.
|
|
3
|
-
# Probes in order: cairosvg (python) → rsvg-convert (system) → puppeteer (node).
|
|
4
|
-
# Writes the first available choice to skills/tech-graph/.renderer.
|
|
5
|
-
# Exits 0 on success, 1 if none found (prints exact install cmd).
|
|
6
|
-
|
|
7
|
-
set -euo pipefail
|
|
8
|
-
|
|
9
|
-
SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
|
|
10
|
-
PLUGIN_DIR="$(cd "$SCRIPT_DIR/.." && pwd)"
|
|
11
|
-
RENDERER_FILE="$PLUGIN_DIR/skills/tech-graph/.renderer"
|
|
12
|
-
|
|
13
|
-
probe_cairosvg() {
|
|
14
|
-
python3 -c "import cairosvg" >/dev/null 2>&1
|
|
15
|
-
}
|
|
16
|
-
|
|
17
|
-
probe_rsvg() {
|
|
18
|
-
command -v rsvg-convert >/dev/null 2>&1
|
|
19
|
-
}
|
|
20
|
-
|
|
21
|
-
probe_puppeteer() {
|
|
22
|
-
node -e "require('puppeteer')" >/dev/null 2>&1
|
|
23
|
-
}
|
|
24
|
-
|
|
25
|
-
if probe_cairosvg; then
|
|
26
|
-
echo "cairosvg" > "$RENDERER_FILE"
|
|
27
|
-
echo "Renderer: cairosvg (python) — selected"
|
|
28
|
-
exit 0
|
|
29
|
-
fi
|
|
30
|
-
|
|
31
|
-
if probe_rsvg; then
|
|
32
|
-
echo "rsvg-convert" > "$RENDERER_FILE"
|
|
33
|
-
echo "Renderer: rsvg-convert — selected"
|
|
34
|
-
exit 0
|
|
35
|
-
fi
|
|
36
|
-
|
|
37
|
-
if probe_puppeteer; then
|
|
38
|
-
echo "puppeteer" > "$RENDERER_FILE"
|
|
39
|
-
echo "Renderer: puppeteer (node) — selected"
|
|
40
|
-
exit 0
|
|
41
|
-
fi
|
|
42
|
-
|
|
43
|
-
cat <<'EOF' >&2
|
|
44
|
-
ERROR: No SVG→PNG renderer found on this system.
|
|
45
|
-
|
|
46
|
-
Install ONE of the following (cairosvg is recommended):
|
|
47
|
-
|
|
48
|
-
1) pip install cairosvg # requires Python >= 3.8
|
|
49
|
-
2) brew install librsvg # macOS
|
|
50
|
-
apt-get install librsvg2-bin # Debian/Ubuntu
|
|
51
|
-
3) npm install -g puppeteer # heavy; last resort
|
|
52
|
-
|
|
53
|
-
After install, re-run: bash plugins/tech-graph/scripts/check-deps.sh
|
|
54
|
-
EOF
|
|
55
|
-
exit 1
|
|
@@ -1,21 +0,0 @@
|
|
|
1
|
-
MIT License
|
|
2
|
-
|
|
3
|
-
Copyright (c) 2025 fireworks-tech-graph contributors
|
|
4
|
-
|
|
5
|
-
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
-
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
-
in the Software without restriction, including without limitation the rights
|
|
8
|
-
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
-
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
-
furnished to do so, subject to the following conditions:
|
|
11
|
-
|
|
12
|
-
The above copyright notice and this permission notice shall be included in all
|
|
13
|
-
copies or substantial portions of the Software.
|
|
14
|
-
|
|
15
|
-
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
-
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
-
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
-
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
-
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
-
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
-
SOFTWARE.
|