oh-my-claude: Instructions file for Claude Code

oh-my-claude Development

Claude Code plugin providing ultrawork mode, context protection, and specialized agent workflows.

Structure

├── .claude-plugin/marketplace.json    # Marketplace registry (version x2)
├── .github/workflows/validate-plugin.yml
├── PLUGIN-STRUCTURE.md               # Detailed architecture guide
├── tests/oh-my-claude/hooks/         # Hook unit tests
│   └── CLAUDE.md                     # Testing conventions
└── plugins/oh-my-claude/             # The actual plugin
    ├── .claude-plugin/plugin.json    # Plugin metadata (version x1)
    ├── agents/                       # 7 specialized agents
    ├── docs/                         # Authoring guides and compatibility notes
    ├── hooks/                        # Python hooks (PEP 723)
    │   └── CLAUDE.md                 # Hook development patterns
    ├── commands/                     # /prime (auto-discovered)
    ├── skills/                       # Skills (in plugin.json)
    │   └── oh-my-claude-runtime/     # Runtime workflow guidance skill
    └── .mcp.json                     # Plugin MCP servers

Plugin-root CLAUDE.md is not loaded as runtime context by current Claude Code. Ship runtime behavior through hooks, skills, agents, commands, MCP, and plugin settings instead.

Development Workflow

Prerequisites

• jq - JSON validation
• Python 3.11+ - Hooks auto-install deps via uv

Version Bumping (CRITICAL)

Claude Code caches plugins. Any change requires bumping version in BOTH:

1. .claude-plugin/marketplace.json - metadata.version AND plugins[0].version
2. plugins/oh-my-claude/.claude-plugin/plugin.json

Then: /plugin update oh-my-claude and start new session.

Testing

Run hook unit tests:

cd tests/oh-my-claude/hooks
uv run --with pytest pytest . -v

CI/CD

GitHub Actions validates: JSON syntax, version sync across files, no ../ paths, shellcheck, ruff linting, pytest, and skill directories. Pytest covers structured hook args and hook script existence.