Skip to content

DeevsDeevs/agent-system

Repository files navigation

Deevs' Agent System

Deevs' plugin marketplace for Claude Code with workflow chains, terminal control, and expert agents.

Installation

/plugin marketplace add git@github.com:DeevsDeevs/agent-system.git

Plugins

chain-system

Multi-session workflow chains for maintaining context across conversations.

Core: Save conversation state, resume complex projects across sessions without losing technical details.

Commands:

  • /chain-link [name] - Save current work to chain
  • /chain-load [name] - Resume from saved chain
  • /chain-list - List all chains

Use when: Working on multi-session projects, need to pause and resume with full context.

Details: chain-system/README.md

/plugin install chain-system@deevs-agent-system

tmux

Interactive terminal control for REPLs, debuggers, and servers.

Core: Run and control interactive CLI programs in separate tmux panes with high-level API.

Quick start:

# One-shot execution
tmux-ctl eval "npm test"

# REPL interaction
tmux-ctl repl python "2+2"

# Long-running process
tmux-ctl start "npm run dev" --name=server --wait="Server started"
tmux-ctl logs server
tmux-ctl stop server

# Parallel execution
tmux-ctl start "npm run build" --name=build
tmux-ctl start "npm test" --name=test
tmux-ctl wait build test

Use when: Need to interact with REPLs (Python, Node, psql), control debuggers, monitor servers, run parallel tasks.

Details: tmux/README.md | tmux/SKILL.md | tmux/reference.md

Setup: Add to PATH after installation:

export PATH="$PATH:$HOME/.claude/plugins/tmux@deevs-agent-system/bin"

Dependencies: bash 4.0+, tmux 2.0+, jq, md5sum/md5

/plugin install tmux@deevs-agent-system

dev-experts

Critical, opinionated developer personas focused on approach and methodology.

Agents:

/architect - Technical lead and architect

  • Plans features, explores alternatives with trade-off analysis
  • Creates actionable implementation plans
  • Use for: Architecture decisions, feature design

/devops - Production detective

  • Methodical bug hunting and failure investigation
  • Forms hypotheses, tests systematically
  • Use for: Production issues, mysterious bugs, deployment failures

/rust-dev - Rust purist

  • Hunts un-Rusty patterns, ownership issues, safety violations
  • Use for: Rust code review, idiom improvements

/python-dev - Pythonista

  • Type safety, async pitfalls, modern Python (3.10+)
  • Use for: Python code review, modernization

/cpp-dev - C++ performance purist

  • UB, memory bugs, latency killers, lock-free correctness
  • Use for: C++ code review, performance optimization

/reviewer - Grumpy code wizard, 40 years experience

  • Security holes, race conditions, performance sins, edge cases
  • Line-by-line analysis with specific fixes
  • Use for: Pre-merge review, security audit

/tester - Testing specialist

  • Comprehensive, real-world tests (no fake tests)
  • Use for: Writing tests, improving coverage

Details: dev-experts/README.md

/plugin install dev-experts@deevs-agent-system

bug-hunters

Systematic bug hunting with spec reconstruction, adversarial validation, and confidence-ranked reports.

Agents:

/orchestrator - Central brain (RED)

  • Reconstructs spec from code, spawns hunters, challenges findings
  • Filters false positives via adversarial validation with dev-experts
  • Use for: Starting any bug hunting session

/logic-hunter - Spec detective (ORANGE)

  • Language-agnostic logic bugs, spec-vs-implementation gaps
  • Scan mode (hotspots) → Hunt mode (deep trace)
  • Use for: Algorithm correctness, data flow issues, design intent verification

/cpp-hunter - C++ bug hunter (YELLOW)

  • Memory corruption, UB, concurrency issues
  • Hypothesis-driven, demands proof
  • Use for: Crash debugging, memory bugs, mysterious C++ failures

/python-hunter - Python bug hunter (YELLOW)

  • Async pitfalls, None propagation, type violations
  • Hypothesis-driven, demands proof
  • Use for: Python-specific bugs, type mismatches, async issues

Flow: Spec Reconstruction → Hotspot Scan → Hunter Deployment → Adversarial Challenge → Confidence Scoring → Report

Details: bug-hunters/README.md

/plugin install bug-hunters@deevs-agent-system

cost-status

Status bar showing session cost, monthly cost, total cost, and context window usage.

Display: $0.52/$30.00/$150.00 | 38k/200k (19%)

  • $session/$month/$total - Cost tracking at three levels
  • used/max (%) - Context window usage

Setup: After installation, add to ~/.claude/settings.json:

{
  "statusLine": {
     "type": "command",
     "command": "bash ~/.claude/scripts/show-cost.sh"
   },
}

Find the path with:

find ~/.claude -name "show-cost.sh" -path "*/cost-status/*" 2>/dev/null | head -1

Details: cost-status/README.md

/plugin install cost-status@deevs-agent-system

arxiv-search

Search arXiv preprint repository for academic papers.

Core: Query arXiv for research papers across physics, mathematics, computer science, quantitative biology, finance, and statistics.

Quick start:

# Basic search (auto-selects Python or bash)
arxiv_search "transformer attention mechanism"

# Limit results
arxiv_search "protein folding" --max-papers 5

Use when: Finding preprints, ML/AI papers, mathematical methods, scientific literature before journal publication.

Dependencies: None (bash fallback). For better reliability: uv pip install arxiv

Details: arxiv-search/SKILL.md

/plugin install arxiv-search@deevs-agent-system

Agent Color Scheme

Universal color scheme across all agent plugins:

Color Role Examples
❤️ RED Deciders & Orchestrators architect, strategist, orchestrator, crisis-hunter, devops
🧡 ORANGE Hybrid (can lead or challenge) logic-hunter
💛 YELLOW Checkers & Validators reviewer, cpp-hunter, python-hunter
💙 BLUE Builders & Implementers cpp-dev, python-dev, rust-dev, tester
💚 CYAN Researchers & Analysts data-sentinel, microstructure-analyst, causal-analyst

Credits

Inspired by:

About

Perfect agent system to be 10x Deevs' engineer

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 6