agentleFS
liza-masliza-mas/liza/skills/lean-thinking/SKILL.md

lean-thinking

Skill409 starsChanged 34 days agoApache-2.0View on GitHub

Inventory wastes (useless, redundant) and frictions (errors, excess complexity, contention) in any flow — process, workflow, agent system, docs, or code — measured against what its consumer values.

We split this skill into the rules it gives an agent

2 rules. About 0 are common, 1 is distinctive, and 1 is very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈1

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 1

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Multi-agent runs: read references/mas-run.md for evidence sources, repair-action metrics, and measurement pitfalls.

    line 75
  2. Very specific:

    Unknown purpose ≠ useless: If the purpose cannot be established, report it as CANDIDATE and ask the owner.

    line 83

≈ “Common” is an estimate: at least 1 in 5 of the 308,232 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Everything a flow does either delivers what its consumer values, enables that delivery, or is waste. Everything that makes delivery harder than it needs to be is friction. Name both with evidence; the owner decides what to change.

Distinct From

SkillIts lensThis skill's lens
code-quality-assessment, clean-codeCode smells, maintainabilityCost to the flow, not to the code
systemic-thinkingCoherence, fragility, future riskPresent cost of how work moves
context-engineeringPrompt payload fitWhole-flow effort, time, rework
have-you-consideredAlternative approachesWhat to stop, merge, or unblock

Code-level issues are in scope only when they cost the flow (rework, waiting, relearning) — report that cost, not the smell.

Workflow

1. FRAME THE VALUE STREAM
   - Consumer: who receives the output? (end user, next stage, reviewer, agent)
   - Value: what would they notice missing? If unclear → ask. Without it, "useless" is undefined.
   - Map trigger → delivered value: steps, handoffs, queues, artifacts, loops.
   - Mark each step: value-adding | enabling (verification, safety, compliance) | candidate waste.
   - Gather evidence: artifacts, logs, git history, timings, retries. Measure where possible
     (lead time vs touch time, rework loops, queue durations). Observe the running system
     (live state, what actors actually do), not only its declared configuration.

2. SWEEP EVERY CATEGORY (below) — full inventory, no early stop.

3. LOAD-BEARING CHECK each candidate (below).

4. RANK by avoidable cost over a stated horizon: frequency × unit cost (time, tokens, rework,
   cognitive load, consumed irreversible inputs), including what it causes downstream. Sunk
   cost does not rank. Compare in one unit where conversion is defensible; otherwise rank
   within each unit and state the judgement that orders them. Mark each cost measured or
   estimated. Findings that feed each other (e.g. retries saturating the lock that blocks
   recovery) rank once, as a loop.

Categories

Waste — useless or redundant work (muda)

CategoryQuestionSignals
UnusedProduced but never (or not yet) consumed?Dead code, unread docs, outputs no stage reads, config that never varies, speculative features
RedundantSame value produced or held twice?Duplicated logic, restated rules, parallel mechanisms, copies kept in sync by hand
Over-processingMore effort than the consumer needs?Ceremony disproportionate to risk, re-validation of unchanged state, excess precision
InventoryPartially done work waiting?Stale branches, unmerged work, parked tasks, backlog rot, high WIP
WaitingTime where nothing advances?Queues, approval latency, idle actors, blocked tasks, slow feedback loops, status that hides the wait (stuck work shown as ready or idle)
HandoffsContext lost when work changes hands?Re-explanation, lossy summaries, knowledge in chat instead of artifacts
RelearningKnowledge rediscovered instead of retained?Repeated investigations, same question asked twice, uncaptured lessons
SwitchingEffort spent navigating instead of doing?Task switching, hunting for information, tool juggling

Friction — what makes delivery harder

CategoryQuestionSignals
DefectsWhere is output redone?Rejections, reverts, retries, flaky checks, fix-the-fix loops, late detection (caught far downstream of where introduced), masked failures (reported as success, fail-open checks)
Complexity / overburden (muri)What demands exceed capacity, or is harder than the problem requires?Accidental complexity, special cases, large config surface, context exhaustion, steps a newcomer cannot follow
Unevenness (mura)Where does flow lurch?Batch-and-burst, uneven task sizing, spiky load, inconsistent conventions
ContentionWhere do actors compete for a shared resource?Locks, single reviewer or bottleneck role, merge conflicts, shared state, rate limits

A step can carry several findings; report each under the category that best explains its cost.

Agent systems: tokens are usually the dominant unit cost. Measure them per delivered output (e.g. per accepted task) and per step, then file heavy consumers under the category that explains them: unchanged context re-read or re-injected → Redundant; re-exploring what an earlier agent found → Relearning; retries and rejected rounds → Defects; polling or idle sessions → Waiting; oversized prompts → Complexity / overburden.

Multi-agent runs: read references/mas-run.md for evidence sources, repair-action metrics, and measurement pitfalls.

Load-Bearing Check

Apparent waste is often protection. Before a candidate becomes a finding:

  • Purpose: What does it guard against? Redundancy may be defense in depth; waiting may be a deliberate gate; ceremony may be the mechanism holding trust.
  • Coupling: What else was justified by pointing at it? Removing it may void that justification.
  • Unknown purpose ≠ useless. If the purpose cannot be established, report it as CANDIDATE and ask the owner.
  • Enabling work is not waste — its excess may be.
  • Protection still has a running cost. A load-bearing mechanism stays, but each time it fires, and each repair it forces afterwards, is friction: report it and target what trips it.

Output Format

Markdown renders consecutive lines as one paragraph: keep each field a list item.

## Value Stream
- **Consumer:** … — **Value:** …
- **Flow:** step → step → …
- **Lead time / touch time:** … (if measurable)

## Findings (ranked by cost)

### W-n | F-n  [Category] — title
- **Evidence:** <location, metric, log excerpt> [measured | estimated]
- **Cost:** <what it costs, how often, over what horizon> [avoidable | sunk]
- **Detection:** <step that caught it> (introduced at <step>) — defects only
- **Loop:** <W-n ↔ F-n> — only when findings feed each other
- **Load-bearing:** <what it protects and why it is still waste> | CANDIDATE — <open question for owner>
- **Countermeasure (hypothesis):** <option> — expect <metric change>; disproved if <observation>
- **Displacement:** <where the cost would move if removed>

## Coverage
- **Swept, no finding:** <categories>
- **Insufficient evidence:** <category — what could not be observed>

Anti-Patterns

FORBIDDEN:

  • Waste without a consumer — calling something useless without naming who does not value it
  • Fence removal — labelling redundancy waste without the load-bearing check
  • Smell hunting — style or code-quality issues with no demonstrated flow cost
  • Manufactured findings — filling categories to look thorough; an empty category is a valid result
  • Local optimization — a countermeasure that moves the cost to another step without saying so
  • Asserted ranking — ordering by perceived importance instead of evidenced cost

ALLOWED:

  • Concluding the flow is already lean
  • Finding that the waste is in the value definition itself (building what no consumer needs)

Integration

Standalone, invoked explicitly on any flow. Complements have-you-considered (alternatives for a found waste) and systemic-thinking (risk the countermeasures might introduce).

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

Reviews can't be read right now.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.