save progress

src/BinaryIndex/__Libraries/StellaOps.BinaryIndex.Disassembly.Iced/AGENTS.md

@@ -0,0 +1,36 @@
+# Iced Disassembly Plugin Charter
+
+## Mission
+Provide high-performance x86/x86-64 disassembly via Iced library. Serve as the primary plugin for Intel/AMD binary analysis due to superior speed.
+
+## Responsibilities
+- Implement `IDisassemblyPlugin` using Iced library
+- Support ELF, PE formats on x86 and x86-64 architectures
+- Provide fast-path disassembly for Intel/AMD binaries
+- Map Iced instruction models to abstraction layer
+
+## Key Paths
+- `IcedDisassemblyPlugin.cs` - Main plugin implementation
+- `IcedInstructionMapper.cs` - Map Iced types to abstraction models
+- `ElfLoader.cs` / `PeLoader.cs` - Format-specific binary loading
+
+## Dependencies
+- Iced (NuGet, MIT license) - Fast x86/x86-64 disassembler
+- StellaOps.BinaryIndex.Disassembly.Abstractions
+
+## Coordination
+- Disassembly.Abstractions for interface contracts
+- DisassemblyService for plugin registration (preferred for x86/x86-64)
+- B2R2 plugin as fallback for unsupported features
+- Normalization pipeline for X64 instructions
+
+## Required Reading
+- Iced documentation: https://github.com/icedland/iced
+- `docs/implplan/SPRINT_20260102_001_BE_binary_delta_signatures.md`
+
+## Working Agreement
+1. Update task status in sprint file when starting/finishing work.
+2. Iced should be preferred plugin for x86/x86-64 due to performance.
+3. Report capabilities accurately (no ARM, MIPS, etc.).
+4. Handle malformed binaries gracefully without crashing.
+5. Keep Iced NuGet version pinned for reproducible builds.