@drunkcoding/agents-and-skills 0.0.45 → 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.
Files changed (107) hide show
  1. package/.claude-plugin/marketplace.json +2 -47
  2. package/README.md +3 -6
  3. package/package.json +4 -1
  4. package/plugins/multica-tool/.claude-plugin/plugin.json +1 -1
  5. package/plugins/multica-tool/scripts/lib.mjs +53 -4
  6. package/plugins/multica-tool/scripts/multica-export.mjs +135 -32
  7. package/plugins/multica-tool/scripts/multica-import.mjs +192 -17
  8. package/plugins/multica-tool/skills/export/SKILL.md +84 -14
  9. package/plugins/multica-tool/skills/import/SKILL.md +22 -7
  10. package/plugins/multica-tool/skills/sync/SKILL.md +1 -1
  11. package/plugins/plugin-validator/.claude-plugin/plugin.json +1 -1
  12. package/plugins/html-effectiveness/.claude-plugin/plugin.json +0 -17
  13. package/plugins/html-effectiveness/README.md +0 -28
  14. package/plugins/html-effectiveness/agents/report-builder.md +0 -66
  15. package/plugins/html-effectiveness/assets/base.css +0 -51
  16. package/plugins/html-effectiveness/assets/base.js +0 -11
  17. package/plugins/html-effectiveness/assets/charts.js +0 -1
  18. package/plugins/html-effectiveness/assets/components.css +0 -10
  19. package/plugins/html-effectiveness/commands/html-report.md +0 -13
  20. package/plugins/html-effectiveness/docs/template-gallery.md +0 -28
  21. package/plugins/html-effectiveness/package.json +0 -6
  22. package/plugins/html-effectiveness/scripts/_tmp.js +0 -37
  23. package/plugins/html-effectiveness/scripts/catalog.js +0 -47
  24. package/plugins/html-effectiveness/scripts/extract.js +0 -104
  25. package/plugins/html-effectiveness/scripts/mustache.js +0 -90
  26. package/plugins/html-effectiveness/scripts/render.js +0 -176
  27. package/plugins/html-effectiveness/skills/html-effectiveness/SKILL.md +0 -94
  28. package/plugins/html-effectiveness/templates/01-exploration-code-approaches.html.tmpl +0 -400
  29. package/plugins/html-effectiveness/templates/02-exploration-visual-designs.html.tmpl +0 -456
  30. package/plugins/html-effectiveness/templates/03-code-review-pr.html.tmpl +0 -581
  31. package/plugins/html-effectiveness/templates/04-code-understanding.html.tmpl +0 -443
  32. package/plugins/html-effectiveness/templates/05-design-system.html.tmpl +0 -578
  33. package/plugins/html-effectiveness/templates/06-component-variants.html.tmpl +0 -557
  34. package/plugins/html-effectiveness/templates/07-prototype-animation.html.tmpl +0 -417
  35. package/plugins/html-effectiveness/templates/08-prototype-interaction.html.tmpl +0 -363
  36. package/plugins/html-effectiveness/templates/09-slide-deck.html.tmpl +0 -535
  37. package/plugins/html-effectiveness/templates/10-svg-illustrations.html.tmpl +0 -444
  38. package/plugins/html-effectiveness/templates/11-status-report.html.tmpl +0 -152
  39. package/plugins/html-effectiveness/templates/12-incident-report.html.tmpl +0 -547
  40. package/plugins/html-effectiveness/templates/13-flowchart-diagram.html.tmpl +0 -361
  41. package/plugins/html-effectiveness/templates/14-research-feature-explainer.html.tmpl +0 -348
  42. package/plugins/html-effectiveness/templates/15-research-concept-explainer.html.tmpl +0 -334
  43. package/plugins/html-effectiveness/templates/16-implementation-plan.html.tmpl +0 -657
  44. package/plugins/html-effectiveness/templates/17-pr-writeup.html.tmpl +0 -553
  45. package/plugins/html-effectiveness/templates/18-editor-triage-board.html.tmpl +0 -541
  46. package/plugins/html-effectiveness/templates/19-editor-feature-flags.html.tmpl +0 -627
  47. package/plugins/html-effectiveness/templates/20-editor-prompt-tuner.html.tmpl +0 -687
  48. package/plugins/html-effectiveness/templates/manifest.json +0 -441
  49. package/plugins/team-share/.claude-plugin/plugin.json +0 -18
  50. package/plugins/team-share/README.md +0 -46
  51. package/plugins/team-share/agents/team-share.md +0 -53
  52. package/plugins/team-share/commands/team-share.md +0 -4
  53. package/plugins/team-share/skills/claude-config/SKILL.md +0 -143
  54. package/plugins/team-share/skills/codegraph-setup/SKILL.md +0 -81
  55. package/plugins/team-share/skills/understand-setup/SKILL.md +0 -115
  56. package/plugins/tech-graph/.claude-plugin/plugin.json +0 -17
  57. package/plugins/tech-graph/README.md +0 -66
  58. package/plugins/tech-graph/agents/tech-graph.md +0 -97
  59. package/plugins/tech-graph/commands/tech-graph.md +0 -13
  60. package/plugins/tech-graph/scripts/check-deps.sh +0 -55
  61. package/plugins/tech-graph/skills/tech-graph/LICENSE +0 -21
  62. package/plugins/tech-graph/skills/tech-graph/README.md +0 -555
  63. package/plugins/tech-graph/skills/tech-graph/README.zh.md +0 -514
  64. package/plugins/tech-graph/skills/tech-graph/SKILL.md +0 -263
  65. package/plugins/tech-graph/skills/tech-graph/agents/openai.yaml +0 -4
  66. package/plugins/tech-graph/skills/tech-graph/assets/samples/sample-style1-flat.png +0 -0
  67. package/plugins/tech-graph/skills/tech-graph/assets/samples/sample-style2-dark.png +0 -0
  68. package/plugins/tech-graph/skills/tech-graph/assets/samples/sample-style3-blueprint.png +0 -0
  69. package/plugins/tech-graph/skills/tech-graph/assets/samples/sample-style4-notion.png +0 -0
  70. package/plugins/tech-graph/skills/tech-graph/assets/samples/sample-style5-glass.png +0 -0
  71. package/plugins/tech-graph/skills/tech-graph/assets/samples/sample-style6-claude.png +0 -0
  72. package/plugins/tech-graph/skills/tech-graph/assets/samples/sample-style7-openai.png +0 -0
  73. package/plugins/tech-graph/skills/tech-graph/fixtures/agent-memory-types-style4.json +0 -181
  74. package/plugins/tech-graph/skills/tech-graph/fixtures/api-flow-style7.json +0 -40
  75. package/plugins/tech-graph/skills/tech-graph/fixtures/mem0-style1.json +0 -297
  76. package/plugins/tech-graph/skills/tech-graph/fixtures/microservices-style3.json +0 -64
  77. package/plugins/tech-graph/skills/tech-graph/fixtures/multi-agent-style5.json +0 -45
  78. package/plugins/tech-graph/skills/tech-graph/fixtures/system-architecture-style6.json +0 -48
  79. package/plugins/tech-graph/skills/tech-graph/fixtures/tool-call-style2.json +0 -182
  80. package/plugins/tech-graph/skills/tech-graph/package.json +0 -42
  81. package/plugins/tech-graph/skills/tech-graph/references/diagram-types.md +0 -171
  82. package/plugins/tech-graph/skills/tech-graph/references/icons.md +0 -406
  83. package/plugins/tech-graph/skills/tech-graph/references/style-1-flat-icon.md +0 -108
  84. package/plugins/tech-graph/skills/tech-graph/references/style-2-dark-terminal.md +0 -107
  85. package/plugins/tech-graph/skills/tech-graph/references/style-3-blueprint.md +0 -113
  86. package/plugins/tech-graph/skills/tech-graph/references/style-4-notion-clean.md +0 -95
  87. package/plugins/tech-graph/skills/tech-graph/references/style-5-glassmorphism.md +0 -125
  88. package/plugins/tech-graph/skills/tech-graph/references/style-6-claude-official.md +0 -209
  89. package/plugins/tech-graph/skills/tech-graph/references/style-7-openai.md +0 -215
  90. package/plugins/tech-graph/skills/tech-graph/references/style-diagram-matrix.md +0 -135
  91. package/plugins/tech-graph/skills/tech-graph/references/svg-layout-best-practices.md +0 -100
  92. package/plugins/tech-graph/skills/tech-graph/references/svg-to-png.md +0 -115
  93. package/plugins/tech-graph/skills/tech-graph/scripts/README.md +0 -269
  94. package/plugins/tech-graph/skills/tech-graph/scripts/generate-diagram.sh +0 -181
  95. package/plugins/tech-graph/skills/tech-graph/scripts/generate-from-template.py +0 -1587
  96. package/plugins/tech-graph/skills/tech-graph/scripts/test-all-styles.sh +0 -143
  97. package/plugins/tech-graph/skills/tech-graph/scripts/validate-svg.sh +0 -306
  98. package/plugins/tech-graph/skills/tech-graph/templates/agent-architecture.svg +0 -28
  99. package/plugins/tech-graph/skills/tech-graph/templates/architecture.svg +0 -23
  100. package/plugins/tech-graph/skills/tech-graph/templates/comparison-matrix.svg +0 -14
  101. package/plugins/tech-graph/skills/tech-graph/templates/data-flow.svg +0 -28
  102. package/plugins/tech-graph/skills/tech-graph/templates/er-diagram.svg +0 -21
  103. package/plugins/tech-graph/skills/tech-graph/templates/flowchart.svg +0 -21
  104. package/plugins/tech-graph/skills/tech-graph/templates/sequence.svg +0 -20
  105. package/plugins/tech-graph/skills/tech-graph/templates/state-machine.svg +0 -20
  106. package/plugins/tech-graph/skills/tech-graph/templates/timeline.svg +0 -19
  107. 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.45",
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.