stellars-claude-code-plugins 0.8.74

Claude Code plugins for autonomous development workflows

stellars-claude-code-plugins

A plugin marketplace for Claude Code providing structured workflows for software development, document analysis, data science, and project management. Each plugin is pure configuration (skills, commands, YAML) - install one or all depending on your needs.

/plugin marketplace add stellarshenson/claude-code-plugins

The marketplace includes a shared YAML-driven orchestration engine (auto-build-claw) that pulls agents through structured phases with quality gates, a semi-data-science document critic (devils-advocate) with Fibonacci risk scoring, data science project standards (datascience) with notebook scaffolding and compliance fixes, structured document processing (document-processing) with source grounding, and project journaling (journal).

[!NOTE] Read the full article on the orchestration approach: Your AI Agent Will Cut Corners. Here's How to Stop It.

Plugins

Plugin	What it solves
auto-build-claw	Shallow fixes, scope creep, lost context, unchecked quality, benchmark gaming - enforces structured phases with multi-agent review
devils-advocate	Untested assumptions, hidden risks, weak documents - quantified critique with Fibonacci risk scoring and measurable improvement
datascience	Inconsistent notebooks, wrong conventions, missing structure - enforces standards and scaffolds projects
document-processing	Ungrounded claims, unverified documents, manual PDF work - source tracing, compliance checking, PDF automation
journal	Lost work history, inconsistent entries - append-only audit trail with archiving

auto-build-claw

Runs structured multi-iteration development cycles where each iteration passes through a full phase lifecycle with quality gates. A program defines what to build, a benchmark measures progress, and the engine enforces the workflow until the objective is met or iterations are exhausted.

• Shallow fixes - forces research and hypothesis before implementation
• Scope creep - plan locks scope, review catches deviations
• Lost context - hypothesis catalogue and failure context persist across iterations
• Unchecked quality - two independent gates (readback + gatekeeper) per phase
• No accountability - every phase records agents, outputs, and verdicts in YAML audit logs
• Benchmark gaming - guardian agent checks for benchmark-specific tuning vs genuine improvement

Skills: auto-build-claw (orchestrator), program-writer, benchmark-writer

Workflow types

Type	Phases	Use when
full	RESEARCH -> HYPOTHESIS -> PLAN -> IMPLEMENT -> TEST -> REVIEW -> RECORD -> NEXT	Feature work, improvements
fast	PLAN -> IMPLEMENT -> TEST -> REVIEW -> RECORD -> NEXT	Clear objective, no exploration needed
gc	PLAN -> IMPLEMENT -> TEST -> RECORD -> NEXT	Cleanup, refactoring
hotfix	IMPLEMENT -> TEST -> RECORD	Targeted bug fix
planning	RESEARCH -> PLAN -> RECORD -> NEXT	Work breakdown (auto-chains before full)

Usage

# Describe what you want - the plugin handles the rest
/auto-build-claw improve error handling in the API layer

The plugin writes PROGRAM.md and BENCHMARK.md from your prompt, asks you to approve, then runs the orchestrator autonomously.

See auto-build-claw/README.md for the full phase lifecycle, agent architecture, and configuration details.

devils-advocate

Systematically critiques documents from the perspective of their toughest audience. Builds a devil persona, harvests verifiable facts, generates a risk-scored concern catalogue, and iterates corrections until residual risk is acceptable.

Skills: setup (build persona + fact repository), evaluate (concern catalogue + baseline scorecard), iterate (apply corrections or re-score), run (full workflow end-to-end)

Risk scoring uses a Fibonacci scale (1-8) for likelihood and impact, producing risk scores from 1-64. Each concern is scored 0-100% on how well the document addresses it, and the residual risk (what remains unaddressed) drives iteration priority.

Usage

# Full end-to-end workflow
/devils-advocate:run

# Step by step
/devils-advocate:setup       # Build persona, harvest facts
/devils-advocate:evaluate    # Generate concerns + baseline scorecard
/devils-advocate:iterate     # Apply corrections, re-score (repeat)

See devils-advocate/README.md for scoring formula details, artefact format, and the full concern catalogue methodology.

datascience

Enforces data science project standards derived from production notebook workflows. Five skills auto-trigger when working with notebooks, datasets, rich output, prompts, or progress bars. Nine commands fix existing code, scaffold new projects, and apply prompt engineering techniques.

Skills: datascience (project conventions), notebook-standards (section order, GPU-first), rich-output (semantic colors), prompt-engineering (7 research-backed techniques), progressbars (tqdm/rich)

Usage

# Create a new project from copier template
/datascience:new-project

# Fix an existing notebook to comply with standards
/datascience:fix-notebook notebooks/01-kj-analysis.py

# Apply rich styling fixes (wrong colors, multiple prints)
/datascience:apply-style notebooks/02-kj-train.py

# Add or fix progress bars (choose tqdm or rich)
/datascience:apply-progressbar notebooks/02-kj-train.py

# Apply prompt engineering technique (CoT, CoD, ToT, few-shot, etc.)
/datascience:apply-prompt-technique

# Full psychological prompting stack for hard problems
/datascience:challenge

# Port legacy project to copier-data-science template
/datascience:fix-project

See datascience/README.md for the full list of standards enforced.

journal

