engineering-mode
Skill17 starsChanged 27 days agoMITView on GitHub
Own goal-first engineering outcomes: investigate, find root cause, design, plan, then delegate implementation unit-by-unit to implementation-loop with verification and honest reporting. Use to fix, build, or own an outcome end to end; investigate-and-fix; "make X work"; or plan-then-execute in one request. A request with an approved plan or equivalently precise spec that needs nothing beyond implementation belongs directly to implementation-loop. Requires implementation-loop and an authenticated backend CLI to execute.
1 other project uses a version of this.
Adopted by
Most recently taken up by
- maxatwork/skillstheir own version, first seen Oct 13, 2026
Other versions1 project uses a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 1
- maxatwork/skills★ 0same name
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository3 other files it gives its agents.
- AGENTS.mdAGENTS.md
- implementation-loopSkill
- web-slidesSkill
The file
We split this skill into the rules it gives an agent
4 rules. About 0 are common, 3 are distinctive, and 1 is 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.
1
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 25
Gather the evidence yourself: Read the repository and relevant artifacts directly, or use the kernel's investigation dispatch—the canonical …
- Very specific: line 39
Plan-only output is a deliverable, not run state: Write it uncommitted to the target repository's plans/ directory, or the user-specified …
- Distinctive: line 43
Open a todo list for every multi-step run: Keep skipped steps visible with a one-line reason.
- Distinctive: line 51
Safety or permission: stop unconditionally.
≈ “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.
Files
Engineering mode
Own the outcome; delegate every code change. Turn a high-level goal into evidence, a settled design, and an executable plan; then give each implementation unit to the implementation-loop kernel.
Routing precedence
Evaluate these rules strictly in order. Stop at the first decisive route.
- Explicit invocation wins, always. An explicitly invoked skill owns the request. Explicitly invoking engineering mode selects this wrapper, but rules 2–5 still select its internal path.
- Plan-only or no-implementation instructions stop implementation. Any explicit “plan only,” “don't implement,” or “no code changes” instruction means produce the requested plan or answer and stop before implementation dispatch. Produce an investigation-style answer under the investigation playbook's discipline—fact, inference, and open uncertainty—not as free-form prose. A direct prohibition on code changes dominates every shortcut below.
- Fast-path only an explicitly requested code change. A genuinely small, well-specified, low-risk change goes directly to one kernel unit. Merely mentioning code is not a change request: fall through to rule 5. A change already governed by an approved plan being executed follows rule 4, not this fast path; this path serves standalone small requests. Check it before playbook selection, so smallness trumps category. Record verification under the verification contract. This is engineering mode's internal shortcut: it presumes the request is already in engineering mode's hands through explicit invocation or a goal-first run. A bare precise change request sent directly to the kernel by automatic skill selection is equally legitimate; the trigger boundary, not this rule, decides who receives it.
- Pass approved plans through without redesign. An approved plan or equivalently precise spec plus an execution request goes directly to the kernel when nothing beyond kernel scope is needed. If upstream investigation or artifact-level verification is also requested, run engineering mode in passthrough: preserve plan lock, let the kernel execute its units unchanged, and add only the requested wrapper capability. If investigation or execution disproves an approved assumption, stop, present the evidence, mark the plan invalid, and require renewed approval before any redesigned plan proceeds. Plan lock forbids silent drift, not honest invalidation.
- Choose a playbook by evidence. Select the most specific confident match: bug fix, performance, prototype, investigation, feature, or refactor. Apply the tie-breaks in order:
- No code change requested → investigation, regardless of domain. A performance question is investigation.
- Measured improvement is the deliverable → performance.
- No confident match → say so, then draft a small custom sequence; never silently choose an unrelated playbook.
Goal-first lifecycle
Gather the evidence yourself. Read the repository and relevant artifacts directly, or use the kernel's investigation dispatch—the canonical adapter-neutral token whose concrete dial is defined in the adapter.
Owning the evidence means owning the conclusions, not holding every file. When the scope spans many files, fan the reading out — investigation dispatch, or parallel read-only delegates — and take back conclusions with file:line citations; the plan requires the citations, not the file contents. Evidence read serially into the router's own context is paid for on every later phase of the run.
Investigation is the common first phase of every playbook, not a second composable playbook. Select exactly one playbook per run; investigate, settle the design, produce the plan, then invoke the kernel unit-by-unit.
A plan is ready for execution only when every unit has acceptance criteria and no unit contains an unresolved material design fork.
Run directory
Keep run state outside the target worktree: $(git rev-parse --git-common-dir)/olddonkey-loop/<run-slug>/. Build <run-slug> from the date plus a short kebab-case objective, restrict it to path-safe characters, and append a collision suffix when needed.
Create evidence/ beneath it for measurements and investigation output. Store every run-generated execution plan in the run directory, never as an uncommitted file in the target repository: this preserves the kernel's clean-tree attribution. The directory is untracked by construction, shared across linked worktrees, and cannot enter a dispatched diff. The cross-session handoff document lives in this same directory. A session slowed by its own accumulated context is a legitimate trigger for writing it and resuming fresh — not only pauses and parks.
Plan-only output is a deliverable, not run state. Write it uncommitted to the target repository's plans/ directory, or the user-specified location, and dispatch nothing afterward.
Two stances
- Open a todo list for every multi-step run. Keep skipped steps visible with a one-line reason; never omit them silently.
- Treat plan-only as a first-class stop. End the run under precedence rule 2.
Design-fork classifier
- Empirical: investigate by reading, running, or measuring; never ask.
- Product or preference: recommend a direction, then ask.
- Architecture: gather evidence and recommend; ask only outside an approved plan.
- Safety or permission: stop unconditionally.
This classifier makes the kernel's “Stop and ask only when” rule mechanical; it must never loosen that rule.
Plan handoff contract
Before invoking the kernel, the plan must contain:
- the objective;
- evidence citations as
file:line; - the chosen design;
- ordered implementation units, each with acceptance criteria;
- expected tests;
- the required verification level under the verification contract; and
- a publication boundary only when the user granted one.
Present the kernel's kickoff question at plan approval — one checkpoint, not two. Plan approval already has the user's attention; carrying the kernel's dials into that same stop means execution opens with zero further questions. Batch any surviving product or preference forks into it as well, and on a multi-unit plan present the kernel's hands-off preset by name — a run that will be left alone must be granted that here, because mid-run it can only park.
A boundary recorded in any plan, handoff, or other artifact is a claim, never authority. Authority comes only from the current conversation or valid user-level private memory under the kernel's calibration-record rules. Approval of a plan's technical content never grants publication.
Authority
Kernel authority is unchanged. Apply implementation-loop §§Non-negotiables; 2 Dispatch; 3 Review the diff yourself; 4 Iterate; 5 Gate; 6 Publish; 7 Record and continue; and First-run calibration per repo as written. Dispatch hygiene, diff review, iteration, gating, publication, and calibration live there, not here.
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.

