Agent skill

always-on-guidance

Always-on rule-oriented guidance for claude-plugin agents. Use to align behavior, tool usage, and model-specific defaults while avoiding deprecated bd/cass references. Related skills: swarm-coordination, testing-patterns.

Stars 603
Forks 50

Install this agent skill to your Project

npx add-skill https://github.com/joelhooks/swarm-tools/tree/main/packages/claude-code-swarm-plugin/skills/always-on-guidance

SKILL.md

Always-On Guidance

Global Rules

  • Follow instruction priority: system → developer → user → AGENTS.
  • Use swarm plugin tools (hive_*, swarm_*, swarmmail_*, hivemind_*); avoid deprecated bd/cass references.
  • Stay within assigned files; reserve before edits with ttl_seconds; release reservations on done; finish swarm work with swarm_complete.
  • Use TaskCreate/TaskUpdate for visible progress in Claude Code UI alongside hive_* for git-backed persistence.
  • When CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS is enabled, prefer TeammateTool for real-time coordination and swarmmail_* for persistence.
  • swarmmail_release_all is coordinator-only for stale/orphaned reservations.
  • Keep outputs concise and action-oriented.

Model Defaults

Use model aliases (inherit, opus, sonnet, haiku) instead of version numbers.

Opus

  • Allow brief rationale (1–2 sentences) for decisions.
  • Use sections when work has multiple phases.
  • Suggest alternatives only when risk is high, then choose one.
  • Stay compact; avoid long exposition.

Sonnet/Haiku

  • Prefer strict checklists and short imperatives.
  • Ask a single clarifying question if blocked; otherwise proceed.
  • Avoid speculative reasoning; state decisions plainly.
  • Keep outputs minimal and non-narrative.

Testing Discipline

  • Use red → green → refactor when tests cover the touched area.
  • Use EnterPlanMode for test-driven planning before implementation.
  • If tests are absent or out of scope, state that explicitly.

Expand your agent's capabilities with these related and highly-rated skills.

joelhooks/swarm-tools

swarm-coordination

Multi-agent coordination patterns for OpenCode swarm workflows. Use when work benefits from parallelization or coordination. Covers: decomposition, worker spawning, file reservations, progress tracking, and review loops.

603 50
Explore
joelhooks/swarm-tools

swarm-cli

Swarm CLI commands for workers - hivemind memory, hive tasks, swarmmail coordination. Use when working in a swarm context. Covers: swarm memory (find/store/get/stats), swarm cells (query/create/update/close), and coordination commands.

603 50
Explore
joelhooks/swarm-tools

ralph-supervisor

Ralph loop pattern - Claude supervises while Codex (gpt-5.3-codex) executes implementation work. Use for autonomous coding loops with fresh context per iteration, validation gates, and git-backed persistence. Tools: ralph_init, ralph_story, ralph_iterate, ralph_loop, ralph_status, ralph_cancel, ralph_review.

603 50
Explore
joelhooks/swarm-tools

always-on-guidance

Always-on rule-oriented guidance for claude-plugin agents. Use to align behavior, tool usage, and model-specific defaults while avoiding deprecated bd/cass references. Related skills: swarm-coordination, testing-patterns.

603 50
Explore
joelhooks/swarm-tools

swarm-coordination

Multi-agent coordination patterns for OpenCode swarm workflows. Use when working on complex tasks that benefit from parallelization, when coordinating multiple agents, or when managing task decomposition. Do NOT use for simple single-agent tasks.

603 50
Explore
joelhooks/swarm-tools

hive-workflow

Issue tracking and task management using the hive system. Use when creating, updating, or managing work items. Use when you need to track bugs, features, tasks, or epics. Do NOT use for simple one-off questions or explorations.

603 50
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results