compound-lite

Captures engineering learnings into docs/solutions notes after non-trivial work.

1|Updated Aug 27, 2025
One-click install
npx skills add https://github.com/IgorGanapolsky/Random-Timer --skill compound-lite-igorganapolsky
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: compound-lite
Source: https://github.com/IgorGanapolsky/Random-Timer/tree/main/.cursor/skills/compound-lite
Command: npx skills add https://github.com/IgorGanapolsky/Random-Timer --skill compound-lite-igorganapolsky

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Teams repeat the same mistakes because lessons from finished work are never written down. This Skill turns completed PRs and repeated corrections into durable, searchable solution notes that future agents and engineers can read. ## Core Features & Use Cases - Solution Note Creation: Copies the templates/compound/SOLUTION.md template into docs/solutions/<slug>.md and fills in Problem, What worked, Prevention, and Evidence sections. - Gate Verification: Runs scripts/compound_gate.py with --json --slug to confirm the note passes the readiness gate before claiming the learning is compounded. - Prevention Encoding: Converts lessons into gates, skills, or AGENTS.md / CLAUDE.md bullets so the same correction never appears twice. - Use Case: After merging a non-trivial bug fix, generate a docs/solutions note, verify it with the compound gate script, and commit it alongside the fix PR. ## Quick Start After finishing this PR, write a compound solution note in docs/solutions and verify it with the compound gate script.

Frequently Asked Questions about compound-lite

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I document engineering learnings after finishing a PR?▼

Copy the templates/compound/SOLUTION.md template into docs/solutions/<slug>.md and fill in the Problem, What worked, Prevention, and Evidence sections. Then verify the note with python3 scripts/compound_gate.py --json --slug <slug> until it returns ready=true.

What is Compound Engineering vs Superpowers or GSD?▼

Compound Engineering sits on top of Superpowers or OpenGSD rather than replacing their checkpoints. Its durable idea is the fourth step: writing down what you learned so the next agent or engineer can read it.

When should I write a solution note?▼

Write one after merging or finishing non-trivial work, or when the same correction appears twice. Committing the note alongside the fix PR keeps the learning tied to the change.

Should I install the full EveryInc Compound Engineering plugin?▼

No, do not install the full 33-skill plugin unless explicitly requested. The lite workflow covers the core practice of writing gated solution notes without the token cost of parallel reviewer farms on every commit.

Why does the compound gate script report ready=false?▼

The gate fails when the solution note contains placeholders or is missing required sections like Problem, Prevention, or Evidence. Fill every section with concrete content and re-run the script with the same slug.