{
  "markdown": "# Spec-First + Superpowers v5\n\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n[![Cursor Compatible](https://img.shields.io/badge/Cursor-Compatible-brightgreen)](https://cursor.sh)\n[![Default: OpenSpec](https://img.shields.io/badge/Default-OpenSpec_OPSX-blue)](https://github.com/Fission-AI/OpenSpec)\n\nA Cursor Agent Skill that enforces spec-before-code workflow. Prevents the AI from skipping design and jumping straight to implementation.\n\n## Install\n\n```bash\nnpx skills add zxzvsdcj/spec-first-superpowers\n```\n\nNon-interactive install (for scripts/CI):\n\n```bash\nnpx skills add zxzvsdcj/spec-first-superpowers --skill spec-first-superpowers --agent cursor --global --yes\n```\n\nVerify installation:\n\n```bash\nnpx skills ls -g -a cursor\n```\n\n> Install command follows the [vercel-labs/skills](https://github.com/vercel-labs/skills) convention.\n\n## Dependency Skills\n\nThese should be installed via Cursor Skills marketplace or `npx skills add`:\n\n- `using-superpowers` + sub-skills (brainstorming, writing-plans, TDD, code-review, etc.)\n- `planning-with-files`\n- `ui-ux-pro-max` (recommended, v2.5.0)\n- `finishing-a-development-branch`\n\nOptional external tools:\n\n- **MemPalace** (`pip install mempalace`) — cross-session memory + knowledge graph\n\nHelper scripts for external CLI tools:\n\n```bash\n# Linux / macOS\nchmod +x install-all.sh && ./install-all.sh\n```\n\n```powershell\n# Windows PowerShell\n.\\install-all.ps1\n```\n\n## Usage\n\nIn any Cursor chat:\n\n```\n/super-spec\n```\n\n| Command | Effect |\n|---------|--------|\n| `/super-spec` | Full workflow (auto mode + auto complexity) |\n| `/super-spec force-spec-kit` | Force Spec-Kit mode |\n| `/super-spec force-openspec` | Force OpenSpec mode |\n| `/super-spec reset` | Reset mode selection |\n| `/super-spec upgrade` | Check all integrated projects for updates and execute upgrade |\n\n## How It Works\n\n```\n/super-spec → Mode Selection → Complexity Triage → Session Recovery (auto + MemPalace)\n    → Specification (G1, with inline spec review)\n    → Persistent Planning (G2, with inline plan review + file structure mapping)\n    → UI/UX Design (G3, conditional, v2.5.0 intelligent design system)\n    → TDD Implementation (G4, with model selection + implementer status)\n    → Archive (+ MemPalace persistence)\n```\n\n## What's in v5\n\n- **Inline self-review**: Replaced subagent review loops with fast inline checklists (~30s vs ~25min, comparable quality, from Superpowers v5.0.6)\n- **MemPalace integration**: Cross-session memory with 96.6% R@5 retrieval, knowledge graph for decision tracking, agent diary for workflow audit\n- **Spec-Kit Workflow Engine**: Custom workflow registration and discovery via Catalog system (v0.7.0+)\n- **OpenSpec `/opsx:refine`**: Targeted artifact review and refinement (custom profile)\n- **OpenSpec profile rename**: \"expanded\" → \"custom\" (v1.2.0)\n- **ui-ux-pro-max v2.5.0**: +6 specialist skills (banner-design, slides, ui-styling, design-system, design, brand), Three.js stack, 1923 Google Fonts DB\n- **Updated all version references**: Spec-Kit v0.7.1, OpenSpec v1.2.0, Superpowers v5.0.7, planning-with-files v2.30.0\n\n### Carried from v4\n\n- Complexity triage (quick/standard/thorough)\n- Session recovery with 5-Question Reboot Test\n- Quality gates G0-G4 with constitution verification\n- Two-stage review (spec conformance + code quality)\n- Subagent-driven execution with zero context pollution\n- Error escalation: 3-Strike Protocol + systematic-debugging\n- Design persistence: `--persist` for cross-session reuse\n- File structure mapping before task decomposition\n- Model selection for subagent execution (fast → standard → capable)\n- Implementer status handling (DONE/DONE_WITH_CONCERNS/NEEDS_CONTEXT/BLOCKED)\n- Scope check for early decomposition detection\n- 6 synergy chains (updated with MemPalace chain)\n\n## Project Structure\n\n```\nspec-first-superpowers/\n├── skills/\n│   └── spec-first-superpowers/             # ← npx skills add installs only this\n│       ├── SKILL.md                        # Core orchestration logic (v5)\n│       ├── references/\n│       │   ├── spec-kit-workflow.md\n│       │   ├── openspec-workflow.md\n│       │   ├── integration-guide.md\n│       │   ├── quality-gates.md\n│       │   ├── synergy-patterns.md\n│       │   ├── mempalace-integration.md    # NEW in v5\n│       │   └── upgrade-protocol.md        # NEW in v5 — /super-spec upgrade\n│       └── assets/\n│           └── constitutions/\n│               ├── openspec-constitution.md\n│               └── spec-kit-constitution.md\n├── .cursor/\n│   └── 00-spec-first-superpowers.mdc       # Always-on gatekeeper rule\n├── test_skill.py                           # Validation script\n├── install-all.sh / install-all.ps1        # Helper install scripts\n└── README.md\n```\n\n> `npx skills add` discovers the `skills/` subdirectory and installs only its contents. Dev files in the repo root are not included.\n\n## Integrated Projects\n\n| Project | GitHub | Version | Role |\n|---------|--------|---------|------|\n| Spec-Kit | [github/spec-kit](https://github.com/github/spec-kit) | v0.7.1 | GitHub's spec-driven framework (uv tool install) |\n| OpenSpec | [Fission-AI/OpenSpec](https://github.com/Fission-AI/OpenSpec) | v1.2.0 | Lightweight OPSX workflow (default, npm) |\n| Superpowers | [obra/superpowers](https://github.com/obra/superpowers) | v5.0.7 | TDD + inline review + subagent methodology |\n| planning-with-files | [OthmanAdi/planning-with-files](https://github.com/OthmanAdi/planning-with-files) | v2.30.0 | File-based persistent planning |\n| ui-ux-pro-max | [nextlevelbuilder/ui-ux-pro-max-skill](https://github.com/nextlevelbuilder/ui-ux-pro-max-skill) | v2.5.0 | UI/UX design system |\n| MemPalace | [MemPalace/mempalace](https://github.com/MemPalace/mempalace) | v3.3.0 | Cross-session memory + knowledge graph (optional) |\n\n---\n\nHades @Hades96444367 · Singapore · 2026\n",
  "bytes": 5876,
  "sha": "2def9262c44fd3f82746b19f46f2bc0d5ea0c1cda5eac6eca7bc9998bb5aee73",
  "repo_slug": "zxzvsdcj/spec-first-superpowers",
  "fonte": "repo",
  "truncated": false,
  "api": "https://api.agentalog.com/api/listings/skl_zxzvsdcj_spec_first_superpowers_spec_fir_45e8e6f6/readme"
}