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 Market Watch 3 ReferencesStateless MCP Servers Can Still Leak Shared State: A Security Contract
An HTTP endpoint might be stateless, but your MCP server might not be. Learn how shared object state in AI agent infrastructure can silently leak data across clients.
-
AI Tool Note 3 ReferencesThe Work Disk Contract: Managing Artifacts in AI Coding Agents
AI coding agents generate artifacts like builds, tests, and logs. Discover why defining a strict 'Work Disk Contract' is crucial to prevent operating system failures and lost evidence.
-
Field Log 3 ReferencesVercel Is Not a Deployment Contract
A Coolify migration audit exposed two hidden Vercel assumptions: rewrites that only existed in vercel.json and a build script that depended on a Unix shell. Learn how to verify your deployment contract.
-
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 References
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.
-
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.