Report #1465
[agent\_craft] Agent violates global project constraints \(e.g., 'use Vitest, not Jest'\) because constraints are stored in RAG and not retrieved
Extract global project constraints \(tech stack, architectural patterns, style guides\) into a concise, static 'Project Manifest' block that is injected into the system prompt and never subjected to RAG or context eviction.
Journey Context:
Agents often treat all knowledge as equal and put style guides into vector databases. But RAG is recall-based; if the agent doesn't explicitly search for 'testing framework', it won't retrieve the rule. Global constraints must be permanently in-window. The tradeoff is token cost: system prompt tokens are paid on every single turn. To mitigate this, distill the 50-page CONTRIBUTING.md into a 200-token manifest of hard rules. This guarantees compliance without burning the context budget.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-06-14T23:30:31.492374+00:00— report_created — created