Forward-Deployed Engineering

SkillCloud & infra

Guide embedded technical engagements from ambiguous stakeholder need through discovery, framing, hypothesis, build, evaluation, deployment, adoption, measurement, and generalization while preserving evidence, decision rights, and field learning. Use when one accountable technical lead must carry continuity across customer or stakeholder discovery, implementation, production fit, adoption, and measurable outcomes. Do not use for a bounded repository change, product investment governance, ongoing reliability or platform ownership, an isolated specialist task, or advisory work that ends before implementation and adoption.

Available today. Use it from your connected AI after setup.

Connect ahel once, and every AI you use reads what you have installed.

Then ask your AI: use the Forward-Deployed Engineering skill

What this skill tells your AI

The instructions your AI receives, as published by magnus919/agent-skills in forward-deployed-engineering/SKILL.md and read by ahel’s review.

Use this bundle when the work is an embedded technical engagement whose success depends on continuity, not merely a recommendation or a code change. This is a normative operating model synthesized from the role observations in source-index.md and from routed specialist methods; the nine-stage sequence is not an externally standardized methodology.

Lifecycle

Discover → Frame → Hypothesize → Build → Evaluate → Deploy → Adopt → Measure → Generalize

StageRequired questionMinimum outputStop condition
DiscoverWhat user workflow and problem are real?Stakeholder/workflow map and unknownsNo recognizable problem or access to the relevant workflow
FrameWhat is in scope, who decides, and what outcome matters?Engagement charter and assumptions/decisions/risks ledgerAuthority, constraints, or outcome cannot be named
HypothesizeWhat smallest intervention could change the workflow?Testable hypothesis and decision ruleNo falsifiable hypothesis or unsafe test
BuildWhat operationally complete slice can be built?Thin-slice implementation plan and ownerDependencies or permissions are infeasible
EvaluateWhat evidence supports quality, safety, and usefulness?Evaluation and release decisionBaseline, representative evidence, or risk constraints missing
DeployCan it be released, recovered, and verified in the authorized environment?Readiness, rollout, rollback, and verification recordNo authorized access, rollback, or release decision
AdoptDo intended users activate and use it in the target workflow?Adoption scorecard and intervention recordAdoption failure is unexplained or ownership/support is absent
MeasureDid the capability change the agreed outcome?Outcome measurement recordInstrumentation cannot distinguish expected from observed
GeneralizeWhat should happen to the local learning?Productization record and field-learning recordNo evidence or receiving owner for the proposed next step

At every stage, read the current charter, workflow map, and ledger and add evidence rather than re-deriving prior decisions. Maintain one engagement charter, one stakeholder/workflow map, and one assumptions-decisions-risks ledger. Each stage records entry evidence, the artifact produced, the accountable decision maker, unresolved unknowns, and the next handoff. Never silently turn an observation into a requirement, a prototype into a production claim, or a local success into a reusable product capability. For the expected depth and evidence labeling of these artifacts, see the worked example engagement.

Where to enter the lifecycle

Enter at the stage that matches what already exists. Do not restart earlier stages unless the current charter's stop conditions require it.

What you already haveEnter at
A stakeholder request or observed workflow opportunity, no validated problemDiscover
Validated problem and stakeholders, no charterFrame (establish the charter first)
Charter, workflow map, and ledger; no approved requirementHypothesize
Approved requirement; thin slice in progressBuild
Built and tested slice; no release decisionEvaluate
Released within the authorized boundaryAdopt
Adopted and measuring against the decision ruleMeasure
Post-launch evidence and a generalization questionGeneralize
A well-specified bounded change with no continuity needRoute to neckbeard instead

Before acting at any entry point, review the current charter, workflow map, ledger, and preceding stage-handoff record as entry evidence.

