القائمة
Use before patching, overriding, or adapting a TaleWorlds type — `taom-src path <Type>` decompiles + caches the installed engine, returning an absolute path.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
Root-cause native Bannerlord CTDs (AccessViolation in TaleWorlds.Native.dll) via Event Log offsets, offline disassembly, and live debugger forensics. No symbols needed.
Dispatch an independent Codex verification job directly via `codex exec` Bash call, then retrieve and present results
Inspect all changed files, group by logical concern, and guide atomic per-concern commits following TAOM's 50/72 rule and commit trailer convention.
Load a snapshot saved by /context-save and present it so this session can pick up where the last one left off without re-deriving decisions.
Launch parallel deep-dive agents to review completed work for quality, standards, compatibility, completeness, and cross-system data flow
Respond to a Bannerlord engine update (Steam force-bump or deliberate migration) — preserve the decompile baseline, regen, diff, re-verify bindings and creature data, control-battle.
| name | taom-src |
| description | Use before patching, overriding, or adapting a TaleWorlds type — `taom-src path <Type>` decompiles + caches the installed engine, returning an absolute path. |
Wraps ilspycmd against the installed DLLs (auto-detects the engine version from Version.xml — currently v1.4.7) and caches at ~/.taom-src/<version>/. Inspired by vercel-labs/opensrc. Use this before every [HarmonyPatch], GameModel override, or adapter that touches a TaleWorlds type — never guess signatures from the E:\Decompiled_Bannerlord\ dump (it can lag the installed engine after a bump).
# Decompile + cache (first call) or print cached path (subsequent calls)
pwsh tools/taom-src.ps1 path TaleWorlds.CampaignSystem.GameComponents.DefaultPartyWageModel
# Compose with grep/cat/rg — exactly like opensrc
rg "GetCharacterWage" $(pwsh tools/taom-src.ps1 path TaleWorlds.CampaignSystem.GameComponents.DefaultPartyWageModel)
cat $(pwsh tools/taom-src.ps1 path TaleWorlds.MountAndBlade.Formation)
Progress goes to stderr, path goes to stdout — safe in $(...).
| Command | Behavior |
|---|---|
path <Type> | Print absolute path to cached .cs. Decompiles on miss. |
path <Type> -Dll <Name> | Skip namespace heuristic; force a specific DLL. |
list | Show all cached types as a table. --json for raw output. |
remove <Type> | Delete one cache entry. |
clean | Nuke the entire cache. |
~/.taom-src/dll-index.json remembers type → dll from prior lookups. Instant hit.TaleWorlds.CampaignSystem.X.Y probes TaleWorlds.CampaignSystem.X.dll, then TaleWorlds.CampaignSystem.dll, then TaleWorlds.dll. Catches ~99% of cases on the first probe.*.dll in bin/Win64_Shipping_Client alphabetically. ~30 probes max.| Situation | Action |
|---|---|
About to write [HarmonyPatch(typeof(X), nameof(X.Y))] | taom-src path X first — verify Y exists with the expected signature |
About to override GetCharacterWage on DefaultPartyWageModel | taom-src path DefaultPartyWageModel — copy the exact base signature |
| About to call a TaleWorlds API from an adapter | taom-src path <Type> — confirm the method exists in the installed engine with the expected signature |
| Bug investigation: "vanilla does X, what does its code actually look like?" | taom-src path <ClassName> then rg for the symptom |
| Want to know what's already cached | taom-src list |
| Situation | Use instead |
|---|---|
| Looking for a class but don't know the FQN | grep -r "ClassName" E:/Decompiled_Bannerlord/ to find namespace, then taom-src path to verify against the installed engine |
| Need to browse a whole namespace tree | ls E:/Decompiled_Bannerlord/<area>/ (the dump is fine for browsing patterns) |
| Need full type list of a DLL | mcp__ilspy__list_types (the ILSpy MCP is purpose-built for this) |
The recurring failure mode (caught by Codex review 2026-05-06, see feedback_codex_caught_api_misread.md in memory): two agents disagreed on a TaleWorlds API; the more confident one was wrong because it inferred from the decompile folder rather than the installed DLLs. A single primitive that always lands on the installed engine version — and caches so the cost is paid once per type — removes the temptation to skip verification.
$env:BANNERLORD_GAME_DIR set to the Bannerlord install root (e.g. E:\Steam\steamapps\common\Mount & Blade II Bannerlord).ilspycmd on PATH (dotnet tool install -g ilspycmd).Both are reported with actionable error messages if missing (per .claude/rules/environment-failures.md).
.claude/skills/research/SKILL.md — broader "decompile and analyze before implementing" workflow. Use that for full analysis sessions; use taom-src for one-shot signature lookups.CLAUDE.md "TaleWorlds Research — Lookup Order" — high-level routing.