fresh-context-review
Skill1 starsChanged 3 months agoMITView on GitHub
Review one substantial implementation in a fresh read-only context against its bounded issue, acceptance criteria, diff, standards, boundaries, and complete verification evidence.
3 other projects use a version of this.
Adopted by
Most recently taken up by
- fmmenchi/ai-skillstheir own version, first seen Oct 16, 2026
- mahik504/orchestra-workflowtheir own version, first seen Oct 15, 2026
- songjiun10-collab/Senior-thinking-skillstheir own version, first seen Oct 12, 2026
Other versions3 projects use a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 3
- songjiun10-collab/Senior-thinking-skills★ 87same name
- mahik504/orchestra-workflow★ 1same name
- fmmenchi/ai-skills★ 0same name
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository28 other files it gives its agents.
- AGENTS.mdAGENTS.md
- skills/vercel-react-best-practices/AGENTS.mdAGENTS.md
- ai-sdkSkill
- anti-slopSkill
- architecture-auditSkill
- browseSkill
- cavemanSkill
- context-budgetSkill
- design-mdSkill
- e2e-testingSkill
- error-handlingSkill
- find-skillsSkill
- frontend-designSkill
- graph-memorySkill
- grill-meSkill
- listenSkill
- manual-qa-planSkill
- next-best-practicesSkill
- nextjs-app-router-patternsSkill
- prd-to-issuesSkill
- project-feedbackSkill
- project-memorialSkill
- scrollcraftSkill
- sequential-afk-runnerSkill
- shadcnSkill
- tddSkill
- vercel-react-best-practicesSkill
- write-prdSkill
The file
We split this skill into the rules it gives an agent
7 rules. 0 are common, 6 are distinctive, and 1 is very specific to this project.
0
Common
Most of the 3 edited versions we read keep these.
6
Distinctive
This author's own choices. Worth a look.
1
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 8
Use this skill after one bounded implementation and its project-feedback checks.
- Distinctive: line 14
When the reviewer acts as a calibration judge, three rules are mandatory:
- Very specific: line 16
Version stamp: Every judge output carries a Judge Version Stamp section naming the model id, the skill/prompt version, and the UTC date.
- Distinctive: line 22
Never blend dimensions into a single verdict.
- Distinctive: line 45
Start a fresh reviewer context with only the artifact bundle.
- Distinctive: line 61
Do not use them for general acceptance, scope, architecture, or style review.
- Distinctive: line 102
If there are no findings, say so explicitly but still return every section.
“Common” is measured: kept by at least 6 in 10 of the 3 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Fresh-Context Review
Use this skill after one bounded implementation and its project-feedback checks. The reviewer must be a new context that did not produce the implementation. Review is read-only and is not human acceptance.
Judge Protocol (calibration)
When the reviewer acts as a calibration judge, three rules are mandatory:
- Version stamp. Every judge output carries a
Judge Version Stampsection naming the model id, the skill/prompt version, and the UTC date. A verdict without a version stamp is not admissible calibration evidence. - One dimension per invocation. Grade exactly one dimension per judge run (correctness, completeness, or style). If a review would grade more than one, split it into separate judge passes and report each dimension separately. Never blend dimensions into a single verdict.
- Unknown escape. Return
UNKNOWNwhen the evidence in the diff, sources, and verification records is insufficient to decide. Never fabricate a verdict to avoid returningUNKNOWN.
Entry Gate
Require these complete inputs before reviewing:
- one bounded issue and its observable acceptance criteria;
- the implementation diff, including every changed file;
- applicable project standards, constraints, non-goals, and module boundaries;
- complete verification evidence with commands, cwd, environment provenance, duration, exit codes, results, and complete log or artifact paths.
Return BLOCKED when an input is absent or selected excerpts replace available
complete evidence. Return UNKNOWN when every required input is present but the
evidence is insufficient to decide a verdict — an unverifiable assumption is not
a basis for PASS or FAIL. Do not infer omitted requirements, inspect producer chat, or ask
the producing context to explain its intent.
Independence and Permissions
Start a fresh reviewer context with only the artifact bundle. Read only the supplied project artifacts and directly relevant source needed to validate file and line evidence. Never edit files, run shell commands, invoke an implementer, weaken or rewrite tests, remediate findings, or claim human acceptance.
The general reviewer owns the integrated verdict. Delegate only when applicable:
security-reviewer: authentication, authorization, input, secrets, and other security-sensitive surfaces;silent-failure-hunter: swallowed errors, unsafe fallbacks, and missing error propagation;pr-test-analyzer: behavioral test quality, misleading assertions, changed-path coverage, and regressions not exercised by tests.
Give each specialist the same bounded artifact bundle and only its named scope. Specialists are advisory, read-only contexts and do not issue the integrated verdict. Do not use them for general acceptance, scope, architecture, or style review.
Review Method
- Map every acceptance criterion to implementation and test evidence.
- Trace each changed hunk to the issue, module boundaries, constraints, or a named necessary support change; flag unrelated changes.
- Inspect behavior, boundary values, failure paths, authorization, and regressions.
- Assess whether tests would fail for the seeded defect rather than merely execute code or assert a weak proxy.
- Assess verification evidence independently. A reported pass is not proof when commands, logs, applicable checks, or assertions are incomplete or misleading.
- Incorporate applicable specialist findings, remove duplicates, and preserve the highest justified severity.
Findings must describe an observable defect or concrete risk. Cite the exact
path:line in the supplied post-change source or test artifact and tie the evidence
to an acceptance criterion, standard, boundary, changed behavior, or verification
claim. Order findings critical, high, medium, then low.
An unresolved critical or high finding, failed required check, missing complete
input, acceptance gap, authorization failure, swallowed error, unrelated change, or
uncovered regression makes the verdict FAIL or BLOCKED, never PASS.
Result Contract
Return exactly these sections:
Verdict:PASS,FAIL,BLOCKED, orUNKNOWN, with one factual reason.Blocking Findings: severity-ordered findings, each withpath:line, issue, impact, evidence, and required change; writeNoneonly when justified.Non-Blocking Findings: same shape, orNone.Required Changes: a deduplicated list mapped to finding IDs, orNone.Acceptance-Criteria Coverage: every criterion markedcovered,partial, oruncovered, with implementation and test evidence.Verification-Evidence Assessment: applicable checks, exact evidence quality, failures, omissions, misleading claims, and whether evidence supports the verdict.Residual Risks: risks remaining after the review, including unavailable checks and human QA needs; never claim human acceptance.Judge Version Stamp: model id, skill/prompt version, and UTC date of the run.
If there are no findings, say so explicitly but still return every section. The review result is an independent engineering assessment, not issue completion, merge approval, deployment approval, or final human acceptance.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
Reviews can't be read right now.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

