# BW Map Magnet — Claude Development Guide

**Version:** 1.5.2 | **Last Updated:** 2026-05-20

## What this plugin does

Showcase locations on a map with hover-to-zoom interaction for activities, restaurants, attractions and more.

## Process

This plugin follows the standard BW Plugins process defined in the umbrella `/srv/apps/bw-plugins/CLAUDE.md`. That covers:

- **Versioning** — default bump is patch; minor only for significantly new feature sets; major reserved.
- **Release gating** — never run `tools/release.sh` without an explicit "release it" from rian.
- **Session protocol** — read `docs/SESSION-LOG.md` + `docs/HANDOFF-NOTES.md` at session start, update at session end.
- **Always / Never** lists (escaping, nonces, `defined( 'ABSPATH' ) || exit;`, `vendor/`, secrets, etc.).

Plus full release process in `/srv/apps/bw-plugins/docs/RELEASE-PROCESS.md`.

## Before making changes

1. Read `docs/SESSION-LOG.md` for recent context.
2. Read `docs/HANDOFF-NOTES.md` for any pending async messages.
3. Read `docs/SPEC.md` for current requirements.
4. Check `docs/KNOWN-ISSUES.md` for active bugs and workarounds.

## Architecture Quick Reference

- Main file: `bw-map-magnet.php` (constant `BW_MAP_MAGNET_VERSION`)
- Core classes: `includes/class-bw-map-magnet-*.php`
- Admin UI: `admin/`
- Frontend assets: `assets/`
- Docs: `docs/`
- Vendored libs: `vendor/`

## Plugin-specific notes

_None at this time. Add an entry here only when this plugin does something deliberately different from the umbrella process — for example, a non-standard prefix, a pre-existing data migration, or a release that needs special coordination._