Firmspec Field Guide
Turn real work into reliable AI workflows.
Practical guidance for understanding processes, digitizing work, preparing knowledge, designing AI systems and keeping them useful.
Your library
Continue where you left off
Browse the guide
Every article, by stage of the work
These follow the path from understanding a real task to running an agent that helps with it. Start at the beginning, or jump straight to what you need.
Start here
7
How to use this field guide
Find the right page whether you want to learn the whole approach or solve one problem right now.
Essential · 4 min
The Workflow Ladder
A practical path from messy real-world work to a reliable digital or AI-assisted workflow.
Essential · 7 min
Do not start with AI
Why the most reliable AI projects begin with the work, not the model.
Essential · 5 min
The automation spectrum
From manual work to autonomous action, and how to pick the right level for a task.
Essential · 6 min
Deterministic vs probabilistic systems
The difference between software that follows rules and software that interprets, and why it changes how you design a workflow.
Essential · 5 min
Use the least complex mechanism that works
A single principle that quietly prevents most wasted AI effort.
Essential · 4 min
From a messy workflow to your first AI pilot
A guided path through the whole field guide, from understanding the work to deciding whether to deploy.
Essential · 6 min1. Understand the work
13
How to interview someone about their work
Use a recent real case to uncover the steps, decisions and exceptions that process documents miss.
Essential · 8 min
Workflow discovery notes template
Capture one real case without turning the conversation into a formal process audit.
Practical · 4 min
Workflow discovery interview checklist
A short checklist to make sure a discovery conversation captures the decisions, sources and exceptions that matter.
Practical · 3 min
How to observe a workflow without disrupting it
Watch real work as it happens to see the steps people forget to mention.
Practical · 6 min
How to find hidden steps and exceptions
Surface the workarounds, special cases and judgment calls that decide whether a workflow can be automated.
Practical · 6 min
How to ask better process questions
Simple question patterns that reveal decisions, sources and judgment instead of tidy summaries.
Practical · 5 min
How to identify pain without jumping to a solution
Separate the real problem from the first solution people reach for, so you solve the right thing.
Practical · 5 min
How to find the person who actually knows
Locate the people whose real knowledge decides whether a workflow can be understood and improved.
Practical · 5 min
The official process is evidence, not truth
Why documented procedures rarely match the real work, and how to use them anyway.
Essential · 4 min
What is tacit knowledge?
The experience-based knowledge people carry in their heads, and why it matters before automating anything.
Essential · 4 min
What is a business rule?
A stable statement of how a decision should be made, and why it usually belongs outside the AI model.
Essential · 4 min
What is an exception?
The cases that fall outside the normal path, and why they are part of the workflow rather than a nuisance.
Essential · 4 min
What is a handoff?
The moment work passes from one person or system to another, and why handoffs are where things get lost.
Essential · 4 min2. Map the workflow
11
How to map a workflow
Turn a real case into a simple map of steps, decisions, systems, people and exceptions.
Essential · 9 min
How to find a workflow's inputs and outputs
Define what starts the work and what a good result looks like before mapping the steps between them.
Practical · 5 min
How to map decisions
Turn vague steps like 'check it' into explicit decisions with observable inputs and clear paths.
Practical · 5 min
How to map handoffs between people and systems
Make the points where work changes hands visible, because that is where delay and lost context live.
Practical · 5 min
How to map exceptions
Give every unusual case a visible path, owner and outcome instead of hiding it in a manual review box.
Practical · 5 min
What is a source of truth?
The one place where a piece of information is considered correct, and why every workflow needs to name it.
Essential · 5 min
What is a system of record?
The official system that owns a type of data, and how it relates to a source of truth.
Practical · 4 min
What is a workflow state?
The named stages a piece of work moves through, and why clear states make a process reliable.
Essential · 4 min
What is a trigger?
The event that starts a workflow, and why naming it precisely matters.
Essential · 3 min
What is a queue?
A shared list of work waiting to be handled, and why queues make workflows visible and fair.
Practical · 3 min
How to validate a workflow map with the people who do the work
Check your map against reality by walking real cases through it with the people who know.
Practical · 4 min3. Make it digital
17
How to turn a manual process into a digital workflow
Create reliable digital inputs, states and records before adding any AI, so the intelligence has somewhere solid to stand.
Essential · 7 min
Structured intake
Capture requests as consistent, complete fields at the door so the rest of the workflow can rely on them.
Practical · 3 min
Missing information request
When required information is absent, ask for it rather than guessing or failing silently.
Practical · 3 min
Structured vs unstructured data
The difference between neatly organized fields and free-form content, and why it changes how a workflow is built.
Essential · 5 min
When a spreadsheet is enough (and when it is not)
A practical guide to whether a spreadsheet is the right tool, without treating spreadsheets as primitive.
Practical · 5 min
How to define useful workflow states
Choose a small set of clear states that make handoffs work and exceptions visible.
Practical · 5 min
How to create a reliable intake form
Turn however requests happen to arrive into one consistent, complete starting point for the workflow.
Practical · 5 min
How to replace verbal handoffs
Turn 'just tell the next person' into a reliable digital signal without losing the speed people valued.
Practical · 4 min
How to choose a source of truth
Pick the one place each important fact is considered correct, and make the others follow it.
Practical · 5 min
Single source of truth
Keep one authoritative place for each fact and make everything else read from it.
Practical · 3 min
How to reduce duplicate data entry
Find where the same information is typed more than once and remove the copies safely.
Practical · 4 min
How to make a process auditable
Keep a clear record of what happened, so you can review decisions, catch failures and build trust.
Practical · 4 min
What is an API?
A defined way for two software systems to exchange information or request actions from each other.
Practical · 5 min
What is a webhook?
A way for one system to tell another that something has happened, the moment it happens.
Technical · 4 min
What is an integration?
A connection that lets two systems work together, so information and actions flow between them.
Practical · 4 min
What is an identifier?
A stable, unique label for a thing, and why workflows fall apart without one.
Practical · 4 min
What is an audit trail?
A record of what happened, when and by whom, kept so a process can be reviewed and trusted.
Practical · 3 min4. Structure the knowledge
23
How to get knowledge out of people's heads
Turn the experience people carry into explicit, owned knowledge that software and colleagues can use.
Essential · 6 min
What is RAG?
How an AI can look up relevant information before it answers, and what that does and does not fix.
Essential · 6 min
Retrieve then answer
Have the AI find relevant information first, then answer from it, instead of answering from memory.
Practical · 3 min
What is an embedding?
A way to represent meaning as numbers so software can compare how similar two pieces of text are.
Technical · 4 min
What is semantic search?
Searching by meaning instead of exact words, and where it helps and misleads.
Practical · 4 min
What is a context window?
The information an AI model can consider at one time, and why it is a real limit to design around.
Practical · 4 min
What is a token?
The small pieces of text a model works in, and why they affect cost and limits.
Technical · 3 min
What is a chunk?
A small piece of a document, sized so it can be searched and retrieved usefully.
Technical · 4 min
How to prepare documents for AI use
Get your documents into a state where an AI can find and use the right information reliably.
Practical · 6 min
How to identify authoritative sources
Decide which document or system to trust when several claim to hold the same knowledge.
Practical · 5 min
Source hierarchy
Rank your sources so that when they disagree, the workflow knows which one to believe.
Practical · 3 min
Cite the source
Return the source alongside every answer, so a person can check it in seconds.
Practical · 3 min
What is provenance?
Knowing where a piece of information came from, which is what lets you trust and check it.
Practical · 3 min
How to handle conflicting sources
Decide what happens when two trusted sources disagree, before an AI has to choose for you.
Practical · 5 min
Dual-source verification
Confirm an important answer against a second source before trusting or acting on it.
Practical · 3 min
How to keep knowledge current
Give knowledge an owner and a review habit so it does not quietly go out of date.
Practical · 5 min
Freshness gate
Refuse to answer from a source that is too old, instead of quietly using stale information.
Practical · 3 min
Knowledge source review checklist
A recurring check to keep the sources a workflow depends on accurate, owned and current.
Practical · 3 min
How to separate facts from instructions
Keep what is true apart from what to do, because they age differently and are used differently.
Practical · 4 min
What is fine-tuning (and do you need it)?
Adjusting a model with your own examples, and why most workflows should try simpler options first.
Technical · 4 min
What data should never go to an AI?
A plain guide to the data you should keep out of an AI workflow, and why.
Essential · 5 min
How to keep customer data safe with AI
Practical steps to protect customer data when an AI workflow touches it.
Practical · 5 min
AI data protection checklist
A short checklist to run before an AI workflow touches personal or confidential data.
Practical · 4 min5. Decide where AI helps
21
What is a large language model?
The kind of AI behind most current tools, what it is good at, and where it goes wrong.
Essential · 5 min
Automation vs AI vs agent
Choose between fixed rules, interpretation and controlled action based on what the work actually needs.
Essential · 7 min
How to decide whether a workflow needs AI
A practical way to tell strong AI opportunities from expensive demonstrations.
Essential · 6 min
AI suitability checklist
Work through the factors that make a task a good or poor fit for AI before you commit.
Practical · 3 min
How to find a good first AI use case
Choose a first project that is useful, safe to get wrong, and easy to learn from.
Practical · 5 min
How to decompose a task before automating it
Break a task into smaller steps so you can use the right mechanism for each part.
Practical · 5 min
How to assess data availability
Check whether the workflow can actually reach the information it needs before you design around it.
Practical · 5 min
How to think about the cost of errors
Judge an AI step by what happens when it is wrong, not only by how often it is right.
Essential · 5 min
Reversible vs irreversible actions
Why an action's reversibility should shape how much autonomy an AI is given over it.
Essential · 4 min
What is classification?
Sorting an input into one of a known set of categories, one of the most reliable uses of AI.
Practical · 4 min
What is extraction?
Pulling specific pieces of information out of unstructured text, turning messy input into usable fields.
Practical · 4 min
What is generation?
Producing new text or content, the most visible AI capability and the one that needs the most review.
Practical · 4 min
What is a copilot?
An AI that works alongside a person rather than replacing them, and why the framing matters.
Practical · 3 min
Rules first, AI second
Handle the clear-cut cases with fixed rules and send only the genuinely hard ones to a model.
Practical · 3 min
What does an AI agent cost?
The real cost drivers behind an AI agent, from usage fees to the human time around it.
Essential · 5 min
How to estimate the cost of an AI workflow
A back-of-envelope method for the running cost of an AI workflow before you commit.
Practical · 5 min
Build vs buy an AI agent
When to build an AI agent yourself, when to buy one off the shelf, and how to decide.
Practical · 5 min
How to choose an AI vendor
What to weigh when picking an AI vendor, beyond the demo and the price.
Practical · 5 min
Questions to ask an AI vendor
A checklist of plain questions to put to any AI vendor before you sign.
Practical · 4 min
Does the vendor train on your data?
Why it matters whether an AI vendor uses your data to train, and how to check.
Essential · 4 min
How to build the business case for an AI pilot
A short, honest business case for an AI pilot that a non-technical decision-maker can trust.
Practical · 5 min6. Design the AI workflow
28
Draft → Approve → Execute
Let AI prepare a consequential action while a person keeps the final decision.
Practical · 4 min
Before giving an agent write access
Check that allowed changes, approvals, logging, reversal and ownership are explicit before an agent can affect business data.
Practical · 3 min
What is an AI agent?
A system that uses a model to choose steps and use tools within limits, and why authority matters more than autonomy.
Essential · 5 min
Read-only assistant
Let AI answer, summarize and suggest without changing anything, the safest way to start.
Practical · 3 min
How to define an agent's job
Write a clear scope, non-goals and boundaries so an AI does the right work and stops at the right edge.
Essential · 6 min
How to write useful agent instructions
Write clear instructions that guide an AI's behavior, while enforcing anything that must always hold elsewhere.
Practical · 5 min
How to define allowed and prohibited actions
List what an AI may and may not do, and separate that from what it is technically able to do.
Practical · 5 min
Read access vs write access
The difference between a system that can look and one that can change, and why it is the first safety decision.
Essential · 4 min
Suggest vs draft vs execute
Three levels of autonomy for a single action, and how to keep them separate from access.
Essential · 5 min
What human in the loop actually means
Why a person in the workflow only adds safety when they have the information, time and authority to act.
Essential · 5 min
What is a tool (in AI workflows)?
A defined action an AI is allowed to perform, and why each tool is a permission you grant.
Practical · 4 min
How to choose tools for an agent
Give an AI the fewest, narrowest tools it needs, and make each one a deliberate permission.
Practical · 5 min
What is a guardrail?
A fixed limit that constrains what an AI can do, independent of what the model decides.
Practical · 4 min
What is a prompt?
The instructions and information given to a model, and why a prompt is not a guarantee.
Practical · 4 min
How to design escalation and failure behavior
Decide what an AI does when it is unsure, hits an exception, or something goes wrong, before it has to.
Essential · 6 min
Triage and route
Classify an incoming item and send it to the right place, with unclear cases going to a person.
Practical · 3 min
Exception queue
Collect the cases an AI should not handle alone into one visible, owned list for people to resolve.
Practical · 3 min
Human fallback
Make sure there is always a person who can take over when the AI cannot, safely and without losing the case.
Practical · 3 min
Confidence threshold
Let the AI act automatically only when it is sure enough, and send the rest to a person.
Practical · 3 min
Extract then validate
Have the AI pull values from messy input, then check them with rules before the workflow acts.
Practical · 3 min
Two-person approval
Require a second person for the highest-risk actions, so no single approval can cause serious harm.
Practical · 3 min
Safe default
When the AI is unsure, fall back to the option that does the least harm.
Practical · 3 min
Retry with a limit
Retry a failed action a bounded number of times, then stop and hand off, instead of trying forever.
Practical · 3 min
What is prompt injection?
How hidden instructions in the content an AI reads can hijack it, and how to limit the damage.
Practical · 5 min
What is a system prompt?
The standing instructions that tell an AI who it is and how to behave, on every request.
Practical · 4 min
How to choose an AI model
A practical way to pick between AI models without needing to follow every release.
Practical · 5 min
What is agent memory?
What an AI agent remembers, what it forgets, and why the difference matters for design.
Practical · 4 min
What is MCP?
A standard way to connect AI systems to tools and data, explained without the jargon.
Technical · 4 min7. Build and test
13
How to build the smallest useful pilot
Start with the narrowest version that delivers real value, so you learn fast and risk little.
Essential · 6 min
How to create a test set from real work
Build a collection of real cases with known good answers, so you can measure quality instead of guessing.
Essential · 6 min
Golden test set
Keep a stable set of real cases with known answers, and rerun it on every change to catch regressions.
Practical · 3 min
What is evaluation?
Measuring how well an AI workflow actually performs, against real cases and agreed answers.
Essential · 5 min
What is ground truth?
The agreed correct answer for a case, and why evaluation depends on having it.
Practical · 3 min
Precision and recall, in plain terms
Two simple ways to describe how a flagging or detection step gets things wrong.
Technical · 4 min
How to test edge cases
Deliberately test the unusual, missing and conflicting inputs where AI workflows tend to fail.
Practical · 5 min
What is a hallucination?
When an AI produces confident, fluent information that is simply not true, and how to guard against it.
Essential · 5 min
What is latency?
How long an AI step takes to respond, and when that speed actually matters for a workflow.
Practical · 3 min
How to run a shadow-mode pilot
Run an AI workflow alongside the real one without acting, so you can compare it safely before trusting it.
Practical · 5 min
Shadow mode
Run the AI on real cases in parallel without acting, to gather evidence before trusting it.
Practical · 3 min
How to test permission boundaries
Confirm an AI cannot do the things it is not allowed to do, not just that it does the right things.
Practical · 5 min
How to introduce an AI workflow to a team
Roll out an AI workflow in a way that builds trust and keeps the people who do the work on side.
Practical · 5 min8. Operate and improve
15
How to assign ownership after launch
Make sure one person is responsible for the workflow once it is live, because deployment creates responsibility.
Essential · 5 min
How to review failed cases
Turn the workflow's mistakes into a steady source of improvement instead of one-off firefighting.
Practical · 5 min
How to collect useful user feedback
Gather feedback from the people using an AI workflow in a way that actually improves it.
Practical · 4 min
How to maintain knowledge sources
Keep the documents and data an AI workflow relies on accurate and current after launch.
Practical · 5 min
Sampled human review
Check a meaningful sample of automated results, so quality stays visible without reviewing everything.
Practical · 3 min
Monthly production review checklist
A regular check to keep a live AI workflow accurate, safe and still worth operating.
Practical · 3 min
How to retire an AI workflow
Shut down or replace a workflow cleanly, without leaving gaps, orphaned access or lost knowledge.
Practical · 5 min
What is drift?
The slow, quiet decline of a workflow that once worked, as the world around it changes.
Essential · 4 min
What is an incident?
A failure serious enough to need a deliberate response, and why AI workflows need a plan for them.
Practical · 4 min
How to document an incident
Record what happened after a serious failure, so you fix the cause and do not repeat it.
Practical · 4 min
How to monitor model or vendor changes
Stay ahead of changes in the AI model or services your workflow depends on.
Practical · 5 min
How to control AI spending
Simple ways to keep AI running costs predictable once a workflow is live.
Practical · 4 min
How to get staff buy-in for AI
How to bring the people who do the work with you when you introduce an AI agent.
Practical · 5 min
How to handle worries about AI replacing jobs
How to address the fear that an AI agent is there to replace people, honestly and without spin.
Essential · 4 min
How to measure whether a workflow is still worth operating
Weigh the value a live workflow delivers against what it costs to run, and be willing to stop.
Practical · 5 minTry a shorter phrase or a different stage.