Prefer accessible all-photos views for property photo review
This commit is contained in:
@@ -63,22 +63,25 @@ For the target property, capture when available:
|
|||||||
|
|
||||||
Always look at the listing photos when they are available. Do not rate a property only from structured text.
|
Always look at the listing photos when they are available. Do not rate a property only from structured text.
|
||||||
|
|
||||||
### Required gallery workflow
|
### Required photo-access workflow
|
||||||
|
|
||||||
When the source site has a photo gallery or modal lightbox, you must explicitly open it and verify that you are seeing distinct images, not just a gallery preview tile or repeated screenshot of the first image.
|
When the source site exposes listing photos, prefer the **most accessible all-photos view** first. This can be:
|
||||||
|
- a scrollable all-photos page
|
||||||
|
- a photo grid
|
||||||
|
- an expanded photo list
|
||||||
|
- or, if necessary, a modal gallery/lightbox
|
||||||
|
|
||||||
Use `web-automation` for this. Preferred process:
|
Use `web-automation` for this. Preferred process:
|
||||||
1. Open the listing page.
|
1. Open the listing page.
|
||||||
2. Click the gallery entry point such as `See all photos`, `See all 29 photos`, or the main hero image.
|
2. Click the photo entry point such as `See all photos`, `See all 29 photos`, `Show all photos`, or the main hero image.
|
||||||
3. Confirm the gallery/lightbox is actually open.
|
3. If that opens a scrollable all-photos view, grid, or photo page that clearly exposes the listing images, use that directly for photo review.
|
||||||
4. Capture the first image.
|
4. Only use next-arrow / slideshow traversal when the site does not provide an accessible all-photos view.
|
||||||
5. Advance through the gallery using the actual next-arrow control inside the gallery, not a blind keyboard press unless you have confirmed it changes the image.
|
5. If you must use a modal/lightbox, verify that you are seeing distinct images, not just a gallery preview tile or repeated screenshot of the first image.
|
||||||
6. After each advance, confirm the image changed before treating it as reviewed.
|
6. Review enough images to cover the key rooms and exterior, and for smaller listings aim to review all photos when practical.
|
||||||
7. Review enough images to cover the key rooms and exterior, and for smaller listings aim to review all photos when practical.
|
7. If photo access fails or is incomplete, say so explicitly and do not claim that you reviewed all photos.
|
||||||
8. If navigation fails, say so explicitly and do not claim that you reviewed all photos.
|
|
||||||
|
|
||||||
Minimum honesty rule: never say you "looked at all photos" unless you successfully inspected distinct gallery images one by one.
|
Minimum honesty rule: never say you "looked at all photos" unless the site actually exposed the full set and you successfully reviewed them.
|
||||||
A gallery landing page, collage view, repeated first image, or a single screenshot of the listing page does **not** count as full photo review.
|
A gallery landing page, collage preview, repeated first image, or a single screenshot of the listing page does **not** count as full photo review.
|
||||||
|
|
||||||
### What to inspect in the photos
|
### What to inspect in the photos
|
||||||
|
|
||||||
|
|||||||
@@ -127,20 +127,21 @@ Example:
|
|||||||
npx tsx flow.ts --instruction 'go to https://search.fiorinis.com then type "pippo" then press enter then wait 2s'
|
npx tsx flow.ts --instruction 'go to https://search.fiorinis.com then type "pippo" then press enter then wait 2s'
|
||||||
```
|
```
|
||||||
|
|
||||||
### Gallery/lightbox workflows
|
### Gallery/lightbox and all-photos workflows
|
||||||
|
|
||||||
For real-estate listings and other image-heavy pages, prefer opening the gallery/lightbox explicitly and verifying that each navigation step produces a distinct image.
|
For real-estate listings and other image-heavy pages, prefer the most accessible all-photos view first.
|
||||||
|
|
||||||
Practical rules:
|
Practical rules:
|
||||||
- Do not treat a listing page hero image, gallery collage, or modal landing view as full photo review.
|
- A scrollable all-photos page, expanded photo grid, or photo list is an acceptable source for condition review if it clearly exposes the listing images.
|
||||||
- After opening the gallery, capture the first image, then use the actual in-gallery next control.
|
- Do not treat a listing page hero image, gallery collage preview, or modal landing view alone as full photo review.
|
||||||
- Confirm the image changed before counting the next screenshot as reviewed.
|
- Only rely on next-arrow / slideshow traversal when the site does not provide an accessible all-photos view.
|
||||||
|
- If using a gallery, confirm the image changed before counting the next screenshot as reviewed.
|
||||||
- If a generic `Next` control exits the gallery or returns to the listing shell, stop and adjust the selector/interaction; do not claim the photos were reviewed.
|
- If a generic `Next` control exits the gallery or returns to the listing shell, stop and adjust the selector/interaction; do not claim the photos were reviewed.
|
||||||
- Blind `ArrowRight` presses are not reliable enough unless you have already verified that they advance the gallery on that site.
|
- Blind `ArrowRight` presses are not reliable enough unless you have already verified that they advance the gallery on that site.
|
||||||
- For smaller listings, review all photos when practical; otherwise review enough distinct photos to cover kitchen, baths, living areas, bedrooms, exterior, and any waterfront/balcony/deck elements.
|
- For smaller listings, review all photos when practical; otherwise review enough distinct photos to cover kitchen, baths, living areas, bedrooms, exterior, and any waterfront/balcony/deck elements.
|
||||||
- If automation cannot reliably advance the gallery, say so explicitly in the final answer.
|
- If automation cannot reliably access enough photos, say so explicitly in the final answer.
|
||||||
|
|
||||||
Where possible, prefer specific controls over vague ones, for example a gallery-specific next-arrow button rather than a page-level `Next` button.
|
Where possible, prefer a site’s explicit `See all photos` / `Show all photos` path over fragile modal navigation.
|
||||||
|
|
||||||
## Compatibility Aliases
|
## Compatibility Aliases
|
||||||
|
|
||||||
|
|||||||
Reference in New Issue
Block a user