Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
32 changes: 32 additions & 0 deletions docs/users/common-workflow.md
Original file line number Diff line number Diff line change
Expand Up @@ -569,3 +569,35 @@ what are the limitations of Qwen Code?
> - Qwen Code always has access to the latest Qwen Code documentation, regardless of the version you're using
> - Ask specific questions to get detailed answers
> - Qwen Code can explain complex features like MCP integration, enterprise configurations, and advanced workflows

## Enforce evidence-based conclusions

When Qwen Code does high-stakes work — code review, incident troubleshooting, audits, or investigating production data — a confident but wrong conclusion costs more than no conclusion at all. You can encode your team's verification policy in QWEN.md (see [Memory](./features/memory.md)) so it applies to every session, without changing anyone's defaults.

The rules below are adapted from a production retrospective of a multi-agent deployment, where confident-but-wrong conclusions repeatedly traced back to the same failure modes: inferring state from code instead of querying it, treating one satisfied condition as proof, and repeating earlier statements as facts.

**1. Add a verification policy to your project QWEN.md**

Put this template in `QWEN.md` at your repository root and commit it, so the policy applies to the whole team:
Comment on lines +579 to +581

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

[Suggestion] Step 1 unconditionally mandates committing the policy to the repository root "so the policy applies to the whole team", while step 2 ("Choose the right scope") presents scope as a choice only after placement is already mandated — and its own body repeats the same repo-root mandate. — Failure scenario: a reader who wants the policy only for themselves (the ~/.qwen/QWEN.md / .qwen/QWEN.local.md scopes the linked table offers) follows the steps top-to-bottom: step 1 tells them to commit a team-wide file before step 2 ever mentions alternatives, so the policy lands in a committed, team-wide file against the reader's intent.

Suggested change
**1. Add a verification policy to your project QWEN.md**
Put this template in `QWEN.md` at your repository root and commit it, so the policy applies to the whole team:
**1. Choose the right scope**
See [Where to create QWEN.md](./features/memory.md#where-to-create-qwenmd) for which file applies to whom.
**2. Add the policy to the file you chose**
Put this template in the file from step 1 and commit it:

— deepseek-v4-flash via Qwen Code /review (v0.21.7)


```markdown
# Verification policy

Treat these rules as mandatory in investigations, troubleshooting, reviews, and any task that draws conclusions:

1. Verify before concluding. Back claims about data or system state with evidence from the authoritative source (database, API, logs, command output). Conclusions drawn from reading code alone must be labeled "unverified inference".
2. Verify the full chain. Enumerate the causal chain and check every link; one satisfied necessary condition does not prove a conclusion.
3. Treat conversation history as leads, not facts. Statements in earlier transcripts — including your own prior assertions — are leads. Re-verify them at the source before repeating them as facts.
4. Troubleshoot in order: your own recent changes first, then docs and known issues, and only then external dependencies.
5. 100% evidence rule in reviews. In review and audit tasks, report no conclusion without evidence; attach verifiable evidence (file:line, query result, log excerpt) to every claim.
```

**2. Choose the right scope**

See [Where to create QWEN.md](./features/memory.md#where-to-create-qwenmd) for which file applies to whom — commit the project-root `QWEN.md` copy so the policy covers the whole team.

> [!tip]
>
> - Keep the rules specific and actionable: "back every claim with a query result" works better than "be careful".
> - Keep the policy short — QWEN.md is followed more reliably when it is concise (see [Memory](./features/memory.md)).
> - Adapt the rules to your stack: name the actual query tools, dashboards, or log commands your team treats as authoritative sources.
1 change: 1 addition & 0 deletions docs/users/features/memory.md
Original file line number Diff line number Diff line change
Expand Up @@ -19,6 +19,7 @@ Add things you'd otherwise have to repeat every session:
- Coding conventions your team follows ("all new files must have JSDoc comments")
- Architectural decisions ("we use the repository pattern, never call the database directly from controllers")
- Personal preferences ("always use pnpm, not npm")
- A verification policy for high-stakes work — for example "verify against the database before concluding" (see [Enforce evidence-based conclusions](../common-workflow.md#enforce-evidence-based-conclusions) for a ready-made template)

Don't include things Qwen can figure out by reading your code. QWEN.md works best when it's short and specific — the longer it gets, the less reliably Qwen follows it.

Expand Down
Loading