Skip to content

hamr0/liteagents

Repository files navigation

         ██╗     ██╗████████╗███████╗ █████╗  ██████╗ ███████╗███╗   ██╗████████╗███████╗
         ██║     ██║╚══██╔══╝██╔════╝██╔══██╗██╔════╝ ██╔════╝████╗  ██║╚══██╔══╝██╔════╝
         ██║     ██║   ██║   █████╗  ███████║██║  ███╗█████╗  ██╔██╗ ██║   ██║   ███████╗
         ██║     ██║   ██║   ██╔══╝  ██╔══██║██║   ██║██╔══╝  ██║╚██╗██║   ██║   ╚════██║
         ███████╗██║   ██║   ███████╗██║  ██║╚██████╔╝███████╗██║ ╚████║   ██║   ███████║
         ╚══════╝╚═╝   ╚═╝   ╚══════╝╚═╝  ╚═╝ ╚═════╝ ╚══════╝╚═╝  ╚═══╝   ╚═╝   ╚══════╝

AI development toolkit with 11 specialized agents and 17 commands per tool

version (auto from package.json) license: Apache 2.0

Supported Tools: Claude Opencode Ampcode Droid

Specialized AI agents and workflow commands for product management, agile development, and software engineering. Simple installer supports Claude, Opencode, Ampcode, and Droid.


Quick Start

# Option 1: NPX (recommended)
npx liteagents

# Option 2: Global install (never use sudo)
npm install -g liteagents
liteagents

# If permission errors:
# mkdir -p ~/.npm-global && npm config set prefix '~/.npm-global'
# echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc && source ~/.bashrc

Supported Tools

  • Claude Code - 11 subagents + 9 skills + 8 commands (+ optional live-canvas channel plugin)
  • Opencode - 11 agent references + 17 commands
  • Ampcode - 11 subagents + 17 commands
  • Droid - 11 agent references + 17 commands

Key Difference:

  • Claude Code: Full subagent system with orchestrator + skills (auto-triggering)
  • Opencode / Droid / Ampcode: Commands only + agent reference documentation

Start Using

# Claude Code examples
@orchestrator help
@1-create-prd Create a PRD for a task management app
/brainstorming Explore authentication approaches
/tdd-flow Implement user login

# Opencode/Ampcode/Droid examples
/1-create-prd Create a PRD for a task management app
/brainstorming Explore authentication approaches
/tdd-flow Implement user login

Hot Memory — project-local learning from your own sessions

Liteagents ships a two-command pipeline that turns Claude Code's session logs into project-local memory. No databases, no external services, just markdown files the assistant reads via @MEMORY.md.

/stash  →  /remember
capture    analyze + consolidate
  • /stash — snapshot the current session's context before compaction or handoff; nudges you to consolidate once a few stashes pile up
  • /remember — runs friction analysis automatically (mining JSONL session logs across all your projects for frustration signals, failed flows, and abandonment patterns, clustered into antigen candidates), then consolidates stashes + friction antigens into .claude/memory/MEMORY.md; auto-injected into CLAUDE.md via @MEMORY.md so every future session benefits

What you get is a memory that learns from your own mistakes and interventions, grows quietly in your repo, and works anywhere Claude Code runs. The friction pass inside /remember scans all your projects and gives you a per-repo reliability verdict:

Per-Project:
  my-app         56% BAD (40/72)  median: 16.0  🔴
  api-service    40% BAD (2/5)    median:  0.5  🟡
  web-client      0% BAD (0/1)    median:  0.0  ✅

WORST: my-app/0203-1630-11eb903a  peak=225  turns=127
BEST:  web-client/0202-2121-8d8608e1  peak=0  turns=4

Verdict: USEFUL    Intervention predictability: 93%

Results land in .claude/friction/antigen_review.md with projects, error patterns, and offending tool sequences called out per cluster — which /remember then encodes as rules the next session sees.

This is the thing in liteagents that nothing else ships. Normal skill bundles give you instructions. The hot-memory pipeline gives you instructions the assistant wrote for itself, from your own logs.


