# orual-plugins

Claude Code plugins for design, implementation, and development workflows. Derived from ed3d-plugins by Ed Ropple (CC BY-SA 4.0), with significant revisions.

## Key Differences from ed3d

- **Smarter agents**: Sonnet is the implementation floor (not Haiku). Opus for review and complex tasks.
- **Adversarial review**: Code reviewer actively verifies implementation integrity, not just style.
- **Three execution modes**: Autonomous (full delegation), Collaborative (human in loop), Light (small tasks).
- **jj (jujutsu) as default VCS**: Workspaces instead of git worktrees.
- **Sanity-check hook**: Periodic Haiku-powered scan for self-deception patterns in agent work.
- **NixOS-aware Playwright**: MCP wrapper that uses nix-patched browser binaries without FHS.

## Conventions

### Task Invocations Use XML Syntax

When documenting Task tool invocations in skills or agent prompts, use XML-style blocks:

```
<invoke name="Task">
<parameter name="subagent_type">orual-basic-agents:sonnet-general-purpose</parameter>
<parameter name="description">Brief description</parameter>
<parameter name="prompt">
The prompt content.
</parameter>
</invoke>
```

### Skill Announcements

Skills announce themselves in lowercase casual style:
- `"using the brainstorming skill to work through this design"`
- `"using the test-driven-development skill to implement this feature"`

### Version Updates

When updating a plugin version in its `.claude-plugin/plugin.json`, also update:
1. The corresponding version in `.claude-plugin/marketplace.json` at repo root
2. Add a changelog entry to `CHANGELOG.md`

## Attribution

Derived from [ed3d-plugins](https://github.com/ed3dai/ed3d-plugins-testing) by Ed Ropple, which is derived from [obra/superpowers](https://github.com/obra/superpowers) by Jesse Vincent. See LICENSE files for details.