gardener
Turn repeated agent mistakes or user corrections into an enforceable improvement to the engineering workflow. Use when the same correction recurs, a rule keeps being missed, or the user asks to improve Paved.
- License 许可
- MIT
- 最近更新
- 2026-11-14
- Stars
- ★ 1
- Forks
- 0
01 前言 Front Matter
- name
- gardener
- description
- Turn repeated agent mistakes or user corrections into an enforceable improvement to the engineering workflow. Use when the same correction recurs, a rule keeps being missed, or the user asks to improve Paved.
02 资源文件 1
- 参考文档references/enforcement-layers.md3.4 KB
03 SKILL.md 正文
<!-- Generated by Paved plugin paved@2.29.0 from core.gardener.gardener@0.4.0; edit Paved Core instead. -->
Gardener
When to use
- A human corrects the same kind of agent mistake a second time.
- A rule is repeatedly violated, overridden or disputed.
- A skill or context document keeps leading agents astray.
- Someone asks to improve rules, skills or verification.
Required context
The concrete incidents: what the agent did, what the correction was, where it happened. Without at least two concrete incidents, record the observation and stop.
paved gardener lists the incidents Paved already records: failed checks, violated rules,
missing verification, generator conflicts and human corrections (a plan a person
rejected, blocking review findings a person sent back to implementation, and the rules
those findings cited). It reads structured records only, never chat transcripts or
source code.
Preconditions
- The pattern is recurring, not a one-off.
- The correct behavior is agreed with a human.
Procedure
- Collect the incidents: task, mistake, correction, files involved.
- Name the pattern in one sentence ("agents add a second HTTP client instead of using the existing one").
- Find the root cause in the path: missing context, missing rule, weak enforcement, misleading skill, or an architecture that makes the mistake easy.
- Choose the layer, trying each in order and stopping at the first that works (see references/enforcement-layers.md): architecture, static analysis, CI, rule, skill, documentation. A rule enforced only by the agent or a reviewer that keeps being violated or corrected is a promotion candidate.
- Choose the owner: Core (true for every repository), an adapter (true for a technology), or the project (true here). Most fixes belong to the project.
- Write a proposal: pattern, incidents, layer, owner, concrete change, and how to verify that it prevents the mistake. A proposal that adds a check or a structural change states that it must first be shown failing on a fixture reproducing one of the recorded mistakes, and passing once that mistake is corrected.
- Hand the proposal to a human. Do not apply changes to rules, skills, Core or project architecture on your own.
Tools
core.repository.diff to cite the incidents precisely.
Rules
core.quality.unknowns-stay-unknown: a proposal cites incidents, not impressions.
Verification
None is required of the proposal itself. A good proposal includes a check or test that would have caught the original incidents.
Evidence
A review artifact containing the proposal and the incidents it is based on.
Completion criteria
- The proposal names the pattern, incidents, layer, owner and verification.
- A proposed check or structural change names the recorded mistake it must fail on before adoption.
- A stronger layer was considered and rejected with a reason before settling on a weaker one.
Failure modes
| Failure | Signal | Response |
|---|---|---|
| Documentation by default | Proposal adds prose where a check is possible | Go back to step 4 |
| Unproven check | The check was never seen failing on a recorded mistake | Reproduce the mistake in a fixture and show the check failing first |
| Project knowledge in Core | Proposal puts a project convention into the Core | Move it to the project |
| Rule inflation | Many narrow rules for one underlying issue | Fix the underlying design instead |
References
Paved integration
Use the project-local Paved contract as the source of truth. Discover state with node "${CLAUDE_PLUGIN_ROOT}/scripts/paved.mjs" status --json, load only relevant .paved/project/ context, and invoke verification with node "${CLAUDE_PLUGIN_ROOT}/scripts/paved.mjs" verify --json. Always run it from the repository being worked on, never from the plugin directory. Do not edit generated integration files or bypass Paved lifecycle and ownership checks.
04 同仓库更多 Skills
sample-skill
Does a sample task. Use when a sample is needed.
unexplained-contract
Does a sample task. Use when a sample is needed.
shell-block
Does a sample task. Use when a sample is needed.
project-identifier
Does a sample task. Use when a sample is needed.
oversized
Does a sample task. Use when a sample is needed.
no-activation
Does a sample task.