convez.ai
SkillEscrita & ConteúdoAvançado
jazz1x

Galmuri — Organizador Inteligente de Contexto

jazz1x/galmuri

Destila, organiza e documenta contexto com transparência e auditoria

Ver no GitHub
InicialPluginScore · de 0 a 100

Skill para Claude que transforma contextos dispersos em resumos bem estruturados com transparência explícita de perdas, rastreamento de evidências e templates de apresentação. Usa um motor de destilação central com quatro adaptadores de saída (explain, pitch, doc, deck) e gates de disciplina para garantir qualidade.

Instalação

$npx convez-ai jazz1x/galmuri

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
3
Forks
0
Acompanhando
0
Saúde
42%
Último commit
há 6 meses
Versão
v0.2.0
Issues abertas
0
Contribuidores
1

Casos de uso

  • Resumir discussões longas em documentação estruturada
  • Gerar pitch decks a partir de contexto desordenado
  • Auditar e documentar skills e decisões técnicas
  • Criar apresentações Jobs-inspired com decomposição D/E/V/R

Veredito

Ferramenta sofisticada para engenheiros e PMs que precisam traduzir contexto caótico em documentação rigorosa. Arquitetura bem pensada com gates de qualidade, mas curva de aprendizado acentuada — recomendado para times que valorizam auditoria e rastreabilidade.

README

A tradução para o português deste README ainda está na fila.

galmuri

Claude Code plugin — gather, organize, and keep context

version license claude-code

galmuri (갈무리) — Korean for "gathering, organizing, and storing with care." Turns sprawling context into well-kept summaries with explicit loss transparency, evidence grounding, and a deck template engine.

한국어 · 日本語

Architecture

galmuri is organized as one engine + four adapters + four discipline gates + one decision skill:

                    ┌─────────────────────────────────┐
                    │         distill (engine)         │
                    │  reduce · ratio · socratic probe │
                    └───────────────┬─────────────────┘
                                    │ EngineOutput JSON
              ┌─────────┬───────────┼───────────┬─────────┐
              ▼         ▼           ▼           ▼         ▼
           explain    pitch        doc         deck
          (inline)  (3-5 lines)  (file)    (JSON+md)

                              deck presets
                    ┌──────────────────────────────────┐
                    │ decision-sandwich-6  pitch-deck   │
                    │ concept-explain      story-arc    │
                    └──────────────────────────────────┘

                    ┌──────────────────────────────────────┐
                    │     discipline gates (read-only)     │
                    │  skill-audit  ·  self-audit          │
                    │     polish    ·    ralphi            │
                    └──────────────────────────────────────┘

                    ┌──────────────────────────────────────┐
                    │       decision forcing (HITL)        │
                    │   forki — binary → roles → choice    │
                    └──────────────────────────────────────┘
SkillRoleOutput
distillExtract essence — audience-tuned, D/E/V/R decomposition, Socratic probeEngineOutput JSON (internal)
explainInline markdown summary for the author (audience=me auto-fixed)stdout only
pitchHook-Core-CTA in 3–5 lines for a named audiencestdout only
docDistilled markdown saved to docs/docs/galmuri-doc-{slug}.md
deckStructured slide copy (JSON + markdown) using Jobs-inspired design tokensgalmuri-deck-{slug}.json + galmuri-deck-{slug}.md
skill-auditSSL (Scheduling-Structural-Logical) decomposition of any SKILL.md — read-only diagnostic.galmuri/audit-{slug}.md or stdout
self-auditSession-action gate: philosophy / scope / convention / token-budget checks before any commitinline table; tmp/self-audit-<ts>.md on overflow
polishCompletion-claim gate: branch / hooks / baseline / testid / tokens / report-length checklist before declaring "done"inline table; halts if any ✗
ralphiQuality-loop discipline: per-cycle token budget + philosophy auto-check via rg sweep + per-cycle commit ruleinline summary; tmp/ralphi-state-<n>.json on overflow
forkiDecision forcing: binary → D/E/V/R roles → trade-off → forced single choice, HITL-onlyinline report; opt-in .galmuri/assets/decision-{ts}.jsonl

Install

skills.sh (recommended)

Works with Claude Code, Cursor, Codex, Windsurf, and 40+ other agents.

npx skills add jazz1x/galmuri          # install into the current project (./.claude/skills/)
npx skills add jazz1x/galmuri -g       # install globally (~/.claude/skills/)

Useful flags:

