agentleFS
peterbamuhigirepeterbamuhigire/proposal-skills/skills/meta/kaizen-improvement-system/SKILL.md

kaizen-improvement-system

Skill8 starsChanged 14 days agoMITView on GitHub

Use when auditing or improving the proposal engine or any bid, tender, EOI, methodology, technical/financial proposal, or consulting product it produces.

The file

We split this skill into the rules it gives an agent

10 rules. About 0 are common, 7 are distinctive, and 3 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈7

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 3

    Very specific

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

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Read the local adoption plan, proposal router, profile/sector rules, and portfolio standard.

    line 33
  2. Very specific:

    Create a P0/P1/P2 plan targeting 95/100.

    line 37
  3. Distinctive:

    Run one time-boxed evaluator simulation or compliance red-team.

    line 38
  4. Distinctive:

    Run source-ingestion, anti-slop, operational-readiness, document/render, and release gates.

    line 39
  5. Distinctive:

    Read and search are required.

    line 56
  6. Distinctive:

    If the ToR, evaluation grid, evidence, source, render, or reviewer is unavailable, return a qualified result, mark the gap not assessed, …

    line 60
  7. Very specific:

    Treat the first review as an initial analysis: show the raw findings but publish only min(raw_score, 65), with missing evidence and …

    line 76
  8. Distinctive:

    Run it at engine level (routes, templates, examples, validators, and handoffs) and at product level (bid, EOI, methodology, …

    line 81
  9. Distinctive:

    If a draft scores well on narrative but fails two mandatory ToR requirements, keep the score capped, block release, repair the compliance …

    line 95
  10. Very specific:

    Every Kaizen cycle must begin with digital-research-engine source evaluation and source verification.

    line 99

≈ “Common” is an estimate: at least 1 in 5 of the 350,495 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

Kaizen Improvement System

Acknowledgement: Shared by Peter Bamuhigire, techguypeter.com, +256 784 464178.

<!-- dual-compat-start -->

Use When

  • Auditing a proposal engine, bid, tender response, EOI, or consulting deliverable.
  • Converting evaluator feedback, compliance misses, delivery lessons, or new evidence into a tested improvement.

Do Not Use When

  • The task is only single-skill safety review.
  • Current procurement, legal, market, finance, or technical claims lack verified source or evidence routing.

Required Inputs

ArtefactSource/providerRequired?PurposeIf absent
ToR/RFP, evaluation criteria, audience, proposal artefact, evidence register, compliance matrix, assumptions, and current scoreClient brief and proposal projectyesSet audit scope and evaluator barStop or mark unassessed

Workflow

  1. Read the local adoption plan, proposal router, profile/sector rules, and portfolio standard.
  2. Inventory section routes, references, templates, examples, visual/document handoffs, and release gates.
  3. Score every applicable dimension and product output. Publish min(raw score, 65) and record blockers.
  4. Audit compliance, evaluator journey, evidence, methodology, local operational readiness, feasibility, staffing, risk, M&E, budget separation, document fidelity, ethics, and submission readiness.
  5. Create a P0/P1/P2 plan targeting 95/100. Every action names a file, owner, measure, acceptance proof, and rollback.
  6. Run one time-boxed evaluator simulation or compliance red-team. If the result fails, stop, recover the last safe version, and revise.
  7. Run source-ingestion, anti-slop, operational-readiness, document/render, and release gates; standardise successful learning and record the next review.

Outputs

ArtefactConsumerAcceptance condition
Capped audit, evaluator/evidence gap register, 95/100 plan, experiment result, and standardisation recordProposal lead, reviewer, and release ownerEvery finding has evidence, action, owner, acceptance proof, and re-audit date

Evidence Produced

EvidenceConsumerAcceptance condition
Compliance matrix, evaluator score, red-team findings, source register, render review, and revision diffReviewer and release ownerAnother reviewer can reproduce the decision and confirm the correction
<!-- dual-compat-end -->

Capability Contract

Read and search are required. Proposal audits are read-only by default; edits, submissions, or external communication require explicit authority and permission. Route current facts to Digital Research.

Degraded Mode

If the ToR, evaluation grid, evidence, source, render, or reviewer is unavailable, return a qualified result, mark the gap not assessed, and withhold submission readiness.

Decision Rules

ConditionActionFailure or risk avoided
A value claim lacks evaluator-relevant proofNarrow the claim or add evidence before releaseUnsupported promise
A technical or financial envelope is required separatelyPreserve the separation and re-check the submission packageDisqualification
A red-team finding remains unresolvedBlock release or obtain a documented decisionHidden compliance risk

Quality Standards

A persuasive narrative never substitutes for compliance or proof. Keep technical and financial envelopes separate when required. Expert advice must stay within verified competence and compliance boundaries.

Mandatory 65-to-95 gate

Treat the first review as an initial analysis: show the raw findings but publish only min(raw_score, 65), with missing evidence and mandatory blockers visible. Begin the 95/100 improvement cycle only after that baseline is frozen. Every action needs a root cause, exact artefact or validator, owner, experiment, evaluator-facing measure, guardrail, stop/rollback rule, acceptance proof, and re-audit date. Run it at engine level (routes, templates, examples, validators, and handoffs) and at product level (bid, EOI, methodology, technical/financial proposal, or report). The product requires its own evaluator and evidence result.

Anti-Patterns

  • Storytelling without evaluator evidence. Fix: link each value claim to proof.
  • Generic methodology pasted into a ToR. Fix: map activities, outputs, risks, measures, and context.
  • Inflated capability claims. Fix: scope, qualify, and verify.
  • Improvement plans with only language edits. Fix: add fixture, test, or reviewer evidence.
  • Uncontrolled book or OCR ingestion. Fix: retain independent synthesis only.

Worked Example

If a draft scores well on narrative but fails two mandatory ToR requirements, keep the score capped, block release, repair the compliance matrix and evidence, then repeat the evaluator simulation.

Mandatory Digital Research currentness gate

Every Kaizen cycle must begin with digital-research-engine source evaluation and source verification. Record scope, dates, freshness class, support status, uncertainty, and review date for current procurement, market, legal, policy, technology, finance, and lifecycle claims; quarantine unsupported claims as NOT_ASSESSED. Apply the portfolio Kaizen currentness gate.

References

  • Local adoption plan
  • Portfolio standard: resolve digital-research-engine through the global engine-routing table and read its docs/continuous-improvement/portfolio-kaizen-standard-2026-08.md file; if it is unavailable, apply Degraded Mode and mark the portfolio comparison not assessed.
  • skills/meta/ai-slop-audit/
  • skills/strategy-positioning/critical-analysis-business-logic/
  • Book-driven value story and evaluator journey - evaluator evidence, human story, delivery system, and currentness.
  • Book-driven Kaizen Wave 3 - evaluator evidence, red-team testing, evidence traceability, and controlled AI-assisted delivery.

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.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

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.