# Meridian

> A Claude skill from mattjaikaran/meridian.

- **Type:** Skill
- **Install:** `agentstack add skill-mattjaikaran-meridian-meridian`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [mattjaikaran](https://agentstack.voostack.com/s/mattjaikaran)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** Apache-2.0
- **Upstream author:** [mattjaikaran](https://github.com/mattjaikaran)
- **Source:** https://github.com/mattjaikaran/meridian

## Install

```sh
agentstack add skill-mattjaikaran-meridian-meridian
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Meridian -- Unified Workflow Engine

Meridian is a SQLite-backed state machine for managing
complex development workflows with deterministic resume,
fresh-context subagents, and engineering discipline protocols.

## Available Skills

- audit-uat -- uat — Cross-Phase Verification Debt Audit
- autonomous -- Hands-Free Execution
- checkpoint -- Manual Save Point
- complete-milestone -- milestone — Complete Milestone
- config -- Workflow Configuration
- dashboard -- Project Dashboard
- debug -- Systematic Debugging
- discuss -- Phase Discussion
- dispatch -- Remote Agent Dispatch
- do -- Freeform Command Router
- execute -- Execution Engine
- fast -- Inline Fast Task
- freeze -- Edit Scope Lock
- history -- Event Timeline
- init -- Initialize Meridian in Current Project
- insert-phase -- phase — Insert Phase Mid-Milestone
- learn -- Execution Learning System
- migrate -- Cross-Project Migration
- next -- Advance to Next Workflow Step
- note -- Quick Note Capture
- pause -- Session Handoff
- plan -- Planning Pipeline
- pr-branch -- branch — Create Clean PR Branch
- profile -- Developer Preference Profiling
- quick -- Lightweight Quick Task
- remove-phase -- phase — Remove Phase
- report -- Session Report
- resume -- Deterministic Resume
- retro -- Structured Retrospective
- revert -- Revert Completed Plan
- review -- Two-Stage Code Review
- roadmap -- Cross-Milestone Roadmap
- scan -- Codebase Audit & Work Discovery
- seed -- Backlog Seed Management
- ship -- Commit + Push + PR
- status -- Show Project Status
- template -- Workflow Templates
- thread -- Persistent Discussion Threads
- validate -- Git State Validation
- verify-phase -- phase -- Nyquist Compliance Check
- workstream -- Multi-Track Parallel Work Management

## Architecture

State is stored in `.meridian/state.db` (SQLite) in each
project directory. The state machine enforces valid transitions
and computes the next action deterministically.

### Hierarchy
```
Project -> Workstream -> Milestone -> Phase -> Plan
                      (optional; milestones not in a workstream are ungrouped)
```

### Phase Lifecycle
```
planned -> context_gathered -> planned_out -> executing -> verifying -> reviewing -> complete
                                                                         |
                                                                       blocked
```

### Plan Lifecycle
```
pending -> executing -> complete
                     -> failed -> pending (retry)
                     -> paused -> executing
```

## Scripts (Python, stdlib only)
- `scripts/db.py` -- Schema init + migrations (v2: priority column)
- `scripts/state.py` -- CRUD + transitions + next-action + auto-advancement + priority
- `scripts/resume.py` -- Deterministic resume prompt generator
- `scripts/export.py` -- SQLite -> JSON export for remote agents
- `scripts/dispatch.py` -- Remote agent HTTP dispatch client
- `scripts/sync.py` -- Bidirectional remote agent sync (pull status + push state)
- `scripts/metrics.py` -- PM metrics: velocity, cycle times, stalls, forecasts, progress
- `scripts/board/`          -- Pluggable board sync (kanban integration)
  - `provider.py`           -- BoardProvider protocol and registry
  - `cli.py`                -- CLI-based board provider (env-var configurable)
  - `sync.py`               -- Sync bridge (called from phase transitions)
- `scripts/context_window.py` -- Token estimation + checkpoint triggers
- `scripts/generate_commands.py` -- Generate Claude Code command wrappers from skills

## References
- `references/state-machine.md` -- State transitions + rules + auto-advancement + priority
- `references/discipline-protocols.md` -- TDD, debugging, verification, review
- `references/remote-agent.md` -- Remote agent dispatch protocol
- `references/board-integration.md` -- Pluggable board sync protocol

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [mattjaikaran](https://github.com/mattjaikaran)
- **Source:** [mattjaikaran/meridian](https://github.com/mattjaikaran/meridian)
- **License:** Apache-2.0

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-mattjaikaran-meridian-meridian
- Seller: https://agentstack.voostack.com/s/mattjaikaran
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.