Project journal management with append-only entry format, continuous numbering, and automatic archiving. Auto-triggers after substantive work to maintain a consistent audit trail in .claude/JOURNAL.md.

Skills: journal (auto-triggered after substantive work)

Usage

# Create a new entry for completed work
/journal:create added retry logic to API client

# Update the most recent entry with corrections
/journal:update also fixed the timeout parameter

# Archive older entries (keeps last 20)
/journal:archive

See journal/README.md for entry format, detail levels, and archiving rules.

document-processing

Structured document processing with source grounding and quality control. Takes input documents through a verified workflow (analyze, draft, ground, uniformize) and produces outputs where every factual claim is traceable to source material.

Skills: process-documents (4-phase workflow), validate-document (grounding + compliance), pdf (basic operations), pdf-pro (production workflows)

Usage

# Full workflow from objective
/document-processing:run synthesize expert opinions into position paper

# Update existing output with new source material
/document-processing:update add new hearing transcript to timeline

# Validate a document against its sources
/document-processing:validate

See document-processing/README.md for the grounding methodology, folder structure, and PDF processing details.

Install

pip install stellars-claude-code-plugins

As a Claude Code plugin marketplace:

/plugin marketplace add stellarshenson/claude-code-plugins

Architecture

stellars_claude_code_plugins/          # Shared engine (pip installable)
  engine/
    fsm.py                             # Phase lifecycle state machine
    model.py                           # Typed YAML model loader + validator
    orchestrator.py                    # Complete orchestration engine
    resources/
      workflow.yaml                    # Default iteration types and phase sequences
      phases.yaml                      # Default phase templates, agents, gates
      app.yaml                         # Default display text and CLI config

auto-build-claw/                       # Plugin: autonomous build iterations
  .claude-plugin/plugin.json           # Plugin registration
  skills/
    auto-build-claw/SKILL.md           # Orchestrator skill definition
    program-writer/SKILL.md            # Program definition skill
    benchmark-writer/SKILL.md          # Benchmark definition skill

devils-advocate/                       # Plugin: critical document analysis
  .claude-plugin/plugin.json           # Plugin registration
  skills/
    setup/SKILL.md                     # Build persona + fact repository
    evaluate/SKILL.md                  # Concern catalogue + scorecard
    improve/SKILL.md                   # Decide how to address concerns
    iterate/SKILL.md                   # Apply corrections, re-score
    run/SKILL.md                       # Full workflow end-to-end

datascience/                           # Plugin: data science standards
  .claude-plugin/plugin.json           # Plugin registration
  skills/
    datascience/SKILL.md               # Project conventions (auto-triggered)
    notebook-standards/SKILL.md        # Notebook structure (auto-triggered)
    rich-output/SKILL.md               # Rich styling patterns (auto-triggered)
    prompt-engineering/SKILL.md        # 7 techniques with references (auto-triggered)
    progressbars/SKILL.md              # tqdm/rich progress bars (auto-triggered)
  commands/
    new-project.md                     # Scaffold from copier template
    notebook.md                        # Create structured notebook
    review.md                          # Compliance review
    apply-style.md                     # Apply rich output styling fixes
    apply-progressbar.md               # Add or fix progress bars
    apply-prompt-technique.md          # Apply prompt engineering technique
    challenge.md                       # Psychological prompting for hard problems
    fix-notebook.md                    # Restructure notebook to standards
    fix-project.md                     # Port/update project to copier template

document-processing/                   # Plugin: structured document processing
  .claude-plugin/plugin.json           # Plugin registration
  skills/
    process-documents/SKILL.md         # 4-phase workflow with grounding
    validate-document/SKILL.md         # Source grounding + compliance
    pdf/SKILL.md                       # Basic PDF operations (pypdf)
    pdf-pro/SKILL.md                   # Production PDF (pdfplumber, OCR)
  commands/
    run.md                             # Full processing workflow
    update.md                          # Update existing output
    validate.md                        # Validate against source

journal/                               # Plugin: project journal management
  .claude-plugin/plugin.json           # Plugin registration
  skills/
    journal/SKILL.md                   # Entry management + archiving (auto-triggered)
  commands/
    create.md                          # Create new journal entry
    update.md                          # Update most recent entry
    archive.md                         # Archive older entries

.claude-plugin/marketplace.json        # Plugin marketplace registry

Building a new plugin

Plugins are pure configuration - no Python code required. Create a directory with skills and register it in the marketplace:

my-plugin/
  .claude-plugin/plugin.json           # Plugin registration and skill triggers
  skills/
    my-skill/SKILL.md                  # Skill definition with description and instructions

The plugin.json registers your skills with Claude Code, defining when they trigger and what tools they have access to. Each SKILL.md contains the instructions Claude follows when the skill is invoked. The shared orchestration engine (pip install stellars-claude-code-plugins) provides the orchestrate CLI command that handles state management, FSM transitions, gate execution, and audit logging.

Register your plugin in the marketplace by adding an entry to .claude-plugin/marketplace.json.

Development

make install          # create venv, install deps, editable install
make test             # run 236 tests
make lint             # ruff format + check
make format           # auto-fix formatting
make build            # clean, test, bump version, build wheel
make publish          # build + twine upload to PyPI

License

MIT License