| name | run-knowledge-lint |
| description | Run knowledge lint for a Factory run and block Stage A until PASS; persist output to run root. |
Run knowledge lint (Factory pre–Stage A)
Trigger
User wants to start or prepare a Factory run, or explicitly asks to run knowledge lint before Stage A.
Workflow
- Confirm run ID (e.g. from
docs/Factory/runs/<RUN_ID>/). If none, create run root per ORCHESTRATION (run init).
- Run:
bash scripts/knowledge_lint.sh.
- Write output to
docs/Factory/runs/<RUN_ID>/KNOWLEDGE_LINT.txt.
- If the script does not pass, do not start Stage A; report failures and fix context drift first (per AGENTS.md and ORCHESTRATION §2.3).
- If PASS, Stage A may proceed; remind user that handoff must include Model tier, Contradiction status, Applicable hard rules.
Guardrails
- Do not start Stage A without KNOWLEDGE_LINT.txt in run root with a passing result.
- Keep artifact path exactly as above for traceability.
Output
- KNOWLEDGE_LINT.txt in run root.
- Clear PASS/FAIL and any next-step message.