The New Core Skill Is Not Coding. It Is Designing Evidence

Nan Wang

Hatched by Nan Wang

Aug 06, 2026

11 min read

92%

0

What if the most valuable person in an AI assisted workplace is not the person who can generate the most code, but the person who can prove that the code, answer, or decision deserves to be trusted?

That question becomes urgent as intelligent systems move from producing isolated snippets to operating across entire workflows. An agent can rewrite a query, search several databases, retrieve relevant passages, call a tool, generate an answer, inspect its own work, and revise the result. The visible output may look effortless. Beneath it lies a chain of fragile decisions.

This creates a strange reversal. As machines become better at producing first drafts, human value moves toward the invisible work surrounding those drafts: defining the problem, supplying the right context, designing the architecture, and verifying the result. The future belongs less to people who can make systems speak and more to people who can make systems accountable.

The real bottleneck is not generation

A language model can produce a plausible answer to almost any question. That is precisely the problem. Plausibility is cheap. Reliability is expensive.

Consider a customer support agent built for a software company. A user asks, “Why did my data disappear after the update?” The system could respond from general knowledge, retrieve documentation, search incident reports, inspect account data, or route the question to a human specialist. Each route may produce a fluent answer. Only some routes will produce a correct one.

The quality of the final response depends on a sequence of upstream choices:

  • Did the system understand what the user was really asking?
  • Did it translate the question into language that the knowledge base can recognize?
  • Did it select the right data source?
  • Was the documentation divided into useful, meaningful units?
  • Did retrieval return the critical exception, or merely a generally relevant paragraph?
  • Did the system check whether its conclusion was supported by the evidence?

Generation is only the final visible layer. In many practical systems, it is not even the most difficult layer. The hard part is constructing a path from an ambiguous human request to a defensible conclusion.

This is why retrieval augmented generation should not be understood as a simple search box attached to a chatbot. It is better understood as an evidence pipeline. Query transformation, intelligent routing, layered indexing, retrieval, re ranking, self correction, and evaluation are not separate tricks. Together, they form a system for managing uncertainty.

The central engineering question is not “Can the model answer?” It is “What evidence allowed it to answer, and how do we know that evidence was sufficient?”

That question also explains why the changing role of the developer is being misunderstood. Coding is not disappearing. What is becoming less scarce is the ability to write routine code from scratch. The scarce ability is designing the conditions under which generated code can be useful, safe, and maintainable.

Context is an engineered resource

People often describe context as if it were simply information placed inside a prompt. That view is too crude. Context behaves more like a budget, a map, and a control system at the same time.

A model given too little context may hallucinate or miss an important constraint. A model given too much context may become distracted, overweight irrelevant details, or follow conflicting instructions. The goal is not maximum information. The goal is maximum decision value per unit of information.

Imagine asking an architect to renovate a building while handing over every document in the company archive. The architect does not become more capable merely because the pile is larger. They need the current floor plan, structural constraints, building codes, client requirements, and a history of known defects. The art lies in selecting and organizing what matters.

The same principle governs an intelligent software agent. Good context includes more than documentation. It may include:

  • The business objective behind the task
  • Rules that must never be violated
  • Definitions of domain specific terms
  • Examples of acceptable and unacceptable behavior
  • The interfaces and permissions available to the system
  • The tests that determine whether the result is correct
  • The circumstances in which the agent must stop and ask for help

This is why document chunking matters. A long document is not automatically useful knowledge. It must be divided into semantically coherent units so that retrieval can bring the right idea into view without importing a mass of unrelated material.

A chunk that is too large mixes several concepts and makes precise retrieval difficult. A chunk that is too small removes the conditions and qualifications that give a statement its meaning. The right unit is not determined by character count alone. It is determined by the smallest piece of text that can answer a meaningful question without losing its necessary context.

The same logic applies to query transformation. Users rarely phrase requests in the vocabulary of a company’s internal knowledge base. A user may ask, “Why did my data disappear?” while the relevant documentation is titled “Post migration object visibility and retention behavior.” A capable system must bridge those vocabularies.

