| namespace | aiwg |
| name | quality-assess |
| platforms | ["all"] |
| description | Perform GRADE quality assessment on a research source |
| commandHint | {"category":"research-quality"} |
Quality Assess Command
Perform a GRADE evidence quality assessment on a research source or finding.
Instructions
When invoked, perform systematic GRADE assessment:
-
Load Source
- Accept REF-XXX identifier or file path
- Load frontmatter metadata
- Determine source type and baseline quality
-
Apply GRADE Framework
- Evaluate 5 downgrade factors (bias, inconsistency, indirectness, imprecision, publication bias)
- Evaluate 3 upgrade factors (large effect, dose-response, confounding)
- Calculate final GRADE level
-
Generate Assessment
- Fill assessment template per @.aiwg/research/docs/grade-assessment-guide.md
- Include hedging language recommendations
- Include applicability notes for AIWG context
-
Save Assessment
- Save to
.aiwg/research/quality-assessments/{ref-id}-assessment.yaml
- Update frontmatter in source document if --update-frontmatter
-
Report
- Display GRADE level with confidence statement
- Show allowed vs forbidden hedging language
- Flag any existing citations that violate the assessed quality level
Arguments
[ref-id or file-path] - Source to assess (required)
--output [yaml|markdown] - Output format (default: yaml)
--update-frontmatter - Update source document frontmatter with assessment
--check-citations - Also check existing citations of this source for GRADE compliance
References
- @.aiwg/research/docs/grade-assessment-guide.md - GRADE methodology
- @$AIWG_ROOT/agentic/code/frameworks/sdlc-complete/agents/quality-assessor.md - Quality Assessor agent
- @$AIWG_ROOT/agentic/code/frameworks/sdlc-complete/schemas/research/quality-dimensions.yaml - Quality schema
- @$AIWG_ROOT/agentic/code/frameworks/sdlc-complete/rules/citation-policy.md - Hedging language rules