docs(wiki): distill agentic-notes into three focused pages #21

Merged

erik merged 1 commit from chore/distill-agentic-notes into main

2026-06-27 20:21:55 +00:00

agent-dev commented

2026-06-27 15:37:36 +00:00

Member

Refs: #1

What

Distills the verbose wiki/agentic-notes.md (a 4,566-line raw ChatGPT export) into three focused, succinct wiki pages, then removes the original.

Per the issue, only the durable features & signals are extracted — the pipeline-ingestion stages and MCP/API-shape detail are intentionally dropped.

Pages

wiki/agentic-ux.md — supporting an agentic UX: map-first / agent-assisted stance, the "agents return view state, not markup" contract, a composable domain-UI grammar (visual/interaction/layout/state primitives + component modes), agent-friendly design principles, and the dual-mode / BYOK / replaceable-agent-layer model.
wiki/photo-tagging.md — tag provenance: camera (IPTC/XMP) vs user vs ML, where embedded tags come from, why the sources stay separate, and trust ranking. Cross-links to the already-implemented extract_signal_from_camera step.
wiki/photo-signals.md — other signals to mine: geotime enrichment, sun position, travel-mode/route reconstruction, camera heading, place/viewpoint clustering, quality/aesthetic scoring, similarity/duplicates, and visual semantics/embeddings — plus the highest-leverage subset.

Notes

Docs-only (wiki/), so just validate is skipped per the cycle protocol; pre-commit fmt/lint ran clean.
New pages cross-reference each other and the existing photo-curation-pipeline.md / image-native-embeddings.md notes, and call out which signals are already implemented today.

🤖 Generated with Claude Code

Refs: #1 --- ## What Distills the verbose `wiki/agentic-notes.md` (a 4,566-line raw ChatGPT export) into three focused, succinct wiki pages, then removes the original. Per the issue, only the durable **features & signals** are extracted — the pipeline-ingestion stages and MCP/API-shape detail are intentionally dropped. ## Pages - **`wiki/agentic-ux.md`** — supporting an agentic UX: map-first / agent-assisted stance, the "agents return view state, not markup" contract, a composable domain-UI grammar (visual/interaction/layout/state primitives + component modes), agent-friendly design principles, and the dual-mode / BYOK / replaceable-agent-layer model. - **`wiki/photo-tagging.md`** — tag provenance: **camera (IPTC/XMP)** vs **user** vs **ML**, where embedded tags come from, why the sources stay separate, and trust ranking. Cross-links to the already-implemented `extract_signal_from_camera` step. - **`wiki/photo-signals.md`** — other signals to mine: geotime enrichment, sun position, travel-mode/route reconstruction, camera heading, place/viewpoint clustering, quality/aesthetic scoring, similarity/duplicates, and visual semantics/embeddings — plus the highest-leverage subset. ## Notes - Docs-only (`wiki/`), so `just validate` is skipped per the cycle protocol; pre-commit fmt/lint ran clean. - New pages cross-reference each other and the existing `photo-curation-pipeline.md` / `image-native-embeddings.md` notes, and call out which signals are already implemented today. 🤖 Generated with [Claude Code](https://claude.com/claude-code)

agent-dev added 1 commit

2026-06-27 15:37:36 +00:00

docs(wiki): distill agentic-notes into three focused pages

Validate / validate (pull_request) Failing after 5s

Details

5bcc2b20da

Replace the 4.5k-line raw ChatGPT export (wiki/agentic-notes.md) with three succinct pages extracting only the durable features & signals, dropping the pipeline-ingestion and API-shape detail per the issue:

- wiki/agentic-ux.md — map-first agent-assisted UX, view-state contract, composable UI grammar, BYOK/replaceable agent layer
- wiki/photo-tagging.md — tag provenance: camera (IPTC/XMP) vs user vs ML, why they stay separate, trust ranking
- wiki/photo-signals.md — geotime enrichment, sun position, travel mode/route, camera heading, place clustering, quality scoring, similarity, embeddings

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

erik was assigned by agent-dev

2026-06-27 15:37:49 +00:00

agent-dev referenced this pull request

2026-06-27 15:38:05 +00:00

Distill agentic-notes.md #1

erik merged commit f7da1e21ff into main

2026-06-27 20:21:55 +00:00

erik deleted branch chore/distill-agentic-notes

2026-06-27 20:21:55 +00:00

erik referenced this pull request from a commit

2026-06-27 20:21:56 +00:00

Merge pull request 'docs(wiki): distill agentic-notes into three focused pages' (#21) from chore/distill-agentic-notes into main