Skip to content

DangQuangSE/team-development-skills / .agents/skills/ck-quality

ck:quality

Verified

Independent senior-engineering quality auditor — architecture, ownership, domain integrity, abstraction, and maintainability. Use as `--gate` inside the ck:cook pipeline (blocks a phase on BLOCKER/HIGH/current-change MEDIUM findings) or call directly with `--audit`, `--diff`, `--changed` on any repository, directory, or file. Never writes tests and never edits production code — it returns structured findings only; ck:cook or ck:fix apply the fix.

FileKindSize
SKILL.mdskill md7.6 KB
references/adapters.mdmarkdown4.4 KB
references/core-contract.mdmarkdown14.3 KB
references/receipt-schema.jsonconfig3.5 KB
references/report-schema.jsonconfig3.2 KB
scripts/receipt.pyscript10.8 KB

references/receipt-schema.json

View on GitHub
{
  "_comment": "Example ck:quality receipt. Issued only by scripts/receipt.py issue, only for a report whose verdict is APPROVED with zero open blocking findings. Verified by scripts/receipt.py verify and by hooks/quality_receipt_gate.py. Not a JSON-Schema document — an annotated canonical instance, matching this pack's plan-schema.json convention.",

  "target": "phase-02-receipt-gate",
  "_target": "The phase file stem this receipt clears for completion — e.g. the stem of phase-02-receipt-gate.md or phase-02-receipt-gate.json. Matches report.target from the report it was issued from.",

  "verdict": "APPROVED",
  "_verdict": "Always APPROVED. A CHANGES_REQUIRED report never produces a receipt.",

  "policy_version": "1.1.0",
  "_policy_version": "Must equal scripts/receipt.py POLICY_VERSION at verify time. A version mismatch invalidates the receipt even if the fingerprint still matches — it forces re-verification under the current contract after a policy change.",

  "root": "D:/GitHub/MySkills",
  "_root": "The filesystem common ancestor of report_path and every reviewed_files entry, computed once at issue time (not necessarily a git root — in a polyrepo project it can be the shared parent folder above sibling repos). report_path and reviewed_files below are stored relative to this root. Verify reads root back from here; it never re-derives or is told where it is. null only when the report and a reviewed file share no common filesystem root (e.g. different Windows drives), in which case report_path/reviewed_files are stored as absolute paths instead.",

  "report_path": "plans/development-quality-pipeline/quality/phase-02-receipt-gate-quality-report.json",
  "_report_path": "Path to the exact report this receipt was derived from, relative to root (or absolute — see _root).",

  "reviewed_files": [
    "development-skills/skills/ck-quality/scripts/receipt.py"
  ],
  "_reviewed_files": "Copied from report.reviewed_files, resolved and re-expressed relative to root (or absolute — see _root), sorted by that stored path.",

  "source_fingerprint": "sha256:...",
  "_source_fingerprint": "sha256 over the report file's exact bytes plus every reviewed file's exact current bytes, in sorted path order. Any change to the report or to a reviewed file after issuance invalidates this hash.",

  "reviewed_at": "2026-07-10T10:30:00Z",
  "_reviewed_at": "Copied from report.reviewed_at — informational only, not part of the trust check.",

  "open_blocking_findings": 0,
  "_open_blocking_findings": "Always 0. Recomputed independently from report.findings at issue time (OPEN + BLOCKER/HIGH, or OPEN + MEDIUM with introduced_by_current_change true) rather than trusted from report.summary.",

  "_verification_rule": "A receipt is VALID only when: its filename is {target}-receipt.json; target matches both the guarded phase and report.target; verdict is APPROVED; policy_version matches current; open_blocking_findings is 0; report_path and every reviewed_files entry resolve (against the stored root, or as absolute paths) and still exist on disk; and recomputing source_fingerprint from current disk contents produces an identical hash. Any other outcome is INVALID and the completion transition it guards must be blocked.",

  "_scope_disclaimer": "A valid receipt proves the reviewed report and reviewed files are byte-identical to what an APPROVED verdict was issued against. It does not itself prove the semantic review (SOLID, ownership, architecture) was correct — that judgment lives in the report the receipt points to."
}
rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit.Stars: 471kUpdated Claude CodeCodexVerifiedInstall
rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure.Stars: 471kUpdated Claude CodeCodexVerifiedInstall
rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics.Stars: 471kUpdated Claude CodeCodexVerifiedInstall
ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first.Stars: 194kUpdated Claude CodeCodexVerifiedInstall