melchimaelran
UserPragmatic, Agent-Controlled, Terminal-based — a spec-driven software-engineering methodology for Claude Code: spec → plan → build → ship.
Categories
Indexed Skills (17)
build
Implement stories from tasks/ with TDD — one inline, several at once in dependency-ordered parallel waves, or a whole epic. Also runs a bug-status story handed off by `pact fix` (bug-fix mode).
fix
Bug flow. Diagnose a bug in an isolated context, write a failing reproduction test and a Fix Plan into a spec — never the source fix itself — then route to build (auto for an easy fix, hand-off for a complex one).
ship
Deliver the active spec — commit, push, open the PR, link issues, wait for CI, merge. --abandon returns a spec to planned. --to-issues publishes a plan to GitHub Issues.
spec
Write or revise the spec for one piece of work — the mandatory front door. Typed (feat | fix | adjust | refactor | perf | chore | docs). The agent drafts; the user steers the real decisions. Produces docs/specs/<date>_<slug>/spec.md.
release
Cut a PACT plugin release from this repository — bump the version in plugin.json and marketplace.json, roll the CHANGELOG, commit, tag, push, and create the GitHub Release. Use when the maintainer asks to "release", "cut a release", "publish a new version", or "tag vX.Y.Z". Repo-local maintainer tool, not a /pact:* command.
config
Conversational editor for PACT settings — .pact/config.toml, stack.toml, the constitution; plus `statusline install` and `project expand`. The user never hand-edits a config file.
init
Set up PACT in a project — a conversational questionnaire, then the .pact/ scaffold. Detects a new vs existing project automatically; force with --new, --adopt, or --reconfig.
plan
Turn a ready spec into epics and stories under tasks/. Epics are vertical slices of user-visible capability in demo-first order; stories are one vertical behavior each. two-pass (validate epics, then stories) or one-pass.
review
Feature-level audit of the active spec before shipping — spec-AC coverage, consistency vs plan/constitution/DRs/project.md, and a whole-diff code review. Runs only when steps.review is on. --project audits the whole codebase for architectural drift.
security
On-demand defensive security audit of this repository and its local dev instance. Turns findings into type:fix spec stubs. Never auto-runs, never auto-fixes, never touches third-party systems.
team
Optional. Derive project-tailored expert and language-guide skills from the stack, the constitution, and the code, into .claude/skills/. Only when steps.team is on. --regenerate refreshes them merge-safe.
adr
Create a Decision Record by hand. The agent drafts Context / Decision / Alternatives / Consequences from the conversation and the repo; the user confirms; the file is written and the index regenerated.
check
Project health report — schema, frontmatter, index drift, unresolvable blocked_by, orphan spec branches, the managed .gitignore block, uncommitted .pact. Names the fix for each finding. Read-only.
design
Optional. Turn a spec into feature-scoped architecture docs under docs/architecture/ (global docs + one self-contained doc per feature). Only when steps.design_docs is on. Also `sync` and `optimize` maintenance modes.
migrate
Upgrade the project's .pact/ layout to the schema this plugin build supports. One-shot, idempotent, refuses a dirty tree, lands one revertable commit.
help
The PACT command map — what every /pact:* command does, grouped by where it sits in the spec -> plan -> build -> ship flow. Script-rendered, zero model tokens. Pass a command name for that command's syntax and full description.
status
Read-only project dashboard — specs, the active spec's stories, live worktrees. Rendered by a script, zero model tokens. --write dumps a tasks/ROADMAP.md snapshot.
Bio shown is the top-scored skill's repo description as a fallback — real GitHub bios land in a future update.