Skip to content

Commit ab9805d

Browse files
chore: complete task-174 and update AGENTS.md
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
1 parent 5d72cd6 commit ab9805d

2 files changed

Lines changed: 45 additions & 62 deletions

File tree

AGENTS.md

Lines changed: 45 additions & 62 deletions
Original file line numberDiff line numberDiff line change
@@ -1039,6 +1039,51 @@ cargo update
10391039
- **rustfmt**: Code formatter: `cargo fmt`
10401040
- **cargo-expand**: View macro expansions: `cargo expand`
10411041

1042+
## Video Demo
1043+
1044+
Convert screen recording (mp4) to AVIF for README using SVT-AV1 (fast, good quality):
1045+
1046+
```bash
1047+
ffmpeg -i input.mp4 -c:v libsvtav1 -vf scale=-1:720 -crf 30 demo.avif
1048+
```
1049+
1050+
- `libsvtav1` is 10-50x faster than `libaom-av1`
1051+
- `-crf 30` balances quality/size (lower = better quality, larger file)
1052+
- Scale to 720p height for reasonable file size
1053+
1054+
### Video Frame Extraction for Debugging
1055+
1056+
Extract frames from screen recordings (MP4/MOV) for debugging UI issues:
1057+
1058+
```bash
1059+
# High-quality PNG frames at source resolution
1060+
ffmpeg -i video.mp4 -vf "fps=15" /tmp/frames/frame_%03d.png
1061+
1062+
# With downscaling for large videos (720p height, maintain aspect)
1063+
ffmpeg -i video.mp4 -vf "fps=15,scale=-1:720" /tmp/frames/frame_%03d.png
1064+
1065+
# Extract specific time range (2s to 5s)
1066+
ffmpeg -i video.mp4 -ss 2 -to 5 -vf "fps=15" /tmp/frames/frame_%03d.png
1067+
1068+
# Maximum quality (lossless PNG, no frame skip)
1069+
ffmpeg -i video.mp4 -vf "fps=30" -compression_level 0 /tmp/frames/frame_%03d.png
1070+
1071+
# JPEG for smaller files (quality 2 = high, 31 = low)
1072+
ffmpeg -i video.mp4 -vf "fps=15" -qscale:v 2 /tmp/frames/frame_%03d.jpg
1073+
```
1074+
1075+
**Parameters:**
1076+
- `fps=15` - Extract 15 frames per second (adjust based on video framerate)
1077+
- `scale=-1:720` - Scale to 720p height, auto-calculate width
1078+
- `-compression_level 0` - Fastest PNG encoding (larger files)
1079+
- `-qscale:v 2` - JPEG quality (2=best, 31=worst)
1080+
1081+
**Use cases:**
1082+
- Debugging spinner/loading issues
1083+
- Capturing exact UI state during animations
1084+
- Documenting visual bugs for reports
1085+
1086+
10421087
<!-- BACKLOG.MD MCP GUIDELINES START -->
10431088

10441089
<CRITICAL_INSTRUCTION>
@@ -1067,65 +1112,3 @@ You MUST read the overview resource to understand the complete workflow. The inf
10671112
</CRITICAL_INSTRUCTION>
10681113

10691114
<!-- BACKLOG.MD MCP GUIDELINES END -->
1070-
1071-
<!-- MANTIC SEARCH GUIDELINES START -->
1072-
1073-
<CRITICAL_INSTRUCTION>
1074-
1075-
## SEARCH CAPABILITY (MANTIC v1.0.21)
1076-
1077-
This project uses Mantic for intelligent code search. Use it before resorting to grep/find commands.
1078-
1079-
**Basic Search:**
1080-
```bash
1081-
npx mantic.sh "your query here"
1082-
```
1083-
1084-
**Advanced Features:**
1085-
1086-
**Zero-Query Mode (Context Detection):**
1087-
```bash
1088-
npx mantic.sh "" # Shows modified files, suggestions, impact
1089-
```
1090-
1091-
**Context Carryover (Session Mode):**
1092-
```bash
1093-
npx mantic.sh "query" --session "session-name"
1094-
```
1095-
1096-
**Output Formats:**
1097-
```bash
1098-
npx mantic.sh "query" --json # Full metadata
1099-
npx mantic.sh "query" --files # Paths only
1100-
npx mantic.sh "query" --markdown # Pretty output
1101-
```
1102-
1103-
**Impact Analysis:**
1104-
```bash
1105-
npx mantic.sh "query" --impact # Shows blast radius
1106-
```
1107-
1108-
**File Type Filters:**
1109-
```bash
1110-
npx mantic.sh "query" --code # Code files only
1111-
npx mantic.sh "query" --test # Test files only
1112-
npx mantic.sh "query" --config # Config files only
1113-
```
1114-
1115-
### Search Quality (v1.0.21)
1116-
1117-
- CamelCase detection: "ScriptController" finds script_controller.h
1118-
- Exact filename matching: "download_manager.cc" returns exact file first
1119-
- Path sequence: "blink renderer core dom" matches directory structure
1120-
- Word boundaries: "script" won't match "javascript"
1121-
- Directory boosting: "gpu" prioritizes files in gpu/ directories
1122-
1123-
### Best Practices
1124-
1125-
**DO NOT use grep/find blindly. Use Mantic first.**
1126-
1127-
Mantic provides brain-inspired scoring that prioritizes business logic over boilerplate, making it more effective for finding relevant code than traditional text search tools.
1128-
1129-
</CRITICAL_INSTRUCTION>
1130-
1131-
<!-- MANTIC SEARCH GUIDELINES END -->

backlog/tasks/task-174 - Last.fm-enhancements-play-count-sync-and-automatic-queue-retry.md renamed to backlog/completed/task-174 - Last.fm-enhancements-play-count-sync-and-automatic-queue-retry.md

File renamed without changes.

0 commit comments

Comments
 (0)