class-ai-agent 1.5.1 → 1.6.2
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/.agent/rules/antigravity-overview.md +2 -1
- package/.agent/rules/codegraph.md +8 -0
- package/.agent/rules/ontosight.md +89 -0
- package/.agents/references/codegraph.md +4 -0
- package/.agents/references/ontosight.md +130 -0
- package/.agents/skills/ui-ux-pro-max/IMPACT-DEMO.md +101 -0
- package/.claude/CLAUDE.md +16 -0
- package/.claude/references/ontosight.md +130 -0
- package/.claude/rules/codegraph.md +8 -0
- package/.claude/rules/ontosight.md +85 -0
- package/.claude/skills/ui-ux-pro-max/IMPACT-DEMO.md +101 -0
- package/.cursor/CURSOR.md +16 -0
- package/.cursor/references/codegraph.md +4 -0
- package/.cursor/references/ontosight.md +130 -0
- package/.cursor/rules/codegraph.mdc +8 -0
- package/.cursor/rules/cursor-overview.mdc +1 -0
- package/.cursor/rules/ontosight.mdc +89 -0
- package/.cursor/skills/ui-ux-pro-max/IMPACT-DEMO.md +101 -0
- package/.kiro/KIRO.md +16 -1
- package/.kiro/references/codegraph.md +4 -0
- package/.kiro/references/ontosight.md +130 -0
- package/.kiro/skills/ui-ux-pro-max/IMPACT-DEMO.md +101 -0
- package/.kiro/steering/codegraph.md +8 -0
- package/.kiro/steering/kiro-overview.md +2 -1
- package/.kiro/steering/ontosight.md +89 -0
- package/AGENTS.md +5 -0
- package/GEMINI.md +17 -1
- package/README.md +60 -7
- package/bin/class-ai-agent.cjs +5 -0
- package/package.json +3 -2
|
@@ -0,0 +1,101 @@
|
|
|
1
|
+
# Impact analysis demonstration — UX playbook
|
|
2
|
+
|
|
3
|
+
Use this playbook when presenting **CodeGraph impact analysis** with an **OntoSight** graph demo. It extends the [ui-ux-pro-max SKILL](SKILL.md) for a specific agent workflow — not a full design-system pass.
|
|
4
|
+
|
|
5
|
+
**Skill path by tool:** `.cursor/skills/ui-ux-pro-max/`, `.claude/skills/ui-ux-pro-max/`, `.kiro/skills/ui-ux-pro-max/`, `.agents/skills/ui-ux-pro-max/`
|
|
6
|
+
|
|
7
|
+
---
|
|
8
|
+
|
|
9
|
+
## When to use
|
|
10
|
+
|
|
11
|
+
User asks about blast radius, what breaks, downstream impact, or wants to **see** / **show** / **demonstrate** impact before a refactor, rename, or delete.
|
|
12
|
+
|
|
13
|
+
Pair with **`.cursor/rules/ontosight.mdc`** (or synced `ontosight` rule in your tool tree).
|
|
14
|
+
|
|
15
|
+
---
|
|
16
|
+
|
|
17
|
+
## ui-ux-pro-max searches (optional, recommended)
|
|
18
|
+
|
|
19
|
+
Run from project root. Adjust the skills path to match your tool.
|
|
20
|
+
|
|
21
|
+
### Network graph UX
|
|
22
|
+
|
|
23
|
+
```bash
|
|
24
|
+
python3 .cursor/skills/ui-ux-pro-max/scripts/search.py "relationship connection network graph" --domain chart
|
|
25
|
+
```
|
|
26
|
+
|
|
27
|
+
Use for: drilldown + hover expectations; provide an adjacency-list or ranked table alternative (network graphs are poor for screen-reader-only users).
|
|
28
|
+
|
|
29
|
+
### Impact tier framing
|
|
30
|
+
|
|
31
|
+
```bash
|
|
32
|
+
python3 .cursor/skills/ui-ux-pro-max/scripts/search.py "root cause decomposition hierarchy drill-down" --domain chart
|
|
33
|
+
```
|
|
34
|
+
|
|
35
|
+
Use for: grouping impact into tiers (direct callers vs transitive) in chat before opening the graph.
|
|
36
|
+
|
|
37
|
+
### Progressive disclosure
|
|
38
|
+
|
|
39
|
+
```bash
|
|
40
|
+
python3 .cursor/skills/ui-ux-pro-max/scripts/search.py "progressive disclosure loading feedback" --domain ux
|
|
41
|
+
```
|
|
42
|
+
|
|
43
|
+
Use for: summary-before-graph; tell the user what OntoSight is loading and what they will see.
|
|
44
|
+
|
|
45
|
+
---
|
|
46
|
+
|
|
47
|
+
## Chat summary template
|
|
48
|
+
|
|
49
|
+
Present this **before** running `npx @royalsolution/ontosight@0.2.0`:
|
|
50
|
+
|
|
51
|
+
### 1. Seed
|
|
52
|
+
|
|
53
|
+
- Symbol name, kind (function, class, …), file path
|
|
54
|
+
|
|
55
|
+
### 2. Blast radius
|
|
56
|
+
|
|
57
|
+
Top 5–10 from `codegraph_impact`, in a **ranked table**:
|
|
58
|
+
|
|
59
|
+
| Rank | Symbol | File | Relationship |
|
|
60
|
+
|------|--------|------|--------------|
|
|
61
|
+
| 1 | … | … | direct caller |
|
|
62
|
+
| 2 | … | … | transitive |
|
|
63
|
+
|
|
64
|
+
Group by risk: **direct callers** (highest) vs **transitive** (lower).
|
|
65
|
+
|
|
66
|
+
### 3. What the graph shows
|
|
67
|
+
|
|
68
|
+
- Seed node and `--hops` depth (typically 3 for impact demos)
|
|
69
|
+
- Note that OntoSight highlights critical / hub nodes in the topology table
|
|
70
|
+
- Mention interactive pan, zoom, and live CodeGraph re-query in the browser
|
|
71
|
+
|
|
72
|
+
### 4. Action
|
|
73
|
+
|
|
74
|
+
Short line: *"Opening interactive impact graph…"* then run:
|
|
75
|
+
|
|
76
|
+
```bash
|
|
77
|
+
npx @royalsolution/ontosight@0.2.0 . --symbol <name> --path <dir-from-search> --hops 3 --max-nodes 200
|
|
78
|
+
```
|
|
79
|
+
|
|
80
|
+
---
|
|
81
|
+
|
|
82
|
+
## Accessibility notes
|
|
83
|
+
|
|
84
|
+
- **Always** include the ranked table — graph-only answers fail accessibility guidance for network visualizations.
|
|
85
|
+
- Keep table columns sortable by impact rank when possible in prose.
|
|
86
|
+
- If subgraph truncates, say so and offer a narrower `--path` before raising `--max-nodes`.
|
|
87
|
+
|
|
88
|
+
---
|
|
89
|
+
|
|
90
|
+
## Full agent workflow
|
|
91
|
+
|
|
92
|
+
```text
|
|
93
|
+
1. codegraph_search({ query: "<symbol>" })
|
|
94
|
+
2. codegraph_impact({ query: "<symbol>" })
|
|
95
|
+
3. Read this file (IMPACT-DEMO.md)
|
|
96
|
+
4. Optional: ui-ux-pro-max chart/ux searches above
|
|
97
|
+
5. Chat summary (template sections 1–3)
|
|
98
|
+
6. npx @royalsolution/ontosight@0.2.0 . --symbol <name> --path <dir> --hops 3 --max-nodes 200
|
|
99
|
+
```
|
|
100
|
+
|
|
101
|
+
See **`.cursor/references/ontosight.md`** for flags and troubleshooting.
|
|
@@ -23,6 +23,14 @@ Use codegraph for **structural** questions — what calls what, what would break
|
|
|
23
23
|
| "See several related symbols' source at once" | `codegraph_explore` |
|
|
24
24
|
| "What files exist under path/" | `codegraph_files` |
|
|
25
25
|
| "Is the index healthy?" | `codegraph_status` |
|
|
26
|
+
| Visual exploration of a subgraph in browser | `npx @royalsolution/ontosight@0.2.0` (see **`.kiro/rules/ontosight.md`**) |
|
|
27
|
+
| "Show/demonstrate impact of changing Z" | `codegraph_impact` → then OntoSight `--symbol Z` (see **`.kiro/rules/ontosight.md`**) |
|
|
28
|
+
|
|
29
|
+
### Visualization
|
|
30
|
+
|
|
31
|
+
For interactive call-graph UI (user asks to "show the graph" or explore architecture visually), use **OntoSight CLI** after gathering context with `codegraph_*` tools. See **`.kiro/rules/ontosight.md`**.
|
|
32
|
+
|
|
33
|
+
For **impact demonstration** requests ("show impact", "blast radius", "what breaks if I change X"), run `codegraph_impact` first, present a text summary, then open OntoSight — never stop at MCP text alone when the user wants to see or show impact.
|
|
26
34
|
|
|
27
35
|
### Tool parameters (do not mix)
|
|
28
36
|
|
|
@@ -24,10 +24,11 @@ Supporting prompts: `debug`, `simplify`, `fix-issue`, `handoff`, `resume` in `.k
|
|
|
24
24
|
|
|
25
25
|
## Mandatory standards
|
|
26
26
|
|
|
27
|
-
- Follow **`.kiro/steering/`** (`*.md` with YAML frontmatter). **`security.md`**, **`codegraph.md`**, and **`agent-continuity.md`** use `inclusion: always`; others often use `fileMatch`.
|
|
27
|
+
- Follow **`.kiro/steering/`** (`*.md` with YAML frontmatter). **`security.md`**, **`codegraph.md`**, **`ontosight.md`**, and **`agent-continuity.md`** use `inclusion: always`; others often use `fileMatch`.
|
|
28
28
|
- Prefer **tests first** and **small vertical slices** (see `.kiro/skills/incremental-implementation/`).
|
|
29
29
|
- Use **`.kiro/references/`** for checklists (security, testing, performance, accessibility).
|
|
30
30
|
- For **structural** code questions, prefer **CodeGraph** MCP tools per **`.kiro/steering/codegraph.md`**.
|
|
31
|
+
- When the user wants a **visual call graph**, use **OntoSight CLI** per **`.kiro/steering/ontosight.md`** (`npx @royalsolution/ontosight@0.2.0`).
|
|
31
32
|
|
|
32
33
|
## Agents (personas)
|
|
33
34
|
|
|
@@ -0,0 +1,89 @@
|
|
|
1
|
+
---
|
|
2
|
+
inclusion: always
|
|
3
|
+
description: "OntoSight CLI — visualize CodeGraph call subgraphs in the browser"
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
## OntoSight
|
|
7
|
+
|
|
8
|
+
[OntoSight](https://www.npmjs.com/package/@royalsolution/ontosight) visualizes CodeGraph call subgraphs in an interactive browser UI. It is **not** an MCP server — there are no `ontosight_*` tools. Use **CodeGraph MCP** (`codegraph_*`) to answer structural questions in chat; use **OntoSight CLI** when the user wants a visual, interactive call graph.
|
|
9
|
+
|
|
10
|
+
See **`.kiro/rules/codegraph.md`** for MCP usage and **`.kiro/references/ontosight.md`** for full flags and troubleshooting.
|
|
11
|
+
|
|
12
|
+
### CodeGraph MCP vs OntoSight
|
|
13
|
+
|
|
14
|
+
| Goal | Use |
|
|
15
|
+
|------|-----|
|
|
16
|
+
| Find symbols, callers, traces, impact (text in chat) | `codegraph_*` MCP tools |
|
|
17
|
+
| Visual exploration of a subgraph | `npx @royalsolution/ontosight@0.2.0` |
|
|
18
|
+
| User says "show me the graph" | OntoSight CLI |
|
|
19
|
+
| Impact / blast radius demonstration | `codegraph_impact` → summary → OntoSight CLI |
|
|
20
|
+
|
|
21
|
+
Rule of thumb: gather facts with CodeGraph MCP; open OntoSight when visualization helps the human explore complexity you already identified.
|
|
22
|
+
|
|
23
|
+
### When to run OntoSight
|
|
24
|
+
|
|
25
|
+
Run (or suggest) OntoSight when the user:
|
|
26
|
+
|
|
27
|
+
- Asks to visualize, show, or explore a call graph or architecture
|
|
28
|
+
- Wants an interactive view after you surfaced symbols via `codegraph_search` / `codegraph_context`
|
|
29
|
+
- Is doing onboarding or architecture review and benefits from a graph UI
|
|
30
|
+
- Asks about **impact**, **blast radius**, or **what breaks** and wants to see or demonstrate scope (refactor, rename, delete)
|
|
31
|
+
|
|
32
|
+
Do **not** run OntoSight to collect agent context — that duplicates CodeGraph MCP and blocks the terminal while the browser is open.
|
|
33
|
+
|
|
34
|
+
### Impact analysis demonstration
|
|
35
|
+
|
|
36
|
+
**Triggers** — open the graph, not only text:
|
|
37
|
+
|
|
38
|
+
- "impact", "blast radius", "what breaks", "what would break", "downstream", "affected by"
|
|
39
|
+
- "show impact", "demonstrate impact", "visualize impact"
|
|
40
|
+
- User is about to refactor, rename, or delete a symbol and wants to see scope
|
|
41
|
+
|
|
42
|
+
**Workflow** (mandatory order):
|
|
43
|
+
|
|
44
|
+
1. `codegraph_search({ query: "<symbol>" })` — confirm name, file, kind
|
|
45
|
+
2. `codegraph_impact({ query: "<symbol>" })` — ranked blast radius (chat facts)
|
|
46
|
+
3. Read **`.kiro/skills/ui-ux-pro-max/IMPACT-DEMO.md`** — presentation checklist (use your tool's skills path: `.claude/skills/`, `.kiro/skills/`, `.agents/skills/`)
|
|
47
|
+
4. Optional: run ui-ux-pro-max searches from the playbook for chart/UX framing
|
|
48
|
+
5. Summarize in chat: seed symbol, top impacted callers, risk tier, what the graph will highlight
|
|
49
|
+
6. `npx @royalsolution/ontosight@0.2.0 . --symbol <name> --path <dir> --hops 3 --max-nodes 200`
|
|
50
|
+
|
|
51
|
+
**Hop guidance:** use `--hops 3` (or `4` for deep trees) for impact demos; prefer `--path` over raising `--max-nodes` when truncated.
|
|
52
|
+
|
|
53
|
+
**UX rule:** always give a **text summary before** opening the browser (progressive disclosure); include a **ranked table** of top impacted symbols as an accessible alternative to the graph alone.
|
|
54
|
+
|
|
55
|
+
### Suggested workflows
|
|
56
|
+
|
|
57
|
+
**Symbol the user named:**
|
|
58
|
+
|
|
59
|
+
1. `codegraph_search({ query: "<name>" })` → confirm file + kind
|
|
60
|
+
2. Summarize in chat
|
|
61
|
+
3. `npx @royalsolution/ontosight@0.2.0 . --symbol <name> --path <dir-from-search>`
|
|
62
|
+
|
|
63
|
+
**Feature area ("how does auth work?"):**
|
|
64
|
+
|
|
65
|
+
1. `codegraph_context({ task: "authentication flow", maxNodes: 20 })`
|
|
66
|
+
2. Summarize key symbols in chat
|
|
67
|
+
3. `npx @royalsolution/ontosight@0.2.0 . --task "authentication flow" --hops 2 --max-nodes 200`
|
|
68
|
+
|
|
69
|
+
**Large repo:** prefer `--path` or `--symbol` before raising `--max-nodes`.
|
|
70
|
+
|
|
71
|
+
### Commands
|
|
72
|
+
|
|
73
|
+
```bash
|
|
74
|
+
npx @royalsolution/ontosight@0.2.0 .
|
|
75
|
+
npx @royalsolution/ontosight@0.2.0 . --symbol <name> --path <dir>
|
|
76
|
+
npx @royalsolution/ontosight@0.2.0 . --task "auth flow" --hops 2 --max-nodes 200
|
|
77
|
+
npx @royalsolution/ontosight@0.2.0 . --symbol <name> --path <dir> --hops 3 --max-nodes 200
|
|
78
|
+
```
|
|
79
|
+
|
|
80
|
+
Auto-creates the CodeGraph index when `.codegraph/codegraph.db` is missing (unless `ONTOSIGHT_SKIP_AUTO_INIT=1`). Ask the user before auto-init on very large repos.
|
|
81
|
+
|
|
82
|
+
### Prerequisites
|
|
83
|
+
|
|
84
|
+
| Requirement | Notes |
|
|
85
|
+
|-------------|-------|
|
|
86
|
+
| Node 20+ | For `npx @royalsolution/ontosight@0.2.0` |
|
|
87
|
+
| Python 3.11+ | Used by `ontosight-codegraph` |
|
|
88
|
+
| uv (recommended) or pipx | Wrapper tries `uvx` first, then `pipx run` |
|
|
89
|
+
| CodeGraph index | `.codegraph/codegraph.db` in project root |
|
package/AGENTS.md
CHANGED
|
@@ -34,6 +34,11 @@ Project guidance for AI coding agents:
|
|
|
34
34
|
|
|
35
35
|
**Cross-tool continuity:** committed [`.agent/SESSION.md`](.agent/README.md) — use `/resume` at session start and `/handoff` at session end (see hub docs and `.agent/README.md`).
|
|
36
36
|
|
|
37
|
+
## Code intelligence
|
|
38
|
+
|
|
39
|
+
- **CodeGraph MCP** (`codegraph_*`) — structural code search in chat; rules in each tool's `codegraph` rule file
|
|
40
|
+
- **OntoSight** (`npx @royalsolution/ontosight@0.2.0`) — interactive call-graph visualization in the browser; rules in each tool's `ontosight` rule file
|
|
41
|
+
|
|
37
42
|
## Maintainers
|
|
38
43
|
|
|
39
44
|
Keep **`.claude/`**, **`.cursor/`**, **`.kiro/`**, and the Antigravity layout in sync when you change workflows or standards. After editing **`.cursor/`** (canonical), run **`npm run sync:all`** to refresh `.claude/`, `.kiro/`, `.agents/`, `.agent/rules/`, and `GEMINI.md`. To refresh vendored Supabase skills from upstream, run **`npm run sync:supabase-skills`**.
|
package/GEMINI.md
CHANGED
|
@@ -52,7 +52,7 @@ Follow this workflow for feature development:
|
|
|
52
52
|
|
|
53
53
|
Project standards are **`.agent/rules/*.md`**. They use YAML frontmatter:
|
|
54
54
|
|
|
55
|
-
- **`trigger: always_on`** — Loaded every session (`antigravity-overview.md`, `security.md`, `codegraph.md`, `agent-continuity.md`)
|
|
55
|
+
- **`trigger: always_on`** — Loaded every session (`antigravity-overview.md`, `security.md`, `codegraph.md`, `ontosight.md`, `agent-continuity.md`)
|
|
56
56
|
- **`trigger: glob`** — Loaded when active files match `globs`
|
|
57
57
|
- **`trigger: model_decision`** — Activated by intent (persona rules)
|
|
58
58
|
|
|
@@ -63,6 +63,7 @@ Project standards are **`.agent/rules/*.md`**. They use YAML frontmatter:
|
|
|
63
63
|
| Data & naming | `naming-conventions`, `database` |
|
|
64
64
|
| Ops & quality | `security`, `monitoring`, `testing`, `git-workflow`, `system-design` |
|
|
65
65
|
| Code intelligence | `codegraph` (MCP usage; see below) |
|
|
66
|
+
| Code visualization | `ontosight` (CLI; see below) |
|
|
66
67
|
| Agent continuity | `agent-continuity` (`.agent/SESSION.md` handoff) |
|
|
67
68
|
|
|
68
69
|
---
|
|
@@ -90,6 +91,20 @@ If the index is missing, run `npx @colbymchenry/codegraph init -i` in the projec
|
|
|
90
91
|
|
|
91
92
|
---
|
|
92
93
|
|
|
94
|
+
## Code visualization (OntoSight)
|
|
95
|
+
|
|
96
|
+
This project includes **[OntoSight](https://www.npmjs.com/package/@royalsolution/ontosight)** for interactive CodeGraph call subgraphs in the browser.
|
|
97
|
+
|
|
98
|
+
| Item | Location |
|
|
99
|
+
|------|----------|
|
|
100
|
+
| Usage rules | `.agent/rules/ontosight.md` |
|
|
101
|
+
| Setup reference | `.agents/references/ontosight.md` |
|
|
102
|
+
| Shared index | `.codegraph/` (same as CodeGraph) |
|
|
103
|
+
|
|
104
|
+
Use `codegraph_*` MCP tools to gather structural facts in chat; run `npx @royalsolution/ontosight@0.2.0 .` when the user wants a visual call graph. For **impact analysis demos**, follow `skills/ui-ux-pro-max/IMPACT-DEMO.md` (search → `codegraph_impact` → summary → graph). Requires Node 20+, Python 3.11+, and uv or pipx.
|
|
105
|
+
|
|
106
|
+
---
|
|
107
|
+
|
|
93
108
|
## Agent personas
|
|
94
109
|
|
|
95
110
|
Instructions live in **`.agents/agents/`**. Invoke by **referencing** the file (paste or attach in chat).
|
|
@@ -130,6 +145,7 @@ Reusable playbooks: **`.agents/skills/*/SKILL.md`** (and related `.md` files whe
|
|
|
130
145
|
| `performance-checklist.md` | Performance |
|
|
131
146
|
| `accessibility-checklist.md` | WCAG-oriented checks |
|
|
132
147
|
| `codegraph.md` | CodeGraph setup (all tools) |
|
|
148
|
+
| `ontosight.md` | OntoSight CLI for visual call graphs |
|
|
133
149
|
| `mcp-antigravity.md` | Antigravity MCP config (`mcp_config.json`) |
|
|
134
150
|
| `agent-continuity.md` | Session handoff and `/resume` / `/handoff` |
|
|
135
151
|
| `supabase.md` | Supabase skills, MCP OAuth, secrets |
|
package/README.md
CHANGED
|
@@ -18,7 +18,7 @@ Open-source AI agent scaffolding by **Royal Solution** — use it in your own pr
|
|
|
18
18
|
<a href="https://www.npmjs.com/package/class-ai-agent"><img src="https://img.shields.io/npm/v/class-ai-agent?label=npm&logo=npm&style=flat-square" alt="npm version" /></a>
|
|
19
19
|
<img src="https://img.shields.io/badge/node-%3E%3D16.7-339933?logo=node.js&logoColor=white&style=flat-square" alt="Node.js 16.7+" />
|
|
20
20
|
<img src="https://img.shields.io/badge/license-MIT-blue?style=flat-square" alt="License MIT" />
|
|
21
|
-
<img src="https://img.shields.io/badge/version-1.
|
|
21
|
+
<img src="https://img.shields.io/badge/version-1.6.2-blue?style=flat-square" alt="Version" />
|
|
22
22
|
</p>
|
|
23
23
|
|
|
24
24
|
</div>
|
|
@@ -30,6 +30,7 @@ Open-source AI agent scaffolding by **Royal Solution** — use it in your own pr
|
|
|
30
30
|
- [Why use this](#why-use-this)
|
|
31
31
|
- [Install (quick)](#install-quick)
|
|
32
32
|
- [CodeGraph (code intelligence)](#codegraph-code-intelligence)
|
|
33
|
+
- [OntoSight (code visualization)](#ontosight-code-visualization)
|
|
33
34
|
- [Agent continuity (cross-tool)](#agent-continuity-cross-tool)
|
|
34
35
|
- [Overview](#overview)
|
|
35
36
|
- [Development workflow](#development-workflow)
|
|
@@ -57,6 +58,7 @@ Open-source AI agent scaffolding by **Royal Solution** — use it in your own pr
|
|
|
57
58
|
| **13 topic rules** | Code style, security, API, DB, testing, git, and more (same ideas in both trees) |
|
|
58
59
|
| **`npx` installer** | Copies the folders into your project in one command |
|
|
59
60
|
| **CodeGraph** | MCP + usage rules for Cursor and Kiro; Antigravity via user `mcp_config.json`; local index via [CodeGraph](https://github.com/colbymchenry/codegraph) |
|
|
61
|
+
| **OntoSight** | Visual call-graph UI via `npx @royalsolution/ontosight@0.2.0`; usage rules synced to all four agent trees |
|
|
60
62
|
| **Agent continuity** | Committed **`.agent/SESSION.md`** — `/resume` and `/handoff` across Cursor, Claude Code, Kiro, and Antigravity |
|
|
61
63
|
|
|
62
64
|
Root **`AGENTS.md`** links hubs: **`.cursor/CURSOR.md`**, **`.kiro/KIRO.md`**, **`.claude/CLAUDE.md`**, **`GEMINI.md`**.
|
|
@@ -138,6 +140,41 @@ npm exec -- class-ai-agent --dir /path/to/your/project
|
|
|
138
140
|
|
|
139
141
|
---
|
|
140
142
|
|
|
143
|
+
## OntoSight (code visualization)
|
|
144
|
+
|
|
145
|
+
[class-ai-agent](https://www.npmjs.com/package/class-ai-agent) integrates **[OntoSight](https://www.npmjs.com/package/@royalsolution/ontosight)** — interactive CodeGraph call subgraphs in the browser. OntoSight complements CodeGraph MCP: use `codegraph_*` for facts in chat; use OntoSight when the user wants a visual graph.
|
|
146
|
+
|
|
147
|
+
| Topic | Details |
|
|
148
|
+
|-------|---------|
|
|
149
|
+
| **What you get** | Always-on usage rules across Cursor, Claude Code, Kiro, and Antigravity |
|
|
150
|
+
| **Cursor** | `.cursor/rules/ontosight.mdc`, `.cursor/references/ontosight.md` |
|
|
151
|
+
| **Kiro** | `.kiro/steering/ontosight.md`, `.kiro/references/ontosight.md` |
|
|
152
|
+
| **Claude Code** | `.claude/rules/ontosight.md`, `.claude/references/ontosight.md` |
|
|
153
|
+
| **Antigravity** | `.agent/rules/ontosight.md`, `.agents/references/ontosight.md` |
|
|
154
|
+
| **Quick start** | `npx @royalsolution/ontosight@0.2.0 .` (auto-inits CodeGraph index if missing) |
|
|
155
|
+
| **Pinned version** | `@royalsolution/ontosight@0.2.0` (`ontosight-codegraph` 0.2.0 on PyPI) |
|
|
156
|
+
| **Requirements** | Node 20+, Python 3.11+, uv or pipx; shares `.codegraph/` with CodeGraph |
|
|
157
|
+
| **Troubleshooting** | `.cursor/references/ontosight.md` |
|
|
158
|
+
| **Impact demos** | `skills/ui-ux-pro-max/IMPACT-DEMO.md` — `codegraph_impact` → UX summary → graph |
|
|
159
|
+
|
|
160
|
+
Example agent workflow (feature area):
|
|
161
|
+
|
|
162
|
+
```text
|
|
163
|
+
1. codegraph_context({ task: "auth flow", maxNodes: 20 }) → answer in chat
|
|
164
|
+
2. npx @royalsolution/ontosight@0.2.0 . --task "auth flow" --hops 2 → open graph for user
|
|
165
|
+
```
|
|
166
|
+
|
|
167
|
+
Example **impact analysis** demo:
|
|
168
|
+
|
|
169
|
+
```text
|
|
170
|
+
1. codegraph_search({ query: "deleteUser" })
|
|
171
|
+
2. codegraph_impact({ query: "deleteUser" }) → ranked blast radius in chat
|
|
172
|
+
3. Follow IMPACT-DEMO.md (ui-ux-pro-max presentation)
|
|
173
|
+
4. npx @royalsolution/ontosight@0.2.0 . --symbol deleteUser --path src/services/ --hops 3
|
|
174
|
+
```
|
|
175
|
+
|
|
176
|
+
---
|
|
177
|
+
|
|
141
178
|
## Overview
|
|
142
179
|
|
|
143
180
|
This repo ships **four parallel layouts** so you can use the same habits in Claude Code, Cursor, Kiro, and Antigravity:
|
|
@@ -153,12 +190,12 @@ What is inside:
|
|
|
153
190
|
|
|
154
191
|
- **Structured workflow** (Spec → Plan → Build → Test → Review → Ship)
|
|
155
192
|
- **10 specialized agents** (markdown personas under `agents/`)
|
|
156
|
-
- **13 mandatory topic rules** (plus **`cursor-overview.mdc`**, **`codegraph.mdc`**, and **`agent-continuity.mdc`** under `.cursor/rules/`)
|
|
193
|
+
- **13 mandatory topic rules** (plus **`cursor-overview.mdc`**, **`codegraph.mdc`**, **`ontosight.mdc`**, and **`agent-continuity.mdc`** under `.cursor/rules/`)
|
|
157
194
|
- **11 workflow prompts** under `commands/` (includes `handoff`, `resume`)
|
|
158
195
|
- **9 skills** (TDD, code review, incremental implementation, deploy, security review, agent continuity, UI/UX Pro Max, **supabase**, **supabase-postgres-best-practices**)
|
|
159
|
-
- **
|
|
196
|
+
- **8 reference docs** (security, testing, performance, accessibility, codegraph, ontosight, agent-continuity, **supabase**)
|
|
160
197
|
- **`.agent/SESSION.md`** for cross-tool session handoff
|
|
161
|
-
- **CodeGraph + Supabase MCP** for Cursor and Kiro (`.cursor/mcp.json`, `.kiro/settings/mcp.json`); Antigravity via user `mcp_config.json` (example in `.agents/references/mcp-antigravity.md`)
|
|
198
|
+
- **CodeGraph + Supabase MCP** for Cursor and Kiro (`.cursor/mcp.json`, `.kiro/settings/mcp.json`); Antigravity via user `mcp_config.json` (example in `.agents/references/mcp-antigravity.md`); **OntoSight CLI** for visual call graphs
|
|
162
199
|
|
|
163
200
|
Keep **`.claude/`**, **`.cursor/`**, **`.kiro/`**, and the Antigravity layout in sync when you change standards. After editing `.cursor/` (canonical), run **`npm run sync:all`** to refresh `.claude/`, `.kiro/`, `.agents/`, `.agent/rules/`, and `GEMINI.md`.
|
|
164
201
|
|
|
@@ -242,7 +279,7 @@ Same ideas as `.claude/` for `commands/`, `agents/`, `skills/`, `references/`. D
|
|
|
242
279
|
| Item | Role |
|
|
243
280
|
|------|------|
|
|
244
281
|
| **`CURSOR.md`** | Hub (like `CLAUDE.md`, Cursor-focused) |
|
|
245
|
-
| **`rules/*.mdc`** | Project rules + YAML; **`security.mdc`**, **`cursor-overview.mdc`**, **`codegraph.mdc`** are central |
|
|
282
|
+
| **`rules/*.mdc`** | Project rules + YAML; **`security.mdc`**, **`cursor-overview.mdc`**, **`codegraph.mdc`**, **`ontosight.mdc`** are central |
|
|
246
283
|
| **`mcp.json`** | MCP servers (CodeGraph) |
|
|
247
284
|
| **`settings.json`** | Path hints (mirrors Claude layout) |
|
|
248
285
|
| **`AGENTS.md`** (repo root) | Entry pointer for Cursor |
|
|
@@ -254,9 +291,9 @@ Same ideas as `.claude/` for `commands/`, `agents/`, `skills/`, `references/`. D
|
|
|
254
291
|
├── settings.json
|
|
255
292
|
├── commands/
|
|
256
293
|
├── agents/
|
|
257
|
-
├── rules/ #
|
|
294
|
+
├── rules/ # 17 × .mdc (13 topics + cursor-overview + codegraph + ontosight + agent-continuity)
|
|
258
295
|
├── skills/
|
|
259
|
-
└── references/ # includes codegraph.md
|
|
296
|
+
└── references/ # includes codegraph.md, ontosight.md
|
|
260
297
|
```
|
|
261
298
|
|
|
262
299
|
After install, **`.codegraph/`** (generated index) lives at the project root and should stay gitignored.
|
|
@@ -400,6 +437,22 @@ Ship thin end-to-end slices (DB + API + UI), not “all models first, then all r
|
|
|
400
437
|
|
|
401
438
|
|
|
402
439
|
|
|
440
|
+
### 1.6.2 — 2026-06-19
|
|
441
|
+
|
|
442
|
+
- Pin agent OntoSight CLI invocations to **`@royalsolution/ontosight@0.2.0`** (latest; `ontosight-codegraph` 0.2.0)
|
|
443
|
+
|
|
444
|
+
### 1.6.1 — 2026-06-19
|
|
445
|
+
|
|
446
|
+
- Add **impact analysis demonstration** workflow: `codegraph_impact` → UX summary → OntoSight graph
|
|
447
|
+
- New `skills/ui-ux-pro-max/IMPACT-DEMO.md` playbook (ui-ux-pro-max chart/UX framing, accessible ranked table)
|
|
448
|
+
- Extend `ontosight` and `codegraph` rules with impact triggers and visualization cross-links
|
|
449
|
+
|
|
450
|
+
### 1.6.0 — 2026-06-19
|
|
451
|
+
|
|
452
|
+
- Integrate **[OntoSight](https://www.npmjs.com/package/@royalsolution/ontosight)** — visual CodeGraph call subgraphs via `npx @royalsolution/ontosight@0.2.0`
|
|
453
|
+
- Add always-on `ontosight` rules and references synced to Cursor, Claude Code, Kiro, and Antigravity
|
|
454
|
+
- Cross-link CodeGraph rules with OntoSight visualization workflows
|
|
455
|
+
|
|
403
456
|
### 1.5.1 — 2026-06-17
|
|
404
457
|
|
|
405
458
|
- Sync package-lock.json version with package.json
|
package/bin/class-ai-agent.cjs
CHANGED
|
@@ -39,6 +39,11 @@ CodeGraph:
|
|
|
39
39
|
After install, runs "npx @colbymchenry/codegraph init -i" in the target directory
|
|
40
40
|
(Node 20+ recommended). Set CODEGRAPH_SKIP_INIT=1 to skip indexing.
|
|
41
41
|
|
|
42
|
+
OntoSight:
|
|
43
|
+
Visual call graphs: npx @royalsolution/ontosight@0.2.0 .
|
|
44
|
+
Agent rules installed at .cursor/rules/ontosight.mdc (and synced trees).
|
|
45
|
+
Requires Node 20+, Python 3.11+, uv or pipx.
|
|
46
|
+
|
|
42
47
|
Supabase:
|
|
43
48
|
Bundled skills under skills/supabase/ and skills/supabase-postgres-best-practices/.
|
|
44
49
|
MCP: https://mcp.supabase.com/mcp (OAuth on first use). Reload Cursor / restart Kiro after install.
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "class-ai-agent",
|
|
3
|
-
"version": "1.
|
|
3
|
+
"version": "1.6.2",
|
|
4
4
|
"description": "Production-grade AI agent configuration for Claude Code, Cursor, Kiro & Antigravity",
|
|
5
5
|
"license": "MIT",
|
|
6
6
|
"repository": {
|
|
@@ -19,6 +19,7 @@
|
|
|
19
19
|
"antigravity",
|
|
20
20
|
"gemini",
|
|
21
21
|
"codegraph",
|
|
22
|
+
"ontosight",
|
|
22
23
|
"supabase",
|
|
23
24
|
"ai",
|
|
24
25
|
"agent",
|
|
@@ -49,6 +50,6 @@
|
|
|
49
50
|
"sync:all": "node scripts/sync-all.mjs",
|
|
50
51
|
"sync:supabase-skills": "node scripts/sync-supabase-skills.mjs",
|
|
51
52
|
"release:readme": "node scripts/update-readme-release.mjs",
|
|
52
|
-
"test:cli": "node bin/class-ai-agent.cjs --help && node bin/class-ai-agent.cjs --version && node -e \"const fs=require('fs');const c=JSON.parse(fs.readFileSync('.cursor/mcp.json','utf8'));const k=JSON.parse(fs.readFileSync('.kiro/settings/mcp.json','utf8'));if(!c.mcpServers?.codegraph||!k.mcpServers?.codegraph)throw new Error('missing codegraph MCP');if(!c.mcpServers?.supabase?.url?.includes('mcp.supabase.com')||!k.mcpServers?.supabase?.url?.includes('mcp.supabase.com'))throw new Error('missing supabase MCP');if(!fs.existsSync('.cursor/skills/supabase/SKILL.md')||!fs.existsSync('.cursor/skills/supabase-postgres-best-practices/SKILL.md'))throw new Error('missing supabase skills');if(!fs.existsSync('.claude/skills/supabase/SKILL.md'))throw new Error('missing claude supabase skill');if(!fs.existsSync('.agents/skills/supabase/SKILL.md'))throw new Error('missing antigravity supabase skill');if(!fs.existsSync('.cursor/references/supabase.md'))throw new Error('missing supabase reference');if(!fs.existsSync('.agents/references/mcp-antigravity.md'))throw new Error('missing mcp-antigravity reference');if(!fs.existsSync('scripts/sync-supabase-skills.mjs'))throw new Error('missing sync-supabase-skills');if(!fs.existsSync('.cursor/rules/codegraph.mdc'))throw new Error('missing codegraph.mdc');if(!fs.existsSync('.claude/rules/codegraph.md'))throw new Error('missing claude codegraph rule');if(!fs.existsSync('.kiro/steering/codegraph.md'))throw new Error('missing kiro codegraph steering');if(!fs.existsSync('.agent/rules/codegraph.md'))throw new Error('missing antigravity codegraph rule');if(!fs.existsSync('.agent/SESSION.template.md'))throw new Error('missing SESSION.template');if(!fs.existsSync('.cursor/rules/agent-continuity.mdc'))throw new Error('missing agent-continuity.mdc');if(!fs.existsSync('.kiro/steering/agent-continuity.md'))throw new Error('missing kiro agent-continuity steering');if(!fs.existsSync('.agent/rules/agent-continuity.md'))throw new Error('missing antigravity agent-continuity rule');if(!fs.existsSync('.cursor/commands/handoff.md')||!fs.existsSync('.cursor/commands/resume.md'))throw new Error('missing handoff/resume commands');if(!fs.existsSync('.agents/workflows/handoff.md')||!fs.existsSync('.agents/workflows/resume.md'))throw new Error('missing antigravity handoff/resume workflows');if(!fs.existsSync('GEMINI.md'))throw new Error('missing GEMINI.md');if(!fs.existsSync('scripts/sync-antigravity-from-cursor.mjs'))throw new Error('missing sync-antigravity script');\" && node scripts/check-parity.mjs"
|
|
53
|
+
"test:cli": "node bin/class-ai-agent.cjs --help && node bin/class-ai-agent.cjs --version && node -e \"const fs=require('fs');const c=JSON.parse(fs.readFileSync('.cursor/mcp.json','utf8'));const k=JSON.parse(fs.readFileSync('.kiro/settings/mcp.json','utf8'));if(!c.mcpServers?.codegraph||!k.mcpServers?.codegraph)throw new Error('missing codegraph MCP');if(!c.mcpServers?.supabase?.url?.includes('mcp.supabase.com')||!k.mcpServers?.supabase?.url?.includes('mcp.supabase.com'))throw new Error('missing supabase MCP');if(!fs.existsSync('.cursor/skills/supabase/SKILL.md')||!fs.existsSync('.cursor/skills/supabase-postgres-best-practices/SKILL.md'))throw new Error('missing supabase skills');if(!fs.existsSync('.claude/skills/supabase/SKILL.md'))throw new Error('missing claude supabase skill');if(!fs.existsSync('.agents/skills/supabase/SKILL.md'))throw new Error('missing antigravity supabase skill');if(!fs.existsSync('.cursor/references/supabase.md'))throw new Error('missing supabase reference');if(!fs.existsSync('.agents/references/mcp-antigravity.md'))throw new Error('missing mcp-antigravity reference');if(!fs.existsSync('scripts/sync-supabase-skills.mjs'))throw new Error('missing sync-supabase-skills');if(!fs.existsSync('.cursor/rules/codegraph.mdc'))throw new Error('missing codegraph.mdc');if(!fs.existsSync('.claude/rules/codegraph.md'))throw new Error('missing claude codegraph rule');if(!fs.existsSync('.kiro/steering/codegraph.md'))throw new Error('missing kiro codegraph steering');if(!fs.existsSync('.agent/rules/codegraph.md'))throw new Error('missing antigravity codegraph rule');if(!fs.existsSync('.cursor/rules/ontosight.mdc'))throw new Error('missing ontosight.mdc');if(!fs.existsSync('.claude/rules/ontosight.md'))throw new Error('missing claude ontosight rule');if(!fs.existsSync('.kiro/steering/ontosight.md'))throw new Error('missing kiro ontosight steering');if(!fs.existsSync('.agent/rules/ontosight.md'))throw new Error('missing antigravity ontosight rule');if(!fs.existsSync('.cursor/references/ontosight.md'))throw new Error('missing ontosight reference');if(!fs.existsSync('.agent/SESSION.template.md'))throw new Error('missing SESSION.template');if(!fs.existsSync('.cursor/rules/agent-continuity.mdc'))throw new Error('missing agent-continuity.mdc');if(!fs.existsSync('.kiro/steering/agent-continuity.md'))throw new Error('missing kiro agent-continuity steering');if(!fs.existsSync('.agent/rules/agent-continuity.md'))throw new Error('missing antigravity agent-continuity rule');if(!fs.existsSync('.cursor/commands/handoff.md')||!fs.existsSync('.cursor/commands/resume.md'))throw new Error('missing handoff/resume commands');if(!fs.existsSync('.agents/workflows/handoff.md')||!fs.existsSync('.agents/workflows/resume.md'))throw new Error('missing antigravity handoff/resume workflows');if(!fs.existsSync('GEMINI.md'))throw new Error('missing GEMINI.md');if(!fs.existsSync('scripts/sync-antigravity-from-cursor.mjs'))throw new Error('missing sync-antigravity script');if(!fs.existsSync('.cursor/skills/ui-ux-pro-max/IMPACT-DEMO.md'))throw new Error('missing IMPACT-DEMO.md');\" && node scripts/check-parity.mjs"
|
|
53
54
|
}
|
|
54
55
|
}
|