DEV Community

Cover image for Not Just for Software
James Sargent
James Sargent

Posted on • Originally published at open.substack.com

Not Just for Software

intent /ĭn-tĕnt′/
noun

  1. Something that is intended; an aim or purpose.
  2. The state of mind necessary for an act to constitute a crime.
  3. The act of turning the mind toward an object; hence, a design; a purpose.

Trail is not a software development framework. It works for software, but that's just where I ran into the problem.

Trail doesn't care if you're writing code, writing a book, or building a complete set of business documents. It cares about one thing: intent. Not the vague, conceptual version of the word, but the operational one.

In Trail, an intent is a formal artifact. It defines the problem, the constraints, what is explicitly out of scope, and what "done" means. It exists before anything gets built, and once execution starts, it does not change. Every decision traces back to it. None of that requires code to exist anywhere in the process.

I'm validating that directly right now with a non-software proof of concept, producing the complete document set for a fictional retail business called Otaku Haven. That includes a business plan, operating agreements, employee handbook, marketing strategy, and vendor contracts. Dozens of documents, all produced through the same intent-and-run structure.

The mechanics do not change. The Architect defines what needs to exist and under what constraints. The Manager plans the execution. The Developer, in this case AI, produces the document. The Reviewer verifies it meets the intent. The output is a Word document instead of a Flutter widget. Trail does not notice the difference.

That's because Trail is not solving for software. It is solving for the handoff problem.

Any time you delegate complex work, whether to a contractor, a team member, or an AI, you run into the same failure modes. Decisions live in conversations instead of files. Scope shifts without anyone noticing. Assumptions go undocumented. Changes cannot be traced back to a decision. Those risks do not care what the deliverable is.

This is not a coding problem. It is a coordination problem.

And coordination problems show up everywhere. HR policy rollout. Marketing campaigns. Legal document production. Financial close processes. Vendor onboarding. If someone defines the work, someone else executes it, and someone eventually has to verify the result, you are operating inside the same system whether you recognize it or not.

Trail applies there.

The tools do not matter. The output does not matter. The domain does not matter. Trail only enforces three things: artifacts are the source of truth, roles are separated, and every handoff is explicit. Everything else is your system.

Web: trail.venturanomadica.com

Top comments (0)