dfbc931c14
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
30 lines
1.8 KiB
Markdown
30 lines
1.8 KiB
Markdown
# 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
|