npx skills add jazz1x/galmuri --list             # preview skills before installing
npx skills add jazz1x/galmuri --skill deck       # install a single skill only

Expected --list output:

distill
explain
pitch
doc
deck
skill-audit
self-audit
polish
ralphi
forki

1. Register the marketplace

Inside a Claude Code session, run:

/plugin marketplace add https://github.com/jazz1x/galmuri.git

2. Install the plugin

/plugin install galmuri

Expected output:

✓ Installed galmuri@0.2.0 — 10 skills registered (distill, explain, pitch, doc, deck, skill-audit, self-audit, polish, ralphi, forki)

3. Verify

/plugin list

All ten slash commands should autocomplete:

/galmuri:distill
/galmuri:explain
/galmuri:pitch
/galmuri:doc
/galmuri:deck
/galmuri:skill-audit
/galmuri:self-audit
/galmuri:polish
/galmuri:ralphi
/galmuri:forki

4. (Optional) Install hooks

galmuri ships optional hooks that add evidence gates, asset recording, prompt hints, and session context injection. They are opt-in — all skills work without them.

Project-level (recommended — scopes hooks to this repo only):

bash scripts/install-hooks.sh
# writes → .claude/settings.json   (backup: .claude/settings.json.bak-<epoch>)

User-level (apply globally to every project):

bash scripts/install-hooks.sh --user
# writes → ~/.claude/settings.json

See the Hooks section for what each hook does.

5. Uninstall

/plugin uninstall galmuri
/plugin marketplace remove galmuri

Quickstart

Just invoke the adapter. It asks what it needs in plain language.

explain — quick inline summary (no file created):

user    > /galmuri:explain path/to/long-doc.md
galmuri > [distill → inline markdown output]

pitch — 3–5 line pitch for a specific audience:

user    > /galmuri:pitch
galmuri > 누구를 위한 pitch 인가요? 예: 투자자, 팀, 고객
user    > 팀 전체 스프린트 킥오프용
galmuri > [Hook-Core-CTA, 3–5 lines]

doc — distilled markdown saved to file:

user    > /galmuri:doc path/to/source.md
galmuri > 누구를 위한 문서인가요? 예: 팀 전체, 나중의 나, 외부 리뷰어
user    > 나중의 나
galmuri > Save to docs/galmuri-doc-source.md? (y / n / edit-slug)
user    > y
✓ Saved · asset recorded in .galmuri/

deck — structured slide copy:

user    > /galmuri:deck
galmuri > 어떤 내용을 슬라이드로 만들까요?
user    > Postgres vs SQLite 마이그레이션 결정
galmuri > [decision-sandwich-6 preset auto-applied]
          → galmuri-deck-postgres-vs-sqlite.json
          → galmuri-deck-postgres-vs-sqlite.md

Usage

distill (engine)

Produces EngineOutput JSON consumed by adapters. Direct invocation useful for piping or scripting.

/galmuri:distill path/to/source.md --audience exec --ratio 0.2

Flags: --mode reduce, --ratio, --audience, --weak-decomposition, --input

explain (adapter)

Inline summary for the author. No file created, no audience query.

/galmuri:explain path/to/source.md

Natural language triggers: 설명해, 이해하게, 정리해서 보여줘, readme 읽고

pitch (adapter)

3–5 line Hook-Core-CTA for a named audience.

/galmuri:pitch path/to/source.md --audience investor

Natural language triggers: pitch 해, 한 문단으로, 소개해줘

doc (adapter)

Distilled markdown saved to docs/galmuri-doc-{slug}.md.

/galmuri:doc path/to/source.md --audience team

Natural language triggers: 문서로, 정리해서 저장, 기록으로

deck (adapter)

Structured slide copy — Jobs-inspired design tokens (SF Pro, 16:9, dark-light-dark pattern), rendered as JSON + markdown. No binary file build.

/galmuri:deck path/to/source.md --preset decision-sandwich-6

Presets:

PresetSlidesUse case
decision-sandwich-66Two-option decision with D/E/V/R decomposition
pitch-deck3Short investor or team pitch
concept-explain4–5Concept introduction
story-arcvariesNarrative-structured content

Natural language triggers: 슬라이드로, deck 만들어, 발표자료

skill-audit (discipline gate)

Static SSL decomposition of any SKILL.md. Single file or a skills/ directory. Read-only.

/galmuri:skill-audit skills/distill/SKILL.md
/galmuri:skill-audit skills/                       # batch mode

Natural language triggers: skill audit, ssl audit, audit skill, ssl 분해

