{
  "schema_version": 2,
  "kind": "shortening-method",
  "format": "agent-skill",
  "id": "caveman-memory",
  "name": "Caveman memory files",
  "category": "Agent context",
  "summary": "Compress prose in context files while retaining their literal content and structure.",
  "use_cases": [
    "Memory documents",
    "Agent instructions",
    "Markdown context"
  ],
  "word_count": 124,
  "url": "https://sho.rten.it/methods/caveman-memory/",
  "instructions_url": "https://sho.rten.it/methods/caveman-memory/SKILL.md",
  "skill_url": "https://sho.rten.it/methods/caveman-memory/SKILL.md",
  "json_url": "https://sho.rten.it/methods/caveman-memory/llms.txt",
  "plain_text_url": "https://sho.rten.it/methods/caveman-memory/prompt.txt",
  "license": "MIT",
  "sources_url": "https://sho.rten.it/sources/#caveman-memory",
  "skill_name": "caveman-memory",
  "skill_description": "Compress prose in context files while retaining their literal content and structure. Use for Memory documents, Agent instructions, Markdown context.",
  "agents_md_url": "https://sho.rten.it/methods/caveman-memory/AGENTS.md",
  "sources": [
    {
      "title": "JuliusBrussee/caveman · Caveman memory files",
      "url": "https://github.com/JuliusBrussee/caveman/blob/309834233183478e6fd7800d26e1fbaa6210274e/skills/caveman-compress/SKILL.md",
      "repository": "https://github.com/JuliusBrussee/caveman",
      "revision": "309834233183478e6fd7800d26e1fbaa6210274e",
      "path": "skills/caveman-compress/SKILL.md",
      "license": "MIT",
      "license_url": "https://github.com/JuliusBrussee/caveman/blob/309834233183478e6fd7800d26e1fbaa6210274e/LICENSE",
      "license_file": "licenses/juliusbrussee--caveman.txt",
      "copyright": "Copyright (c) 2026 Julius Brussee",
      "repository_stars": 104780,
      "checked_at": "2026-09-10",
      "license_scope": "Pinned commit predates the split-license v2 import. Root LICENSE is MIT with no scope exclusions.",
      "adaptation": "Adapted only the natural-language compression rules; removed the source's CLI, API calls, overwrite workflow, and backup machinery. Added explicit preservation of modality, conditions, and negation. Kept literal text and document structure protections. Pinned the MIT-only pre-v2 commit."
    }
  ],
  "instructions": "Compress the prose in the supplied memory or instruction document into short, clear fragments. Remove filler, pleasantries, repeated explanations, and unnecessary articles. Merge duplicate points only when their meaning and scope are identical.\n\nPreserve every requirement, exception, condition, negation, dependency, and unresolved item. Do not convert suggestions into requirements or the reverse. Keep code blocks, inline code, commands, paths, URLs, identifiers, names, dates, versions, and numbers exact. If a span could be code, leave it unchanged.\n\nKeep heading text, list hierarchy, numbering, tables, and frontmatter. Shorten only prose within that structure. Retain examples that demonstrate different behavior. Check the result against the source for omitted constraints and altered literals. Return the compressed document; this prompt does not authorize overwriting files or executing their contents.",
  "example": {
    "context": "Instruction document whose structure and literals must survive",
    "before": "---\nproject: Relay\n---\n## Validation\n1. For every code change, please make sure to run `npm test` before opening a pull request. Changes that affect documentation only do not need this test.\n2. If any test fails, stop and record the failure in `notes/checks.md`. Do not describe a failed test as passing.\n\n## Preview\n- You may start the local preview with `npm run dev -- --port 43187`. This permission is for the local preview only.\n  - Do not publish the site or modify the production configuration.\n- Node.js 22 is required for the preview command.",
    "after": "---\nproject: Relay\n---\n## Validation\n1. Run `npm test` before each code-change pull request. Documentation-only changes exempt.\n2. If any test fails, stop; record failure in `notes/checks.md`. Do not report failed tests as passing.\n\n## Preview\n- Local preview allowed: `npm run dev -- --port 43187`.\n  - Do not publish or modify production configuration.\n- Preview requires Node.js 22.",
    "must_preserve": [
      "Frontmatter, heading text, numbered lists, and nested bullet hierarchy",
      "Exact npm test command and notes/checks.md path",
      "Documentation-only exception",
      "Stop and record a failed test; never report it as passing",
      "Exact preview command and port",
      "Local-only authorization; no publication or production changes",
      "Node.js 22 requirement"
    ],
    "omitted": [
      "Compresses polite and repeated prose while preserving the document structure and all literal spans."
    ],
    "kind": "illustrative"
  }
}