ovrseelisted
Install: claude install-skill samuelboulery/ovrsee
# Ovrsee
Le dossier `ovrsee/` d'un dépôt contient l'état du projet sous forme lisible :
les plans approuvés, la carte des pages, les captures datées. Il est écrit par
des hooks, jamais à la main.
**L'ovrsee se lit. Il ne s'exécute jamais.** Une seule exception à l'édition :
`ovrsee/tickets/` et `ovrsee/board.json`, qui sont le tableau du projet et se
saisissent — par l'interface, par toi, ou par le CLI. Les plans, les pages et
les scans restent capturés par des hooks et ne s'éditent pas à la main.
## Quand l'utiliser
- Reprise d'un projet dormant : lire `ovrsee/` avant d'ouvrir le code.
- L'utilisateur demande où en est le projet, ce qui reste à faire, ou pourquoi
telle décision a été prise.
- Un plan vient d'être approuvé mais le hook de capture n'a pas tourné.
## Ce qu'on lit, et dans quel ordre
1. `ovrsee/plans/*.md` — un fichier par plan approuvé. Frontmatter JSON entre
deux `---` : `status` (`open` | `closed`), `title`, `opened`, `closed`,
`commits[]` (chacun avec `sha`, `date`, `files[]`). Le corps est le plan tel
qu'il a été approuvé, avec son intention et ses alternatives écartées.
2. `ovrsee/pages/pages.json` — les pages de l'application, leurs routes et
leurs liens sortants.
3. `ovrsee/pages/scans.jsonl` — une ligne par scan. **Une ligne `"ok": false`
signifie que le crawl a échoué ce jour-là : les captures de cette page sont
plus vieilles que le commit.** Ne jamais présenter une capture périmée comme
fraîche.
4. `ovrsee/board.json` puis