self-audit (discipline gate)

Meta-audit of the current session before commit — philosophy, scope, convention, and token-budget violations.

/galmuri:self-audit

Natural language triggers: audit yourself, self-check, 셀프 점검, before commit

polish (discipline gate)

Self-check table before any "done" claim. Halts on any ✗ row. Not the full quality-loop polish (that's oh-my-borory:polish).

/galmuri:polish

Natural language triggers: polish, 완료 점검, done check, ready to ship, PR ready

ralphi (discipline gate)

Quality-loop discipline — per-cycle token budget + philosophy auto-check via rg sweep. Etymology: Ralph Wiggum (persistent retry) + -i (inspection).

/galmuri:ralphi

Natural language triggers: ralphi, 사이클 점검, loop budget, cycle gate

forki (decision forcing)

Binary → roles → trade-off → forced single choice. HITL-only: the LLM proposes; the user verdicts at Steps 1, 3, 6. Past decisions in .galmuri/assets/ are surfaced at Step 0 for trust / reopen; a fresh verdict can be appended as a decision asset at Step 8 (opt-in).

/galmuri:forki

Natural language triggers: forki, 결정, 선택, 어느 쪽, 둘 중 뭐, decide, choose between, trade-off

Backwards Compatibility

shrink is a context-routed alias retained for compatibility. It will be removed in a future release.

TriggerRoutes to
shrink, 줄여줘, 압축explain (short source) or doc (long source); pitch when the user explicitly asks for one line / TL;DR

A one-time deprecation warning fires per session on first use.

Removed in 0.0.3: the decide / 의사결정 / 결정해 triggers no longer auto-route to deck. Use galmuri:forki (added in 0.2.0) for binary decision forcing, or invoke deck --preset decision-sandwich-6 explicitly when slides are the deliverable.

Contributing

This repo ships a pre-commit guardrail at .githooks/pre-commit that blocks runtime artifacts, validates plugin JSON, checks README heading parity between README.md and README.ko.md, and runs the full tests/ suite when bats is installed. Git does not auto-install repo hooks — enable once per clone:

git config core.hooksPath .githooks

Run tests directly:

bash tests/run.sh   # requires bats-core + python3

CI runs the same suite on ubuntu + macos via .github/workflows/tests.yml.

Hooks

galmuri ships recommended hooks in hooks/recommended.json. scripts/install-hooks.sh merges them into .claude/settings.json with HITL conflict resolution.

EventMatcherShim(s)What it does
PreToolUseWritepre-write.shValidates source evidence before writing a galmuri output file
PostToolUseWrite|Editpost-write.sh, asset-record.shRecords output as an asset; cleans source from .galmuri/tmp/
UserPromptSubmit—prompt-hint.sh, source-capture.shRoutes skill-trigger phrases to the matching adapter; captures user prompt to .galmuri/tmp/
SessionStart—session-start.shInjects 3 most recent assets as session context

Hooks are opt-in — all skills work without them.

Assets

Every output is recorded in .galmuri/*.jsonl with metadata. Asset types:

TypeCaptured when
summarydistill/explain/doc output
deckdeck template built
pitchpitch output
evidence-traceevidence-check passes

Query past assets:

bash scripts/query-assets.sh --type doc --limit 5 --format inject

.galmuri/ is gitignored by default.

Sibling Integration (optional)

galmuri reads sibling plugin state when present, silently skips when absent:

SourceWhen readEffect
.harnish/persona.jsondistill Step 1Suggests default audience from persona
.honne/persona.jsondistill Step 1Reflects formality / verbosity only

Naming

  • galmuri (갈무리) = gather + organize + keep (Korean native word)
  • distill = remove tone and scaffolding, keep only claims that change decisions
  • explain = inline, self-directed summary (audience=me)
  • pitch = concise Hook-Core-CTA for a named audience
  • doc = distilled document saved to file
  • deck = structured slide copy with Jobs-inspired design tokens

Triad

galmuri sits between two sibling plugins — independent, connected by shared artifacts only:

harnish (make)  ──→  honne (know)  ──→  galmuri (keep)
  execution         reflection          refinement
  • harnish — autonomous implementation engine
  • honne — evidence-backed self-reflection (6-axis persona)
  • galmuri — summary · deck · documentation

Footnote

"Compression is lossy. Silence about what was lost is the actual failure."

Every galmuri output includes a loss diff. If it doesn't, we built the wrong tool.

License

MIT — See LICENSE.

Ver o original no GitHub

Bom para

Relacionados