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.

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.

148 articles

Start here

7

1. Understand the work

13
Guide1. Understand the work 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
Guide1. Understand the work Workflow discovery notes template

Capture one real case without turning the conversation into a formal process audit.

Practical · 4 min
Checklist1. Understand the work Workflow discovery interview checklist

A short checklist to make sure a discovery conversation captures the decisions, sources and exceptions that matter.

Practical · 3 min
Guide1. Understand the work 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
Guide1. Understand the work 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
Guide1. Understand the work How to ask better process questions

Simple question patterns that reveal decisions, sources and judgment instead of tidy summaries.

Practical · 5 min
Guide1. Understand the work 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
Guide1. Understand the work 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
Concept1. Understand the work The official process is evidence, not truth

Why documented procedures rarely match the real work, and how to use them anyway.

Essential · 4 min
Concept1. Understand the work What is tacit knowledge?

The experience-based knowledge people carry in their heads, and why it matters before automating anything.

Essential · 4 min
Concept1. Understand the work 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
Concept1. Understand the work 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
Concept1. Understand the work 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 min

2. Map the workflow

11
Guide2. Map the workflow How to map a workflow

Turn a real case into a simple map of steps, decisions, systems, people and exceptions.

Essential · 9 min
Guide2. Map the workflow 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
Guide2. Map the workflow How to map decisions

Turn vague steps like 'check it' into explicit decisions with observable inputs and clear paths.

Practical · 5 min
Guide2. Map the workflow 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
Guide2. Map the workflow 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
Concept2. Map the workflow 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
Concept2. Map the workflow 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
Concept2. Map the workflow 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
Concept2. Map the workflow What is a trigger?

The event that starts a workflow, and why naming it precisely matters.

Essential · 3 min
Concept2. Map the workflow What is a queue?

A shared list of work waiting to be handled, and why queues make workflows visible and fair.

Practical · 3 min
Guide2. Map the workflow 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 min

3. Make it digital

17
Guide3. Make it digital 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
Pattern3. Make it digital Structured intake

Capture requests as consistent, complete fields at the door so the rest of the workflow can rely on them.

Practical · 3 min
Pattern3. Make it digital Missing information request

When required information is absent, ask for it rather than guessing or failing silently.

Practical · 3 min
Concept3. Make it digital 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
Guide3. Make it digital 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
Guide3. Make it digital How to define useful workflow states

Choose a small set of clear states that make handoffs work and exceptions visible.

Practical · 5 min
Guide3. Make it digital 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
Guide3. Make it digital 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
Guide3. Make it digital 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
Pattern3. Make it digital Single source of truth

Keep one authoritative place for each fact and make everything else read from it.

Practical · 3 min
Guide3. Make it digital How to reduce duplicate data entry

Find where the same information is typed more than once and remove the copies safely.

Practical · 4 min
Guide3. Make it digital 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
Concept3. Make it digital What is an API?

A defined way for two software systems to exchange information or request actions from each other.

Practical · 5 min
Concept3. Make it digital What is a webhook?

A way for one system to tell another that something has happened, the moment it happens.

Technical · 4 min
Concept3. Make it digital What is an integration?

A connection that lets two systems work together, so information and actions flow between them.

Practical · 4 min
Concept3. Make it digital What is an identifier?

A stable, unique label for a thing, and why workflows fall apart without one.

Practical · 4 min
Concept3. Make it digital 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 min

4. Structure the knowledge

23
Guide4. Structure the knowledge 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
Concept4. Structure the knowledge 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
Pattern4. Structure the knowledge Retrieve then answer

Have the AI find relevant information first, then answer from it, instead of answering from memory.

Practical · 3 min
Concept4. Structure the knowledge 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
Concept4. Structure the knowledge What is semantic search?

Searching by meaning instead of exact words, and where it helps and misleads.

Practical · 4 min
Concept4. Structure the knowledge 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
Concept4. Structure the knowledge What is a token?

The small pieces of text a model works in, and why they affect cost and limits.

Technical · 3 min
Concept4. Structure the knowledge What is a chunk?

A small piece of a document, sized so it can be searched and retrieved usefully.

Technical · 4 min
Guide4. Structure the knowledge 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
Guide4. Structure the knowledge How to identify authoritative sources

Decide which document or system to trust when several claim to hold the same knowledge.

