# AGENTS.md

## Project Policy

This project evaluates ramen soup images for ラーメン豚山.

When working on prompt design, API tests, result formatting, or evaluation logic, treat the following document as the fixed source of truth:

- `APIテスト/豚山スープ画像評価プロンプト方針.md`

Do not casually change the evaluation policy. If a change is needed, update both the implementation prompt and the policy document together.

## Fixed Evaluation Target

The target is not a completed ramen bowl.

Evaluate only the soup surface inside a stock pot, large cooking pot, or soup kettle in a kitchen setting.

Do not evaluate:

- Finished bowl presentation
- Noodles
- Bowl toppings
- Plating quality
- Taste, aroma, salt level, or Brix from image alone

Brix must be treated as a separate non-image input.

## Fixed Output Schema

Keep the JSON schema aligned with the policy document.

Primary keys:

- `assessable`
- `retake_recommended`
- `image_condition_score`
- `visual_density`
- `water_level`
- `oil_emulsification`
- `boiling_heat_state`
- `photo_quality`
- `deduction_reasons`
- `craftsperson_check_points`
- `summary`

Use English `snake_case` keys. Category values may remain Japanese.

## Critical Density Rule

The `visual_density` rule is especially sensitive and should not be simplified.

The fixed distinction is:

- `11`: the liquid body remains lightly cloudy and translucent, with a pale beige to light brown see-through quality.
- `12`: the liquid body is cloudy beige to turbid light brown, with weaker transparency and standard emulsified thickness.

Do not decide density from white foam, steam, boiling turbulence, fat film, white membrane, or ingredient surface whiteness.

For the 11/12 boundary, use the three-point rule in the policy document:

1. Whether foam-free liquid looks light brown and translucent or cloudy beige.
2. Whether ingredient edges are clear or slightly blurred through the liquid.
3. Whether white areas and brown liquid look separated or cloudiness appears spread through the liquid.

If two or more signals point to 11, choose 11. If two or more signals point to 12, choose 12.

## Editing Guidance

- Keep `APIテスト/index.html` prompt text and `APIテスト/豚山スープ画像評価プロンプト方針.md` synchronized.
- Preserve the local test UI unless the user explicitly asks for a different structure.
- Keep raw API response display and formatted assessment display both available.
- Avoid introducing unrelated frameworks or build steps for the current HTML test UI.