Agentic Support Workflow

A Claude Code plugin that bundles the spec-driven development workflow skills used across Open Elements projects. These skills drive multi-step processes a developer runs deliberately — planning a feature, implementing it through a proper GitHub flow, reviewing it, documenting a release, or auditing a whole project.

This plugin is a focused extract of the workflow skills from claude-base; install it when you want the workflows without the full base configuration.

Installation

Install from inside Claude Code:

/plugin marketplace add OpenElementsLabs/agentic-support-workflow
/plugin install agentic-support-workflow@open-elements

Skills are namespaced under the plugin, e.g. /agentic-support-workflow:spec-create.

The big picture

The workflows are built around spec-driven development: non-trivial work is planned as a specification before it is implemented, and the plan, the decisions, and the divergences are all kept as durable Markdown files under docs/ — so the reasoning behind the code survives, and both humans and Claude can pick up where the last session left off.

        ┌─────────────┐
idea →  │  /vision    │  product discovery → docs/vision.md
        └──────┬──────┘
               │  pick a feature
               ▼
        ┌──────────────────┐
        │ /proposal-create │  non-technical stakeholder defines a feature in
        └──────┬───────────┘  plain language → docs/proposals/<id>.md
               │  engineer picks it up
               ▼
        ┌─────────────┐     ┌──────────────┐
        │ /spec-create│ ──► │  /adr-create │  (for architecturally
        └──────┬──────┘     └──────────────┘   significant decisions)
               │  design.md + behaviors.md
               ▼
        ┌───────────────┐
        │/spec-implement│  → steps.md (ordered task plan)
        └──────┬────────┘
               ▼
        ┌───────────────────────────────────────────────┐
        │                  /spec-flow                     │  end-to-end orchestration:
        │   issue → branch → implement → review → PR      │  ties the steps together
        └───────────────────────────────────────────────┘

Skills

Skill	What it does
/vision	Product discovery — turns an idea into docs/vision.md.
/proposal-create	Non-technical stakeholders define a feature in plain language → docs/proposals/<id>.md, ready for an engineer to turn into a spec.
/spec-create	Plans a feature or bug fix into a design.md + behaviors.md spec through interactive discussion (optionally from a proposal).
/adr-create	Captures an architecturally significant decision as an Architecture Decision Record.
/spec-implement	Turns a spec into an ordered task plan (steps.md).
/spec-flow	End-to-end orchestration: issue → branch → implement → review → PR.
/spec-review	Reviews an implementation against its spec.
/roadmap-execute	Executes a roadmap of specs, implementing them in sequence.
/quality-review	Reviews a changeset against the applicable coding conventions.
/project-analyze	Analyzes a project's structure, stack, and health.
/project-quality-audit	Audits a whole project for release readiness against quality thresholds.
/reproducible-builds-check	Checks a build for reproducibility.
/release-doc	Generates release notes / upgrade documentation.
/todo-capture	Captures TODOs and follow-ups into durable tracking.
/grill-me	Relentless Socratic interview that stress-tests a plan, spec, or design.

Trigger a workflow by typing its slash command (namespaced, e.g. /agentic-support-workflow:spec-create) or by describing the task in natural language — Claude matches your request to the right skill.

Dependencies and setup

• Several workflows use the GitHub CLI (gh) for issues, branches, and pull requests — install and authenticate it (gh auth login).
• quality-review and project-quality-audit read the coding-quality and security conventions bundled under conventions/.

Repository structure

• .claude-plugin/plugin.json — plugin manifest
• .claude-plugin/marketplace.json — marketplace catalog (lists this plugin, source: "./")
• skills/ — the workflow skills (skills/<name>/SKILL.md), plus the shared _workflow-shared/ helper
• conventions/ — convention documents referenced by the quality skills

Releasing

Bump version in both .claude-plugin/plugin.json and the agentic-support-workflow entry in .claude-plugin/marketplace.json, update CHANGELOG.md, tag the release, and validate with:

claude plugin validate ./ --strict

Users only receive an update when the version is bumped.

License

Apache-2.0. See LICENSE.