Night Market Architecture Contract

Documents the load-bearing design decisions, enforced invariants, and known weak points of the claude-night-market repo for judging design changes.

Dev & CodingAdvanced★ 329⑂ 33AI score 7/10Last updated: Aug 16, 2026

What it does

This skill is the architecture contract for the claude-night-market repo.

Six load-bearing decisions: plugins must be self-contained deployables (no root shared library), hooks must be Python 3.9 compatible under the host interpreter, marketplace.json is the single version source of truth, skill descriptions are capped at 160 chars, collective memory lives in GitHub Discussions, and every skill fits one of three roles.
Invariants table: what enforces each invariant (CI workflows, ratchet scripts, guard tests) and exactly what breaks if it is weakened.
Five known weak points: silent skill-discovery overflow, unpinned mdbook in the deploy workflow, per-feature-cycle overwriting of planning docs, per-plugin mypy/pytest constraints, and an under-orchestrated quality-gate federation.
A 17-row ADR digest plus a re-verification command block for volatile facts.

Every claim cites an ADR, a commit hash, or a checked-in enforcement file, so it can be verified rather than trusted.

Who it's for

Contributors to (or operators of a fork of) claude-night-market
Maintainers of multi-plugin monorepos who want a written rule for where DRY stops and duplication starts
Anyone studying real failure modes in the Claude Code hook/skill ecosystem

Examples

Proposing to extract a duplicated utility into a shared root module → the skill cites ADR-0001 and the reverted commits 054e2679/29961cd2 to explain why consolidation is rejected.
Adding a new Stop hook → walks the five hook rules: read the JSON payload from stdin, no relative paths, safe imports under a bare interpreter, subprocess timeout below the hooks.json budget.
Bumping to 1.9.16 → directs you to update_versions.py instead of hand-editing, and lists every manifest that must stay in sync.

· · · Install guide · · ·

Try it now, no install

Paste this into Claude to use the skill without installing anything.

Read the instructions in this file and follow them to help me:
https://raw.githubusercontent.com/athola/claude-night-market/HEAD/.claude/skills/night-market-architecture-contract/SKILL.md

What I want: (describe your task here)

If Claude can't open the link, open it yourself and paste the contents instead.

↓ If it works for you, download the ZIP below and install it. Then it runs on its own — no pasting each time.

Install in the Claude app (no terminal)

Download the ZIP with the button below.
In Claude, open Settings → Capabilities and turn on 'Code execution and file creation'. (one time)
Go to Customize → Skills → + → 'Upload a skill' and upload the ZIP.

↓ Download ZIP

Install in Claude Code

Let Claude do it — paste this into Claude Code

Install the skill I found on Claude Skill Mart.
Copy the .claude/skills/night-market-architecture-contract folder from the GitHub repo athola/claude-night-market into my ~/.claude/skills/night-market-architecture-contract/.
When it's done, tell me in one line what this skill can do.

Install with a command instead

git clone https://github.com/athola/claude-night-market.git && mkdir -p ~/.claude/skills && cp -r claude-night-market/.claude/skills/night-market-architecture-contract ~/.claude/skills/

⚠ This is a third-party skill. Check the source repository before installing.

Open a terminal.
Clone the repo: git clone https://github.com/athola/claude-night-market.git
Create the skills directory: mkdir -p ~/.claude/skills
Copy the skill: cp -r claude-night-market/.claude/skills/night-market-architecture-contract ~/.claude/skills/
Restart Claude Code and ask something like "check the architecture contract before I change this plugin" to confirm it loads.
Note: the ADRs, scripts, and tests it cites exist only inside the claude-night-market repo, so run Claude Code from that checkout if you want the verification commands to work.

View source on GitHub ↗License: MIT