56  Installable Library

57 Installable Library

The installable library is generated from canonical spell and stack data. It gives practitioners lower-friction assets without forking the book.

57.1 Export Targets

57.2 Local Install

Dry-run first:

python3 scripts/install_assets.py --target codex --dest tmp/grimoire-assets
python3 scripts/grimoire.py install --target cursor --dest tmp/grimoire-assets

Copy selected assets:

python3 scripts/install_assets.py --target codex --dest tmp/grimoire-assets --write
python3 scripts/grimoire.py install --target claude-code --dest tmp/grimoire-assets --write

Installable console scripts are declared in pyproject.toml for editable local use:

python3 -m pip install -e .
grimoire export --target cursor
grimoire export --target claude-code
grimoire install --target cursor --dest tmp/grimoire-assets
grimoire install --target claude-code --dest tmp/grimoire-assets --write
grimoire bench import examples/evaluations/manual-import-template.json
grimoire bench hardness-import examples/evaluations/hardness-v4/manual-import-template.json
grimoire adoption report -- --id adoption.example-review.v1 --title "Example Review" --provenance reviewer-supplied --task "Describe the real task." --spell-or-stack-used spell.safe-refactoring.v1 --surface "Reviewer workflow" --artifact-produced "Patch or review artifact." --verification-performed "Tests or review checks." --time-cost "Low" --failure-or-friction "Record friction honestly." --reuse-decision reuse --write-report tmp/adoption-report.json
grimoire-install-assets --target cursor --dest tmp/grimoire-assets --write
grimoire-install-assets --target claude-code --dest tmp/grimoire-assets --write
grimoire-import-hardness-run validate examples/evaluations/hardness-v4/manual-import-template.json

57.3 Rules

  • Exports are generated. Do not hand-edit them.
  • Every export links back to a spell or stack ID and working seal.
  • Every release bundle includes a bundle-local manifest and the global manifest records SHA-256 checksums.
  • Provider-specific formats are adapters. The canonical data remains in data/spells.json and data/stacks.json.
  • No export is allowed to add hidden network calls or model-provider dependencies.
  • Defensive jailbreak-resilience exports must preserve the dual-use safety scope and avoid operational bypass payloads.