meridian
Agent enforcement framework — context injection, planning gates, session learning
Not in a marketplace yet, so it loads for one session with --plugin-dir.
Plugin meridian in markmdev/meridian. Commands read from the repo's manifest — 1 month ago.
This plugin runs code on your machine — its hooks fire automatically on events like tool use. The exact commands are listed below; read them before installing.
What it installs
Skills (6)
add-frontmatterScan all .md files in the project and add or fix YAML frontmatter (summary + read_when) so they can be discovered by context routers like Reflex.
create-docsCreate or update .meridian/docs/ knowledge files for a module or directory. Produces reference docs with frontmatter for context routing.
error-auditAudit code for silent error swallowing, fallbacks to degraded alternatives, backwards compatibility shims, and UI that fails to show errors to the user. Finds and fixes all occurrences in the specified scope.
observability-auditAudit code for observability gaps — debug logs left in, errors caught without being logged, missing context on log entries, untracked slow operations. Uses the app's existing observability tooling exclusively.
planningInterview-driven planning methodology that produces implementation-ready plans. Always use this skill INSTEAD of EnterPlanMode — it provides structured interviewing (20-40 clarifying questions), exhaustive parallel codebase exploration (5-15 Explore agents), verbatim requirements capture, and automa
ux-states-auditAudit UI code for missing loading states, empty states, and error states. Every async operation and data-driven UI must handle all three. Finds gaps and implements the missing states using the app's existing patterns.
Slash commands (3)
/meridian:coderabbit-reviewHandle CodeRabbit AI review cycles after creating a PR
/meridian:thinkThink through a problem on paper before acting
/meridian:work-untilStart a work-until loop that keeps you working on a task until completion
Subagents (8)
architectReviews architecture — either existing code or proposed plans. Use during planning to validate approach, or after changes to check structural health.
code-health-reviewerFinds dead code, pattern drift, over-engineering, and refactoring opportunities. Use after completing large tasks, at the end of feature work, or when code has gone through many iterations.
code-reviewerDeep code review that finds real bugs — logic errors, data flow issues, pattern inconsistencies. Returns structured findings to the calling agent.
docs-researcherUse BEFORE writing code that uses an external API, library, or tool not already documented in `.meridian/api-docs/`. Researches via web scraping and builds comprehensive knowledge docs with current versions, API operations, limits, and gotchas.
ExploreUse for broad codebase research when you don't know where to look, need to understand "how does X work?", or want comprehensive findings across many files. Returns file paths, line numbers, code snippets, and negative results. Read-only — cannot modify files.
implementUse when you have a detailed, unambiguous implementation spec (e.g., "add export for function X in file Y"). Executes the spec, runs typecheck/tests, reports results. Spawn multiple in parallel for independent tasks. Does NOT ask questions — reports ambiguity and stops.
pebble-scaffolderDocuments planned work in Pebble before implementation. Creates appropriate structure (epic, task, or bug fix) based on scope.
plan-reviewerValidate a plan before implementation. Use before exiting Plan mode. Pass the plan file path and any additional context files. Returns JSON with findings and score (must reach 9+ to proceed).
Hooks (15)
- SessionStart
python3 "${CLAUDE_PLUGIN_ROOT}/scripts/context-injector.py"
- SessionStart
python3 "${CLAUDE_PLUGIN_ROOT}/scripts/session-cleanup.py"
- SessionStart
python3 "${CLAUDE_PLUGIN_ROOT}/scripts/save-injected-files.py"
- Stop
python3 "${CLAUDE_PLUGIN_ROOT}/scripts/work-until-stop.py"
- Stop
python3 "${CLAUDE_PLUGIN_ROOT}/scripts/stop-checklist.py"
- PostToolUse
python3 "${CLAUDE_PLUGIN_ROOT}/scripts/action-counter.py"
- PostToolUse
python3 "${CLAUDE_PLUGIN_ROOT}/scripts/plan-approval-reminder.py"
- PreToolUse
python3 "${CLAUDE_PLUGIN_ROOT}/scripts/reviewer-root-guard.py"
- UserPromptSubmit
python3 "${CLAUDE_PLUGIN_ROOT}/scripts/action-counter.py"
- UserPromptSubmit
python3 "${CLAUDE_PLUGIN_ROOT}/scripts/plan-mode-tracker.py"
- UserPromptSubmit
python3 "${CLAUDE_PLUGIN_ROOT}/scripts/instruction-reminder.py"
- PreCompact
python3 "${CLAUDE_PLUGIN_ROOT}/scripts/session-transcript.py"
- PreCompact
python3 "${CLAUDE_PLUGIN_ROOT}/scripts/session-learner.py"
- SessionEnd
python3 "${CLAUDE_PLUGIN_ROOT}/scripts/session-learner.py"
- SessionEnd
python3 "${CLAUDE_PLUGIN_ROOT}/scripts/session-transcript.py"
Maintain meridian?
This page updates itself from your repo. Add the badge to your README, or get it Featured to pin it above the organic results with a followed link to your site.