diff --git a/.claude-plugin/marketplace.json b/.claude-plugin/marketplace.json index 5ad9949..fcf8cc0 100644 --- a/.claude-plugin/marketplace.json +++ b/.claude-plugin/marketplace.json @@ -9,14 +9,14 @@ }, "metadata": { "description": "Disciplined MCP server + skill system. Iron Laws, 1% Rule, rationalization tables, SessionStart hook injection.", - "version": "1.4.0" + "version": "1.5.0" }, "plugins": [ { "name": "hyperstack", "source": "./", - "description": "Disciplined MCP server + skill system. 12 plugins and 80 tools covering designer, shadcn/ui, design tokens, ui/ux, React Flow v12, Motion v12, Lenis, React 19, Echo, Go, Rust. 22 skills with adversarial enforcement.", - "version": "1.4.0", + "description": "Disciplined MCP server + skill system. 16 plugins and 121 tools covering designer, shadcn/ui, design tokens, ui/ux, React Flow v12, Motion v12, Lenis, React 19, Echo, Go, Rust, product-manager, marketing, reflect, optimizer. 29 skills with adversarial enforcement.", + "version": "1.5.0", "category": "productivity", "strict": true } diff --git a/.claude-plugin/plugin.json b/.claude-plugin/plugin.json index 3a227aa..0d29a0e 100644 --- a/.claude-plugin/plugin.json +++ b/.claude-plugin/plugin.json @@ -1,8 +1,8 @@ { "name": "hyperstack", "displayName": "Hyperstack", - "description": "Disciplined MCP server + skill system. 12 plugins and 80 tools covering designer (6 personalities, 13 page templates, 9 presets), shadcn/ui, design tokens, ui/ux, React Flow v12, Motion v12, Lenis, React 19, Echo, Go, and Rust. 22 skills with adversarial enforcement: Iron Laws, 1% Rule, rationalization tables, and SessionStart hook injection. Forces your agent to use real docs, real DESIGN.md contracts, and real verification before shipping.", - "version": "1.4.0", + "description": "Disciplined MCP server + skill system. 16 plugins and 121 tools covering designer (6 personalities, 13 page templates, 9 presets), shadcn/ui, design tokens, ui/ux, React Flow v12, Motion v12, Lenis, React 19, Echo, Go, Rust, product-manager, marketing, reflect, and optimizer. 29 skills with adversarial enforcement: Iron Laws, 1% Rule, rationalization tables, and SessionStart hook injection. Forces your agent to use real docs, real DESIGN.md contracts, and real verification before shipping.", + "version": "1.5.0", "author": { "name": "Orkait", "email": "orkaitsolutions@gmail.com" diff --git a/.cursor-plugin/plugin.json b/.cursor-plugin/plugin.json index ce204b1..e5ce9ea 100644 --- a/.cursor-plugin/plugin.json +++ b/.cursor-plugin/plugin.json @@ -2,7 +2,7 @@ "name": "hyperstack", "displayName": "Hyperstack", "description": "Senior Staff Engineer persona + domain knowledge MCP server for React Flow, Motion, Go, Rust, design tokens, and more", - "version": "1.4.0", + "version": "1.5.0", "author": { "name": "Orkait", "email": "orkaitsolutions@gmail.com" diff --git a/CHANGELOG.md b/CHANGELOG.md index 3483f9b..a83e4dc 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -2,6 +2,22 @@ All notable changes to Hyperstack are documented here. Format follows Keep a Changelog; versioning is SemVer. +## [1.5.0] - 2026-09-04 + +### Added +- **`react-pro-coder` skill**: 56 React and Next.js rules with stable IDs (`CD-3`, `ST-2`, `DF-5`) across component design, hooks, state placement, performance, data fetching (RSC, React 19 Actions, `use()`), TypeScript, styling and accessibility, architecture, testing, and production security. Gated on `react_get_constraints` so framework ground truth stays in the plugin. Ships a review checklist keyed to rule IDs, a 10-section output contract, and a negative-doubt routine. +- **`python-pro-coder` skill**: 60 FastAPI + Pydantic v2 + SQLAlchemy 2.0 rules (`PD-4`, `AS-2`, `SE-5`) across project structure, modelling, endpoint design, settings, dependency injection, async and performance, security, error handling, database access, testing, and observability. Gated on a version-verified stack file that names the dead dependencies and their replacements: `python-jose` (abandoned, CVE-2024-33664) to PyJWT or joserfc, `passlib` (breaks on Python 3.13+) to pwdlib, `@app.on_event` to `lifespan`, `AsyncClient(app=app)` to `ASGITransport`. +- **`best-practices` reference set**: four new files covering rules no skill held - coupling and abstraction (Law of Demeter, Command-Query Separation, flag arguments, rule of three, leaky abstractions, cargo cult), change hygiene (atomic commits, PR size, automate-before-human, review conduct, tracked debt), architecture at scale (modular monolith default, dependency direction, 12 factors, ADRs), and an operations baseline (structured logs, metrics vs logs, liveness vs readiness, graceful degradation, N+1). + +### Changed +- **`engineering-discipline` + `design-patterns-skill` merged into `best-practices`**: the two skills shipped byte-identical copies of the same six pattern reference files (2172 duplicated lines), and `design-patterns-skill` was a strict subset of the other's Quick Reference mode. The merged skill keeps the pattern-selection table and AI-bias guidance that only `design-patterns-skill` carried, and declares `supersedes: ["engineering-discipline", "design-patterns-skill"]`. Callers updated across 20 files. +- **`worktree-isolation`**: `wtg` reference refreshed to the current engine, with an expanded setup guide and multi-repo feature-group notes. +- Manifest counts reconciled against the live server: 16 plugins, 121 tools, 29 skills, 4 personas. README badges, install guide, summary, and CREDITS carried stale figures from several releases back. + +### Removed +- `skills/design-patterns-skill/` and `skills/engineering-discipline/` (both absorbed by `best-practices`). +- `references/misc/overview.md`: an orphaned Kiro-era install document that restated `SKILL.md` and described a directory layout that no longer exists. + ## [1.4.0] - 2026-07-18 ### Added diff --git a/CREDITS.md b/CREDITS.md index 1ab60b0..7845aab 100644 --- a/CREDITS.md +++ b/CREDITS.md @@ -10,7 +10,7 @@ Hyperstack's gate skill enforcement pattern - Iron Laws, 1% Rule, rationalizatio Five Hyperstack workflow skills (`ship-gate`, `debug-discipline`, `run-plan`, `deliver`, `forge-plan`) are structurally derived from their superpowers equivalents. They have since been extended with MCP integration, DESIGN.md pipeline hooks, and Hyperstack-specific domain content. -Everything else - the MCP server, 11 plugins, 79 tools, designer engine, DESIGN.md pipeline, React Flow / Motion / Lenis / Echo / Go / Rust / design tokens domain content, shadcn expert, and SessionStart hook - has no equivalent in superpowers and is original work. +Everything else - the MCP server, 16 plugins, 121 tools, designer engine, DESIGN.md pipeline, React Flow / Motion / Lenis / Echo / Go / Rust / design tokens domain content, shadcn expert, and SessionStart hook - has no equivalent in superpowers and is original work. --- diff --git a/README.md b/README.md index c059884..02b8d9d 100755 --- a/README.md +++ b/README.md @@ -12,8 +12,8 @@

- Plugins - Skills + Plugins + Skills Hook

@@ -25,7 +25,7 @@ **Hyperstack is a disciplined engineering harness for AI coding agents.** -It provides the necessary **Ground Truth** (via 80 specialized MCP tools) and **Adversarial Enforcement** (via 22 rigorous skills) to transform a generic LLM into a high-precision Senior Engineer. +It provides the necessary **Ground Truth** (via 121 specialized MCP tools) and **Adversarial Enforcement** (via 29 rigorous skills) to transform a generic LLM into a high-precision Senior Engineer. Unlike standard "polite" instructions, Hyperstack uses **Iron Laws** and a **SessionStart hook** to force agents to check real documentation, follow precise design specs, and provide binary verification before shipping. @@ -85,8 +85,8 @@ If you aren't using the Autopilot, follow the **Unified Bootstrap** to set up bo It is not just a library; it is a **disciplined harness** made of three tightly-coupled layers: 1. **The Harness**: Bootstraps the agent, routes internal specialist roles (`hyper`, `website-builder`), and enforces global development invariants. -2. **The MCP Ground Truth**: 12 TypeScript plugins (80 tools) that provide deterministic data. No hallucinated imports or invented component specs. -3. **The Adversarial Gates**: 22 skills with **"Enforcement Teeth"**. These aren't suggestions; they are Iron Laws supported by rationalization tables that counter every excuse an agent uses to skip quality gates. +2. **The MCP Ground Truth**: 16 TypeScript plugins (121 tools) that provide deterministic data. No hallucinated imports or invented component specs. +3. **The Adversarial Gates**: 29 skills with **"Enforcement Teeth"**. These aren't suggestions; they are Iron Laws supported by rationalization tables that counter every excuse an agent uses to skip quality gates. > [!IMPORTANT] > **Use Hyperstack if** you want to force your agent to check docs, write designs first, and prove its work. @@ -100,12 +100,12 @@ graph TD Harness --> Gates{Adversarial Gates} subgraph "The Enforcement Layer" - Gates -->|Iron Laws| Skills[21 Skills with Enforcement Teeth] + Gates -->|Iron Laws| Skills[29 Skills with Enforcement Teeth] Skills -->|SessionStart| Injection[Auto-Context Injection] end subgraph "The Knowledge Layer" - Skills -->|Ground Truth| MCP[12 MCP Plugins / 80 Tools] + Skills -->|Ground Truth| MCP[16 MCP Plugins / 121 Tools] MCP -->|Designer| Design[DESIGN.md Pipeline] MCP -->|Verified| Code[Programmatic Compliance Check] end @@ -221,7 +221,7 @@ Your AI calls these for deterministic data. Memory is not acceptable. Every plug | 📈 **Product & Growth** | `optimizer`, `product-manager`, `marketing`, `reflect` | DSA technique matching, Product risk gates (JTBD, RICE), Positioning & GTM, Target-customer screen/feature review | > [!TIP] -> **118 tools across 16 plugins**. Every tool is designed to provide the "Senior Engineer" answer, bypassing the "AI Slop" default. +> **121 tools across 16 plugins**. Every tool is designed to provide the "Senior Engineer" answer, bypassing the "AI Slop" default. ### Layer 2: Skills (Enforcement Teeth) @@ -303,7 +303,7 @@ Domain-expert lenses `hyper` auto-engages when their triggers match the request -Full index at `skills/INDEX.md`. Regenerate with `bash scripts/generate-skills-index.sh` after adding or editing any skill. +Full index at `skills/INDEX.md`. Regenerate with `bun scripts/generate-skills-index.ts` after adding or editing any skill. --- @@ -503,7 +503,7 @@ We welcome contributions that follow the **Disciplined Engineering** standard. ```bash # Regenerate the skills index after editing -bash scripts/generate-skills-index.sh +bun scripts/generate-skills-index.ts ``` ## 📄 License diff --git a/docs/benchmarks-spec.md b/docs/benchmarks-spec.md index 85f7bf2..c2d7fe7 100644 --- a/docs/benchmarks-spec.md +++ b/docs/benchmarks-spec.md @@ -13,7 +13,7 @@ This is the exact thing the quarterly audit proved by hand (Next 15->16 async pa | Goals | Non-goals (v1) | |---|---| | One claim, deterministic metric, multi-model | Measuring "code quality" broadly (fuzzy, needs a judge) | -| Reproducible single command, raw results stamped | Benchmarking all 12 plugins (start with high-drift ones) | +| Reproducible single command, raw results stamped | Benchmarking all 16 plugins (start with high-drift ones) | | A README number that replaces faith | A judge-model rubric (avoid fuzzy scoring in v1) | | Re-runnable each quarter alongside the audit | Proving the agent *will* call the tools (that is v2) | diff --git a/gemini-extension.json b/gemini-extension.json index b82767e..b8e4b3d 100644 --- a/gemini-extension.json +++ b/gemini-extension.json @@ -1,6 +1,6 @@ { "name": "hyperstack", - "description": "Disciplined MCP server + skill system. 12 plugins, 80 tools, 22 skills with adversarial enforcement. Designer/DESIGN.md pipeline, shadcn/ui, React Flow, Motion, Lenis, React 19, Echo, Go, Rust, design tokens, UI/UX.", - "version": "1.4.0", + "description": "Disciplined MCP server + skill system. 16 plugins, 121 tools, 29 skills with adversarial enforcement. Designer/DESIGN.md pipeline, shadcn/ui, React Flow, Motion, Lenis, React 19, Echo, Go, Rust, design tokens, UI/UX.", + "version": "1.5.0", "contextFileName": "GEMINI.md" } diff --git a/install.md b/install.md index 7a2489c..fe259f0 100644 --- a/install.md +++ b/install.md @@ -18,8 +18,8 @@ If you only remember four things, remember these: Three tightly-coupled pieces, installed together: 1. **An internal harness** - bootstrap, internal role routing, and workflow control. Current internal roles include `main` and `website-builder`. -2. **An MCP server** with 12 plugins and 80 tools - deterministic knowledge for React Flow v12, Motion v12, Lenis, React 19 / Next.js, Echo, Go, Rust, design tokens, UI/UX principles, shadcn/ui (Base UI edition), and the `designer` DESIGN.md pipeline. -3. **A skill system** with 21 skills including adversarial enforcement gates (`blueprint`, `designer`, `forge-plan`, `ship-gate`, `best-practices`) and a SessionStart hook that face-injects the `hyperstack` skill at every session start. +2. **An MCP server** with 16 plugins and 121 tools - deterministic knowledge for React Flow v12, Motion v12, Lenis, React 19 / Next.js, Echo, Go, Rust, design tokens, UI/UX principles, shadcn/ui (Base UI edition), product management, marketing, algorithmic optimization, and the `designer` DESIGN.md pipeline. +3. **A skill system** with 29 skills including adversarial enforcement gates (`blueprint`, `designer`, `forge-plan`, `ship-gate`, `best-practices`) and a SessionStart hook that face-injects the `hyperstack` skill at every session start. The install steps below wire the public pieces the user actually needs: the MCP server and the skills. The internal harness is shipped inside the repository and @@ -343,7 +343,7 @@ Once all verifications pass, your final action is to explain the new reality to > "System Synchronized. Hyperstack is now active. > -> I have installed the **Disciplined Engineering Harness** with 12 plugins and 80 tools. I have also established your **Iron Laws** (~/.hyperstack/skills). +> I have installed the **Disciplined Engineering Harness** with 16 plugins and 121 tools. I have also established your **Iron Laws** (~/.hyperstack/skills). > > From now on: > - I will not refactor code without a failing test. diff --git a/package-lock.json b/package-lock.json index 094744a..f88ef0b 100644 --- a/package-lock.json +++ b/package-lock.json @@ -1,12 +1,12 @@ { "name": "@orkait-ai/hyperstack", - "version": "1.4.0", + "version": "1.5.0", "lockfileVersion": 3, "requires": true, "packages": { "": { "name": "@orkait-ai/hyperstack", - "version": "1.4.0", + "version": "1.5.0", "license": "MIT", "dependencies": { "@modelcontextprotocol/sdk": "^1.17.0", diff --git a/package.json b/package.json index d87a51f..63270f7 100644 --- a/package.json +++ b/package.json @@ -1,7 +1,7 @@ { "name": "@orkait-ai/hyperstack", - "version": "1.4.0", - "description": "Disciplined MCP server + skill system. 16 plugins, 117 tools, 27 skills, 3 personas with adversarial enforcement. Personas (product-manager gate; marketing + reflect capabilities), Designer/DESIGN.md pipeline, shadcn/ui, React Flow, Motion, Lenis, React 19, Echo, Go, Rust, design tokens, UI/UX.", + "version": "1.5.0", + "description": "Disciplined MCP server + skill system. 16 plugins, 121 tools, 29 skills, 4 personas with adversarial enforcement. Personas (product-manager gate; marketing + reflect + bro capabilities), Designer/DESIGN.md pipeline, shadcn/ui, React Flow, Motion, Lenis, React 19, Echo, Go, Rust, design tokens, UI/UX.", "bin": { "hyperstack": "bin/hyperstack.mjs" }, diff --git a/summary.md b/summary.md index 5fd274e..4e7822e 100644 --- a/summary.md +++ b/summary.md @@ -67,8 +67,8 @@ Hyperstack uses internal roles to manage complexity. These roles are **internal - **`hyper` (Core):** The conductor. Owns request classification, routing, gate enforcement, final verification, and delivery. - **`website-builder` (Specialist):** Owns website-facing design/implementation, CTA hierarchy, and page structure. Delegates back to `hyper` for verification. -### 9. The Skill System (21 skills, 3 categories) -Every skill has a `category:` frontmatter field. The index at `skills/INDEX.md` is auto-generated from frontmatter by `bash scripts/generate-skills-index.sh`. +### 9. The Skill System (29 skills, 3 categories) +Every skill has a `category:` frontmatter field. The index at `skills/INDEX.md` is auto-generated from frontmatter by `bun scripts/generate-skills-index.ts`. - **Core (13):** blueprint, forge-plan, run-plan, best-practices, ship-gate, deliver, test-first, debug-discipline, code-review, autonomous-mode, subagent-ops, parallel-dispatch, worktree-isolation - **Domain (6):** designer, shadcn-expert, behaviour-analysis, security-review, readme-writer, python-pro-coder, react-pro-coder @@ -113,7 +113,7 @@ Every skill references its upstream and downstream edges explicitly. **Active development.** Main branch is stable and the Docker image publishes automatically on push. -Eleven plugins, seventy-nine tools, twenty-one skills, and two internal agents (`hyper` and `website-builder`). The SessionStart hook is wired. The adversarial enforcement is in place. The designer pipeline works end-to-end (verified via test harness). shadcn is integrated as an optional choice. +Sixteen plugins, one hundred twenty-one tools, twenty-nine skills, four personas, and two internal agents (`hyper` and `website-builder`). The SessionStart hook is wired. The adversarial enforcement is in place. The designer pipeline works end-to-end (verified via test harness). shadcn is integrated as an optional choice. ### Remaining work - More pressure-test scenarios for gate skills (forge-plan, best-practices, behaviour-analysis, test-first)