master/chat-summaries/2026-02-16_15-18-summary.md

# Created CrossPoint Reader Development Skill

**Date**: 2026-02-16
**Task**: Create a Cursor agent skill for CrossPoint Reader firmware development guidance.

## Changes Made

Created project-level skill at `.cursor/skills/crosspoint-reader-dev/` with 6 files:

| File | Lines | Purpose |
|------|-------|---------|
| `SKILL.md` | 202 | Core rules: agent identity, hardware constraints, resource protocol, architecture overview, HAL usage, coding standards, error handling, activity lifecycle, UI rules |
| `architecture.md` | 138 | Build system (PlatformIO CLI + VS Code), build flags, environments, generated files, local config, platform detection |
| `coding-patterns.md` | 135 | FreeRTOS tasks, malloc patterns, global font loading, button mapping, UI rendering rules |
| `debugging-and-testing.md` | 148 | Build commands, serial monitoring, crash debugging (OOM, stack overflow, use-after-free, watchdog), testing checklist, CI/CD pipeline |
| `git-workflow.md` | 98 | Repository detection, branch naming, commit messages, when to commit |
| `cache-management.md` | 100 | SD card cache structure, invalidation rules, file format versioning |

## Design Decisions

- **Progressive disclosure**: SKILL.md kept to 202 lines (well under 500 limit) with always-needed info; detailed references in separate files one level deep
- **Project-level storage**: `.cursor/skills/` so it's shared with anyone using the repo
- **Description** includes broad trigger terms: ESP32-C3, PlatformIO, EPUB, e-ink, HAL, activity lifecycle, FreeRTOS, SD card, embedded C++

## Follow-up Items

- Consider adding the skill directory to `.gitignore` if this should remain personal, or commit if sharing with collaborators
- Update cache file format version numbers if they've changed since the guide was written
- Skill will auto-activate when the agent detects firmware/embedded development context
mod: Phase 1 - bring forward mod-exclusive files with ActivityManager migration Brings ~55 mod-exclusive files to the upstream-based mod/master-resync branch: Activities (migrated to new ActivityManager pattern): - Clock/Time: SetTimeActivity, SetTimezoneOffsetActivity, NtpSyncActivity - Dictionary: DictionaryDefinitionActivity, DictionarySuggestionsActivity, DictionaryWordSelectActivity, LookedUpWordsActivity - Bookmark: EpubReaderBookmarkSelectionActivity - Book management: BookManageMenuActivity, EndOfBookMenuActivity - OPDS: OpdsServerListActivity, OpdsSettingsActivity - Utility: DirectoryPickerActivity, NumericStepperActivity Utilities (unchanged): - BookManager, BookSettings, BookmarkStore, BootNtpSync - Dictionary, LookupHistory, TimeSync, OpdsServerStore Libraries: PlaceholderCover, TableData, ChapterXPathIndexer Scripts: inject_mod_version, generate_book_icon, preview_placeholder_cover Docs: KOReader sync XPath mapping Migration changes: - ActivityWithSubactivity -> Activity base class - Callback constructors -> finish()/setResult() pattern - enterNewActivity() -> startActivityForResult() - Activity::RenderLock&& -> RenderLock&& These files won't compile yet - they reference mod settings and I18n strings that will be added in subsequent phases. Made-with: Cursor 2026-03-07 15:10:00 -05:00			`# Created CrossPoint Reader Development Skill`

			`Date: 2026-02-16`
			`Task: Create a Cursor agent skill for CrossPoint Reader firmware development guidance.`

			`## Changes Made`

			Created project-level skill at `.cursor/skills/crosspoint-reader-dev/` with 6 files:

			`\| File \| Lines \| Purpose \|`
			`\|------\|-------\|---------\|`
			\| `SKILL.md` \| 202 \| Core rules: agent identity, hardware constraints, resource protocol, architecture overview, HAL usage, coding standards, error handling, activity lifecycle, UI rules \|
			\| `architecture.md` \| 138 \| Build system (PlatformIO CLI + VS Code), build flags, environments, generated files, local config, platform detection \|
			\| `coding-patterns.md` \| 135 \| FreeRTOS tasks, malloc patterns, global font loading, button mapping, UI rendering rules \|
			\| `debugging-and-testing.md` \| 148 \| Build commands, serial monitoring, crash debugging (OOM, stack overflow, use-after-free, watchdog), testing checklist, CI/CD pipeline \|
			\| `git-workflow.md` \| 98 \| Repository detection, branch naming, commit messages, when to commit \|
			\| `cache-management.md` \| 100 \| SD card cache structure, invalidation rules, file format versioning \|

			`## Design Decisions`

			`- Progressive disclosure: SKILL.md kept to 202 lines (well under 500 limit) with always-needed info; detailed references in separate files one level deep`
			- Project-level storage: `.cursor/skills/` so it's shared with anyone using the repo
			`- Description includes broad trigger terms: ESP32-C3, PlatformIO, EPUB, e-ink, HAL, activity lifecycle, FreeRTOS, SD card, embedded C++`

			`## Follow-up Items`

			- Consider adding the skill directory to `.gitignore` if this should remain personal, or commit if sharing with collaborators
			`- Update cache file format version numbers if they've changed since the guide was written`
			`- Skill will auto-activate when the agent detects firmware/embedded development context`