semantics (context types, ordering, project scopes) out of pitfalls.md
into a new retrieval-semantics.md. Pitfalls.md becomes a compact debug
checklist: missing columns, FTS errors, over-large output, empty results.
SKILL.md query routing updated to point at the three reference tiers.
Teach the agent to derive second-pass filters from first-pass evidence
instead of pulling large message windows. Add the pattern and a pitfall
warning against defaulting to LIMIT 25 transcript browsing.
Teach the agent to keep intermediate retrieval inside the query script
and return compact evidence in a single turn, instead of spending
multiple conversation rounds showing raw results. Add the pattern to
query-patterns.md and the rationale to pitfalls.md.
Split the monolithic skill prompt into three tiers:
- Core API (search/context/sql) stays in the first prompt
- Structured helpers listed as one-liners with filter signatures
- Detailed patterns and pitfalls extracted to references/
Add references/query-patterns.md (copyable CodeAct recipes) and
references/pitfalls.md (scope, FTS, ordering, compactness traps).
Clarify project scope semantics (slug vs path vs cwd) throughout.
Add ORDER BY timestamp DESC to failures() for newest-first default.
tommy0103