Loading protocol

  1. Establish the charter before solution design: problem, users, workflow, outcome, scope, authority, constraints, success measure, and stop conditions.
  2. Load lifecycle and artifacts and update the shared ledger after every stage.
  3. Treat the stage skills in manifest.yaml as candidates. Apply the route-selection conditions, load one primary specialist, and follow its method rather than copying it into this bundle.
  4. Before action in a constrained or sensitive environment, load authority and escalation and route access, security, privacy, irreversible, cost, and external-commitment decisions to their authorized owner.
  5. Before calling applied AI or any risky capability production-ready, load agent-evals-and-observability and production-readiness, and require baseline, representative and adversarial evidence, constraints, and a release decision.
  6. Treat adoption and measured workflow impact as completion conditions, not postscript communications. Use adoption and measurement.
  7. Apply the classification rules in generalization and productization, then close with the productization record. Classify local work as configuration, reusable pattern, product capability, transfer/replacement, or retirement, with evidence and an owner.
  8. Treat artifacts as private by default and apply the external-sharing gate before they leave the authorized engagement context.

Load only the primary specialist for the active stage. Add a secondary specialist only for a named blocker, risk, or handoff; do not preload every skill in the manifest. If one specialist fully owns the request, stop routing and hand the task to that specialist instead of running the FDE lifecycle.

Epistemic and communication contract

Label each material statement as one of: source fact, engagement observation, inference, recommendation, decision, or commitment. Use the communication reference for concise status and escalation updates. The discovery brief records the overlap audit and source limitations.

Completion and stop rules

The engagement is complete only when the capability is technically verified, deployed within the authorized boundary, adopted by the intended workflow, measured against an agreed outcome, and its learning has a generalization decision. A prototype, demo, or stakeholder approval alone is not completion.

Stop and preserve the ledger when the problem cannot be articulated, authority or access is missing, evidence fails, adoption remains unexplained or below the decision rule, or the next action exceeds the charter. Escalate rather than guess on security, privacy, irreversible changes, material cost, external commitments, or business authority. Route a well-specified repository bug directly to neckbeard and the relevant specialist instead of invoking this lifecycle.

When not to use

ScenarioReach forWhy
Well-bounded repository changeneckbeardOwns intake through verified PR and authorized release for a bounded change
Product investment, portfolio, or lifecycle governanceproduct-lifecycleOwns investment and lifecycle governance, not delivery continuity
Ongoing reliability ownership (SLOs, alerts, incidents)site-reliability-engineeringStanding operational ownership, not an embedded engagement
Internal platform design or operationplatform-engineeringPlatform ownership, not customer delivery
One discipline fully owns the taskThat specialist directlyFDE stops routing when one specialist owns the request
Advisory analysis ending before implementation and adoptionThe relevant architecture or decision specialistFDE completion requires adoption and outcome continuity

File map

PathLoad when
references/discovery-brief.mdReviewing the boundary, overlap audit, or evidence basis
references/source-index.mdChecking an externally verifiable role claim or refresh date
references/lifecycle-and-artifacts.mdStarting or handing off any lifecycle stage
references/route-selection.mdSelecting one stage specialist without violating its entry boundary
references/authority-and-escalation.mdWorking under access, security, privacy, cost, or authority constraints
references/adoption-and-measurement.mdEvaluating activation, workflow adoption, and measurable impact
references/generalization-and-productization.mdDeciding what field work becomes or does not become reusable
references/communication.mdWriting status, decision, escalation, or handoff communication
references/worked-example-engagement.mdCalibrating expected artifact depth or evidence labeling at any stage
templates/Creating the charter, workflow map, ledger, stage handoff, engagement status, evaluation and release decision, adoption scorecard, outcome measurement record, productization record, or field learning record
manifest.yamlReading machine-readable stages, routes, outputs, and conflicts

Signals

GitHub stars
78
Forks
8
Last commit
Sep 2026
Advanced
Catalog kind
skill
Gateway key
forward-deployed-engineering
Source
github.com/magnus919/agent-skills