Field Notes
Articles for people shipping software with agents: concrete artifacts, source pressure, and reusable operating rules.
Start here / Field Log
DESIGN.md: Turning Visual Taste Into a Strict Agent Contract
Visual design for AI agents fails when built on screenshots and vibes. Learn how DESIGN.md turns UI taste into an inspectable, lintable technical contract.
- Artifact
- A concrete file, run, screenshot, log, or decision surface anchors the argument.
- Question
- What did this artifact make clearer about shipping software with agents?
- Sources
- 3 references behind the argument.
- Payoff
- A decision rule you can reuse in your own agent workflow.
Start here: concrete artifact, source pressure, and a reusable decision rule.
Concrete artifact
The argument has to touch a file, run, screenshot, log, or decision surface.
Source pressure
Outside references are used to sharpen the claim, not to decorate it.
Reusable rule
A good post ends with a test the reader can apply somewhere else.
The archive is intentionally small. The point is not to list every AI trend; it is to make each claim inspectable.
-
AI Explainer 3 ReferencesHow to Stop AI Agents From Losing Their Memory: The Operating Structure
Long LLM prompts are not operating memory. Learn how to build an artifact-driven memory stack with source notes, specs, and searchable indexes for autonomous AI agents.
-
Field Log 3 ReferencesDESIGN.md: Turning Visual Taste Into a Strict Agent Contract
Visual design for AI agents fails when built on screenshots and vibes. Learn how DESIGN.md turns UI taste into an inspectable, lintable technical contract.
-
AI Explainer 3 ReferencesSoftware 3.0 Is a Verification Problem
The useful Software 3.0 lesson is not that LLMs replace engineering. It is that faster generation moves the bottleneck to context, review, and evidence.
-
About 0 ReferencesAbout Vibecode Town: A Field Log for AI-Assisted Software Engineering
Vibecode Town is an evidence-backed field log tracking AI-assisted software development, agentic workflows, and technical contracts. We focus on verifiable proof, not AI hype.
-
Field Log 3 ReferencesFrustration Is a Signal, Not the Specification: Engineering Agentic Boundaries
Don't just vent at your AI agent when it makes a mistake. Turn repeated frustration into a strict technical contract, a verifier, and a durable test.
-
AI Explainer 3 ReferencesWhat Vibe Coding Actually Is: Exploration vs Production
Vibe coding is useful for exploration, but production work starts when intent becomes a technical contract the agent can verify against.