Generating several versions of a question is useful because a single query represents only one interpretation of the user’s intent. One reformulation might search for symptoms, another for technical causes, and another for policy language. The system is not merely searching more. It is exploring the space of possible meanings.

This suggests a useful mental model: context engineering is the design of an information environment in which the model is likely to make the right decision. It includes what the system sees, what it cannot see, how information is ranked, and what evidence counts as sufficient.

The new professional role: from producer to verifier

When machines become strong at first drafts, the value of human work shifts toward judgment. This has happened before. Photography reduced the cost of capturing an image, but increased the importance of composition, editing, and visual direction. Spreadsheets reduced the labor of arithmetic, but increased the importance of modeling assumptions and interpreting results.

Generative systems create the same shift in software and knowledge work. A person who measures productivity by the number of lines written may feel displaced. A person who can specify a system, provide its constraints, inspect its behavior, and improve its failure modes becomes more valuable.

That person is not simply a prompt writer. They are a verification specialist.

Verification requires a different posture from generation. Generation asks, “What could work?” Verification asks, “Under what conditions does this fail?” It searches for missing requirements, contradictory instructions, unauthorized behavior, unhandled edge cases, and false confidence.

Suppose an agent is asked to summarize a legal policy for a customer. A generator may produce a concise and readable explanation. A verifier asks harder questions:

  • Did the system distinguish current policy from archived policy?
  • Did it preserve exceptions and eligibility conditions?
  • Did it infer a rule that the document never stated?
  • Can every important claim be traced to a specific passage?
  • What happens when two approved documents disagree?
  • Does the response change when the user’s account type changes?

These are not questions that can be solved by asking the model to “be more accurate.” They require system design. The agent may need a source hierarchy, a date filter, a contradiction detector, a confidence threshold, and an escalation path.

The result is a crucial distinction between answer quality and system quality. An answer can be correct by accident. A system is trustworthy only when it produces correct answers for reasons that can be inspected and repeated.

This is also why evaluation must happen end to end. Testing retrieval in isolation is not enough. A document may be retrieved correctly, yet the model may misread it. A model may generate an excellent answer, yet the router may send the next question to the wrong database. Every stage can pass its local test while the complete workflow fails.

A useful evaluation framework examines at least four dimensions:

  1. Retrieval coverage: Did the system find the evidence needed to answer?
  2. Evidence precision: Were the retrieved passages relevant rather than merely similar?
  3. Reasoning fidelity: Does the answer actually follow from the evidence?
  4. Operational behavior: Does the system handle uncertainty, permissions, latency, and escalation correctly?

The fourth dimension is frequently neglected. An answer that is factually correct but reveals restricted information is not a successful answer. An answer that is accurate but arrives after the customer has abandoned the interaction is not operationally successful. Reliability is always situated in a real environment.

Architecture is the bridge between intelligence and trust

If context engineering determines what the system knows, architecture determines what the system is allowed to do with that knowledge.

This is where routing becomes more important than raw model capability. Not every question should go to the same model, index, or tool. A pricing question may belong in a structured database. A troubleshooting question may require technical documentation and recent incident data. A request involving a private account may require authentication before retrieval begins.

Intelligent routing is therefore a form of institutional judgment made executable. It encodes distinctions such as:

  • Public knowledge versus private knowledge
  • Stable reference material versus rapidly changing data
  • Explanation versus calculation
  • Low risk assistance versus high consequence action
  • A question that can be answered automatically versus one that requires review

The architecture should make these distinctions visible. If every task enters one undifferentiated prompt, the system becomes difficult to inspect and nearly impossible to govern. If the workflow has explicit stages, each stage can be measured and improved.

A robust pattern might look like this:

  1. Interpret the request and identify its likely intent.
  2. Generate alternative formulations if the intent is ambiguous.
  3. Route the request to the appropriate source or tool.
  4. Retrieve evidence using several complementary strategies.
  5. Re rank the evidence according to relevance and authority.
  6. Generate a response with citations or an explicit account of uncertainty.
  7. Grade the response against factual, procedural, and safety criteria.
  8. Revise, escalate, or refuse when the result does not meet the threshold.

