1
0
forked from jason/echo
Files
chorus/chorus-memory.plugin.src/commands/chorus-save.md
T
jason f2bfd70dd4 Phase 5: group-voice docs, onboarding runbook, CHORUS icon — v2.0.0-rc.1
The final phase of CHORUS-PLAN.md. Code- and doc-complete for group use;
rc pends live deployment at chorusapi.mpm.to.

- Repo README rewritten for CHORUS: group model (schema 5), concurrency
  posture, configuration, baked-build onboarding, layout, testing, 2.0
  version history (ECHO history referenced at the fork tag).
- Operator→member voice sweep across SKILL.md (incl. the trigger
  description, now group-aware), all references, 8 command docs, plugin
  README; member preferences / semantic layer / triage guidance describe
  the group model.
- docs/ONBOARDING.md: member runbook — vault stand-up, per-member config,
  bake, deliver, self-onboarding first load, norms, offboarding.
- docs/USAGE.md rewritten as the member usage guide.
- New icon: chorus-icon.svg + 1024/512/64 PNGs (three voices, one center).
- Removed ECHO-era assets (icons, spec PDF, perf briefs); ECHO planning
  docs retired to docs/history/. All preserved at echo-fork-point.
- eval/README documents test_multimember.py. Manifest -> 2.0.0-rc.1;
  rebuilt chorus-memory.plugin.

Verified: routing-sync, 25/25 unit, scaffold, 5 mock e2e suites,
run_eval metrics green.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-21 15:41:58 -05:00

2.3 KiB

description, argument-hint
description argument-hint
Save to CHORUS memory — route content to its canonical home (search-first, idempotent) [what to remember]

Use the chorus-memory skill to persist this to the CHORUS vault:

$ARGUMENTS

Prefer the one-call capture — it routes (via the entity index), derives the canonical path, stamps complete frontmatter (kind-default status, the kind seeded into tags), indexes, auto-links mentioned entities, and writes the Agent-Log line. Pick the --kind from the content (person, company, concept, reference, meeting, project, area, semantic, episodic, working, skill, decision); add --tags when obvious; use --inbox only when the home is genuinely unknown. Write multi-line bodies to a file with the Write tool (cross-platform, no heredoc) — updates to an existing entity preserve the whole body, so don't pre-trim it.

CHORUS="${CLAUDE_PLUGIN_ROOT}/skills/chorus-memory/scripts/chorus.py"   # run with: python3 "$CHORUS" ... (Windows: python / py -3)
[ -f "$CHORUS" ] || CHORUS=$(ls /sessions/*/mnt/.remote-plugins/*/skills/chorus-memory/scripts/chorus.py 2>/dev/null | head -1)   # CoWork sandbox fallback
python3 "$CHORUS" capture "<title>" <bodyfile> --kind <kind> [--aliases a,b] [--tags t1,t2] [--source p1,p2]
python3 "$CHORUS" capture "<title>" --inbox     # unknown home -> idempotent inbox line

If capture exits 76 (duplicate gate): the title strongly resembles an existing entity — do NOT retry blindly. Show the member the printed candidates and either update the existing note (capture ... --merge-into <slug>) or, only after they confirm it's genuinely distinct, re-run with --force.

Drop to the low-level verbs only for shapes capture doesn't model (a project ## Status replace, an ADR mirror, a daily-note edit):

python3 "$CHORUS" put   <routed/path>.md <bodyfile>                       # create/overwrite (verifies)
python3 "$CHORUS" patch <path>.md append heading "<H1::Sub>" <bodyfile>   # targeted append

Write in third person about the vault owner; never put [[wikilinks]] in frontmatter. capture handles agent_written, source_notes, indexing, and linking for you; if you write by hand, resolve "<title>" first to avoid duplicates and bump updated: only on substantive changes.