Repository manualdocs/RESEARCH_BASIS.md

Research Basis

Canonical documentation rendered from the repository docs/ folder.

referenceSource file

Research Basis

The suite applies prompt-engineering techniques selectively according to task, model, risk, and output medium. No technique is treated as a universal incantation. The operating standard is clarity, relevant context, explicit boundaries, fit-for-purpose examples, structured outputs, tool-aware verification, and empirical evaluation.

Primary guidance

Research surveys

Operator-supplied explorations

Applied conclusions

1. Tags and signs are readability and delimitation mechanisms; they are not hidden commands or standalone security controls. 2. Stable contracts belong in the control plane; capability prompts contain only task-changing evidence, method, risk, medium, and quality details. 3. Examples are optional and should be diverse, relevant, and short enough to clarify rather than dominate. 4. Factual work requires retrieval, provenance, claim support, uncertainty, and verification. 5. Creative work benefits from divergent candidates and rubric-guided convergence, but imaginative work must not manufacture evidence. 6. Complex work should be chained only when stages have genuinely different responsibilities and a useful handoff. 7. Visual and interactive outputs need medium-specific contracts, accessibility, responsive behavior, and exact export review. 8. Prompt quality is an empirical property: representative fixtures, adversarial cases, and regression evaluation matter more than ornamental complexity.

Evidence standard for suite claims

Guidance and surveys justify methods to test, not claims that this specific suite performs well. Suite-level quality claims require its own fixtures, model runs, skill conformance, and human review. The package therefore separates structural validation from external behavioral evidence and records unmeasured surfaces explicitly.