0be354a920
Single-commit clean baseline after security scrub of niche-tells, project codenames, internal jargon, and contributor-email leaks. Contents: - 100 Rust crates (_primitives/_rust/) - 37 agent manifests (_manifests/) + generated specs (_generated/) - 67 user-invocable skills (skills/) - 33 hooks (hooks/) - Composition blocks (_blocks/) - Documentation (docs/, README.md) - TS adapter packages (_ts_packages/) - Assembler (_assembler/) - Roles (_roles/) - Templates (_templates/) - Forgejo CI (.forgejo/) Author: Denis Parfionovich <info@greendragon.info> License: see LICENSE.
30 lines
1.3 KiB
Markdown
30 lines
1.3 KiB
Markdown
# \_primitives — first-class building blocks
|
|
|
|
`_primitives/` holds standalone utilities that agents, hooks, and skills
|
|
(including `/compose-solution`) depend on. Unlike `_blocks/` (behavioral
|
|
markdown) or `_manifests/` (agent TOML), primitives are executable shell
|
|
programs installed at `$HOME/.claude/agents/_primitives/` by `install.sh`.
|
|
|
|
## Current primitives
|
|
|
|
| Primitive | Purpose | Invocation |
|
|
|---|---|---|
|
|
| `tomd.sh` | Universal non-native-format → markdown converter (PDF, DOCX, XLSX, PPTX, CSV, images, code). | `~/.claude/agents/_primitives/tomd.sh <file>` |
|
|
|
|
`tomd.sh` is a first-class primitive. Universal non-native-format →
|
|
markdown converter with configurable cache directory
|
|
(`KEISEI_TOMD_CACHE`) and KeiSeiKit-style error tags (`[tomd]`).
|
|
|
|
## Hook integration
|
|
|
|
`hooks/tomd-preread.sh` is a PreToolUse(Read) hook that auto-redirects
|
|
Claude to the converted markdown when a Read targets `.docx / .doc / .xlsx /
|
|
.pptx / .csv`. Cached under `$KEISEI_TOMD_CACHE` (default
|
|
`/tmp/keisei-tomd-cache`).
|
|
|
|
## `/compose-solution` discovery
|
|
|
|
Phase 3 prior-art sweep greps `_primitives/` alongside `_blocks/`,
|
|
`_manifests/`, `skills/`, `_bridges/`, `hooks/`. If a user task involves
|
|
file-format parsing, the meta-composer surfaces `tomd` automatically —
|
|
reuse over rewrite (RULE "No Patching").
|