Understand-Anything

fix: sync Phase 0.5 inline script with .gitignore integration and header fix

The skill's inline Node.js generator was duplicated from core and missed
the .gitignore seeding and bin/ header fix. Updated the one-liner to read
.gitignore patterns, deduplicate against defaults with trailing-slash
normalization, and remove bin/ from the built-in defaults header comment.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Lum1104 · 2026-04-12 11:47:55 +08:00

55fc2ac848

feat: seed .understandignore with .gitignore patterns on first generation

Read the project's .gitignore at starter-file generation time and include
non-default patterns as commented suggestions in .understandignore. Patterns
already covered by hardcoded defaults are deduplicated (with trailing-slash
normalization). This is a one-time inclusion — users can later remove patterns
for files they want analyzed without the filter re-reading .gitignore.

Also fixes the starter header listing bin/ as a built-in default when it is
intentionally excluded from DEFAULT_IGNORE_PATTERNS (bin/ is used by Node/Ruby
CLI launchers).

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Lum1104 · 2026-04-12 11:39:31 +08:00

6ef1a21315

Merge branch 'main' into feat/understandignore

Lum1104 · 2026-04-12 11:34:10 +08:00

bc311c80ad

docs: add Korean and Spanish README translations

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Lum1104 · 2026-04-12 11:31:46 +08:00

c2f5b02b2d

feat: /understand-knowledge for Karpathy LLM wiki format

Yuxiang Lin · 2026-04-12 11:24:38 +08:00

78c8859d2a

fix: highlight connected edges on node selection in knowledge view

Connected edges now highlight (thicker, full opacity) when a node is
selected/focused. Unconnected edges dim to near-invisible. Edge labels
only show on connected edges to reduce visual noise.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Lum1104 · 2026-04-12 11:24:17 +08:00

1d15851905

fix: address Codex review — stable layout, scoped infra filter, basename dedup

P1: Separate force layout computation from visual state updates so
clicking/searching/touring doesn't re-randomize node positions. Layout
only recomputes when the graph data or filters change.

P1: Restrict infrastructure-file skipping (index.md, log.md, etc.) to
the wiki root level only. Nested files like concepts/index.md are now
correctly treated as content articles.

P2: Track ambiguous bare basenames in the wikilink resolution map.
Duplicate basenames (e.g., a/foo.md and b/foo.md) are removed from
the flat lookup so [[foo]] doesn't silently resolve to the wrong page.

Also fixed: edge IDs now use stable source-target-type keys instead of
array indices for proper React reconciliation.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Lum1104 · 2026-04-12 11:21:24 +08:00

7e41ba7a68

docs: add /understand-knowledge to translated READMEs

Updated zh-CN, zh-TW, ja-JP, tr-TR with the same 4 changes:
tagline, knowledge base section, command example, agent table row.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Lum1104 · 2026-04-12 11:15:51 +08:00

d3dfbd873b

docs: add /understand-knowledge to README

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Lum1104 · 2026-04-12 11:12:38 +08:00

66a8706646

feat: add /understand-knowledge for Karpathy LLM wiki knowledge bases

Support the Karpathy LLM wiki pattern — a three-layer architecture
(raw sources + wiki markdown + schema) with wikilinks, index.md
categories, and append-only log.md.

Pipeline:
- parse-knowledge-base.py: deterministic extraction of articles,
  wikilinks, categories from index.md, source nodes from raw/
- article-analyzer agent: LLM-based entity/claim extraction and
  implicit relationship discovery (builds_on, contradicts, etc.)
- merge-knowledge-graph.py: combines scan + analysis with entity
  dedup, layer assignment from categories, tour generation

Dashboard:
- KnowledgeGraphView with d3-force layout (community clustering
  by index.md categories, degree-proportional sizing)
- 5 knowledge node types (article, entity, topic, claim, source)
- 6 knowledge edge types with visual styling
- KnowledgeNodeDetails sidebar (wikilinks, backlinks, preview)
- Auto-detect kind:"knowledge" → knowledge-only view mode

