# Claude Night Market [![Version](https://img.shields.io/badge/version-1.9.21-blue)](CHANGELOG.md) [![License: MIT](https://img.shields.io/badge/license-MIT-green)](LICENSE) [![Plugins](https://img.shields.io/badge/plugins-23-orange)](book/src/plugins/) [![Skills](https://img.shields.io/badge/skills-206-teal)](book/src/reference/capabilities-reference.md) [![Claude Code](https://img.shields.io/badge/Claude_Code-2.1.16%2B-purple)](https://code.claude.com/docs/en/overview) **A plugin marketplace for Claude Code.** Install only the plugins you need to run git workflows, code review, spec-driven development, and autonomous agents from inside your Claude Code session. *Written for a practitioner: someone who already uses Claude Code and wants to know what these plugins do and whether to install them. If you are new to Claude Code, start with the [official docs](https://code.claude.com/docs/en/overview). For the design rationale behind a plugin, see [the book](book/src/plugins/).*

Night Market skills in action

## Install Requires **Claude Code 2.1.16+** (2.1.32+ for agent teams, 2.1.38+ for security features) and **Python 3.9+** for hooks, which is what macOS ships. ```bash # Add the marketplace, then install the plugins you want /plugin marketplace add athola/claude-night-market /plugin install sanctum@claude-night-market # Git workflows /plugin install pensive@claude-night-market # Code review /plugin install spec-kit@claude-night-market # Spec-driven dev ``` Run `claude --init` once after installing. Two other paths exist: [`npx skills`][skills-cli] pulls the skill files alone into `.claude/skills/`, without commands, agents, or hooks, and `opkg i gh@athola/claude-night-market --plugins sanctum,pensive` installs whole plugins from the `openpackage.yml` each one ships. Full options are in the [Installation Guide](book/src/getting-started/installation.md). > If the `Skill` tool is unavailable, read skill files directly > at `plugins/{plugin}/skills/{skill-name}/SKILL.md`. ## Everyday Use Night Market is built around the loop you already work in. A typical feature runs end to end on a handful of commands: 1. **Start a feature.** `/attune:mission` routes you through brainstorm, specify, plan, and execute phases. 2. **Write the code.** `imbue` enforces a failing test before the implementation is written. 3. **Review before you push.** `/full-review` runs a multi-discipline pass; `/refine-code` cleans up duplication and dead code. 4. **Ship it.** `/prepare-pr` runs quality gates and drafts a description that says who the change is for, where it lands inside and outside the codebase, and when it is fully integrated. 5. **Pick up where you left off.** `/catchup` rebuilds context from recent git history after a break. The commands you reach for most: | Task | Command | |------|---------| | Run the project lifecycle | `/attune:mission` | | Initialize a new project | `/attune:arch-init` | | Review a PR | `/full-review` | | Address review feedback | `/fix-pr` | | Implement an issue | `/do-issue` | | Prepare a pull request | `/prepare-pr` | | Write a spec | `/speckit-specify` | | Catch up on changes | `/catchup` | | Package project knowledge as skills | `/attune:skill-library` | | Clean up the codebase | `/unbloat` | | Pressure-test a decision | `/attune:war-room` | Full task-by-task walkthroughs are in the [Common Workflows Guide][workflows]. ## What's Inside 23 plugins in four layers. Each installs independently, and dependencies pull their shared runtime automatically. **Foundation** is the base every other layer builds on: `leyline` (auth, quotas, error patterns, trust verification), `sanctum` (git, commits, PR prep, sessions), and `imbue` (TDD enforcement, proof-of-work, scope guarding). **Utility** handles cross-cutting concerns: `conserve` (context and token optimization), `conjure` (delegation to seven external model CLIs plus a local runner), `hookify` (a behavioral rules engine with a security catalog), `egregore` (autonomous agent orchestration), `herald` (notifications), and `oracle` (local ML inference). **Domain** is where the day-to-day work happens: `pensive` (code and architecture review), `attune` (project lifecycle), `spec-kit` (spec-driven development), `parseltongue` (Python), `minister` (GitHub issues and DORA metrics), `memory-palace` (knowledge organization), `archetypes` (architecture paradigms), `gauntlet` (codebase learning), `phantom` (computer use), `scribe` (documentation and slop detection), `scry` (recordings), `tome` (research), and `cartograph` (codebase visualization). **Meta** improves the system itself: `abstract` (skill authoring, hook development, evaluation, and skill-stability tracking). Plugin architecture across Foundation, Utility, Domain, and Meta layers The full skill, command, and agent inventory is in the [Capabilities Reference](book/src/reference/capabilities-reference.md). ## Safety > ⚠️ Plugins run inside your Claude Code session and can read or > edit your repo, run shell commands, and call external services. > **Review any plugin before installing it.** Three guards reduce the blast radius, but none replace your own review: - **TDD gates** (`imbue`) block implementation writes that lack a failing test. - **Destructive-command blockers** (`conserve`, `hookify`) auto-approve safe commands and halt or warn on `rm -rf`, `git push --force`, and production-shaped targets. - **Additive-bias audits** (`leyline`) flag unjustified additions before commit. [CONSTITUTION.md](CONSTITUTION.md) holds the immutable rules that override any conflicting skill or hook; [STEWARDSHIP.md](STEWARDSHIP.md) is the maintenance contract. ## Network and data Three parts of the marketplace reach off your machine, and each can be turned off. Two hooks use your own `gh` credentials: a once-per-session star prompt that only reads your star status (`CLAUDE_NIGHT_MARKET_NO_STAR_PROMPT=1` disables it), and a session-stop hook that posts a learnings discussion and may open issues (`auto_post_learnings: false` in `~/.claude/skills/discussions/config.json` disables it). The third, delegation through `conjure`, sends prompts and file contents to an external model CLI under the credentials you configured for it (`CONJURE_DELEGATION=off` for one run). What each sends, and every switch, is in [Network and Data](docs/deep-dive/network-and-data.md). ## Plugin Development ```bash make validate-all make lint && make test # checks only; rewrites nothing make fix # ruff format + ruff check --fix ``` A plugin directory holds `.claude-plugin/plugin.json` (metadata) plus any of `commands/`, `skills/`, `hooks/`, `agents/`, `workflows/`, and `tests/`, with a `Makefile` and `pyproject.toml`. A `workflows/` script orchestrates several subagents at once and runs only when you ask for one. Copy the layout from an existing plugin such as `plugins/abstract`, then see the [Plugin Development Guide][dev-guide] for structure and naming conventions. Working on this repo needs **Python 3.12+** and **GNU make 3.82+**. The guide covers both, including why Xcode's make 3.81 reports a green build it did not run. ## Documentation - [Installation Guide](book/src/getting-started/installation.md) - [Quick Start](book/src/getting-started/quick-start.md) - [Common Workflows][workflows] - [Plugin Development Guide][dev-guide] - [Capabilities Reference](book/src/reference/capabilities-reference.md) - [Tutorials](book/src/tutorials/README.md) - [Network and Data](docs/deep-dive/network-and-data.md) - [Architecture Decision Records](docs/adr/) - [CHANGELOG](CHANGELOG.md) Per-plugin pages are in `book/src/plugins/`. ## Stewardship and Contributing Every plugin is entrusted to the community: steward rather than own, and think several iterations ahead. Each plugin maintains its own tests and docs; run `make test` at the repo root to execute every suite, and `/stewardship-health` to view per-plugin health. Contribution guidelines are in the [Plugin Development Guide][dev-guide]. ## Acknowledgements Night Market builds on [Anthropic Claude Code][claude-code] and integrates with [github/spec-kit][spec-kit-upstream] (v0.5.0) and [obra/superpowers][superpowers-upstream] (v5.0.7, see the [integration guide][superpowers-doc]). Its AI involvement is declared under the [Quillx][quillx] disclosure standard as 3/5 (Adapted): human-directed, AI-generated, and meaningfully edited. ## License [MIT](LICENSE) [claude-code]: https://docs.anthropic.com/en/docs/build-with-claude/claude-code [dev-guide]: docs/plugin-development-guide.md [workflows]: book/src/getting-started/common-workflows.md [spec-kit-upstream]: https://github.com/github/spec-kit [superpowers-upstream]: https://github.com/obra/superpowers [superpowers-doc]: book/src/reference/superpowers-integration.md [quillx]: https://github.com/QAInsights/Quillx [skills-cli]: https://github.com/vercel-labs/skills