Practical · 5 min
Pattern4. Structure the knowledge Source hierarchy

Rank your sources so that when they disagree, the workflow knows which one to believe.

Practical · 3 min
Pattern4. Structure the knowledge Cite the source

Return the source alongside every answer, so a person can check it in seconds.

Practical · 3 min
Concept4. Structure the knowledge What is provenance?

Knowing where a piece of information came from, which is what lets you trust and check it.

Practical · 3 min
Guide4. Structure the knowledge How to handle conflicting sources

Decide what happens when two trusted sources disagree, before an AI has to choose for you.

Practical · 5 min
Pattern4. Structure the knowledge Dual-source verification

Confirm an important answer against a second source before trusting or acting on it.

Practical · 3 min
Guide4. Structure the knowledge 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
Pattern4. Structure the knowledge Freshness gate

Refuse to answer from a source that is too old, instead of quietly using stale information.

Practical · 3 min
Checklist4. Structure the knowledge Knowledge source review checklist

A recurring check to keep the sources a workflow depends on accurate, owned and current.

Practical · 3 min
Guide4. Structure the knowledge 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
Concept4. Structure the knowledge 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
Guide4. Structure the knowledge 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
Guide4. Structure the knowledge How to keep customer data safe with AI

Practical steps to protect customer data when an AI workflow touches it.

Practical · 5 min
Checklist4. Structure the knowledge AI data protection checklist

A short checklist to run before an AI workflow touches personal or confidential data.

Practical · 4 min

5. Decide where AI helps

21
Concept5. Decide where AI helps 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
Concept5. Decide where AI helps Automation vs AI vs agent

Choose between fixed rules, interpretation and controlled action based on what the work actually needs.

Essential · 7 min
Guide5. Decide where AI helps How to decide whether a workflow needs AI

A practical way to tell strong AI opportunities from expensive demonstrations.

Essential · 6 min
Checklist5. Decide where AI helps AI suitability checklist

Work through the factors that make a task a good or poor fit for AI before you commit.

Practical · 3 min
Guide5. Decide where AI helps 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
Guide5. Decide where AI helps 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
Guide5. Decide where AI helps How to assess data availability

Check whether the workflow can actually reach the information it needs before you design around it.

Practical · 5 min
Guide5. Decide where AI helps 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
Concept5. Decide where AI helps Reversible vs irreversible actions

Why an action's reversibility should shape how much autonomy an AI is given over it.

Essential · 4 min
Concept5. Decide where AI helps 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
Concept5. Decide where AI helps What is extraction?

Pulling specific pieces of information out of unstructured text, turning messy input into usable fields.

Practical · 4 min
Concept5. Decide where AI helps What is generation?

Producing new text or content, the most visible AI capability and the one that needs the most review.

Practical · 4 min
Concept5. Decide where AI helps What is a copilot?

An AI that works alongside a person rather than replacing them, and why the framing matters.

Practical · 3 min
Pattern5. Decide where AI helps 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
Concept5. Decide where AI helps 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
Guide5. Decide where AI helps 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
Guide5. Decide where AI helps 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
Guide5. Decide where AI helps How to choose an AI vendor

What to weigh when picking an AI vendor, beyond the demo and the price.

Practical · 5 min
Checklist5. Decide where AI helps Questions to ask an AI vendor

A checklist of plain questions to put to any AI vendor before you sign.

Practical · 4 min
Concept5. Decide where AI helps 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
Guide5. Decide where AI helps 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 min

6. Design the AI workflow

28
Pattern6. Design the AI workflow Draft → Approve → Execute

Let AI prepare a consequential action while a person keeps the final decision.

Practical · 4 min
Checklist6. Design the AI workflow 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
Concept6. Design the AI workflow 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
Pattern6. Design the AI workflow Read-only assistant

Let AI answer, summarize and suggest without changing anything, the safest way to start.

Practical · 3 min
Guide6. Design the AI workflow 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
Guide6. Design the AI workflow 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
Guide6. Design the AI workflow 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
Concept6. Design the AI workflow 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
Concept6. Design the AI workflow Suggest vs draft vs execute

Three levels of autonomy for a single action, and how to keep them separate from access.

Essential · 5 min
Concept6. Design the AI workflow 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
Concept6. Design the AI workflow 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
Guide6. Design the AI workflow 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
Concept6. Design the AI workflow What is a guardrail?

