template-validation-quality git:20260524.1029201A

Immutable. This exact content is served forever at /api/v1/blob/11465255988cdd16.

---
name: template-validation-quality
description: |
  Run validation CLI, prerender, markdown/PDF/integrity gates, and QA workflows for the
  Research Project Template. USE WHEN validate manuscript, check PDF for ?? refs, prerender
  gate, link checker, output integrity, or pre-commit validation — even without
  validation_quality prompt.
---

# Validation quality

Prefer **actual CLI entrypoints** in [`CLAUDE.md`](../../../CLAUDE.md) — not illustrative Python stubs.

## Natural invoke

- "Validate markdown under projects/template_prose_project/manuscript/"
- "PDF has unresolved references — run validation"
- "Strict prerender before render"

## Inputs to confirm

- **Target** — manuscript dir, PDF path, or `output/<project>/`.
- **Project** — from active_projects when path ambiguous.

## Workflow

1. **Source markdown** — `infrastructure.validation.cli markdown` and/or `prerender`.

2. **Citations** — `infrastructure.reference.citation validate` on `.bib`.

3. **Links** — `infrastructure.validation.cli links --repo-root .`

4. **PDF** — after render: `cli pdf output/<project>/pdf/`

5. **Integrity** — `cli integrity output/<project>/`

6. **Report** — diagnostic codes from validation; path + fix per issue.

## Deliverables

- Command list with exit codes
- Issue table: code | file | message | fix

## Verification commands

```bash
uv run python -m infrastructure.validation.cli prerender projects/<project>/manuscript --repo-root .
uv run python -m infrastructure.validation.cli markdown projects/<project>/manuscript --repo-root . --strict
uv run python -m infrastructure.reference.citation validate projects/<project>/manuscript/references.bib
uv run python -m infrastructure.validation.cli links --repo-root .
uv run python -m infrastructure.validation.cli pdf output/<project>/pdf/
uv run python -m infrastructure.validation.cli integrity output/<project>/
uv run python -m infrastructure.prose.cli report projects/<project>/manuscript
```

## When NOT to use

- **Failing pipeline stage triage** → [pipeline-debugging](../pipeline-debugging/SKILL.md)
- **Claim-by-claim manuscript audit** → [manuscript-claim-verification](../manuscript-claim-verification/SKILL.md)

## References

- [`infrastructure/validation/AGENTS.md`](../../../infrastructure/validation/AGENTS.md)