push-out
Skill88 starsChanged 3 days agoMITView on GitHub
Moves recurring DevOps and operational work out of individual memory, manual execution, ticket queues, and team-local practice into documented procedures, repo standards, shared platforms, self-service controls, and adaptive feedback loops. Use when reducing toil, designing an improvement roadmap, deciding what to standardize or automate, assessing where operational work currently lives, pruning prose documentation duplicated by code/config/tests/policy-as-code/architecture-as-code, or asking how to move work from humans into durable systems.
In this repository52 other files it gives its agents.
- CLAUDE.mdCLAUDE.md
- alchemy-orchestrateSkill
- alchemySkill
- architecture-as-code-javascriptSkill
- architecture-as-code-pythonSkill
- architecture-as-codeSkill
- architecture-guidelinesSkill
- bring-downSkill
- ci-cd-reliability-architectureSkill
- continuous-improvementSkill
- defect-shift-leftSkill
- dependency-lifecycleSkill
- evolutionary-database-designSkill
- functionality-complexity-tradeoffSkill
- gate-lifecycleSkill
- implementation-readinessSkill
- infrastructure-fitSkill
- morphogenetic-architectureSkill
- observability-designSkill
- push-outSkill
- requirements-groundingSkill
- requirements-topologySkill
- requirements-traceabilitySkill
- structural-simplificationSkill
- system-optimizationSkill
- test-strategySkill
- zero-copy-requirementsSkill
- alchemy-orchestrateSkill
- alchemySkill
- architecture-as-code-javascriptSkill
- architecture-as-code-pythonSkill
- architecture-as-codeSkill
- architecture-guidelinesSkill
- bring-downSkill
- ci-cd-reliability-architectureSkill
- continuous-improvementSkill
- defect-shift-leftSkill
- dependency-lifecycleSkill
- evolutionary-database-designSkill
- functionality-complexity-tradeoffSkill
- gate-lifecycleSkill
- implementation-readinessSkill
- infrastructure-fitSkill
- morphogenetic-architectureSkill
- observability-designSkill
- requirements-groundingSkill
- requirements-topologySkill
- requirements-traceabilitySkill
- structural-simplificationSkill
- system-optimizationSkill
- test-strategySkill
- zero-copy-requirementsSkill
The file
We split this skill into the rules it gives an agent
6 rules. About 0 are common, 3 are distinctive, and 3 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈3
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
- Distinctive: line 78
Do not push work to Rank 4 or 5 unless the lower-rank foundations exist or are created in the same change.
- Distinctive: line 90
Question necessity: Delete work that no longer serves a real purpose.
- Very specific: line 105
If many candidates compete, apply system-optimization to find the constraint before improving adjacent work.
- Distinctive: line 120
Documentation pruning pattern: when prose documentation repeats behavior, rules, setup, policy, or architecture that is already enforced or …
- Very specific: line 128
When the move concerns deployment safety, apply ci-cd-reliability-architecture.
- Very specific: line 129
When the move concerns check placement, apply defect-shift-left.
≈ “Common” is an estimate: at least 1 in 5 of the 372,429 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.
Files
Push-Out
Purpose: Move recurring operational burden outward from fragile human execution into durable system capability.
Improvement Trio
defect-shift-left: move defect detection earlier.push-out: move recurring operational work outward.bring-down: move bespoke code down into reusable capability.
Core Directives
- Push work, not responsibility. The owner remains accountable; the execution path moves into a more durable layer.
- Evidence before rank. Assign no push-out rank without observed proof.
- Delete before pushing. Remove unnecessary work before documenting, standardizing, automating, or platforming it.
- Standardize before automating. Automation over ad hoc practice industrializes confusion.
- Self-service needs guardrails. A platform without the guardrail set — policy, validation, permissions, audit, observability, and rollback — exports toil to users.
- Feedback closes the loop. Dashboards and metrics are not improvement until they trigger action.
- Executable sources beat prose duplicates. When code, config, tests, schemas, CI, policy-as-code, or architecture-as-code already define the operational truth, keep prose only for intent, ownership, rationale, external constraints, trade-offs, rollback notes, and links to that source.
1. Push-Out Ladder
The ladder names where recurring operational work currently lives.
| Rank | Location | Work lives in | Evidence |
| 0 | Individual memory | Heroics, tribal knowledge, manual clicks | "Ask Alice", no runbook, no repeatable input/output |
| 1 | Team procedure | Runbook, checklist, documented handoff | Another team member can repeat it manually |
| 2 | Repo standard | Template, script, CI job, policy, config convention | The repo enforces or strongly guides the path |
| 3 | Shared platform | Golden path, reusable workflow, managed internal primitive | Multiple repos/teams consume the same capability |
| 4 | Self-service control | Guardrailed workflow developers can run without ops handoff | Users trigger it safely; the guardrail set exists (Directive 5) |
| 5 | Adaptive system | Metrics and feedback change the system | Thresholds, reviews, or automation drive continuous improvement |
push-out distance = target rank - current rankHigher is not always better. Choose the target by frequency, risk, toil cost, blast radius, and number of dependent teams.
2. Target-Rank Heuristics
| Condition | Minimum target |
| Rare, low-risk internal task | Rank 1 |
| Repeated task inside one repo/team | Rank 2 |
| Repeated task across repos/teams | Rank 3 |
| Frequent developer-facing request or ticket queue | Rank 4 |
| High-volume, high-risk, regulated, or incident-prone path | Rank 5 |
Do not push work to Rank 4 or 5 unless the lower-rank foundations exist or are created in the same change.
3. Push-Out Protocol
- Define scope. Name the product, repo, platform, teams, environments, and time window.
- Inventory recurring work. Find manual steps, tickets, approvals, incident repeats, deploy chores, dashboard checks, and hand-maintained config.
- Question necessity. Delete work that no longer serves a real purpose.
- Locate current rank. Assign rank 0-5 with evidence.
- Choose target rank. Justify by frequency, risk, blast radius, compliance, toil cost, and dependency count.
- Compute distance. Target rank - current rank.
- Choose the next move. Emit one action that advances exactly one rank.
- Gate and retire. Prove the new path works, then remove same-scope manual duplicates.
Prioritize by:
priority = push-out distance x frequency x risk x blast radius x toil costIf many candidates compete, apply system-optimization to find the constraint
before improving adjacent work.
4. Move Patterns
| Move | Use when | Action |
| 0 to 1 | Knowledge is tribal | Write owner, inputs, outputs, runbook, rollback |
| 1 to 2 | A runbook repeats | Convert to script, template, CI job, config schema, or policy |
| 2 to 3 | Many repos copy the same practice | Extract shared workflow, platform primitive, or golden path |
| 3 to 4 | Platform team is still a ticket queue | Add self-service UI/API/CLI with the full guardrail set (Directive 5) |
| 4 to 5 | Self-service exists but does not improve | Add SLOs, trend review, alert thresholds, incident learning, and removal loop |
Documentation pruning pattern: when prose documentation repeats behavior, rules, setup, policy, or architecture that is already enforced or derivable from code, config, tests, schemas, generated output, CI, policy-as-code, or architecture-as-code, do not create a second source of truth. Verify the executable source covers the same scope, then replace the prose duplicate with the smallest useful note: why it exists, who owns it, where the executable source lives, and which external constraint or trade-off is not visible from the code.
When the move concerns deployment safety, apply ci-cd-reliability-architecture.
When the move concerns check placement, apply defect-shift-left. When the
move concerns duplicated custom implementation, apply bring-down. When the
question is which artifact owns the fact rather than whether prose duplicates
an executable source, apply zero-copy-requirements.
5. Anti-Patterns
| Anti-pattern | Correction |
| Automating an undocumented process | Document and standardize first |
| Platform team as ticket queue | Push to guardrailed self-service |
| Self-service without policy or rollback | Add the full guardrail set (Directive 5) |
| Dashboard called improvement | Define threshold, review cadence, and action |
| Tool adoption treated as maturity | Score the operational outcome, not the product installed |
| Golden path with no adoption signal | Measure usage, escape hatches, and support load |
| Manual approval called governance | Replace with policy-as-code where technically possible |
| Keeping manual duplicate forever | Retire same-scope duplicate after proof |
| Prose repeats an executable source of truth | Keep intent/rationale/ownership/link; delete the repeated mechanics |
6. Output Contract
Emit results in this shape:
Scope: <product/repo/platform/team/environment/time window>
Mode: Assessment | Improvement | Roadmap
Decision: Keep manual | Delete | Document (→1) | Standardize (→2) | Platformize (→3) | Self-service (→4) | Adaptive (→5)
Summary: <2-4 sentences: main toil source, best next push, key risk>
Verification: <metrics, logs, workflow search, runbook check, or Not run + reason>
Work map:
| Work item | Current rank | Target rank | Distance | Evidence | Decision | Confidence | Next action |
| --------- | ------------ | ----------- | -------- | -------- | -------- | ---------- | ----------- |
Priorities:
| Rank | Work item | Why now | Push-out move | Validation | Duplicate to retire |
| ---- | --------- | ------- | ------------- | ---------- | ------------------- |
Gaps:
<Missing evidence, unknown ownership, absent metrics, excluded work, or risks>7. See Also
defect-shift-left- move defect detection earlier.bring-down- move bespoke code down into reusable capability.system-optimization- bottleneck and waste analysis before improvement.ci-cd-reliability-architecture- pipeline safety and deployment reliability patterns.zero-copy-requirements- which artifact owns a fact, before pruning the duplicate.continuous-improvement- promotion of recurring findings into skills, checks, or templates.
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
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.

