Repository navigation
Expand file tree
/
Copy pathAGENTS.html
More file actions
49 lines (47 loc) · 18 KB
/
Copy pathAGENTS.html
File metadata and controls
49 lines (47 loc) · 18 KB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
<!DOCTYPE html>
<html lang="ru-RU" dir="ltr">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width,initial-scale=1">
<title>GitNexus — Code Intelligence — Alterfo</title>
<meta name="description" content="Олег Сидоркин — инженер и музыкант: проекты, локальные инструменты без облака и заметки об аудио, AI и архитектуре.">
<meta name="generator" content="VitePress v1.6.4">
<link rel="preload stylesheet" href="/assets/style.DdaRuoNM.css" as="style">
<link rel="preload stylesheet" href="/vp-icons.css" as="style">
<script type="module" src="/assets/app.CQFr8Ko6.js"></script>
<link rel="modulepreload" href="/assets/chunks/runtime-core.esm-bundler.BJauBgjz.js">
<link rel="modulepreload" href="/assets/chunks/plugin-vue_export-helper.DlAUqK2U.js">
<link rel="modulepreload" href="/assets/AGENTS.md.BEKqCaiR.lean.js">
<link rel="prefetch" href="/assets/chunks/WebGPUParticles.zb9LuRO7.js">
<link rel="prefetch" href="/assets/chunks/IDEF0Editor.BW5Mczob.js">
<link rel="prefetch" href="/assets/chunks/Journal.BRdLE313.js">
<link rel="prefetch" href="/assets/chunks/Piano.CxsmEEn6.js">
<link rel="prefetch" href="/assets/chunks/OpenPoseEditor.BFObR9yp.js">
<link rel="prefetch" href="/assets/chunks/PlannerEditor.BgWxQ-y6.js">
<link rel="prefetch" href="/assets/chunks/DecisionJournal.B6osHv30.js">
<link rel="prefetch" href="/assets/chunks/FinanceApp.CoqvIG_J.js">
<link rel="prefetch" href="/assets/chunks/CasualGames.BmNXmiV7.js">
<link rel="icon" type="image/svg+xml" href="/home-wheel.svg">
<link rel="icon" type="image/png" sizes="48x48" href="/favicon.png">
<link rel="apple-touch-icon" sizes="180x180" href="/apple-touch-icon.png">
<meta name="theme-color" content="#f6f2ea">
<meta name="google-site-verification" content="2_Fb2XwDwWWj4hDQX-P5joNEDLaeIVO2X1DFzRNnRlk">
<script id="check-mac-os">document.documentElement.classList.toggle("mac",/Mac|iPhone|iPod|iPad/i.test(navigator.platform));</script>
<link rel="canonical" href="https://alterfo.github.io/AGENTS">
<meta property="og:type" content="website">
<meta property="og:title" content="GitNexus — Code Intelligence">
<meta property="og:description" content="Oleg Sidorkin — инженер и музыкант. Проекты, инструменты и заметки.">
<meta property="og:url" content="https://alterfo.github.io/AGENTS">
<meta property="og:image" content="https://alterfo.github.io/og.png">
<meta property="og:site_name" content="Alterfo">
<meta property="og:locale" content="ru_RU">
<meta name="twitter:card" content="summary_large_image">
<meta name="twitter:title" content="GitNexus — Code Intelligence">
<meta name="twitter:description" content="Oleg Sidorkin — инженер и музыкант. Проекты, инструменты и заметки.">
<meta name="twitter:image" content="https://alterfo.github.io/og.png">
</head>
<body>
<div id="app"><div class="Layout" data-v-d8b57b2d><!--[--><header class="site-header" id="large-header"><canvas></canvas><div class="animation-toggler top-2"><button type="button">Включить анимацию!</button></div><div class="page-title" style="opacity:1;">GitNexus — Code Intelligence</div></header><!--]--><!--[--><span tabindex="-1" data-v-fcbfc0e0></span><a href="#VPContent" class="VPSkipLink visually-hidden" data-v-fcbfc0e0>Skip to content</a><!--]--><!----><header class="VPNav" data-v-d8b57b2d data-v-7ad780c2><div class="VPNavBar" data-v-7ad780c2 data-v-9fd4d1dd><div class="wrapper" data-v-9fd4d1dd><div class="container" data-v-9fd4d1dd><div class="title" data-v-9fd4d1dd><div class="VPNavBarTitle" data-v-9fd4d1dd data-v-9f43907a><a class="title" href="/" data-v-9f43907a><!--[--><!--]--><!--[--><img class="VPImage logo" src="/home-wheel.svg" alt data-v-ab19afbb><!--]--><!----><!--[--><!--]--></a></div></div><div class="content" data-v-9fd4d1dd><div class="content-body" data-v-9fd4d1dd><!--[--><!--]--><div class="VPNavBarSearch search" data-v-9fd4d1dd><!----></div><nav aria-labelledby="main-nav-aria-label" class="VPNavBarMenu menu" data-v-9fd4d1dd data-v-afb2845e><span id="main-nav-aria-label" class="visually-hidden" data-v-afb2845e> Main Navigation </span><!--[--><!--[--><div class="VPFlyout VPNavBarMenuGroup" data-v-afb2845e data-v-bfe7971f><button type="button" class="button" aria-haspopup="true" aria-expanded="false" data-v-bfe7971f><span class="text" data-v-bfe7971f><!----><span data-v-bfe7971f>Проекты</span><span class="vpi-chevron-down text-icon" data-v-bfe7971f></span></span></button><div class="menu" data-v-bfe7971f><div class="VPMenu" data-v-bfe7971f data-v-20ed86d6><div class="items" data-v-20ed86d6><!--[--><!--[--><div class="VPMenuGroup" data-v-20ed86d6 data-v-a6b0397c><p class="title" data-v-a6b0397c>Приложения</p><!--[--><!--[--><div class="VPMenuLink" data-v-a6b0397c data-v-7eeeb2dc><a class="VPLink link" href="/journal.html" data-v-7eeeb2dc><!--[--><span data-v-7eeeb2dc>Дневник</span><!--]--></a></div><!--]--><!--[--><div class="VPMenuLink" data-v-a6b0397c data-v-7eeeb2dc><a class="VPLink link" href="/idef0.html" data-v-7eeeb2dc><!--[--><span data-v-7eeeb2dc>IDEF0-редактор</span><!--]--></a></div><!--]--><!--[--><div class="VPMenuLink" data-v-a6b0397c data-v-7eeeb2dc><a class="VPLink link" href="/ar/" target="_self" data-v-7eeeb2dc><!--[--><span data-v-7eeeb2dc>Аудио-реактив</span><!--]--></a></div><!--]--><!--[--><div class="VPMenuLink" data-v-a6b0397c data-v-7eeeb2dc><a class="VPLink link" href="/piano.html" data-v-7eeeb2dc><!--[--><span data-v-7eeeb2dc>Piano Teacher</span><!--]--></a></div><!--]--><!--[--><div class="VPMenuLink" data-v-a6b0397c data-v-7eeeb2dc><a class="VPLink link" href="/openpose.html" data-v-7eeeb2dc><!--[--><span data-v-7eeeb2dc>OpenPose Editor</span><!--]--></a></div><!--]--><!--[--><div class="VPMenuLink" data-v-a6b0397c data-v-7eeeb2dc><a class="VPLink link" href="/planner.html" data-v-7eeeb2dc><!--[--><span data-v-7eeeb2dc>Планировщик</span><!--]--></a></div><!--]--><!--[--><div class="VPMenuLink" data-v-a6b0397c data-v-7eeeb2dc><a class="VPLink link" href="/decision-journal.html" data-v-7eeeb2dc><!--[--><span data-v-7eeeb2dc>Журнал решений</span><!--]--></a></div><!--]--><!--[--><div class="VPMenuLink" data-v-a6b0397c data-v-7eeeb2dc><a class="VPLink link" href="/finance.html" data-v-7eeeb2dc><!--[--><span data-v-7eeeb2dc>Финансы</span><!--]--></a></div><!--]--><!--[--><div class="VPMenuLink" data-v-a6b0397c data-v-7eeeb2dc><a class="VPLink link" href="/casual-games.html" data-v-7eeeb2dc><!--[--><span data-v-7eeeb2dc>Пазлы</span><!--]--></a></div><!--]--><!--]--></div><!--]--><!--[--><div class="VPMenuGroup" data-v-20ed86d6 data-v-a6b0397c><p class="title" data-v-a6b0397c>Разборы</p><!--[--><!--[--><div class="VPMenuLink" data-v-a6b0397c data-v-7eeeb2dc><a class="VPLink link" href="/projects/ar-engine.html" data-v-7eeeb2dc><!--[--><span data-v-7eeeb2dc>Аудио-реактив — архитектура</span><!--]--></a></div><!--]--><!--[--><div class="VPMenuLink" data-v-a6b0397c data-v-7eeeb2dc><a class="VPLink link" href="/projects/idef0-editor.html" data-v-7eeeb2dc><!--[--><span data-v-7eeeb2dc>IDEF0 Editor — архитектура</span><!--]--></a></div><!--]--><!--]--></div><!--]--><!--]--></div><!--[--><!--]--></div></div></div><!--]--><!--[--><a class="VPLink link VPNavBarMenuLink" href="/music.html" tabindex="0" data-v-afb2845e data-v-815115f5><!--[--><span data-v-815115f5>Музыка</span><!--]--></a><!--]--><!--[--><a class="VPLink link VPNavBarMenuLink" href="/blog.html" tabindex="0" data-v-afb2845e data-v-815115f5><!--[--><span data-v-815115f5>Блог</span><!--]--></a><!--]--><!--]--></nav><!----><!----><!----><!----><!--[--><!--]--><button type="button" class="VPNavBarHamburger hamburger" aria-label="mobile navigation" aria-expanded="false" aria-controls="VPNavScreen" data-v-9fd4d1dd data-v-6bee1efd><span class="container" data-v-6bee1efd><span class="top" data-v-6bee1efd></span><span class="middle" data-v-6bee1efd></span><span class="bottom" data-v-6bee1efd></span></span></button></div></div></div></div><div class="divider" data-v-9fd4d1dd><div class="divider-line" data-v-9fd4d1dd></div></div></div><!----></header><div class="VPLocalNav empty fixed" data-v-d8b57b2d data-v-2488c25a><div class="container" data-v-2488c25a><!----><div class="VPLocalNavOutlineDropdown" style="--vp-vh:0px;" data-v-2488c25a data-v-6b867909><button data-v-6b867909>Return to top</button><!----></div></div></div><!----><div class="VPContent" id="VPContent" data-v-d8b57b2d data-v-9a6c75ad><div class="VPDoc has-aside" data-v-9a6c75ad data-v-e6f2a212><!--[--><!--]--><div class="container" data-v-e6f2a212><div class="aside" data-v-e6f2a212><div class="aside-curtain" data-v-e6f2a212></div><div class="aside-container" data-v-e6f2a212><div class="aside-content" data-v-e6f2a212><div class="VPDocAside" data-v-e6f2a212 data-v-cb998dce><!--[--><!--]--><!--[--><!--]--><nav aria-labelledby="doc-outline-aria-label" class="VPDocAsideOutline" data-v-cb998dce data-v-f610f197><div class="content" data-v-f610f197><div class="outline-marker" data-v-f610f197></div><div aria-level="2" class="outline-title" id="doc-outline-aria-label" role="heading" data-v-f610f197>On this page</div><ul class="VPDocOutlineItem root" data-v-f610f197 data-v-53c99d69><!--[--><!--]--></ul></div></nav><!--[--><!--]--><div class="spacer" data-v-cb998dce></div><!--[--><!--]--><!----><!--[--><!--]--><!--[--><!--]--></div></div></div></div><div class="content" data-v-e6f2a212><div class="content-container" data-v-e6f2a212><!--[--><!--]--><main class="main" data-v-e6f2a212><div style="position:relative;" class="vp-doc _AGENTS" data-v-e6f2a212><div><h1 id="gitnexus-—-code-intelligence" tabindex="-1">GitNexus — Code Intelligence <a class="header-anchor" href="#gitnexus-—-code-intelligence" aria-label="Permalink to "GitNexus — Code Intelligence""></a></h1><p>This project is indexed by GitNexus as <strong>alterfo.github.io-src</strong> (623 symbols, 967 relationships, 44 execution flows). Use the GitNexus MCP tools to understand code, assess impact, and navigate safely.</p><blockquote><p>Index stale? Run <code>node .gitnexus/run.cjs analyze</code> from the project root — it auto-selects an available runner. No <code>.gitnexus/run.cjs</code> yet? <code>npx gitnexus analyze</code> (npm 11 crash → <code>npm i -g gitnexus</code>; #1939).</p></blockquote><h2 id="always-do" tabindex="-1">Always Do <a class="header-anchor" href="#always-do" aria-label="Permalink to "Always Do""></a></h2><ul><li><strong>MUST run impact analysis before editing any symbol.</strong> Before modifying a function, class, or method, run <code>impact({target: "symbolName", direction: "upstream"})</code> and report the blast radius (direct callers, affected processes, risk level) to the user.</li><li><strong>MUST run <code>detect_changes()</code> before committing</strong> to verify your changes only affect expected symbols and execution flows. For regression review, compare against the default branch: <code>detect_changes({scope: "compare", base_ref: "master"})</code>.</li><li><strong>MUST warn the user</strong> if impact analysis returns HIGH or CRITICAL risk before proceeding with edits.</li><li>When exploring unfamiliar code, use <code>query({query: "concept"})</code> to find execution flows instead of grepping. It returns process-grouped results ranked by relevance.</li><li>When you need full context on a specific symbol — callers, callees, which execution flows it participates in — use <code>context({name: "symbolName"})</code>.</li></ul><h2 id="never-do" tabindex="-1">Never Do <a class="header-anchor" href="#never-do" aria-label="Permalink to "Never Do""></a></h2><ul><li>NEVER edit a function, class, or method without first running <code>impact</code> on it.</li><li>NEVER ignore HIGH or CRITICAL risk warnings from impact analysis.</li><li>NEVER rename symbols with find-and-replace — use <code>rename</code> which understands the call graph.</li><li>NEVER commit changes without running <code>detect_changes()</code> to check affected scope.</li></ul><h2 id="resources" tabindex="-1">Resources <a class="header-anchor" href="#resources" aria-label="Permalink to "Resources""></a></h2><table tabindex="0"><thead><tr><th>Resource</th><th>Use for</th></tr></thead><tbody><tr><td><code>gitnexus://repo/alterfo.github.io-src/context</code></td><td>Codebase overview, check index freshness</td></tr><tr><td><code>gitnexus://repo/alterfo.github.io-src/clusters</code></td><td>All functional areas</td></tr><tr><td><code>gitnexus://repo/alterfo.github.io-src/processes</code></td><td>All execution flows</td></tr><tr><td><code>gitnexus://repo/alterfo.github.io-src/process/{name}</code></td><td>Step-by-step execution trace</td></tr></tbody></table><h2 id="cli" tabindex="-1">CLI <a class="header-anchor" href="#cli" aria-label="Permalink to "CLI""></a></h2><table tabindex="0"><thead><tr><th>Task</th><th>Read this skill file</th></tr></thead><tbody><tr><td>Understand architecture / "How does X work?"</td><td><code>.claude/skills/gitnexus/gitnexus-exploring/SKILL.md</code></td></tr><tr><td>Blast radius / "What breaks if I change X?"</td><td><code>.claude/skills/gitnexus/gitnexus-impact-analysis/SKILL.md</code></td></tr><tr><td>Trace bugs / "Why is X failing?"</td><td><code>.claude/skills/gitnexus/gitnexus-debugging/SKILL.md</code></td></tr><tr><td>Rename / extract / split / refactor</td><td><code>.claude/skills/gitnexus/gitnexus-refactoring/SKILL.md</code></td></tr><tr><td>Tools, resources, schema reference</td><td><code>.claude/skills/gitnexus/gitnexus-guide/SKILL.md</code></td></tr><tr><td>Index, status, clean, wiki CLI commands</td><td><code>.claude/skills/gitnexus/gitnexus-cli/SKILL.md</code></td></tr></tbody></table></div></div></main><footer class="VPDocFooter" data-v-e6f2a212 data-v-1bcd8184><!--[--><!--]--><!----><!----></footer><!--[--><!--]--></div></div></div><!--[--><!--]--></div></div><!----><!--[--><!--]--></div></div>
<script>window.__VP_HASH_MAP__=JSON.parse("{\"agents.md\":\"BEKqCaiR\",\"blog.md\":\"DBjFsyEC\",\"casual-games.md\":\"BeT5v4w4\",\"decision-journal.md\":\"DCVZdFJe\",\"finance.md\":\"DRJUGNal\",\"idef0.md\":\"BBBgU_ti\",\"index.md\":\"COcO3eJ1\",\"journal.md\":\"CqfTD08r\",\"music.md\":\"CrZw8Bje\",\"openpose.md\":\"CxCWM-XC\",\"piano.md\":\"Dg9BTbVs\",\"planner.md\":\"BCEm_3kg\",\"posts_2020-09-03-why-the-blog-appears.md\":\"DshqACF5\",\"posts_2020-09-04-canvas-circle-of-life.md\":\"c4mPnOJh\",\"posts_2020-09-05-reflection.md\":\"C4uGuY_b\",\"posts_2020-09-07-values-prioritization.md\":\"DEtrNJFP\",\"posts_2020-09-08-organization-values.md\":\"Cq3v6FVu\",\"posts_2020-09-10-vuepress-migration.md\":\"Z3lxQgai\",\"posts_2020-09-11-adaptive-fonts.md\":\"CFDwJNxL\",\"posts_2020-09-13-resistance.md\":\"BhogP4Dq\",\"posts_2020-09-15-spinal-hernia.md\":\"ILREIcbj\",\"posts_2020-09-17-conflict-management.md\":\"CHWeX6Q9\",\"posts_2020-09-18-archetypes.md\":\"MPczL02n\",\"posts_2020-09-19-working-from-home.md\":\"B4ZVCqtb\",\"posts_2020-09-21-empathy.md\":\"aeqGrumL\",\"posts_2020-09-24-bulling.md\":\"CHb2f92_\",\"posts_2020-09-24-graphql-resolvers.md\":\"Cqi4o_RO\",\"posts_2020-09-25-critical-rendering-path.md\":\"BfMIrAS2\",\"posts_2020-09-26-stress-tolerance.md\":\"D9taGeV0\",\"posts_2020-10-05-sdlc.md\":\"MlcfR_1p\",\"posts_2020-10-11-hyperresponsibility.md\":\"D-dVVcUh\",\"posts_2020-10-12-principles.md\":\"DfuBiWpY\",\"posts_2020-10-21-eastern-martial-arts.md\":\"4oNdV4iw\",\"posts_2021-05-08-paupiauau.md\":\"rD3gTj7l\",\"posts_2021-06-30-crisises.md\":\"ysCmP5dE\",\"posts_2021-10-29-frustration.md\":\"J-NXH4c3\",\"posts_2021-11-24-poject-from-scratch.md\":\"kt2Q3r0V\",\"posts_2022-03-06-negotiations.md\":\"BA-uSFJ_\",\"posts_2022-06-14-impact.md\":\"CcQ0ohyD\",\"posts_2022-10-16-frustration.md\":\"UWOuWhA4\",\"posts_2022-10-16-timemanagement.md\":\"B2-07H-g\",\"posts_2022-11-03-my-next-project.md\":\"B35WuxNj\",\"posts_2022-12-24-stack-2-maintainability-reliability.md\":\"_h_v0p4F\",\"posts_2023-01-11-stack-3-overengineering.md\":\"BJspndgs\",\"posts_2024-10-02-vpn.md\":\"D2jyGON9\",\"posts_2025-03-22-relationships.md\":\"CgOICPVh\",\"posts_2025-12-12-rational-planning.md\":\"gZPp9dSo\",\"posts_2026-06-11-instrumenty-v-brauzere-bez-oblaka.md\":\"ChpKQ5OC\",\"projects_ar-engine.md\":\"DAfHbSlG\",\"projects_idef0-editor.md\":\"BHRVHvEg\"}");window.__VP_SITE_DATA__=JSON.parse("{\"lang\":\"ru-RU\",\"dir\":\"ltr\",\"title\":\"Alterfo\",\"titleTemplate\":\":title — Alterfo\",\"description\":\"Олег Сидоркин — инженер и музыкант: проекты, локальные инструменты без облака и заметки об аудио, AI и архитектуре.\",\"base\":\"/\",\"head\":[],\"router\":{\"prefetchLinks\":true},\"appearance\":false,\"themeConfig\":{\"logo\":\"/home-wheel.svg\",\"siteTitle\":false,\"nav\":[{\"text\":\"Проекты\",\"items\":[{\"text\":\"Приложения\",\"items\":[{\"text\":\"Дневник\",\"link\":\"/journal\"},{\"text\":\"IDEF0-редактор\",\"link\":\"/idef0\"},{\"text\":\"Аудио-реактив\",\"link\":\"/ar/\",\"target\":\"_self\"},{\"text\":\"Piano Teacher\",\"link\":\"/piano\"},{\"text\":\"OpenPose Editor\",\"link\":\"/openpose\"},{\"text\":\"Планировщик\",\"link\":\"/planner\"},{\"text\":\"Журнал решений\",\"link\":\"/decision-journal\"},{\"text\":\"Финансы\",\"link\":\"/finance\"},{\"text\":\"Пазлы\",\"link\":\"/casual-games\"}]},{\"text\":\"Разборы\",\"items\":[{\"text\":\"Аудио-реактив — архитектура\",\"link\":\"/projects/ar-engine\"},{\"text\":\"IDEF0 Editor — архитектура\",\"link\":\"/projects/idef0-editor\"}]}]},{\"text\":\"Музыка\",\"link\":\"/music\"},{\"text\":\"Блог\",\"link\":\"/blog\"}]},\"locales\":{},\"scrollOffset\":134,\"cleanUrls\":false}");</script>
</body>
</html>