By pmco23
OpenSpec development toolkit: AST structural search, GitHub code search, quality gates, TDD scaffolding, and workflow guardrails.
npx claudepluginhub pmco23/claude-code-openspec-toolkitFind all definitions, calls, and imports of a symbol
Language-scoped AST search
Find all sites matching a refactoring target pattern
Structural AST search with ast-grep pattern
Commit with a message generated from OpenSpec change context
Find real-world usage examples on GitHub
Find real-world solutions to an error or problem on GitHub
Find how a specific code pattern is used across GitHub projects
Interactive config.yaml generator — interviews you + reads your codebase to seed openspec/config.yaml
Generate missing project docs (README.md, CHANGELOG.md, CONTRIBUTING.md) from codebase context
Create a PR with title and body generated from OpenSpec spec artifacts
Update changelog, bump version, commit, push, and optionally create a PR or GitHub release
Run parallel review agents on the current OpenSpec change or git diff
Scaffold tests for the current OpenSpec change
Post-archive cleanup — checkout main, pull, delete merged branch, prune remotes
Use this agent for the post-apply quality gate — spec compliance check, security scan, and code quality audit with a go/no-go verdict. Invoke after /opsx:apply and before archiving, when asked to "review and prepare to archive", or as a final quality gate. This agent is read-only and cannot modify files. Replaces inline post-apply logic in /review to keep the main context clean.
Use this agent to audit error handling for silent failures, broad catches, swallowed errors, and inappropriate fallbacks. Invoke during post-apply review, before archiving an OpenSpec change, or when reviewing code that modifies error handling, catch blocks, or fallback logic. This agent is read-only and cannot modify files.
Use this agent to review test coverage quality and completeness. Invoke after /scaffold generates test stubs and they've been implemented, during post-apply review, or before archiving an OpenSpec change. Complements /scaffold — it creates the tests, this agent reviews whether they're actually good. This agent is read-only and cannot modify files.
Opinionated Claude Code plugin for spec-driven development with OpenSpec. Adds AST structural search, GitHub code search, quality gates, TDD scaffolding, and workflow guardrails.
claude plugin marketplace add pmco23/claude-code-openspec-toolkit
claude plugin install openspec-toolkit@openspec-toolkit
git clone https://github.com/pmco23/claude-code-openspec-toolkit.git
claude plugin install ./claude-code-openspec-toolkit/plugins/openspec-toolkit
See INSTALL.md for prerequisites and verification steps.
| Server | Purpose | Transport |
|---|---|---|
gh_grep | Search public GitHub code | HTTP remote |
ast-grep | Structural AST search | Docker stdio |
| Command | Description |
|---|---|
/init-config | Interactive config.yaml generator — interviews you + reads codebase to seed openspec/config.yaml |
/init-docs [readme|changelog|contributing|all] | Generate missing project docs from codebase context |
/scaffold | Scaffold tests for the current OpenSpec change with auto-detected framework and conventions |
| Command | Description |
|---|---|
/commit | Commit with message generated from OpenSpec change context (reads tasks.md + diff) |
/pr | Create PR with title/body from spec artifacts (proposal.md + tasks.md checklist) |
/release [patch|minor|major] [--pr] [--release] | Update changelog, bump version, push. Optionally create PR or GitHub release |
/sync | Post-archive cleanup: checkout main, pull, delete merged openspec branches, prune remotes |
| Command | Description |
|---|---|
/ast <pattern> | Structural AST search with ast-grep pattern |
/ast-find <symbol> | Find all definitions, calls, and imports of a symbol |
/ast-lang <lang> <pattern> | Language-scoped AST search |
/ast-refactor <pattern> | Find all sites matching a refactoring target |
| Command | Description |
|---|---|
/gh-examples <query> | Find real-world usage examples on GitHub |
/gh-pattern <pattern> | Find how a pattern is used across GitHub projects |
/gh-fix <error> | Find real-world solutions to an error |
| Command | Description |
|---|---|
/review [change] [aspects] | Run parallel review agents on current change or git diff |
| Skill | Description | When to use |
|---|---|---|
post-apply | Combined quality gate: spec compliance + security + code quality → go/no-go | After /opsx:apply, before archiving |
Load the post-apply skill and review the add-dark-mode change
| Agent | Purpose |
|---|---|
quality-gate | Spec compliance + security scan + code quality → go/no-go verdict (read-only) |
silent-failure-hunter | Deep error handling audit: catch specificity, swallowed errors, fallback masking (read-only) |
test-quality-reviewer | Test coverage quality: behavioral coverage, critical gaps, test anti-patterns (read-only) |
| Hook | Event | Purpose |
|---|---|---|
pre-apply-guard | PreToolUse | Warns if /opsx:apply runs without config.yaml or with vague acceptance criteria |
pre-archive-guard | PreToolUse | Warns if archiving without running a quality review first |
post-review-nudge | Stop | After a GO verdict, suggests the shipping sequence: archive → commit → pr |
session-context | SessionStart | Auto-detects active OpenSpec change and injects context into the session |
auto-format | PostToolUse | Auto-formats edited files using the project's formatter (Prettier, Black, gofmt, rustfmt) |
auto-test | PostToolUse | Runs related tests after editing source files for immediate TDD feedback |
See CLAUDE.md for workflow rules loaded into every session.
openspec init then /init-config to generate config.yaml/opsx:propose/scaffold/opsx:apply (with TDD — make scaffolded tests pass)/review for comprehensive audit, or load post-apply for go/no-go verdict/opsx:archive/commit → /pr → /release --release → /syncMIT
Context-Driven Development: draft specs and plans before implementation. Structured workflows for features and fixes.
Executes bash commands
Hook triggers when Bash tool is used
Modifies files
Hook triggers on file write and edit operations
External network access
Connects to servers outside your machine
Share bugs, ideas, or general feedback.
GitHub Spec-Kit integration for Specification-Driven Development - define WHAT and HOW before coding
SDLC enforcement for AI agents — TDD, planning, self-review, CI shepherd
Persona-driven AI development team: orchestrator, team agents, review agents, skills, slash commands, and advisory hooks for Claude Code
GitHub specification integration and verification
Skills-first specification-driven development framework with 7 agent skills for planning, implementation, review, and shipping. Natural language activation with intelligent agent orchestration. Includes /plan, /implement, /research commands plus managing-specifications, implementing-features, and reviewing-and-shipping skills.
Runs pre-commands
Contains inline bash commands via ! syntax
Runs pre-commands
Contains inline bash commands via ! syntax
Share bugs, ideas, or general feedback.