Core:
- 5 node types + 6 edge types added to NodeType/EdgeType unions
- KnowledgeMeta interface (wikilinks, backlinks, category, content)
- kind field on KnowledgeGraph for view mode detection
- Zod schemas + node/edge type aliases

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Lum1104 · 2026-04-12 11:09:41 +08:00

2fc85e68c3

docs: add Star History rank badge to all READMEs

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Lum1104 · 2026-04-11 09:19:13 +08:00

55a03f6647

docs: reorganize docs/ into superpowers/specs/ and superpowers/plans/

Move all design docs to docs/superpowers/specs/ and all implementation
plans to docs/superpowers/plans/ for consistent organization.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Lum1104 · 2026-04-11 09:15:51 +08:00

b2c2934291

docs: add /understand-knowledge implementation plan (14 tasks)

Detailed step-by-step plan covering core type extensions, schema validation,
dashboard changes (CSS, store, sidebar, reading panel, edge styling, layout),
agent definitions, format guides, and skill definition.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Lum1104 · 2026-04-11 09:15:51 +08:00

e58ceb856f

docs: add /understand-knowledge design spec for personal knowledge base plugin

New skill that takes markdown knowledge bases (Obsidian, Logseq, Dendron, Foam,
Karpathy-style, Zettelkasten, plain) and produces interactive knowledge graphs
with typed nodes/edges, auto-format detection, and dashboard visualization.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Lum1104 · 2026-04-11 09:15:51 +08:00

098ad791c0

Add funding information for Patreon

Yuxiang Lin · 2026-04-10 19:45:02 +08:00

78b72724ed

fix: address code review — remove bin/ from defaults, fix negation override flow

- Remove bin/ from DEFAULT_IGNORE_PATTERNS (Node/Ruby CLI launchers use bin/)
- .NET users can add bin/ to .understandignore manually
- Fix project-scanner Step 2.5 to re-filter from original file list when
  .understandignore exists, ensuring ! negation correctly overrides defaults

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Lum1104 · 2026-04-10 11:51:59 +08:00

d3de6dc1fd

fix: update pnpm-lock.yaml with ignore dependency

Lum1104 · 2026-04-10 11:45:05 +08:00

2104501bc8

feat(skill): add Phase 0.5 for .understandignore setup and review pause

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Lum1104 · 2026-04-10 11:39:45 +08:00

59a6f56bfe

feat(agent): add .understandignore support and bin/obj exclusions to project-scanner

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Lum1104 · 2026-04-10 11:38:23 +08:00

3e27a4a8d4

feat(core): export IgnoreFilter and IgnoreGenerator from core index

Lum1104 · 2026-04-10 11:36:53 +08:00

4201cbcb9e

feat(core): add IgnoreGenerator for starter .understandignore file creation

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Lum1104 · 2026-04-10 11:36:23 +08:00

6f8270fb37

feat(core): add IgnoreFilter module with .understandignore parsing and tests

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Lum1104 · 2026-04-10 11:33:10 +08:00

5e86254b77

chore(core): add ignore package for .understandignore support

Lum1104 · 2026-04-10 11:30:52 +08:00

07b02d18ae

docs: add .understandignore implementation plan (7 tasks)

TDD-driven plan covering IgnoreFilter module, IgnoreGenerator, core exports,
project-scanner agent update, and skill Phase 0.5 integration.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Lum1104 · 2026-04-10 11:27:47 +08:00

c077623389

docs: add .understandignore design spec

User-configurable file exclusion using .gitignore syntax, with hardcoded
defaults, auto-generated starter file, and pre-analysis review pause.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Lum1104 · 2026-04-10 11:24:49 +08:00

ce25b61e36

docs: reorganize docs/ into superpowers/specs/ and superpowers/plans/

