Start with the decision
A feature request is not a problem statement. Identify who decides what, using which evidence, under what deadline, and at what cost if wrong.
A concise operating reference for turning technical capability into adopted, measurable outcomes.
These principles apply across forward deployed engineering, production AI, solutions engineering, consulting, and implementation.
A feature request is not a problem statement. Identify who decides what, using which evidence, under what deadline, and at what cost if wrong.
Spreadsheets, chat messages, private scripts, and expert memory contain the real operating logic. Treat them as evidence, not embarrassment.
Label what is observed, calculated, assumed, predicted, and recommended. Trust collapses when these categories blur.
Narrow the scope, not the completeness. A slice still needs data, logic, interface, permissions, support, and a measurable decision.
Stale data, missing identity, model uncertainty, integration failure, and user disagreement need visible behavior—not silent fallback.
Human review must have clear inputs, time, expertise, escalation, and accountability. A button labeled approve is not a control system.
Trust, incentives, workflow fit, training, ownership, and exceptions shape real performance as much as code.
Measure whether people use the intervention, where they override it, how work changes, and whether the intended outcome moves.
Software will make ambiguity faster and harder to see. Resolve ownership and decision rules before encoding them.
Architecture diagrams, runbooks, data contracts, and decision records should let someone else operate and change the system safely.
A rollback plan includes data, workflow, communications, ownership, and reconciliation—not only a previous container image.
A positive pilot is evidence, not proof. Know what created the result, what conditions it depends on, and what changes at scale.
The templates are intentionally short. Their job is to expose weak reasoning and preserve decisions, not generate documentation volume.
Capture the decision, workflow, stakeholders, baseline, assumptions, constraints, evidence, and open questions.
Show the actor, trigger, inputs, decision rule, action, feedback, and downstream consequence.
Document source, owner, freshness, identifiers, validity rules, access, lineage, and failure behavior.
State how the intervention changes the decision, why it should work, and what must be validated.
Connect each failure mode to prevention, detection, response, owner, and evidence.
Define users, scope, duration, training, support, metrics, gates, rollback, and decision authority.
Explain normal operation, alerts, exceptions, escalation, recovery, ownership, and changes.
Compare baseline and observed outcomes, adoption, costs, confounders, and the scale/revise/stop recommendation.
Choose one live project. Complete the discovery record before redesigning the solution. Revisit the decision map at every scope change. Use the value proof to decide whether the intervention deserves more investment.
Atlas Freight provides a complete task sequence and staged complication.