IFM Agent Documentation & Skill Map
This document maps engineering tasks to their corresponding AGENTS.md instructions, SKILL.md workflows, architecture reference docs, and executable verification commands.
Task Routing Table
| Task Description | Primary AGENTS.md | Applicable Skill (SKILL.md) | Deep Context Docs | Executable Verification |
|---|---|---|---|---|
| Architecture Review & Refactoring | AGENTS.md (root) | architecture-review | docs/architecture/invariants.md, docs/architecture/README.md | cargo test --workspace |
| Audio Pipeline & Opus Codec | crates/AGENTS.md | audio-development | AUDIO_MIXING.md, docs/architecture/audio.md, docs/audio/README.md | cargo test -p ifm-audio |
| Wire Protocol & Binary Packets | crates/AGENTS.md | protocol-change | IFM-PROTOCOL-SPEC.md, docs/protocol/README.md | cargo test -p ifm-protocol |
| libp2p, QUIC, WebRTC Transport | crates/AGENTS.md | transport-development | docs/transport/README.md, docs/protocol/discovery.md | cargo test -p ifm-transport |
| Relay Plane & Mesh Forwarding | packages/sdk/AGENTS.md | relay-development | docs/demos/README.md, docs/rendezvous/README.md | cargo test -p ifm-transport |
| TypeScript SDK Development | packages/sdk/AGENTS.md | sdk-development | docs/sdk/README.md | npm run build && npm run test:cli |
| Bug Fixing & Packet Diagnostics | AGENTS.md (root) | debugging | docs/developer-tools.md | npm run test:cli, cargo test |
| Test-Driven Development (TDD) | AGENTS.md (root) | test-driven-development | docs/architecture/map.md | cargo test --workspace, npm run test:cli |
| Cross-Repository Schema Change | AGENTS.md (root) | cross-repository-change | docs/architecture/invariants.md | cargo test --workspace, npm run build |
| Mobile Radio Listener PWA | packages/ifm-pwa/AGENTS.md | sdk-development | docs/mobile-pwa/README.md, mobile-radio-listener.md | bun --cwd packages/ifm-pwa build |
| Landing & Documentation Site | packages/landing/AGENTS.md | sdk-development | docs/index.md, docs/distribution/README.md | bun scripts/build-docs.mjs |
Skill Navigation Pattern
When an AI coding agent begins a task:
text
1. Read root AGENTS.md for global operating rules & invariants.
2. Locate task in the Task Routing Table above.
3. Read the specified repository/package AGENTS.md.
4. Load the relevant SKILL.md for step-by-step workflow procedures.
5. Refer to deep context docs for domain-specific formulas or specs.
6. Execute the listed verification commands to validate changes.