What's Included

11 Agents

Workflow Agents (3):

  • 1-create-prd - Define scope with structured Product Requirement Documents
  • 2-generate-tasks - Break PRDs into granular, actionable task lists
  • 3-process-task-list - Execute tasks iteratively with progress tracking and review checkpoints

Specialist Agents (8):

  • orchestrator - Analyze intent, coordinate workflows, route to optimal agent sequences
  • code-developer - Implementation, debugging, refactoring, code best practices
  • quality-assurance - Test architecture, quality gates, requirements traceability, risk assessment
  • context-builder - Initialize project context, discover documentation, create knowledge bases
  • feature-planner - Epics, user stories, prioritization, backlog management, retrospectives
  • market-researcher - Market analysis, competitive research, project discovery, brainstorming
  • system-architect - System design, technology selection, API design, scalability planning
  • ui-designer - UI/UX design, wireframes, prototypes, accessibility, design systems

18 Commands/Skills

Auto-Triggering Skills (3) - Claude Code only:

  • tdd-flow - Write test first, watch fail, minimal passing code
  • test-traps - Prevent mocking anti-patterns
  • verify-done - Verify before claiming done

Manual Skills/Commands (15):

Hot Memory Pipeline (3) — see the Hot Memory section above for the full walkthrough:

  • stash - Snapshot session context to .claude/stash/ before compaction, handoff, or ending complex work
  • friction - Analyze all JSONL sessions for frustration signals, cluster failures per project, surface antigens
  • remember - Consolidate stashes + friction antigens into .claude/memory/MEMORY.md; auto-injected via @MEMORY.md

Design:

  • live-canvas - Design UI variations with click-to-annotate feedback in the browser; ships a companion MCP channel plugin for Claude Code so Saves stream into the session in real time. Other tools use batch mode.

Workflow & analysis:

  • brainstorming - Structured brainstorming sessions
  • docs-builder - Project documentation generation
  • trace-back - Trace bugs backward through call stack
  • skill-creator - Guide for creating new skills
  • debug-method - Four-phase debugging framework
  • optimize - Performance analysis
  • refactor - Safe refactoring with behavior preservation
  • diff-review - Review a file, branch, or range; verifies findings, fixes confirmed/unambiguous ones, asks on ambiguous or downstream-affecting ones
  • security - Vulnerability scan; same verify→fix→ask flow as /diff-review
  • ship - Pre-deployment checklist
  • test-generate - Generate test suites

Claude-only plugin: live-canvas-channel is a bundled Claude Code MCP channel plugin that ships under ~/.claude/plugins/live-canvas-marketplace/. One-time /plugin install + a session started with --dangerously-load-development-channels unlocks live mode. Skill probes for the channel on each invocation and handholds setup when missing. See packages/claude/skills/live-canvas/README.md for the full walkthrough.


Documentation

Document Description
INSTALLER_GUIDE.md Complete installation guide, troubleshooting, and FAQ
subagentic-manual.md Detailed agent/command reference

Example Workflows

Feature Development:

@orchestrator I need to add user authentication
# Orchestrator routes to:
# → market-researcher (research approaches)
# → 1-create-prd (requirements)
# → 2-generate-tasks (implementation tasks)
# → 3-process-task-list (execution)

Code Quality:

@quality-assurance Review this PR before merge
/diff-review main  # review branch vs main, fixes confirmed issues, asks on ambiguous ones
/debug-method Investigate this race condition

Architecture & Design:

@system-architect Design microservices architecture
@ui-designer Create wireframes for mobile checkout

Stats

  • 11 Specialized Agents
  • 22 Workflow Commands & Skills
  • 4 Supported Tools (Claude, Opencode, Ampcode, Droid)
  • Apache-2.0 License

Links


License

Apache-2.0 © 2026 hamr0 — see LICENSE.


Need help? See the Installer Guide or open an issue

About

Comprehensive AI liteagents kit (subagents, skills/commands) for Claude Code, Opencode, Ampcode, and Droid

Topics

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors