Driving
When it goes wrong
The agent checks the document chain and its own work for known failure modes. It reports findings as product questions for you to resolve.
The agent checks the project's documents before acting on them and checks its own work for the method's known failure modes. It reports findings in product language. You can respond without learning the method's failure categories or choosing which check to run.
The agent checks before it builds
Whenever your agent is about to draw up a build plan, run one, or change the project's documents, it first checks the whole document chain, without being asked. The same check runs at the start of every session. If the chain has a problem, the agent stops and raises it with you before touching code, because everything it builds assumes those documents are sound.
You never have to prompt this. If you ever feel like checking anyway, ask in plain words:
Give the plans a quick health check and tell me what you find.rcf define validate
rcf audit coverageWhat runs behind the scenes: validate proves the documents are well formed and every reference resolves; coverage proves every agreed check has a real test behind it.
What it may come back with
Findings reach you as plain statements about the product, with a decision attached. The document ids and method vocabulary stay in the files where they belong. Expect shapes like these:
- A gap. "The plan for search does not say what should happen when nothing matches. Want me to add a check for that?"
- A missing failure path. "Sign-up does not describe what happens when someone uses an expired link. What should they see?"
- A contradiction. "Two parts of the plan disagree about whether deleting a recipe needs a confirmation step. Which do you want?"
None of these need a technical answer. They need your intent: yes, add the check; show them a message that says the link expired; yes to the confirmation step. "I do not know yet" is also an answer, and the agent knows what to do with it: the question is recorded and parked, visibly, not forgotten.
If you want to see the detail behind a finding, ask. The agent can point you at the exact document, or open the tree viewer so you can read what it read.
When you spot something yourself
Sometimes you will see the problem first, in the running app. You do not need to work out which document let it through. Say what you see:
That is not what I meant by search. It should find close matches, not just exact ones.Report a problem in your own words. The agent treats a reported bug as a gap in the plans first: it strengthens the plan and its checks, then fixes the code against the corrected plan.
The agent's rule for a reported bug is to treat it as a gap in the plans first: find the promise that should have ruled the bug out and the test that should have caught it, strengthen both, then fix the code against the corrected plan. The agent is responsible for this process; your role is to describe the observed problem.
The safety net behind this
The failure modes this method exists to guard against, a skipped layer of planning, a test bent into passing instead of the code being fixed, work declared finished before it really was, are the agent's own checklist, walked before each stage of work is allowed to end. By its own rules, a problem you had to point out is a check it failed to run, not a duty you failed to perform.
So if the same kind of problem keeps reaching you, say that too, plainly: "this is the third time search has come back wrong". Recurring problems are a finding about the process, and dealing with the pattern rather than the instance is in the agent's playbook.
The operating rules are published. The harness block publishes every one of them, in the exact words the agent was given. Read them if you are curious; you will never need to quote them.