Skip to content

Commit cf39fca

Browse files
Delqhisin-context-bridge-builder
authored andcommitted
docs(AGENTS): auto-sync from SIN-Code-Bundle
1 parent 813d9ab commit cf39fca

1 file changed

Lines changed: 44 additions & 4 deletions

File tree

AGENTS.md

Lines changed: 44 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -101,10 +101,6 @@ sin-code orchestrate --action add --title "Feature implementieren" --tags "urgen
101101
- **VOR jedem API-Call:** Immer `sin-harvest` mit Caching und Struktur-Extraktion nutzen
102102
- **Für jede Planung:** Immer `sin-orchestrate` mit Dependencies und Rollback-Plan nutzen
103103

104-
### MCP Server State
105-
106-
Both `sin-code-bundle` (Python CLI, legacy) and `sin-code` (Go unified binary, v1.0.0+) are currently registered in `opencode.json`. The Go unified binary (`sin-code`) is the modern recommended approach and supersedes the standalone Python binaries. Agents should prefer `sin-code` subcommands over the legacy `~/.local/bin/<tool>` paths.
107-
108104
### Versionen (aktuell)
109105

110106
| Tool | Version | Status |
@@ -486,3 +482,47 @@ sin sin-code agents-md --output AGENTS.md
486482
## Version
487483

488484
v0.2.0
485+
486+
<!-- gitnexus:start -->
487+
# GitNexus — Code Intelligence
488+
489+
This project is indexed by GitNexus as **SIN-Code-Bundle** (8727 symbols, 15372 relationships, 252 execution flows). Use the GitNexus MCP tools to understand code, assess impact, and navigate safely.
490+
491+
> If any GitNexus tool warns the index is stale, run `npx gitnexus analyze` in terminal first.
492+
493+
## Always Do
494+
495+
- **MUST run impact analysis before editing any symbol.** Before modifying a function, class, or method, run `gitnexus_impact({target: "symbolName", direction: "upstream"})` and report the blast radius (direct callers, affected processes, risk level) to the user.
496+
- **MUST run `gitnexus_detect_changes()` before committing** to verify your changes only affect expected symbols and execution flows.
497+
- **MUST warn the user** if impact analysis returns HIGH or CRITICAL risk before proceeding with edits.
498+
- When exploring unfamiliar code, use `gitnexus_query({query: "concept"})` to find execution flows instead of grepping. It returns process-grouped results ranked by relevance.
499+
- When you need full context on a specific symbol — callers, callees, which execution flows it participates in — use `gitnexus_context({name: "symbolName"})`.
500+
501+
## Never Do
502+
503+
- NEVER edit a function, class, or method without first running `gitnexus_impact` on it.
504+
- NEVER ignore HIGH or CRITICAL risk warnings from impact analysis.
505+
- NEVER rename symbols with find-and-replace — use `gitnexus_rename` which understands the call graph.
506+
- NEVER commit changes without running `gitnexus_detect_changes()` to check affected scope.
507+
508+
## Resources
509+
510+
| Resource | Use for |
511+
|----------|---------|
512+
| `gitnexus://repo/SIN-Code-Bundle/context` | Codebase overview, check index freshness |
513+
| `gitnexus://repo/SIN-Code-Bundle/clusters` | All functional areas |
514+
| `gitnexus://repo/SIN-Code-Bundle/processes` | All execution flows |
515+
| `gitnexus://repo/SIN-Code-Bundle/process/{name}` | Step-by-step execution trace |
516+
517+
## CLI
518+
519+
| Task | Read this skill file |
520+
|------|---------------------|
521+
| Understand architecture / "How does X work?" | `.claude/skills/gitnexus/gitnexus-exploring/SKILL.md` |
522+
| Blast radius / "What breaks if I change X?" | `.claude/skills/gitnexus/gitnexus-impact-analysis/SKILL.md` |
523+
| Trace bugs / "Why is X failing?" | `.claude/skills/gitnexus/gitnexus-debugging/SKILL.md` |
524+
| Rename / extract / split / refactor | `.claude/skills/gitnexus/gitnexus-refactoring/SKILL.md` |
525+
| Tools, resources, schema reference | `.claude/skills/gitnexus/gitnexus-guide/SKILL.md` |
526+
| Index, status, clean, wiki CLI commands | `.claude/skills/gitnexus/gitnexus-cli/SKILL.md` |
527+
528+
<!-- gitnexus:end -->

0 commit comments

Comments
 (0)