A fixed limit that constrains what an AI can do, independent of what the model decides.

Practical · 4 min
Concept6. Design the AI workflow What is a prompt?

The instructions and information given to a model, and why a prompt is not a guarantee.

Practical · 4 min
Guide6. Design the AI workflow 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
Pattern6. Design the AI workflow Triage and route

Classify an incoming item and send it to the right place, with unclear cases going to a person.

Practical · 3 min
Pattern6. Design the AI workflow Exception queue

Collect the cases an AI should not handle alone into one visible, owned list for people to resolve.

Practical · 3 min
Pattern6. Design the AI workflow 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
Pattern6. Design the AI workflow Confidence threshold

Let the AI act automatically only when it is sure enough, and send the rest to a person.

Practical · 3 min
Pattern6. Design the AI workflow Extract then validate

Have the AI pull values from messy input, then check them with rules before the workflow acts.

Practical · 3 min
Pattern6. Design the AI workflow Two-person approval

Require a second person for the highest-risk actions, so no single approval can cause serious harm.

Practical · 3 min
Pattern6. Design the AI workflow Safe default

When the AI is unsure, fall back to the option that does the least harm.

Practical · 3 min
Pattern6. Design the AI workflow 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
Concept6. Design the AI workflow 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
Concept6. Design the AI workflow 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
Guide6. Design the AI workflow How to choose an AI model

A practical way to pick between AI models without needing to follow every release.

Practical · 5 min
Concept6. Design the AI workflow What is agent memory?

What an AI agent remembers, what it forgets, and why the difference matters for design.

Practical · 4 min
Concept6. Design the AI workflow What is MCP?

A standard way to connect AI systems to tools and data, explained without the jargon.

Technical · 4 min

7. Build and test

13
Guide7. Build and test 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
Guide7. Build and test 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
Pattern7. Build and test 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
Concept7. Build and test What is evaluation?

Measuring how well an AI workflow actually performs, against real cases and agreed answers.

Essential · 5 min
Concept7. Build and test What is ground truth?

The agreed correct answer for a case, and why evaluation depends on having it.

Practical · 3 min
Concept7. Build and test Precision and recall, in plain terms

Two simple ways to describe how a flagging or detection step gets things wrong.

Technical · 4 min
Guide7. Build and test How to test edge cases

Deliberately test the unusual, missing and conflicting inputs where AI workflows tend to fail.

Practical · 5 min
Concept7. Build and test 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
Concept7. Build and test What is latency?

How long an AI step takes to respond, and when that speed actually matters for a workflow.

Practical · 3 min
Guide7. Build and test 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
Pattern7. Build and test Shadow mode

Run the AI on real cases in parallel without acting, to gather evidence before trusting it.

Practical · 3 min
Guide7. Build and test 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
Guide7. Build and test 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 min

8. Operate and improve

15
Guide8. Operate and improve 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
Guide8. Operate and improve How to review failed cases

Turn the workflow's mistakes into a steady source of improvement instead of one-off firefighting.

Practical · 5 min
Guide8. Operate and improve 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
Guide8. Operate and improve How to maintain knowledge sources

Keep the documents and data an AI workflow relies on accurate and current after launch.

Practical · 5 min
Pattern8. Operate and improve Sampled human review

Check a meaningful sample of automated results, so quality stays visible without reviewing everything.

Practical · 3 min
Checklist8. Operate and improve Monthly production review checklist

A regular check to keep a live AI workflow accurate, safe and still worth operating.

Practical · 3 min
Guide8. Operate and improve How to retire an AI workflow

Shut down or replace a workflow cleanly, without leaving gaps, orphaned access or lost knowledge.

Practical · 5 min
Concept8. Operate and improve What is drift?

The slow, quiet decline of a workflow that once worked, as the world around it changes.

Essential · 4 min
Concept8. Operate and improve 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
Guide8. Operate and improve 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
Guide8. Operate and improve How to monitor model or vendor changes

Stay ahead of changes in the AI model or services your workflow depends on.

Practical · 5 min
Guide8. Operate and improve How to control AI spending

Simple ways to keep AI running costs predictable once a workflow is live.

Practical · 4 min
Guide8. Operate and improve 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
Guide8. Operate and improve 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
Guide8. Operate and improve 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 min