memento

Memento

A Claude Code way-of-work cycle. Maximize confidence over speed — and match process weight to task size.

Every task starts with a prior-art sweep (find any existing implementation before scoping), then is sized Small or Large:

• Small → implement directly → final-review
• Large → brainstorm → plan → auto-review → human-review → TDD-red → implement → smoke → final-review → receiving-review

Independent agents for test / implement / review. Red-commit SHA is the handoff artifact.

Install

/plugin marketplace add JoaoAnt42/memento
/plugin install memento@memento

That's it — skills and the /use_memento command are now available.

Manual install (no plugin system)

git clone https://github.com/JoaoAnt42/memento
cd memento
for d in skills/*/; do
  name="$(basename "$d")"
  mkdir -p ~/.claude/skills/"$name"
  cp "$d/SKILL.md" ~/.claude/skills/"$name"/SKILL.md
done
cp commands/use_memento.md ~/.claude/commands/use_memento.md

Local development

The plugin installs from a version-pinned cache — update-all (/plugin marketplace update) only re-pulls when the version field changes, not on every commit. To ship an edit:

1. Edit skills/commands in your local clone.
2. Bump version in both .claude-plugin/plugin.json and .claude-plugin/marketplace.json (all three fields must match).
3. Commit and push to master.
4. In Claude: /plugin marketplace update memento then /plugin update memento@memento.
5. Restart Claude.

Skip the version bump and the update is a silent no-op — Claude keeps serving the cached version. Pushing requires the JoaoAnt42 GitHub identity (the clone's origin uses SSH).

Use

/use_memento <task description>

Entry point is memento-0-using. Each step invokes the next skill in sequence.

Steps

Step	Skill	Purpose
0	memento-0-using	Entry point. Prior-art sweep, then size Small/Large and route
1	memento-1-brainstorming	Explore intent, self-research first
2	memento-2-planning	Write plan in Obsidian, propose-4-options
3	memento-3-auto-review	Devil's Advocate + Simplifier + Orchestrator
4	memento-4-human-review	Submit plan; on approve, create a git worktree per repo; rejection loops back to step 2
6	memento-6-tdd-red	Write failing tests, commit red SHA
7	memento-7-implementing	Independent impl agent, input = red SHA
7.5	memento-7b-human-smoke	Optional; gated by needs_human_smoke: true
8	memento-8-final-review	Parallel reviewers, precedence: Bugs > CRAP > Simplifier > DA > Tests
8.5	memento-8b-cross-pr-review	Optional, multi-repo only (repos: ≥2). Cross-PR contract check; applies fixes in worktrees and pushes
9	memento-9-receiving-review	Verify, push back, or implement. Loops back to step 8 on non-trivial review changes.

Requirements

• Claude Code with plugin / skill support