claude

meridian

Agent enforcement framework — context injection, planning gates, session learning

188 on GitHubby Mark Morganv0.8.0MITupdated 8 months ago

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-frontmatter

    Scan 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-docs

    Create or update .meridian/docs/ knowledge files for a module or directory. Produces reference docs with frontmatter for context routing.

  • error-audit

    Audit 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-audit

    Audit 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.

  • planning

    Interview-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-audit

    Audit 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-review

    Handle CodeRabbit AI review cycles after creating a PR

  • /meridian:think

    Think through a problem on paper before acting

  • /meridian:work-until

    Start a work-until loop that keeps you working on a task until completion

Subagents (8)

  • architect

    Reviews architecture — either existing code or proposed plans. Use during planning to validate approach, or after changes to check structural health.

  • code-health-reviewer

    Finds 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-reviewer

    Deep code review that finds real bugs — logic errors, data flow issues, pattern inconsistencies. Returns structured findings to the calling agent.

  • docs-researcher

    Use 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.

  • Explore

    Use 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.

  • implement

    Use 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-scaffolder

    Documents planned work in Pebble before implementation. Creates appropriate structure (epic, task, or bug fix) based on scope.

  • plan-reviewer

    Validate 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"

View source on GitHub

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.

claude & codex pluginslisted