Fincanya Kahve Falı

View saved version →

---
name: coffee-reading
description: Use when the user sends a photo of their Turkish coffee cup or asks for a reading ('kahve falıma bak', 'read my coffee cup'). Reads the cup (kahve falı) from the photo, shape by shape.
---

Fincanya reads Turkish coffee cups (kahve falı) for entertainment and tradition, in Turkish or English. This skill covers a reading from a photo of the user's own cup and questions about what a shape in the grounds means.

## Inputs

- A photo of the inside of the cup, taken from above after the grounds have dried. A photo of the saucer is optional; by tradition it is read for the wish and home.
- Or a question about one shape, such as "kahve falında deve görmek ne demek?" or "what does a bird near the rim mean?". No photo is needed for that.

## Flow

1. `read_cup` takes the cup photo, and the saucer photo when there is one. It finds the rim, outlines up to 8 shapes in the cup and 3 on the saucer, and returns each shape's zone, clock position, size, form and 8 lexicon suggestions. It shows no card and contains no meanings yet.
2. `name_shapes` takes one Fincanya lexicon name per outlined shape: one of its suggestions, or any lexicon entry in Turkish or English. It returns each shape's traditional meaning, a short reading in English and Turkish (`reply_en`, `reply_tr`) that is suitable to show the user as is, and the card with the photo and numbered outlines, where the user can tap a shape to correct it.
3. When the user wants to keep the reading, `save_reading` adds it to their fal defteri (journal). `rename_shape` corrects a shape in a saved reading, `open_journal` shows past readings, `share_reading` makes an unlisted link and `stop_sharing` turns it off. `delete_reading` deletes one reading, or the whole fal defteri, when the user asks.
4. For a question about a shape, `lookup_symbol` searches the lexicon and returns a one-sentence answer (`answer_en`, `answer_tr`).

## Scope

- Every meaning comes from Fincanya's written lexicon of about 400 traditional shapes. The rim stands for the near future, the middle for the present, the bottom for the past and the saucer for the wish and home.
- A reading describes tradition only: the lexicon contains no predictions or advice about business, partnerships, contracts, money, health, law, death, pregnancy or break-ups.
- By tradition the wish (niyet) stays secret, so no tool has an input for it.
- Fincanya reads coffee cups only; palm, tarot and horoscope readings are outside it.

Referenced files: 2 — file references are metadata, not package contents.

View saved version →

---
name: fal-defteri
description: Use when the user wants to keep, correct, revisit, share or delete their coffee readings ('falımı kaydet', 'show my fal defteri', 'share this reading'). Manages the fal defteri, the user's own journal of Fincanya readings.
---

The user wants to do something with readings they already have: keep one, fix a shape they see differently, look back at past cups, share one with friends or remove one. The fal defteri (journal) belongs to the user's ChatGPT account and holds only their own readings.

## Flow

1. To keep the reading just made, call `save_reading`. Saving twice keeps one copy.
2. When the user sees a shape differently ("shape 2 looks like a fish to me"), call `rename_shape` with the shape number and the lexicon entry they name. The card comes back with the new name and its traditional meaning; the other shapes keep theirs.
3. To look back, call `open_journal`. It shows the saved readings with their dates, a thumbnail of each cup and the first shape names; tapping one opens its card.
4. To share a reading, call `share_reading`. It returns an unlisted link that friends can open without ChatGPT. `stop_sharing` turns the link off at once.
5. When the user asks, `delete_reading` removes one reading or the whole fal defteri.

## Scope

- A reading has to exist first. For a new cup photo, the coffee-reading skill comes first.
- Shape names come only from Fincanya's lexicon of about 400 traditional shapes, in Turkish or English.
- Unsaved readings are removed after 24 hours; saved ones stay until the user deletes them.

Referenced files: 2 — file references are metadata, not package contents.

View saved version →

---
name: shape-meanings
description: Use when the user asks what a shape means in a Turkish coffee reading, with or without a photo ('kahve falında deve görmek ne demek?', 'what does a bird near the rim mean?'). Answers from Fincanya's lexicon of about 400 traditional shapes.
---

The user wants the traditional meaning of one shape, for example a camel, a bird, a fish, a road or a ring. No photo is needed.

## Flow

1. Call `lookup_symbol` with the shape as the user names it, in Turkish or English. It searches Fincanya's lexicon and returns a one-sentence answer in both languages.
2. Answer in the user's language. When the user says where the shape sits, the zone adds to the meaning: the rim stands for the near future, the middle for the present, the bottom for the past and the saucer for the wish and home.
3. If the user then wants their own cup read, the coffee-reading skill takes a photo of it.

## Scope

- Meanings come from Fincanya's written lexicon and are framed as tradition, for entertainment.
- The lexicon holds no predictions or advice about money, health, law, death, pregnancy or break-ups.
- Palm, tarot and horoscope readings are outside Fincanya.

Referenced files: 2 — file references are metadata, not package contents.