← AiAkiv MemoryCONTENT HISTORY

Update to AiAkiv Memory

Snapshot Sep 30, 2026 · 23:09 UTC · version 2.0.0

Collection source: not recorded for this historical snapshot.

WHAT CHANGED · RULE-BASED ANALYSIS

First saved snapshot

No earlier snapshot is available to establish a change.

Compare saved observations

Download comparison JSON
Full technical diff · 0 changed fields
Full snapshot data
{
  "name": "aiakiv-cards",
  "description": "Create a public AiAkiv card from the user's memory. Use when the user asks to make a card, share a memory as a link/page, publish a summary card, or asks what AiAkiv cards are or how to fix/delete one. A card is a one-page public site (card.aiakiv.com) written by YOU from memory search results and baked by the card service — live on the open web the moment it is created.",
  "included_files": [],
  "skill_md_contents": "---\r\nname: aiakiv-cards\r\ndescription: >-\r\n  Create a public AiAkiv card from the user's memory. Use when the user asks to\r\n  make a card, share a memory as a link/page, publish a summary card, or asks\r\n  what AiAkiv cards are or how to fix/delete one. A card is a one-page public\r\n  site (card.aiakiv.com) written by YOU from memory search results and baked by\r\n  the card service — live on the open web the moment it is created.\r\n---\r\n\r\n# AiAkiv cards\r\n\r\nA **card** is a one-page public summary of the user's AiAkiv memory: title,\r\n3–5 bullets, a one-line conclusion, optional long body — plus two share images\r\nwith the short URL stamped in. Anyone with the address can view it, no login.\r\nYou create it through the shared app gateway; the server never calls a model —\r\n**you write the content**.\r\n\r\n## The one fact that governs everything\r\n\r\n**Creating IS publishing.** The card is live on the open web the instant the\r\ncreate call returns. Unlisted (nobody finds it without the address) but NOT\r\nprivate. There is no draft state and no undo except deletion in the console.\r\nSo: filter before you create, and relay the response's `notice` to the user\r\nfirst, verbatim.\r\n\r\n## Procedure\r\n\r\n1. **Search memory first** (`search_memory`). The card summarizes what is\r\n   actually stored — do not invent content. Set `source_count` to the number\r\n   of memories you actually used.\r\n2. **Filter for sensitivity** — personal names, emails, internal addresses,\r\n   decisions not yet public. If the topic is at all sensitive, show the user a\r\n   draft and get a go-ahead before creating.\r\n3. **Get the live format**: `run_aiakiv_app_action(app=\"card\", action=\"describe\")`.\r\n   Only `describe` and `create` exist — this tool cannot delete, edit, or\r\n   change search visibility.\r\n4. **Write to fit the image, not just the limits.** `describe` returns\r\n   `bullets.renders` with the measured safe line width (~30 Hangul chars) and\r\n   max lines per bullet. Bullets share one fixed block of vertical space:\r\n   5 bullets ≈ one safe line each; 3 bullets can run 2–3 lines each. Staying\r\n   under `max_chars_each` (120) is NOT enough. Aim to fit on the first try —\r\n   re-creating issues a NEW key and leaves the old card published and counted\r\n   against quota until the user deletes it in the console.\r\n5. **Create**: `run_aiakiv_app_action(app=\"card\", action=\"create\", data={...})`.\r\n   Fields: `title` (≤80), `bullets` (3–5), `conclusion` (≤200),\r\n   `source_count`, `tags` (≤3, ≤20 chars each — these are the search terms on\r\n   card.aiakiv.com), `body` (optional, ≤30k chars, restricted markdown:\r\n   paragraphs, `##`, lists, `>`, code, bold/italic, http(s) links, `---`;\r\n   anything else renders as plain text). Title/bullets/conclusion/tags are\r\n   single-line — newlines collapse. If a long body gets mangled in transport,\r\n   pass `data` as one JSON **string**.\r\n\r\n## Handling the response\r\n\r\n- **`notice` comes first.** Relay it to the user before the link, before any\r\n  summary, uncompressed. It states the card is already public and how to take\r\n  it down.\r\n- **`url`** — show verbatim as a clickable link. `og_url` / `square_url` are\r\n  the share images (Instagram / boards that don't unfurl links).\r\n- **`fit`** (present only when something was cut) — report it as-is:\r\n  `bullets_truncated` / `bullets_dropped` are original bullet numbers, `hint`\r\n  says how much to shorten. The PAGE always shows full text; only the images\r\n  crop. Let the user decide whether to shorten and re-create — and if they do,\r\n  remind them the old card stays up until deleted.\r\n- **Errors** (`{error, hint, field}`): `invalid_card` → fix the named field\r\n  and retry; `payload_too_large` → shrink the body; `quota_exceeded` (50 held /\r\n  10 per hour / 30 per day) → tell the user; anything else → relay and stop.\r\n  On any error the card was NOT created — never say it was.\r\n\r\n## What you must not do\r\n\r\n- Create a card the user didn't ask for (\"summarize this\" is not a card request).\r\n- Fill a card with content that isn't in memory.\r\n- Claim you deleted a card or toggled search visibility — you can't. Manage-\r\n  ment (list, copy link, images, delete, search-visibility toggle) lives in\r\n  the AiAkiv console → Data → Cards (app.aiakiv.com).\r\n- Offer to set the user's public nickname or attach filing tags — you can't.\r\n  Those are console-only too (see below). `data.tags` is a different thing:\r\n  card tags are baked into the image at create time and cannot be changed.\r\n- Quietly re-create after a `fit` warning — that leaves two public cards.\r\n- Paste the card's URL anywhere on the user's behalf; sharing is their call.\r\n\r\n## Useful context for the user\r\n\r\n- KakaoTalk / Slack / Discord / Notion / blogs unfurl the bare URL into a card.\r\n  Instagram and some board sites don't — upload the square/wide image instead;\r\n  the URL is stamped inside it.\r\n- Search visibility is OFF by default. Turning it on (console) lists the card\r\n  on card.aiakiv.com search by title/tags; turning it off later un-lists it\r\n  but the card stays public to anyone with the address.\r\n- card.aiakiv.com search narrows three ways — text, author nickname, filing\r\n  tag — and the address bar tracks whatever is narrowed, so any view can be\r\n  shared as a link. **Nickname and filing tags are set in the console, by the\r\n  user, not by you.** A nickname is optional; without one nothing identifying\r\n  the user is published. Their email is never published in any case. Filing\r\n  tags show on the card page and group cards in search; they never change the\r\n  card image.\r\n- Deleting removes the page immediately, but third-party preview caches can\r\n  linger. Deleting the account does NOT delete cards — clean up in the console\r\n  first.\r\n"
}

SHA-256: 60405487b4aea342b9f95efe87d744733d12585b58d3b6d6b5668f5995032b60