By veegee82
LDD — Gradient Descent for Agents. Thirteen discipline skills across four parameter spaces: inner (code, ∂L/∂code), refinement (deliverable, ∂L/∂output), outer (method, ∂L/∂method), CoT (reasoning chain, ∂L/∂thought). Plus four infrastructure skills: using-ldd dispatcher, opt-in architect-mode (L3/L4 greenfield design), bootstrap-userspace (host-portability across Claude Code / Desktop / Codex / Gemini CLI / ChatGPT), host-statusline (Claude-Code live loss monitor). Total 17 skills; measured Δloss_bundle = 0.561 (normalized mean across 11 measurement-eligible disciplines; target ≥ 0.30).
Based on adoption, maintenance, documentation, and repository signals. Not a security audit or endorsement.
Documented sugar for LDD[level=L3]: — runs the 5-phase design protocol (Constraints → Non-goals → 3 Candidates → Scoring+Dialectical → Deliverable) from skills/architect-mode/SKILL.md by setting the thinking level to L3 for the next task. Opt-in, not default. Accepts optional creativity argument — /ldd-architect [conservative|standard|inventive]. This command does NOT introduce a separate `mode` axis; it is equivalent to the user typing `LDD[level=L3]:` (or `LDD[level=L3, creativity=<value>]:`) on the next task.
Pre-grant, list, check, or revoke autonomy acks so architect-mode's `creativity=inventive` can fire in autonomous runs (loops, cron, remote agents) without a synchronous human ack. HMAC-signed, scoped to a task family, short-TTL by default.
Show the current LDD hyperparameter config — which layer each value comes from (bundle default / project file / session override / inline) with full provenance.
Explain why LDD just invoked the skill(s) it invoked — cite the trigger phrase from the user's message that matched the dispatch table.
Explicitly install or re-install the LDD plugin's project-local artifacts (.ldd/ldd_trace launcher, statusline, heartbeat + stop-render hooks, settings merge). Idempotent; version-gated; safe to re-run. Required once per project as the opt-in step — unless one of the auto-opt-in signals (plugin self-identification, user-global flag) already fires; afterwards the plugin's SessionStart hook maintains everything automatically on every session start and every plugin update.
Apply after any non-trivial implementation task — evaluates whether an ADR is warranted, writes to Atelier-ADR repo when yes, names the skip reason when no, and generates E2E tests for every new structural invariant so LDD has a loss signal. High bar: most tasks produce no ADR.
The 5-phase design protocol that is active at thinking-levels L3 and L4. NOT a separate mode — it is the discipline the level preset pulls in. Opt-in via four paths — inline `LDD[level=L3]:` (or `LDD[level=L4]:`) prefix, the `/ldd-architect` command, trigger phrases like "design" / "architect" / "from scratch" / "greenfield", or the thinking-levels auto-dispatch landing at L3 / L4 (9-signal scorer; see `../using-ldd/SKILL.md` § Auto-dispatch: thinking-levels). Supports three creativity levels (`conservative` | `standard` | `inventive`) that change the loss function, not the amount of structure.
Use at the start of any LDD task when there is no existing `.ldd/trace.log` readable in the working directory — fires before any other LDD skill writes trace state. Detects the host's persistence capabilities (filesystem, artifact/canvas, conversation-history, memory-pointer, inline-only), picks the most durable tier silently without prompting the user, restores any prior trace state it finds, and announces the chosen store in the LDD trace block's `Store :` header line. Makes LDD portable across Claude Code, Claude Desktop, Codex, Gemini CLI, Cursor, ChatGPT, and any other host the LLM can introspect.
Use when the agent or the user wants to introduce a new measurable quantity as a first-class loss component — e.g., tracking cyclomatic complexity alongside test_pass_rate, or adding a domain-specific rubric to a reasoning chain. Forbids ad-hoc arithmetic on observations and forbids using a new metric as a load-bearing decision gate until calibration has passed. Extends LDD's loss framework to agent-defined objectives without touching LDD core.
Use when a reasoning task requires a multi-step Chain-of-Thought (CoT) AND the task is verifiable (grounded answer, testable code, derivable proof). Forbids greedy step-by-step commitment — every step in the chain goes through thesis/antithesis/synthesis BEFORE entering the chain, using memory-primed antitheses to attack the proposed step. Produces a calibrated predicted-correctness per step and per chain. Applies SGD-on-thoughts in the same way `dialectical-reasoning` applies SGD-on-actions.
⚡ New here? Read the 60-second Gist — six-file overview: pitch, install, trigger phrases, philosophy, evidence. Shareable single URL.
LDD is gradient descent for coding agents. Thirteen discipline skills on four parameter spaces — code (
θ), deliverable (y), method (m), reasoning chain (t) — plus four infrastructure skills (entry-point, opt-in architect-mode, host-portability bootstrap, Claude-Code statusline). Total 17 skills, portable across Claude Code · Codex · Gemini CLI · Aider · Cursor · Copilot CLI · Continue.dev, that turn "the test is green, ship it" into a measured optimization procedure with a loss function, a gradient, a step-size rule, and a regularizer.
Imagine a climber on a cloud-shrouded mountain. The summit is L = 0 (no rubric violations). She can't see the top, only her altimeter, the local slope, her log book of past steps, and a fellow climber asking hostile questions about her next move. LDD encodes those four instruments — measure before every step (inner loop), probe the slope from a hostile angle (dialectical-reasoning), consult the log book for patterns (project memory), calibrate predictions against observations (drift-detection) — and extends them across the four gradients the agent actually works on: code, output, method, and thought. The full theory — metaphor, four-axis architecture, formulas — lives in docs/theory.md.
/plugin marketplace add https://github.com/veegee82/loss-driven-development.git
/plugin install loss-driven-development@loss-driven-development
On first SessionStart the plugin's install hook sets up .ldd/ and the statusline + heartbeat hooks for the current project. Three opt-in paths are honored (any one suffices): .ldd/ already present, the project IS the LDD plugin's own source repo (self-identified via .claude-plugin/plugin.json), or the user turned on a global auto-opt-in (LDD_AUTO_OPTIN=1 or "ldd": {"auto_install": true} in ~/.claude/settings.json). For everything else the explicit /ldd-install command still works — see commands/ldd-install.md.
Then prefix any message with LDD: — the agent announces which skill it's invoking:
Invoking
root-cause-by-layer: symptom is aTypeError; walking the 5-layer ladder before the fix.
Full install for other agents (Codex · Gemini CLI · Aider · Cursor · …) below.
Before any of the four gradients starts descending, LDD picks how much rigor to bring to the task. Every non-trivial task is auto-scored onto a 5-step rigor ladder: L0 reflex (typo fix) → L1 diagnostic (failing test) → L2 deliberate (default baseline) → L3 structural (cross-layer / architect) → L4 method (greenfield / inventive). This is the learning-rate scheduler for the gradient descent, not a fifth loop — it decides depth-of-deliberation before the first forward pass. You don't configure anything — the scorer reads the task text, picks a level, announces it on one line:
Dispatched: L3/structural · creativity=standard (signals: greenfield=+3, components>=3=+2)
Override with one token when you disagree: LDD+: (one level up), LDD++: (two), LDD=max: (to L4), LDD[level=L1]: (explicit). Natural-language works too: "take your time", "denk gründlich", "volle Kanne". The scorer is upward-biased on boundaries — better a hair too careful than silently too shallow. Full spec: docs/ldd/thinking-levels.md.
Own this plugin?
Verify ownership to unlock analytics, metadata editing, and a verified badge. GitHub access is read-only (username + org membership).
Sign in to claimOwn this plugin?
Verify ownership to unlock analytics, metadata editing, and a verified badge. GitHub access is read-only (username + org membership).
Sign in to claimnpx claudepluginhub veegee82/loss-driven-development --plugin loss-driven-developmentComprehensive skill pack with 66 specialized skills for full-stack developers: 12 language experts (Python, TypeScript, Go, Rust, C++, Swift, Kotlin, C#, PHP, Java, SQL, JavaScript), 10 backend frameworks, 6 frontend/mobile, plus infrastructure, DevOps, security, and testing. Features progressive disclosure architecture for 50% faster loading.
Harness-native ECC operator layer - 67 agents, 271 skills, 92 legacy command shims, reusable hooks, rules, selective install profiles, and production-ready workflows for Claude Code, Codex, OpenCode, Cursor, and related agent harnesses
Core skills library for Claude Code: TDD, debugging, collaboration patterns, and proven techniques
Upstash Context7 MCP server for up-to-date documentation lookup. Pull version-specific documentation and code examples directly from source repositories into your LLM context.
Access thousands of AI prompts and skills directly in your AI coding assistant. Search prompts, discover skills, save your own, and improve prompts with AI.
Develop, test, build, and deploy Godot 4.x games with Claude Code. Includes GdUnit4 testing, web/desktop exports, CI/CD pipelines, and deployment to Vercel/GitHub Pages/itch.io.