Content
68%Weight 40%Scale 1-5Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
A lean, command-heavy dispatcher body that is largely copy-paste actionable and clearly organized by assay. Its main weaknesses are implicit validation (the readiness gate is described as an output but not as a checkpoint) and a BAM/direct-MACS2 path with no concrete command.
Suggestions
Add an explicit validation checkpoint after preflight, e.g. 'Review peak_calling_readiness.json; resolve flagged samples before kickoff' with a retry loop on failure.
Provide a concrete MACS2 command example for the focused peak-calling-from-prepared-BAMs path.
Replace the changelog phrasing ('now also emit') with a plain statement of outputs, and trim the description of what the shared FASTQ package validates.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dominated by copy-paste commands and terse checklists with almost no padding, and it assumes Claude's competence (no explanation of what ATAC-seq or peak calling is). Minor trimmable spots remain: the sentence describing what the package 'validates... runs seqkit stats and FastQC/MultiQC' and the changelog-style 'now also emit' phrasing, so it sits at the 4 anchor rather than the 5 anchor where every token earns its place. | 4 / 5 |
Actionability | Concrete executable commands throughout: the preflight invocation with flags, the run_fastq_assay_package.py call with arguments, and three complete Nextflow kickoff commands covering all assay families. It falls short of 5 because the 'direct MACS2' path for prepared BAMs has no command, and there is no example of interpreting the emitted peak_calling_readiness.json. | 4 / 5 |
Workflow Clarity | The sequence is present and readable (confirm inputs, choose workflow by assay, preflight, FASTQ package, kickoff), but validation is implicit: peak_calling_readiness.json is mentioned as an output yet there is no explicit checkpoint or feedback loop saying what to check or what to do when preflight fails. For a batch NGS pipeline without an explicit validation checkpoint, the rubric caps this at 3; it does not reach 4 because the checkpoints are missing rather than merely having minor gaps. | 3 / 5 |
Progressive Disclosure | Sections are well organized with a clear dispatcher role and explicit handoff to named assay-specific skills, and the body stays a lean overview rather than inlining workflow detail. It does not reach 5 because the referenced script paths (plugins/ngs-analysis/scripts/...) live outside the bundle with no local reference files, and there are no clearly signaled reference docs for the delegated assay workflows. | 4 / 5 |
Total | 15 / 20 Passed |