| name | aegis-context |
| description | AEGIS project context — Electron desktop app for AI agent monitoring with Svelte 5 renderer. Provides architecture map, module locations, IPC channels, component inventory, and coding conventions. MUST be invoked before working on any AEGIS source file: editing scanners, watchers, or scoring in src/main/; modifying Svelte components, stores, or utils in src/renderer/; updating agent-database.json, constants.js, or types in src/shared/; adding IPC channels to preload.js; debugging anomaly-detector, rule-loader, network-monitor, or process-scanner; writing tests; or asking how AEGIS architecture works. Skip only for trivial one-line fixes (typos, renames) and bare git/npm commands. |
AEGIS Context
Project
AEGIS — Independent AI Oversight Layer (Electron desktop)
Repo: github.com/antropos17/Aegis | Version: 0.10.0-alpha
Current Focus: Launch preparation (GIF, Dev.to, Reddit, HN)
Stack
Read package.json for exact versions. NEVER hardcode.
Electron 33, Svelte 5, Vite 7, TypeScript (incremental, allowJs:true, checkJs:true), chokidar.
Architecture
- Main process (Node.js): src/main/ — 23 CJS modules (scanners, watchers, IPC, scoring, logging)
- Renderer (Svelte 5): src/renderer/ — 43 components + 9 stores + 15 utils via IPC bridge
- Bridge: src/main/preload.js — contextBridge, 43 invoke + 6 push channels
- Data: src/shared/agent-database.json (110 agent signatures)
- Config: src/shared/constants.js (68 rules across 8 categories)
- Rules: src/main/rule-loader.js — loadRules() + categoryIndex Map for O(1) lookup by category
- Types: src/shared/types/ — 8 .ts files
- Tests: 707 pass, 4 skip across 44 files (Vitest, all ESM)
Key Components (Fancy UI — complete)
- ShieldTab: bento grid with SummaryCards, RiskRing, ActivityFeed
- SummaryCards: animated counters + trend arrows
- Sparkline: pure SVG mini charts
- TrustBadge: color-coded trust level indicator
- RiskRing: SVG gauge with glow + pulse animation
- AgentCard: sparkline + badge + spotlight hover
- FooterMiniCharts: CPU/memory sparklines in footer
- TabBar: sliding indicator + tab transitions
- VisTimeline, AgentGraph, EventFeed, AgentStatsPanel
Key Files
- src/renderer/lib/styles/tokens.css — 60+ design tokens (Fancy UI)
- src/renderer/lib/styles/global.css — atmosphere, fonts, resets
- src/shared/constants.js — ~70 SENSITIVE_RULES
MCP
- Context7: fresh docs for any library (append "use context7")
- Svelte MCP: list-sections, get-documentation, svelte-autofixer
Skills (.claude/skills/)
- aegis-context — project overview, auto-invoked on any task
- design-system — Fancy UI tokens, typography, glassmorphism, animation rules
- electron-main — CJS modules, platform abstraction, IPC, file watchers
- svelte-patterns — Svelte 5 runes, component patterns, template directives
- testing — Vitest patterns, ESM imports, mocking, test structure
- prompt-craft — prompt formula for Claude Code and Antigravity
- pr-monitor — PR triage, contributor management, /loop monitoring
- ci-monitor — CI watching, repo health, post-launch metrics
Commands
- /audit — full health check via auditor agent
- /ship v#.#.# — release workflow via shipper agent
- /research "query" — explore codebase (read-only)
