CLAUDE.md@.claude git:20260924.f62b60dA

Immutable. This exact content never changes and is served at /api/v1/blob/864b4dc2ed33e17c.

# optimus-claude

GitHub: https://github.com/oprogramadorreal/optimus-claude

A Claude Code plugin whose source is markdown: `SKILL.md` files are instructions a model executes, not documentation about code that runs. Edit them as prompts, not as prose.

Test command: `bash scripts/validate.sh && bash scripts/test-hooks.sh && python -m pytest test/`

## Where to look

Load the doc that matches the change — not all of them.

| Changing | Read first |
|---|---|
| A skill, agent, or shared reference (`skills/`, `agents/`, `references/`) | `.claude/docs/skill-writing-guidelines.md` |
| Scripts or hooks (`scripts/`, `hooks/`) | `.claude/docs/coding-guidelines.md` |
| Tests, or anything under `scripts/harness_common/` | `.claude/docs/testing.md` |
| Deep-loop invariants, harness JSON contracts, agent and reference tiers, Claude/Codex host wiring | `.claude/docs/architecture.md` |
| Contribution workflow, skill anatomy, feature-branch testing, version bumping | `CONTRIBUTING.md` |

## Key rules

- Never leave a `ref` field in `marketplace.json` on the master branch
- Every PR to master bumps the version in `.claude-plugin/plugin.json` and `.codex-plugin/plugin.json` and updates the `README.md` version badge to match — `validate.sh` fails the PR otherwise
- Only `/optimus:init` writes `.claude/.optimus-version` in user projects — other skills that install template files must NOT update this file (it tracks init's full template audit, not individual file freshness)