source-command-qcheck

SkillFiles & storage

Skeptical staff-engineer code review of changed files against coding-standards.md.

Available today. Use it from your connected AI after setup.

Connect ahel once, and every AI you use reads what you have installed.

Then ask your AI: use the source-command-qcheck skill

What this skill tells your AI

The instructions your AI receives, as published by vscarpenter/gsd-task-manager in .agents/skills/source-command-qcheck/SKILL.md and read by ahel’s review.

Use this skill when the user asks to run the migrated source command qcheck.

Command Template

Review all changed files in this session as a skeptical staff engineer for the gsd-taskmanager codebase. Apply the full coding-standards.md and AGENTS.md rules.

Run git status and git diff first to see what has changed. Then evaluate each changed file against:

  1. Standards compliance — Files ≤350 lines, functions ≤30 lines, ≤3 nesting levels, no magic numbers, descriptive naming.
  2. Type safety — All function signatures typed, no any without justification, Zod validation at boundaries (user input, import, MCP tool inputs).
  3. TDD evidence — Were tests written first? Check git log if uncertain. Each new behavior should have a behavior-named test.
  4. Test quality — Positive AND negative cases. Coverage ≥80% for changed files. Independent tests (no shared mutable state). Mocks at boundaries, not deep.
  5. Error handling — Typed errors, no swallowed exceptions, toast.error() from sonner instead of window.alert().
  6. Project-specific gotchas:
    • PocketBase: client_updated_at (not updated) in sort/filter, _superusers admin endpoint, 100ms push throttle, batch lookups not N+1.
    • Schema: .safeParse() (not .parse()) on user input paths; import uses .strip(), export uses .strict().
    • Tests: bun run test (not bun test); localStorage.removeItem(key) (not clear()).
    • UI: toast.error() (not alert()); accessibility baseline from coding-standards Part 2.
  7. Security — Input validation, no committed secrets, parameterized queries, least privilege.
  8. Observability — Structured logging via lib/logger.ts, no console.* in production paths, no PII in logs.
  9. Definition of Done — Every box in coding-standards.md Part 7 "Definition of Done" checklist.

Distinguish blocking issues from suggestions. Prefix non-blocking comments with nit: or suggestion:.

Do not rewrite the code. Return a structured list of findings, organized by file, with file:line — issue — fix.

Signals

GitHub stars
25
Forks
3
Last commit
Sep 2026
Advanced
Catalog kind
skill
Gateway key
source-command-qcheck
Source
github.com/vscarpenter/gsd-task-manager