slagyr/agent-lib

Reusable skills/commands/rules for AI agents

★ 0Forks 0GitHub ↗Compare

README

Agent Lib

A library of reusable skills, commands, and other agent components for AI coding agents.

Structure

agent-lib/
  skills/       # Skills teach agents how to behave in specific contexts
  commands/     # Commands define reusable agent actions

Available Skills

Skill Description
architecture Architecture principles: Screaming Architecture, domain-as-interface seams (Ports & Adapters at the directory level), implicit/explicit API pairs.
beans-multi-worker Multi-worker discipline for shared beans trackers. Session close protocol, when to pull, resolving git conflicts on bean files.
clojure Clojure coding conventions. Naming, formatting, function design, state management, threading, cross-platform patterns.
c3kit Guide to the c3kit ecosystem (apron, bucket, wire, scaffold). Schemas, database API, web layer, app lifecycle.
c3kit-schema Deep reference for c3kit.apron.schema. Four operations, spec anatomy, nested types, entity-level specs, error handling, silent-failure trap.
gherkin Writing good Gherkin feature files. Scenario structure, step clarity, tag conventions, common traps.
logging Structured logging discipline. Levels, event-keyword conventions (:domain/action), feature-test assertions on log entries.
multimethod-seams Decouple a Clojure package with multimethods: core as interface, convention-require impls, no lying defaults, split substitution sets.
refactor Refactoring lessons. Extract method/namespace, rename, magic-number-to-constant, the discipline of rewiring callers immediately.
smells Code smells. Dead code, unused bindings, duplication, magic numbers, long parameter lists, god namespaces, sleeping in tests, testing smells.
tdd Test-Driven Development for Clojure. Red-Green-Refactor, the Three Laws, Arrange-Act-Assert with Speclj.
hardening Project quality bars (coverage, later crap/mutation/duplication). Thresholds from .hardening.edn; skill holds defaults only.

For toolbox managed projects, add to your boot file:

- [tdd](https://raw.githubusercontent.com/slagyr/agent-lib/main/skills/tdd/SKILL.md)
- [c3kit-schema](https://raw.githubusercontent.com/slagyr/agent-lib/main/skills/c3kit-schema/SKILL.md)

Available Commands

Command Description
plan Planning mode using the beans issue tracker. Gathers context, discusses requirements, and creates beans.
plan-with-features Extends /plan with a feature-first workflow using Gherkin and gherclj.
todo Convert TODO comments in the code into beans.
work Pick up the next ready bean and work on it.
verify Review beans tagged unverified by workers. Runs tests, checks acceptance criteria, removes the tag or reopens.
harden After verify: enforce .hardening.edn quality steps (coverage by default). Optional orchestration stage.

For toolbox managed projects, add to your boot file:

- [plan](https://raw.githubusercontent.com/slagyr/agent-lib/main/commands/plan.md)
- [plan-with-features](https://raw.githubusercontent.com/slagyr/agent-lib/main/commands/plan-with-features.md)
- [todo](https://raw.githubusercontent.com/slagyr/agent-lib/main/commands/todo.md)
- [work](https://raw.githubusercontent.com/slagyr/agent-lib/main/commands/work.md)
- [verify](https://raw.githubusercontent.com/slagyr/agent-lib/main/commands/verify.md)

Contributors

slagyr

Issues