Egonex-AI/Understand-Anything / understand-anything-plugin/skills/understand
understand
VerifiedAnalyze a codebase to produce an interactive knowledge graph for understanding architecture, components, and relationships
generate-ignore.mjs
View on GitHub#!/usr/bin/env node
/**
* generate-ignore.mjs
*
* Writes a starter `.understandignore` into the project's data directory
* (`.ua/`, or legacy `.understand-anything/` when that directory already
* exists — see core's resolveUaDir) by delegating to
* `generateStarterIgnoreFile` in `@understand-anything/core`. Invoked from
* SKILL.md Phase 0.5; replaces the inline `node -e "…"` block that previously
* duplicated the generator logic.
*
* Usage:
* node generate-ignore.mjs <projectRoot>
*
* Behaviour:
* - Exits 0 with a stderr notice if the target file already exists.
* - Creates the resolved data dir (`.ua/` or legacy
* `.understand-anything/`) if missing.
* - Emits a one-line stderr summary on success.
*
* Mirrors the @understand-anything/core resolution dance used by
* scan-project.mjs: workspace-linked package first, plugin-cache dist fallback.
*
* Plugin root resolution: prefer $PLUGIN_ROOT from the environment (set by
* SKILL.md Phase 0 via its multi-candidate search) over the
* `resolve(__dirname, '../..')` heuristic. The relative path breaks when
* `skills/understand/` is copied into a runtime skills directory whose
* parent is not the plugin checkout.
*/
import { createRequire } from 'node:module';
import { dirname, join, resolve } from 'node:path';
import { fileURLToPath, pathToFileURL } from 'node:url';
import { existsSync, mkdirSync, writeFileSync } from 'node:fs';
const __dirname = dirname(fileURLToPath(import.meta.url));
function resolvePluginRoot() {
const envRoot = process.env.PLUGIN_ROOT;
if (envRoot && existsSync(join(envRoot, 'package.json'))) {
return envRoot;
}
return resolve(__dirname, '../..');
}
const pluginRoot = resolvePluginRoot();
const require = createRequire(resolve(pluginRoot, 'package.json'));
let core;
try {
core = await import(pathToFileURL(require.resolve('@understand-anything/core')).href);
} catch {
core = await import(pathToFileURL(resolve(pluginRoot, 'packages/core/dist/index.js')).href);
}
const { generateStarterIgnoreFile, resolveUaDir } = core;
const projectRoot = resolve(process.argv[2] ?? process.cwd());
const outDir = resolveUaDir(projectRoot);
const outPath = join(outDir, '.understandignore');
if (existsSync(outPath)) {
console.error(`generate-ignore: ${outPath} already exists — skipping`);
process.exit(0);
}
if (!existsSync(outDir)) mkdirSync(outDir, { recursive: true });
writeFileSync(outPath, generateStarterIgnoreFile(projectRoot));
console.error(`generate-ignore: wrote ${outPath}`);
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation). | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK). | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |