constellos-local

Claude Code Plugins

A curated marketplace of plugins that extend Claude Code with typed hooks for development workflows. This repository provides both ready-to-use plugins and shared TypeScript utilities for creating your own.

Overview

This marketplace contains three production-ready plugins designed for modern development workflows:

• github-orchestration - GitHub workflow orchestration with branch context, commit enhancement, and CI management
• nextjs-supabase-ai-sdk-dev - Development quality enforcement with linting, type checking, and testing
• project-context - Context discovery, folder validation, and documentation management

All plugins leverage shared TypeScript utilities for consistent behavior, comprehensive type safety, and automatic logging. Hooks are self-executable TypeScript files with full type definitions.

Quick Start

Installation

1. Add this marketplace to your .claude/settings.json:

{
  "extraKnownMarketplaces": {
    "constellos": {
      "source": {
        "source": "directory",
        "path": "./.claude-plugin"
      }
    }
  }
}

2. Install plugins using the CLI:

claude plugin install github-orchestration@constellos
claude plugin install nextjs-supabase-ai-sdk-dev@constellos
claude plugin install project-context@constellos

Or enable them in your settings:

{
  "enabledPlugins": {
    "github-orchestration@constellos": true,
    "nextjs-supabase-ai-sdk-dev@constellos": true,
    "project-context@constellos": true
  }
}

Available Plugins

GitHub Orchestration (github-orchestration)

Purpose: Comprehensive GitHub workflow orchestration for issue-driven development with automatic context discovery and commit enhancement.

Key Features:

• Displays linked GitHub issue for current branch at session start
• Shows branch sync status (remote tracking branch and origin/main)
• Lists outstanding open issues available for work
• Auto-commits subagent work with task context and git trailers
• Automatically creates/updates GitHub issues from plan files
• Enhances commits with task and issue metadata
• Checks PR status at session end with CI and preview URL reporting
• Installs GitHub CLI on remote environments

Hooks:

• SessionStart (install-github.ts) - Installs GitHub CLI (non-blocking)
• SessionStart (add-github-context.ts) - Displays branch issue context and sync status (non-blocking)
• PostToolUse[Write|Edit] (sync-plan-to-issue.ts) - Syncs plan files to GitHub issues (non-blocking)
• PostToolUse[Bash] (enhance-commit-context.ts) - Enriches commits with task metadata (non-blocking)
• SubagentStop (commit-task.ts) - Auto-commits agent work (non-blocking)
• Stop (commit-session-check-pr-status.ts) - Session commit and PR checks (progressive blocking)

Use Cases:

• Issue-driven development with branch linking
• Multi-agent workflows with automatic commit documentation
• PR readiness checks before ending sessions
• Automated task documentation through enriched commits

Documentation: plugins/github-orchestration/README.md

---

Next.js Development Tools (nextjs-supabase-ai-sdk-dev)

Purpose: Enforces code quality through automated checks at both file and project levels for Next.js, Supabase, and AI SDK projects.

Key Features:

• Per-file quality checks (ESLint, TypeScript, TSDoc) on every edit
• Automatic test execution when test files are modified
• Comprehensive project-wide validation at session end (blocking)
• Installs Vercel and Supabase CLIs on remote environments
• Encourages UI review after ui-developer agent completes
• Logs all Task tool calls for context in SubagentStop hooks

Hooks:

• SessionStart (install-vercel.ts, install-supabase.ts) - CLI installation (non-blocking)
• PreToolUse[Task] (shared log-task-call.ts) - Task context logging (non-blocking)
• PostToolUse[Task] (shared log-task-result.ts) - Task result logging (non-blocking)
• PostToolUse[Task] (encourage-ui-review.ts) - UI review encouragement (non-blocking)
• PostToolUse[Write|Edit] (check-file-eslint.ts) - ESLint on files (non-blocking, informational)
• PostToolUse[Write|Edit] (check-file-types.ts) - TypeScript on files (non-blocking, informational)
• PostToolUse[Write|Edit] (check-file-tsdoc.ts) - TSDoc validation (non-blocking, informational)
• PostToolUse[Write|Edit test files] (check-file-vitest-results.ts) - Test execution (non-blocking, informational)
• Stop (check-global-eslint.ts) - Project-wide ESLint (blocking)
• Stop (check-global-types.ts) - Project-wide TypeScript (blocking)
• Stop (check-global-vitest-results.ts) - Full test suite (blocking)