Manifesto / 01 Read the pledge ↓

A discipline for the age of synthetic intelligence

Build the thing that proves the words.

Software is no longer written only in code. It begins as intent, becomes an artifact, and earns trust through evidence.

Definition

Artifact engineering is the discipline of turning human intent into durable, inspectable software through collaboration with synthetic intelligence.

From source code to shared intent

The old abstraction was code over machine language. The next abstraction is intent over code.

That does not make engineering disappear. It moves engineering upward. The hard work becomes stating the real problem, carrying context without distortion, choosing constraints, testing behavior, and deciding what is worthy of release.

An artifact is not a chat response or a mockup. It is a working object: a page, tool, system, document, model, or interface that can be opened, examined, used, and improved. The conversation is scaffolding. The artifact is the proof.

Not prompting. Engineering.

Prompting asks for an output.

It optimizes the next response.

Artifact engineering owns an outcome.

It manages intent, construction, verification, and revision as one system.

Seven principles

  1. Intent is the first material.

    Before choosing tools, state what must become true for the person using the artifact. A vague request can begin the work; it cannot finish the specification.

  2. Context is part of the design.

    Constraints, history, audience, environment, and taste are not overhead. They determine whether the right thing gets built.

  3. The artifact outranks the conversation.

    Fluent explanation does not compensate for broken behavior. What opens, runs, reads, calculates, or communicates is what counts.

  4. Verification is a creative act.

    Testing reveals what the artifact actually is. Inspect the output, exercise the interactions, challenge assumptions, and revise from evidence.

  5. Human judgment remains accountable.

    Synthetic intelligence can generate options and execute at speed. People still own purpose, consequences, acceptance, and release.

  6. Legibility is a feature.

    A good artifact makes its operation and limits understandable. Hidden cleverness is worth less than visible reliability.

  7. Iteration compounds.

    Preserve what was learned. Each artifact should make the next one easier to specify, safer to build, and faster to verify.

The working method

Artifact engineering is a loop, not a single generation.

Frame

Name the change

Define the user, the situation, and the outcome that matters.

Ground

Gather reality

Bring in the source material, constraints, interfaces, and facts the work depends on.

Shape

Choose the form

Decide what the artifact should be, what it should omit, and how someone will use it.

Build

Make a complete object

Produce the smallest finished artifact that can honestly satisfy the intent.

Prove

Test the claim

Inspect the rendered result, exercise its behavior, and compare it with the original outcome.

Carry

Keep the learning

Record the decisions and patterns that should survive into the next iteration.

A research agenda

A discipline needs more than a name. It needs questions that can produce methods, evidence, and tools.

01 / INTENT

How can ambiguous human goals become precise without flattening what people mean?

02 / MEMORY

How should a system preserve context while keeping it current, bounded, and under human control?

03 / PROOF

What evidence makes a generated artifact trustworthy enough for its consequences?

04 / REPAIR

How can artifacts explain failure and support correction without requiring their makers to start over?

05 / AUTHORSHIP

How should credit and responsibility work when human judgment and synthetic production are inseparable?

06 / ACCESS

What becomes possible when the ability to make software is no longer limited by fluency in syntax?

The artifact engineer’s pledge

I will begin with human intent, build toward a real outcome, test what I make, reveal what I cannot prove, and take responsibility for what I release. I will use synthetic intelligence to enlarge human agency—not to disguise the absence of judgment. The artifact will be my evidence.