## Critical Rules

1. **MANDATORY: ALWAYS run `/rg:conventions` before writing ANY code**
2. **MANDATORY: ALWAYS read the relevant `docs/` file before ANY feature**
3. **MANDATORY: ALWAYS use `/rg:plan` to plan work**
4. **MANDATORY: ALWAYS use `/rg:work` to begin work**
5. **MANDATORY: NEVER edit, delete, or mutate staging, production, or remote data**

<EXTREMELY_IMPORTANT>
BEFORE YOU DO ANYTHING — read this and follow it.

1. *ALWAYS* Run /rg:conventions to load the index
2. *ALWAYS* Read the docs relevant to your task
3. *ALWAYS* Output a "Conventions loaded:" block
4. *NEVER* Write code without reading the docs
5. *NEVER* Skip re-reading because you read it earlier
</EXTREMELY_IMPORTANT>

---
name: rg:conventions
description: Load project coding conventions before writing code.
---
# Project Conventions
Convention docs live in `docs/conventions/`, by domain.
Read the relevant ones with the Read tool before writing code.

| Doc | When to read |
|-----|--------------|
| docs/conventions/architecture/coding_patterns.md | naming, YAGNI |
| docs/conventions/hotwire/turbo_streams.md | streams, DOM IDs |
| docs/conventions/testing/rspec/overview.md | rules, anti-patterns |

---
name: rg:plan
description: >-
  Plan a feature with automatic convention loading, then hand
  off to compound-engineering:ce-plan for structured planning.
---
# Plan With Convention Context
Orchestrate: understand → conventions → docs → plan.

**NEVER auto-invoke a work skill.** This produces a plan only.

<EXTREMELY_IMPORTANT>
**ALWAYS re-read convention docs before writing code, even
if you read them earlier.** Context compression means earlier
reads may be gone from working memory.

**ALWAYS output this confirmation before writing any code:**

    Conventions loaded:
      - docs/conventions/architecture/coding_patterns.md
</EXTREMELY_IMPORTANT>

## Use `static values` for all controller state -- never query DOM on `connect()`

The server renders data attributes; the controller reads them
declaratively. Always declare type and default together for
non-String values.

// BAD -- queries DOM for initial state
connect() {
  const selected = this.element.querySelector("input[type=radio]:checked")
}

// GOOD -- server provides state via values
static values = { default: String }

connect() {
  if (this.hasDefaultValue) this.revealByValue(this.defaultValue)
}

## Checklist

- [ ] All state in `static values` with typed defaults -- not DOM queries
- [ ] `connect()` paired with `disconnect()` for all timers, listeners, references
- [ ] `data-controller` element wraps all `data-action` elements that reference it

# Block direct rspec — must use bin/agent-rspec
if echo "$COMMAND" | grep -qE 'rspec\s' && ! echo "$COMMAND" | grep -qE 'bin/agent-rspec'; then
  echo "BLOCKED: Do not run rspec directly. Use bin/agent-rspec." >&2
  exit 2
fi

# Block starting the dev server
if echo "$COMMAND" | grep -qE '(bin/dev|rails\s+s\b|rails\s+server)'; then
  echo "BLOCKED: Do not start the dev server." >&2
  exit 2
fi

"deny": [
  "Skill(brainstorming)",
  "Skill(write-plan)",
  "Skill(using-git-worktrees)"
],
"allow": [
  "Bash(bin/agent-rspec:*)",
  "Bash(bin/rails:*)",
  "Bash(bin/rubocop:*)"
]

if [[ -f "${GIT_ROOT}/config/master.key" ]]; then
  ln -sfn "${GIT_ROOT}/config/master.key" \
          "${target}/config/master.key"
  ok "  ✓ Linked config/master.key"
fi