Lean-LLM/lean-agents
Lean-LLM/lean-agents has 73 GitHub stars and 0 forks. GitHot measured +1 stars in 24 hours. Last checked 2026-11-17 02:36 UTC. Last push 2026-11-10.
Measured star growth
- in 24h
- +1
- in 7 days
- Collecting history
- in 15 days
- Collecting history
- in 1 month
- Collecting history
Net star changes over overlapping periods, not daily totals. Missing measurements are left blank. Stars measure attention, not software quality.
About
~66% Faster, ~44% Less Tokens, The only AI coding workflow you need, Supports small models
AIREADME.md
OriginalLean Agents
Short prompts for coding agents. Less text per turn, one clear rule set.
No speed or token savings are claimed. See BENCHMARK.md for the tests so far.
How it works
AGENTS.md is the one shared policy. Two roles:
| Role | Who | Does |
|---|---|---|
ORCHESTRATOR |
Primary agent (build) |
Small single fixes itself. Features, refactors and multi-file work go to a worker, one per independent task. |
CODER |
Worker (general, or worker on Codex) |
Investigates, edits, tests, repairs inside its scope. Never delegates. |
Up to 10 workers run in parallel on independent tasks; the primary waits for all. Agents never ask the user questions; they resolve things themselves. Delete the ## Questions section in AGENTS.md if you want questions back.
What's inside
| Path | What |
|---|---|
AGENTS.md |
Shared policy: roles, routing, engineering, output. |
agents/ |
Agent files: build.md (primary), general.md / worker.toml (CODER), plus optional lean-* and explore helpers. |
skills/lean-code |
Smallest complete change, lean pass after coding, dedup. Load for all coding. |
skills/lean-java |
Java/JVM: Maven, Gradle, JUnit, concurrency, Spring. |
skills/lean-web |
JS/TS, Node, React/Next.js, Fastify, auth, tests. |
skills/lean-plan |
Plan a feature from scratch. |
extensions/ |
Pi: subagent tool for general. |
mods/ |
Command Code: loads the build prompt. |
plugins/ |
Legacy OpenCode no-op, kept so old installs get overwritten. |
.chatgpt/ |
Prompt for ChatGPT projects that write plans for coding agents. |
Agents load the skills that fit the task and workspace.
Install
Put AGENTS.md at the repo root (or the host's global instructions path). Start a fresh session and check it loaded. Merge with existing config; don't overwrite.
- OpenCode: copy
agents/build.mdandagents/general.mdto.opencode/agents/or~/.config/opencode/agents/. Setdefault_agent: "build". - Claude Code: copy the same two files to
.claude/agents/or~/.claude/agents/. Runclaude --agent build. Add@AGENTS.mdtoCLAUDE.mdif needed. - Codex: copy
agents/worker.tomlto.codex/agents/. Turn on multi-agent. RootAGENTS.mdmakes Codex the orchestrator. - Command Code: reads
AGENTS.md. Optional: installmods/lean-primary.ts(keepagents/build.mdbeside it). Its built-ingeneralcan't be overridden, so giveRole: CODERin the handoff. - Pi: use
extensions/lean-subagents.ts(keepagents/general.mdbeside it). LoadAGENTS.mdyourself if the host doesn't.
Limits
Prompts are not enforcement. The model may skip delegation. Check the first tool calls of a fresh session.
License
MIT. See LICENSE.