Scale Your Intelligence
From MAGE to durable principles for working with AI agents
AI and agents can scale your intelligence—but the results will reflect the quality of your judgments.
Goal: AI should optimize your thinking—not replace it.
Scaling reliable agentic software engineering
| Mode | Best suited to | Concrete examples |
|---|---|---|
| AI chat | Simple information gathering, explanation, summarization, and one-off synthesis | Claude chat; ChatGPT chat |
| AI agent | Inspecting artifacts, using tools, editing files, running checks, and pursuing a multi-step outcome | Claude Code; Codex |
Implementation capacity can grow faster than the judgment needed to direct it.
Paraphrase of Davis, MAGE, pp. 4, 18–23
Is there a third approach that preserves both leverage and reliability? What would it require?
Discussion framing by Inouye; engineering problem informed by Davis, MAGE, Part 1
Repeated reconstruction creates churn—even when each local change looks plausible.
Paraphrase of Davis, MAGE, pp. 28–45
MAGE = Model-Based Agentic Software Engineering, a method developed by James C. Davis for engineering large software systems with coding agents.
Model consequential knowledge → give obligations authority → convert recurring lessons into engineering capital
“A model is a purposeful reduction of a system. It preserves the information one engineering question needs and suppresses the detail that question does not.” — James C. Davis, MAGE, p. 38
Definition and Modeling Principle from Davis, MAGE, §2.1.1, p. 38 and Part 2
| Engineering question | Example model |
|---|---|
| How is the system divided and connected? | Architecture, component, or dependency model |
| What can happen, and in what order? | State machine, workflow, scenario, or use-case model |
| What must or must not happen? | Policy, invariant, permission, privacy, or security model |
| What counts as acceptable evidence? | Measurement, metric, threshold, or assurance model |
| Who owns a decision or artifact? | Ownership, decision, or provenance model |
| How do facts connect across the system? | System knowledge graph |
Examples adapted from Davis, MAGE, Part 2
Models can state what should hold, but representation alone does not make the work follow the model. Alignment gives selected obligations consequence.
| Mechanism | Role | Simple example |
|---|---|---|
| Constraint | Restrict action | A sandbox forbids a dangerous operation |
| Sensor | Produce evidence | A scan reports exposed endpoints |
| Validator | Judge evidence | A test checks required behavior |
| Gate | Control admission | CI blocks a release that fails checks |
Agents remain free within permitted bounds; work that violates a governed obligation does not pass.
Paraphrase of Davis’s Alignment Principle: Davis, MAGE, pp. 4–6 and Part 3
Paraphrase of Davis’s governance-conversion loop: Davis, MAGE, pp. 4–6 and Part 4
Model consequential knowledge → give obligations authority → delegate work → inspect evidence → convert recurring lessons
Summary of Davis, MAGE, “MAGE on One Page,” p. 6
Scale your intelligence beyond software engineering
AI and agents can scale your intelligence—but the results will reflect the quality of your judgments.
Offload work that does not require your attention so you can invest it where your judgment creates the most value.
To scale your intelligence, externalize the thinking that matters and engineer a system that can apply it reliably, test the results, and learn from corrections.
Instructor synthesis by Inouye; relationship inspired by Davis’s Modeling, Alignment, and governance-conversion loop in MAGE
Principle 1: Make consequential context explicit, durable, and inspectable.
Inouye synthesis; directly inspired by Davis’s Modeling Principle and governance conversion
Principle 1: Make consequential context explicit, durable, and inspectable.
| Software engineering | Research | Writing |
|---|---|---|
| Store goals, interfaces, invariants, and decisions beside the code. | Preserve the research question, assumptions, inclusion rules, and evidence ledger. | Preserve audience, purpose, thesis, source notes, and editorial decisions. |
| Let the agent maintain these artifacts as the project changes. | Let later analyses inherit the same definitions and exclusions. | Let each revision inherit the same argument and citation constraints. |
Examples by Inouye; principle inspired by Davis, MAGE, Parts 2 and 4
Principle 2: Build structure at useful levels of abstraction.
Inouye synthesis; directly inspired by Davis’s reasoning-horizon argument and Modeling Principle
Principle 2: Build structure at useful levels of abstraction.
| Software engineering | Research | Writing |
|---|---|---|
| Goal → architecture → pipeline → module → code | Question → constructs → hypotheses → study → analysis | Purpose → argument → sections → paragraph claims → sentences |
| Decide locally while preserving interfaces between levels. | Refine one level without silently changing the research question. | Revise prose locally without losing the role of the section. |
Examples and cross-domain hierarchy by Inouye; starting point: Davis, MAGE, Part 2
Principle 3: Deliver the right context where each decision occurs.
Inouye extension of Davis’s purposeful modeling and connected system knowledge: Davis, MAGE, Parts 1.3 and 2.8
Principle 3: Deliver the right context where each decision occurs.
| Software engineering | Research | Writing |
|---|---|---|
| A privacy edit receives the product goal, privacy invariant, module contract, and related tests. | An analysis receives the hypothesis, data dictionary, preprocessing decisions, and relevant prior results. | A section revision receives the audience, thesis, outline, neighboring claims, and source constraints. |
The worker can request adjacent or higher-level context when a local decision crosses a boundary.
Dynamic-context formulation and examples by Inouye; informed by Davis, MAGE, Parts 1.3 and 2.8
Principle 4: Engineer the environment around value, requirements, and evidence.
Inouye synthesis; related to Davis’s changed-bottleneck argument and governed engineering environment
Principle 4: Engineer the environment around value, requirements, and evidence.
| Software engineering | Research | Writing |
|---|---|---|
| Name the user, task, constraints, failure costs, and acceptance evidence before choosing features. | Name the contribution, competing explanations, falsifying evidence, and acceptable uncertainty. | Name the reader, desired effect, central claim, evidence standard, and tone before polishing prose. |
Cross-domain formulation and examples by Inouye; MAGE influence: Davis, MAGE, pp. 4–6
Principle 5: Govern invariants and turn recurring judgment into durable structure.
Inouye generalization of Davis’s Alignment Principle and governance conversion
Principle 5: Govern invariants and turn recurring judgment into durable structure.
| Software engineering | Research | Writing |
|---|---|---|
| Record architecture decisions; gate releases on privacy and test evidence. | Preserve protocol decisions, provenance, exclusions, and deviations; require evidence before claims advance. | Archive sources and exact quotations; enforce citation and editorial checks before publication. |
Humans retain novel tradeoffs. Repeated judgments become instructions, models, validators, or gates that future work inherits.
Cross-domain examples by Inouye; directly inspired by Davis, MAGE, Parts 3–4
Principle 6: Make the process deterministic and formal wherever the value exceeds the cost.
Determinism emphasis by Inouye; informed by Davis’s constraints, sensors, validators, and gates
Principle 6: Make the process deterministic and formal wherever the value exceeds the cost.
| Software engineering | Research | Writing |
|---|---|---|
| Use schemas, types, tests, dependency checks, and reproducible builds; reserve AI review for architecture and novel bugs. | Script transformations and statistical checks; use structured metadata; reserve AI synthesis for interpretation and competing explanations. | Check links, quotations, citations, lengths, and required sections mechanically; reserve AI review for coherence and reader impact. |
Maintain human-readable and machine-readable views when each supports a different kind of reasoning—and check that they correspond.
Cross-domain division of labor by Inouye; MAGE influence: Davis, MAGE, Part 3
Make intent explicit → structure the work → deliver relevant context → delegate → observe evidence → govern → preserve the lesson
The goal is not to eliminate ambiguity. It is to expose consequential ambiguity early enough for human judgment—and to stop paying for the same judgment twice.
Inouye synthesis; adapted from Davis’s Modeling, Alignment, and governance-conversion loop
Choose a current software, research, writing, or AI Product task:
Exercise by Inouye; informed by Davis’s MAGE workflow