# Product Cli

> Knowledge graph CLI for managing features, ADRs, and test criteria as MCP-discoverable artifacts.

- **Type:** MCP server
- **Install:** `agentstack add mcp-hafeok-product-cli`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [Hafeok](https://agentstack.voostack.com/s/hafeok)
- **Installs:** 0
- **Category:** [Integrations](https://agentstack.voostack.com/c/integrations)
- **Latest version:** 0.1.4
- **License:** MIT
- **Upstream author:** [Hafeok](https://github.com/Hafeok)
- **Source:** https://github.com/Hafeok/product-cli

## Install

```sh
agentstack add mcp-hafeok-product-cli
```

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

## About

# Product

**A CLI and MCP server for the Product Framework — specify software as a verifiable What/How graph.**

The [Product Framework](docs/product-framework-open.md) is an open standard for
describing a software product as one connected, machine-readable graph: the
**What** (domain model + event model — entities, commands, events, read models,
UI steps typed against Abstract Interaction Objects, *systems*, *triggers*,
*Deciders*, *Projectors*), the **How** (contracts, the screen-composition /
reification model, delivery slices), and the typed links between them. The graph
can drive generation, gate verification, and explain itself — so "describe this
system" is a query, not a stale document.

This repo is the reference tooling: a single Rust binary (`product`) plus an MCP
server that lets an agent author and verify the graph directly. No database, no
service — the graph lives as YAML/Turtle under `.product/`.

```
$ product init --demo                 # scaffold + seed the bookstore What model
$ product domain new system sys-shop --system-kind application \
      --purpose "consumer e-commerce" --target-classes gui
$ product domain validate --strict    # per-node shapes + graph-level completeness
$ product decider derive Order        # derive an aggregate's executable signature
$ product decider validate Order-decider
$ product mcp --http                  # MCP server + a live Event-Modeling web view at /
```

---

## Install

```bash
# from source
cargo install --path product-cli
```

The binary ships with the What→How→Build **Claude Code skills** baked in.
`product init` writes them into `.claude/skills/` of the new repo (pass
`--no-skills` to opt out); `product skills install` (re)installs them, and
`product skills install --global` puts them in `~/.claude/skills/` for every
project. Start a fresh Claude Code session to pick them up, then `/product-session`.

## 60-second tour

```bash
product init --demo                   # a worked What model to explore
product domain list                   # the captured nodes, by kind
product domain show Order             # one node and its links
product domain export                 # the graph as RDF/Turtle
product domain validate               # §3.1/§3.2 per-node conformance shapes
product domain validate --strict      # + §3.2.0/§3.2.5/§3.4/§4.5 completeness checks
product decider derive Order          # §3.3 — derive decide/evolve signature
product decider simulate Order-decider  # run its flow-derived scenarios
product guide                         # where you are + the next step
```

## The model

- **What** — `product domain …` captures the domain + event model; `product
  decider …` (§3.3) and `product projector …` (§3.4) make behaviour and read
  models executable; `product primitive …` (§3.5) names irreducible algorithms.
- **How** — `product how`, `product slice`, `product build`, `product seam`,
  `product preview` cover the How contract, delivery slices, the screen seam, and
  the §11/§12 design-system / content-store preview profiles.
- Everything is validated against the framework's SHACL shapes + SPARQL rules;
  the captured What serializes to Turtle (`product domain export`).

## MCP + the web view

`product mcp --http` starts the MCP server (framework tools: `product_domain_*`,
`product_decider_*`, `product_projector_*`, …) and serves a live web view at `/`
that renders the active What graph as an Event-Modeling swimlane timeline
(triggers / commands / views over per-aggregate event streams), with a two-lane
structural mode and live SSE refresh.

## Build & test

```bash
cargo build
cargo t                                          # full suite (alias: test --no-fail-fast)
cargo clippy -- -D warnings -D clippy::unwrap_used
```

See [CLAUDE.md](CLAUDE.md) for the architecture and contributor workflow, and
[docs/product-framework-open.md](docs/product-framework-open.md) for the spec.

## License

See [`LICENSE`](LICENSE).

## Source & license

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

- **Author:** [Hafeok](https://github.com/Hafeok)
- **Source:** [Hafeok/product-cli](https://github.com/Hafeok/product-cli)
- **License:** MIT

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

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.4 — 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.4** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-hafeok-product-cli
- Seller: https://agentstack.voostack.com/s/hafeok
- 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%.