Shape Up SDLC harness for Claude Code: shaping, intake, orient, scope-mapping, building, evaluation and QA skills orchestrated by a tech-lead.
Use this skill whenever a user provides a product requirement, pitch, or feature description and wants it broken down into structured, executable development tasks. Triggers on: "analyze this pitch", "break this into tasks", "generate tasks from requirement", "act as BA", "create spec from PRD", "turn this into dev tasks", or any request to decompose a feature into DDD-structured documents and implementation tasks for Claude Code CLI execution. Also triggers when user mentions Shape Up, bounded context, domain model, or use cases. Output is a linked document tree (pitch → domain model → use cases → tasks). Emits BDD scenarios + integration flow in task AC, a UC System Flow tracing UI→API→UC→DB, a derived UC Test Surface, and per-phase gates (summary + max 2 questions, never assumes).
Use this skill for Shape Up step 7 (Orient) — the builder-led reconnaissance pass that runs AFTER kick-off and BEFORE any task board exists. Triggers on: "orient on this feature", "scout the codebase for this pitch", "where does this pitch touch the code", "do an orient pass", "recon before we plan", "spike the riskiest part before mapping scopes". The tech-lead orchestrator invokes it at step 7 before delegating to ba-pitch-analyzer (Map Scopes, step 8). Use it even when the user describes "read the code first and surface the unknowns" without naming Orient. The Scout is a PURE worker: it reads code, spikes the single riskiest area, and emits four artifacts (code-surface map, spike findings, discovered-task seed, hill signal). It writes NO production code, builds NO scope board, keeps NO run-state, and renders NO progress report — those belong to ba (planner) and tech-lead (orchestrator) respectively.
Use this skill for the post-PASS exploratory QA pass — Shape Up's "QA is for the edges", made explicit for the harness. Triggers on: "hunt edge cases", "QA pass on this feature", "exploratory test the running app", "edge hunt before ship", "run qa-edge-hunter", "the evaluator passed — what did it miss?". tech-lead invokes it after the run's FIRST PASS at GATE L3, before SHIP; it also runs standalone given a spec folder, a PASS EVAL report, and a running app. The Hunter is a PURE worker: it charters edges OUTSIDE what the evaluator probed (EVAL-*.md = negative-space input), hunts them on the running app through six fixed lenses; findings → discovery/ledger.md, always `~`. NO verdict, NO score, NO gate; never fixes code, never promotes its own findings, never blocks ship — triage is PO/TL's at SHIP S.0/GATE L4. NOT for checking AC (spec-evaluator), deriving test cases (ba), or fixing bugs (task-executor).
Use this skill for any Shape Up workflow before writing code. Triggers on: "shape this feature", "frame this problem", "breadboard this", "map affordances", "write a framing doc", "write a kickoff doc", "turn this transcript into a framing document", "turn this transcript into a kickoff document", "what should we build", "explore solutions", "is this shaped enough to build", "slice this into scopes", "fit check", "wiring diagram". Also triggers when user says "before we build...", "I want to think through...", "let's shape this", or provides a raw transcript and wants it structured. DEFAULT: if no sub-command given, run /shapeup full — ask clarifying questions at each gate, keep solutions as simple as possible, never touch parts that already work. Sub-commands: /shapeup full | /shapeup shaping | /shapeup spike | /shapeup breadboarding | /shapeup framing-doc | /shapeup kickoff-doc | /shapeup breadboard-reflection
Use this skill whenever the user wants to evaluate, QA, or verify that an implemented task actually matches its spec and acceptance criteria — the judge in a planner→generator→evaluator harness, pairing with task-executor. Trigger on: "evaluate task TASK-NNN", "QA TASK-NNN", "verify against spec", "check acceptance criteria", "does this match the spec", "grade this build", "run evaluator", "verify TDD", "run integration tests", "check test coverage". Use it even when the user just points at a built task plus a spec folder and asks if it is correct. Three always-on dimensions: spec-conformance (AC + Done-when + contract shapes + non-go), tdd-surface (test suite green + companion test files), and integration (full-stack integration test + auth boundary + RLS-JWT pattern). Security and performance ship as disabled, injectable stubs. Skeptical by default — absence of evidence is a FAIL, probes the running app and test suite, files file:line bugs, never marks a task done.
Own this plugin?
Verify ownership to unlock analytics, metadata editing, and a verified badge. GitHub access is read-only (username + org membership).
Sign in to claimOwn this plugin?
Verify ownership to unlock analytics, metadata editing, and a verified badge. GitHub access is read-only (username + org membership).
Sign in to claimBased on adoption, maintenance, documentation, and repository signals. Not a security audit or endorsement.
A Claude Code plugin that turns a raw idea into shipped
code through an opinionated Shape Up software-development lifecycle. It packages
a planner → generator → judge skill harness — shaping, intake, orient, scope
mapping, vertical building, evaluation, and exploratory QA — orchestrated end-to-end
by a thin tech-lead.
This repository is both the plugin and its marketplace, so colleagues install it directly from GitHub.
Attribution. The
shapeupskill (shaping, breadboarding, spike, framing/kickoff docs) is inspired by and reuses material from rjs/shaping-skills. See Credits.
In any Claude Code session:
/plugin marketplace add nguyenvanphituoc/shapeup-sdlc-plugin
/plugin install shapeup-sdlc-plugin@nvptuoc-marketplace
Pin to a released version:
/plugin marketplace add nguyenvanphituoc/[email protected]
This plugin depends on the official Playwright plugin
(playwright@claude-plugins-official) — the QA and evaluation skills drive the running
app to verify [ui] criteria. On a normal /plugin install, Claude Code resolves the
dependency automatically (adding the claude-plugins-official marketplace if needed).
The evaluation/QA skills drive the browser through the Playwright CLI by default (token-efficient), so the dependency also expects a browser binary to be present:
npx playwright install chromium
Troubleshooting — Dependency "playwright@claude-plugins-official" is not installed.
This means the Playwright plugin is missing or installed-but-disabled. Install and/or
enable it, then reload:
claude plugin install playwright@claude-plugins-official # if missing
claude plugin enable playwright@claude-plugins-official # if disabled
In a session, /reload-plugins picks up the change. Note: the dependency gate is also
checked when loading a working copy with claude --plugin-dir ., so enable Playwright
before dev-loading this plugin.
Commit this to a project's .claude/settings.json so everyone who opens the repo gets
the plugin enabled automatically:
{
"extraKnownMarketplaces": {
"nvptuoc-marketplace": {
"source": { "source": "github", "repo": "nguyenvanphituoc/shapeup-sdlc-plugin" }
}
},
"enabledPlugins": {
"shapeup-sdlc-plugin@nvptuoc-marketplace": true
}
}
Instead of installing the plugin globally, you can scaffold the Shape Up SDLC harness directly into a target repository. This allows the AI skills, configurations, and evaluation fixtures to live as local files inside the project codebase, enabling local skill evolution and custom project tuning.
Run one of the following from the root of your target project:
Option A — Remote (curl, no clone needed):
curl -fsSL "https://raw.githubusercontent.com/nguyenvanphituoc/shapeup-sdlc-plugin/main/scripts/install-harness.sh" | bash -s -- --directory . --yes
Note —
--yesflag: When piped viacurl | bash, stdin is consumed by the pipe so the interactive prompt receives no input and cancels. Always pass--yes(or-y) with the remote one-liner. Omit it when running the script directly to get an explicit confirmation.
Option B — Local clone:
/path/to/shapeup-sdlc-plugin/scripts/install-harness.sh --directory .
Option C — Windows PowerShell (remote):
& ([scriptblock]::Create((irm "https://raw.githubusercontent.com/nguyenvanphituoc/shapeup-sdlc-plugin/main/scripts/install-harness.ps1"))) -Directory . -Yes
This installer automatically configures:
.claude/skills/ and appends/creates CLAUDE.md..agents/skills/, subagent configs to .agents/subagents/, and creates .agents/AGENTS.md..codex/skills/ and creates .codex/AGENTS.md..shapeup-sdlc/ ignore rule to .gitignore, initializes docs/shapeup-sdlc/metrics.jsonl, and creates a local docs/repair-memory.md memory log.The harness walks a pitch from idea to ship. The full annotated pipeline (gates,
discovered-task ledger, retrofit path) lives in docs/mechanism-roadmap.md;
a simplified view:
npx claudepluginhub nguyenvanphituoc/shapeup-sdlc-plugin --plugin shapeup-sdlc-pluginComplete collection of battle-tested Claude Code configs from an Anthropic hackathon winner - agents, skills, hooks, and rules evolved over 10+ months of intensive daily use
20 SEO/GEO skills and 5 commands on one shared contract for keyword research, content creation, technical audits, schema markup, monitoring, quality gates, entity truth, and campaign memory.
Modern R development skills for Claude Code - tidyverse patterns, rlang metaprogramming, Bayesian inference, performance optimization, and more
Comprehensive skill pack with 66 specialized skills for full-stack developers: 12 language experts (Python, TypeScript, Go, Rust, C++, Swift, Kotlin, C#, PHP, Java, SQL, JavaScript), 10 backend frameworks, 6 frontend/mobile, plus infrastructure, DevOps, security, and testing. Features progressive disclosure architecture for 50% faster loading.
Tools to maintain and improve CLAUDE.md files - audit quality, capture session learnings, and keep project memory current.
Unity Development Toolkit - Expert agents for scripting/refactoring/optimization, script templates, and Agent Skills for Unity C# development