Move all design docs to docs/superpowers/specs/ and all implementation
plans to docs/superpowers/plans/ for consistent organization.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Lum1104 · 2026-04-09 23:11:44 +08:00

b3acd5b1d2

docs: add /understand-knowledge implementation plan (14 tasks)

Detailed step-by-step plan covering core type extensions, schema validation,
dashboard changes (CSS, store, sidebar, reading panel, edge styling, layout),
agent definitions, format guides, and skill definition.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Lum1104 · 2026-04-09 23:06:32 +08:00

7c999602bf

docs: add /understand-knowledge design spec for personal knowledge base plugin

New skill that takes markdown knowledge bases (Obsidian, Logseq, Dendron, Foam,
Karpathy-style, Zettelkasten, plain) and produces interactive knowledge graphs
with typed nodes/edges, auto-format detection, and dashboard visualization.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Lum1104 · 2026-04-09 22:56:00 +08:00

9f7931a1f9

fix: include access token in dashboard URL reported to user

The understand-dashboard skill now instructs agents to capture and
share the full tokenized URL from the Vite server output, so users
are not blocked by the token gate.

Bump version to 2.2.1.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Lum1104 · 2026-04-09 22:50:20 +08:00

1842541a93

docs: add platform badges for Codex, Copilot, Gemini CLI, OpenCode

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Lum1104 · 2026-04-09 18:58:22 +08:00

003339ec88

docs: add animated showcase GIFs and streamline READMEs

- Replace static overview.png with two animated GIFs (structural + domain views)
- Reorder READMEs: Features section before Quick Start
- Remove redundant sections (Why, Who is this for, duplicate feature entries)
- Move project structure/tech stack/dev commands to CONTRIBUTING.md
- Homepage: use Supabase-hosted MP4 videos via GitHub variables, GIF fallback
- Add DEMO_STRUCTURAL_VIDEO_URL and DEMO_DOMAIN_VIDEO_URL to deploy workflow

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Lum1104 · 2026-04-09 18:42:51 +08:00

7e40b6d03a

docs: update README tagline with expanded input types and multi-platform support

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Lum1104 · 2026-04-09 00:46:39 +08:00

04972b63f6

fix: sync copilot plugin version to 2.2.0

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Lum1104 · 2026-04-06 12:11:51 +08:00

311f2ad1ac

Merge pull request #74 from bryan-anthropic/fix/marketplace-json-schema

fix: remove invalid keys from marketplace.json plugins entry

Yuxiang Lin · 2026-04-06 00:03:36 +08:00

f9f07d7cb9

fix: remove invalid keys from marketplace.json plugins entry

The plugins array entries only support 'name' and 'source' fields.
The 'version' and 'description' keys cause schema validation failures
during the marketplace review process.

Bryan Thompson · 2026-04-05 10:52:56 -05:00

46ab9255f6

fix: add metadata.description to marketplace.json to resolve validation warning

Lum1104 · 2026-04-05 12:30:25 +08:00

bc51673913

Merge pull request #73 from bryan-anthropic/fix/marketplace-json-schema

Fix marketplace.json schema validation

Yuxiang Lin · 2026-04-04 23:53:53 +08:00

fb9d60dfe3

Fix marketplace.json schema validation

Remove root-level "version" and "description" keys that are not
recognized by the marketplace schema validator. The description
is already correctly set in the plugins array entry.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Bryan Thompson · 2026-04-04 10:17:27 -05:00

5c35dc9550

Merge pull request #71 from Lum1104/feat/merge-graphs

feat: add graph merge scripts and improve agent pipeline

Yuxiang Lin · 2026-04-04 16:29:02 +08:00

cf15d49850

fix: coerce edge weights to float before comparison in merge scripts

Prevents TypeError crash when LLM batches emit mixed weight types
(e.g. 0.8 vs "0.7") during edge deduplication.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Lum1104 · 2026-04-04 12:50:04 +08:00

660f766783

