/setup

/setup — Memplexor bootstrap

You are running the Memplexor /setup command in the current project at $PWD.

Arguments

Parse $ARGUMENTS (space-separated flags):

• --dry-run → analyze + report only, write nothing
• --refresh → re-run analysis, refresh generated files only
• --force → overwrite generated files even if they lack the generation marker; never delete user memory
• --preserve-memory → default; preserve CURRENT.md, HISTORY.md, sessions/*
• --help → print this usage and exit

If --help: print the argument list above and stop.

Step 1 — Detect project root

project_root is the current working directory ($PWD). Never write outside it.

Step 2 — Inspect repository

Read whichever of these exist (use Glob/Read; never assume):

File	Signal
package.json	Node + scripts + framework deps
pnpm-lock.yaml / yarn.lock / package-lock.json / bun.lockb	Package manager
pyproject.toml / requirements.txt / Pipfile / poetry.lock	Python
Cargo.toml	Rust
go.mod	Go
Gemfile	Ruby
composer.json	PHP
Makefile	Build commands
tsconfig.json / .eslintrc* / .prettierrc* / ruff.toml	Style/typecheck
Dockerfile / docker-compose.yml	Containers
.github/workflows/* / .gitlab-ci.yml	CI
README.md	High-level description

Detect:

• Primary language(s)
• Framework(s) (Next.js, React, FastAPI, Django, Rails, Axum, Gin, …)
• Package manager
• Build / Test / Lint / Typecheck / Run commands (from scripts section or Makefile)
• Key top-level directories (src/, app/, lib/, tests/, pkg/, etc.)

Step 3 — Plan changes

Compute the file list. THESE ARE THE ONLY PATHS YOU WRITE. Do not create .claude/memory/CURRENT.md or .claude/memory/HISTORY.md at the memory root — those go inside context/ and progress/.

.claude/memory/                                (mkdir -p)
.claude/memory/context/                        (mkdir -p)
.claude/memory/progress/                       (mkdir -p)
.claude/memory/sessions/                       (mkdir -p)
.claude/memory/context/CURRENT.md              (seed if absent unless --force)
.claude/memory/progress/HISTORY.md             (append setup entry; create if absent)
.claude/skills/project-guidelines/SKILL.md     (generate or refresh)

Forbidden paths (never create these):

• .claude/memory/CURRENT.md — wrong, use context/CURRENT.md
• .claude/memory/HISTORY.md — wrong, use progress/HISTORY.md
• Anything outside $PWD

If --dry-run: print the plan, exit. Do not write.

Step 4 — Idempotency rules

• Generation marker: include <!-- Generated by Memplexor --> in the first line of every generated file
• CURRENT.md:
  • Absent → seed from template (Step 5)
  • Present + has marker → refresh if --refresh or --force, else preserve
  • Present + no marker → preserve unless --force
• HISTORY.md: always append. Skip the append if the latest H2 entry already matches the new title within 60 seconds.
• SKILL.md: treat like CURRENT.md.
• sessions/: never touch existing files.

Step 5 — Write files

Use atomic writes (write to .tmp.<rand> then rename) for any file you overwrite.

CURRENT.md template

<!-- Generated by Memplexor -->
# Current Project Context

**Last updated:** <ISO-8601 with timezone offset>

## Where We Are

* Project initialized with Memplexor.
* Detected stack: <languages, frameworks>
* Package manager: <manager>

## Recent Work

* (none — fresh setup)

## Next Steps

* Start a new Claude Code session to confirm SessionStart context injection fires.
* Run `/memory-status` to inspect memory health.

## Open Questions

* (add yours here — survives save-hook rewrites)

## Important Files

* <list 5-10 key files / directories detected>

## Warnings or Constraints

* (add yours here — survives save-hook rewrites)

HISTORY.md entry (append)

## <ISO-8601> — setup complete

* Initialized Memplexor project memory.
* Generated project guidelines skill.
* Verified hook registration.
* Detected stack: <stack>
* Next: start a new Claude Code session to verify SessionStart injection.

SKILL.md template

See templates/project-guidelines.SKILL.md for the full structure. Fill in:

• name: project-guidelines
• description: one sentence naming the stack + that these are project conventions
• Sections: Detected Stack, Build / Test / Lint / Typecheck commands, Code Conventions, Do, Don't, Key Directories, Project Notes.

Step 6 — Verify hook registration

The plugin's hooks/hooks.json already registers SessionStart, Stop, PreCompact at install time. Confirm the plugin is loaded by checking that ${CLAUDE_PLUGIN_ROOT} resolves and the script files exist. Report status.

Step 7 — Report

Print a single concise summary:

Created:
* <list of newly created files>

Refreshed:
* <list of files updated because of --refresh / --force>

Preserved:
* <list of user-authored files left untouched>

Skipped:
* <list of files skipped + reason>

Warnings:
* <missing test command, no README, etc.>

Next:
* Start a new Claude Code session to verify SessionStart injection.
* Run /memory-status to inspect.

Safety rules

• Never delete files.
• Never write secrets (.env, credentials, tokens) into memory.
• Never store full transcripts.
• Stay inside $PWD — no parent traversal.