Docs

FDEOps documentation

Installation, task skills, customer records and the local CLI.

Find the right guide

Every example uses npx, so no global install is assumed.

npx fdeops scan

Read local repository files and print an initial assessment. Creates no record; changes nothing.

npx fdeops demo

Run fictional notes through the review flow and generate a fieldbook. Creates or resets the demo folder.

npx fdeops resume --init client01

Create a customer record and link the current workspace to it.

npx fdeops resume

Summarize the selected customer's record. Output capped at 16 KiB by default.

npx fdeops recall "retry approval"

Find matching details in the selected customer's record with file references.

npx fdeops debrief --smart notes.md

Draft a pending record update from a local notes file using fixed rules. Ask your agent to check the interpretation.

npx fdeops debrief --review

Reopen the pending proposal to check interpretation, sources and open questions.

npx fdeops debrief --apply

Apply the pending proposal after you have reviewed it.

npx fdeops defend

Separate recorded assertions, sources and evidence gaps. A source reference does not authenticate the claim.

npx fdeops handoff --out successor.md

Generate a handoff summary to review before sharing. An export is not a completed handoff.

npx fdeops dashboard --all --open

Generate and open a read-only view of customer records. Regenerate after updates.

skills: Interpret the task and guide the work.
cli: Local file operations. Write commands apply when run; they are not dry runs.

Markdown files at ~/fde-engagements/<client>/.fde/. The fieldbook is a read-only HTML view of them.

context.md: Current state and next actions.
brief.md: The customer's request and constraints.
success.md: Outcome criteria and acceptance authority.
reality.md: Working theory, evidence and differences from the brief.
terrain.md: Relevant systems, teams and constraints.
stakeholders.md: Evidence-backed stakeholder observations and decision rights.
trust-profile.md: Access constraints, sensitive information and AI-use rules.
decisions.md: Dated decisions, reasons and sources.
risks.md: Open and retired risks.
delivery.md: Promises, measurements, acceptance and evidence.

Exact headings and allowed values: record schema.

Use one task skill or let fde help you work across the project. Start with the notes or code you already have.