This sequence resembles a quality control process more than a traditional software function. The system does not simply transform input into output. It creates checkpoints where uncertainty can be detected.

Self correction is particularly powerful when it is grounded in explicit criteria. Asking an agent to review its own answer without a rubric often produces a second confident answer. Asking it to check whether each claim is supported, whether required steps were followed, and whether sensitive data was exposed creates a meaningful control loop.

Yet self correction should not become an excuse to remove humans from difficult decisions. An agent grading its own work is useful, but it remains part of the system being evaluated. Independent tests, sampled human review, adversarial cases, and production monitoring are still necessary.

Trust does not come from a system claiming confidence. It comes from a system that knows when its evidence is weak and behaves accordingly.

A practical curriculum for the AI era

The shift from production to verification changes what people should learn. The most useful sequence is not “learn a model, then learn a prompt.” It is a progression from understanding constraints to designing reliable systems.

1. Audit your commodity skills

List the tasks you perform that can be described as predictable transformations: boilerplate code, routine documentation, basic data formatting, simple test generation, or standard research summaries. These tasks are not worthless, but they are increasingly easy to delegate.

For each task, ask what remains difficult after generation becomes cheap. Usually the answer involves requirements, exceptions, integration, judgment, or accountability. Those are the skills worth deepening.

2. Learn to supply useful context

Practice turning vague requests into operational specifications. Include the objective, relevant background, constraints, examples, interfaces, definitions, and failure conditions. Treat documentation as a designed input to a reasoning system, not as a passive archive.

A good exercise is to give an agent the same task twice. First, provide only the request. Then provide a carefully structured context packet. Compare not only the outputs, but the types of mistakes each version makes. This reveals which information actually changes the decision.

3. Become fluent in verification

For every generated result, ask what would disprove it. Build tests that target ambiguity, missing context, conflicting sources, unusual inputs, permission boundaries, and stale information.

Do not test only happy paths. A system that works on the obvious example has demonstrated very little. The difficult cases define the boundaries of its competence.

4. Study system architecture

Learn how information moves through a workflow: where it is stored, how it is indexed, how access is controlled, how tools are called, and where failures are recorded. You do not need to build every component yourself. You do need to understand the relationships among them.

The most capable practitioners will be able to move between levels of abstraction. They can discuss a user’s goal, a retrieval strategy, an API contract, an evaluation metric, and a business risk without treating any one of those levels as the whole problem.

Key Takeaways

  • Treat AI output as a hypothesis, not a finished product. The important question is what evidence supports it and what could falsify it.
  • Engineer context deliberately. Provide the model with goals, constraints, domain definitions, examples, permissions, and explicit failure conditions.
  • Design retrieval as a reasoning process. Rewrite ambiguous questions, search from multiple angles, route to the right sources, and rank evidence by authority as well as similarity.
  • Evaluate the complete workflow. Measure retrieval, reasoning, safety, latency, escalation, and maintenance, not just the quality of a single response.
  • Invest in verification and architecture. As routine generation becomes cheaper, the ability to define boundaries and build trustworthy feedback loops becomes more valuable.

The deepest change is not that machines can now write code. It is that they can participate in chains of judgment that once required a human at every step. That possibility is powerful, but it also makes invisible design decisions more consequential.

The future professional will not be judged only by what they can produce. They will be judged by the quality of the environment they create around production: the context they provide, the sources they trust, the constraints they encode, and the tests they use to expose failure.

In that world, expertise is no longer just the ability to know an answer. It is the ability to construct a process in which the right answer can be found, challenged, corrected, and trusted.

When generation becomes abundant, judgment becomes infrastructure.

Sources

← Back to Library

Hatch New Ideas with Glasp AI 🐣

Glasp AI allows you to hatch new ideas based on your curated content. Let's curate and create with Glasp AI :)

Start Hatching 🐣