fix: overhaul Claude Code plugin for correctness and spec compliance (#225 )

- Fix critical bugs: coder-agent name (CoderAgent→coder-agent), manifest
  path in session-start.sh, /oac:setup ghost command replaced with /install-context
- Fix hooks.json: add timeout/async, add description, restore matcher
- Fix session-start.sh: dual-format output (Claude Code + Cursor/OpenCode),
  remove invalid JSON escapes for $ and backtick
- Fix agent spec compliance: disallowedTools on read-only agents, WebFetch
  on external-scout, haiku model on context-scout, example blocks on 3 agents
- Fix skill descriptions: triggering conditions only (no workflow summaries)
  per superpowers empirical testing — prevents Claude shortcutting skill content
- Add Red Flags + Rationalization tables to 4 discipline skills
- Add install-context skill + command replacing oac-setup/oac-plan/oac-add-context
- Add cleanup-tmp.sh (was missing, broke /oac:cleanup)
- Add TypeScript installer (install-context.ts/js) with profile-based download
- Update plugin.json: keywords, homepage for marketplace discoverability
- Update README: correct skill count, fix structure diagram, remove stale refs
- Remove obsolete files: FIRST-TIME-SETUP.md, INSTALL.md, QUICK-START.md,
  download-context.sh, verify-context.sh, load-config.sh, context-manager skill,
  oac-setup/oac-plan/oac-add-context commands

2026-02-19 20:16:17 +00:00

2.9 KiB

Raw Blame History

name: install-context description: Install OpenAgents Control context files from registry with interactive profile selection argument-hint: [--profile=] [--force] [--dry-run] [--verbose]

Install Context Command

$ARGUMENTS

Overview

Install context files from the OpenAgents Control registry with interactive profile selection.

Available profiles: essential, standard, extended, specialized, all

Options:

--profile=<profile> - Install specific profile (skips interactive selection)
--force - Force reinstall even if already installed
--dry-run - Preview what would be installed without installing
--verbose - Show detailed installation progress
--categories=<ids> - Install specific context components (comma-separated)

Usage

Interactive Mode (Recommended)

/install-context

This will:

Check current installation status
Ask which profile to install
Confirm before proceeding
Run installation
Verify files
Offer cleanup options

Direct Mode (With Options)

# Install essential profile
/install-context --profile=essential

# Force reinstall standard profile
/install-context --profile=standard --force

# Preview extended profile
/install-context --profile=extended --dry-run

# Install with verbose output
/install-context --profile=standard --verbose

# Install specific components
/install-context --categories=core-standards,openagents-repo

How It Works

This command invokes the install-context skill which:

Checks current installation - Shows what's already installed (if any)
Asks for profile - Interactive selection or uses --profile option
Confirms installation - Shows summary and asks for confirmation
Runs TypeScript installer - Executes scripts/install-context.ts
Verifies installation - Checks files exist and manifest is created
Offers cleanup - Asks about cleaning up temporary files

Profile Descriptions

essential (Recommended for getting started)

Minimal components for basic functionality
~4 components, ~30 seconds download
Includes: core patterns, project context, navigation

standard (Recommended for most users)

Standard components for typical use
~12 components, ~2 minutes download
Includes: essential + development workflows + common patterns

extended (For advanced features)

Extended components for advanced features
~30 components, ~5 minutes download
Includes: standard + specialized domains + advanced patterns

specialized (For specific domains)

Specialized components for specific domains
~50 components, ~10 minutes download
Includes: extended + domain-specific contexts (UI, data, product, etc.)

all (Complete installation)

All available context components
~191 components, ~20 minutes download
Includes: Everything in the registry

Examples

Example 1: First-time Installation

User: /install-context

2.9 KiB Raw Blame History