fix: address PR #71 review findings and bump version to 2.2.0

Fix all actionable code review items: add missing domain/flow/step node
types, fix batch numeric sorting, align gate thresholds, merge duplicate
tour steps instead of dropping, add Writing Results section to
assemble-reviewer, use skill-relative script paths, and add func→function
type mapping.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Lum1104 · 2026-04-04 12:28:20 +08:00

52050e40cb

feat: add graph merge scripts and improve agent pipeline reliability

Add Python scripts to merge knowledge graphs (closes #70) and move
mechanical normalization out of LLM context into deterministic scripts
with diagnostic reporting. Convert all agent definitions from dispatch
templates to self-contained system prompts to prevent instruction loss.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Lum1104 · 2026-04-04 11:56:58 +08:00

b3683d62e2

docs: add live demo badge and switch to default rounded badges across all READMEs

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Lum1104 · 2026-04-03 11:55:01 +08:00

3dfacd1c43

feat: add live demo dashboard on GitHub Pages

Add a demo mode to the dashboard that fetches graph data from Supabase
Storage instead of the local Vite dev server, bypasses the token gate,
and deploys alongside the homepage at /Understand-Anything/demo/.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Lum1104 · 2026-04-03 11:49:00 +08:00

d6a80224b6

Merge pull request #66 from Lum1104/feat/business-knowledge

feat: add business domain knowledge extraction and visualization

Yuxiang Lin · 2026-04-03 00:18:38 +08:00

v2.1.0 2ec1c37efa

fix(dashboard): auto-widen domain graph spacing for long edge labels

Instead of truncating cross_domain edge labels, compute ranksep from
the longest label length (~6px/char) so dagre spaces nodes further
apart. Also add label background for readability, and support
spacingOverrides parameter in applyDagreLayout.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Lum1104 · 2026-04-03 00:17:20 +08:00

63ee658478

docs: add business domain knowledge feature to all README translations

Add /understand-domain command, domain-analyzer agent, and two new
feature entries (Business Domain Knowledge + Structural/Domain Views)
to all 5 README versions: English, Simplified Chinese, Traditional
Chinese, Japanese, and Turkish.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Lum1104 · 2026-04-03 00:10:01 +08:00

87cfe0d869

chore: update pnpm-lock.yaml

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Lum1104 · 2026-04-03 00:05:10 +08:00

6d01c449c5

fix(dashboard): address 8 audit issues across dashboard components

1. Add infrastructure edge category to EDGE_CATEGORY_MAP for 8 missing
   edge types (deploys, serves, provisions, triggers, migrates, documents,
   routes, defines_schema) — previously unfiltered regardless of toggles

2. navigateToDomain now switches viewMode to "domain" — previously
   clicking flow buttons from structural mode was a silent no-op

3. ExportMenu JSON export for non-technical persona now keeps all
   file-level types — previously dropped config/document/service/etc.

4. ProjectOverview category breakdown now includes module/concept in
   Code and domain/flow/step in new Domain category

5. SearchBar type badge colors now cover all 16 node types — previously
   only 5 had colors, rest fell back to file color

6. PathFinder BFS now traverses edges bidirectionally — previously
   only followed forward direction, missing valid reverse paths

7. GraphView node filtering consolidated into single authoritative
   type set — previously fileLevelTypes and persona conditions were
   separate lists that could drift

8. SelectedNodeFitView delayed 100ms to run after layer-level fitView
   on search-click navigation — previously layer fit clobbered node fit

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Lum1104 · 2026-04-03 00:03:03 +08:00

20eb483195

fix(dashboard): show function/class nodes in layer detail view

Function and class nodes were invisible in the graph because they
are not directly assigned to layers (only file-level nodes are).
Expand layer membership by following `contains` edges from file nodes
in the active layer to include their child function/class nodes.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Lum1104 · 2026-04-02 23:56:34 +08:00

d52dd933ee

323 Commits