change-control-and-handoffs

Governs spec workflow, handoff documents, git conventions, and cross-repo schema contracts for PalFish GMV.

1|Updated May 23, 2026
One-click install
npx skills add https://github.com/palfish-t-i-u/palfish-t-i-u-h-th-ng-ver-2 --skill change-control-and-handoffs-palfish-t-i-u
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: change-control-and-handoffs
Source: https://github.com/palfish-t-i-u/palfish-t-i-u-h-th-ng-ver-2/tree/main/.claude/skills/change-control-and-handoffs
Command: npx skills add https://github.com/palfish-t-i-u/palfish-t-i-u-h-th-ng-ver-2 --skill change-control-and-handoffs-palfish-t-i-u

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Engineering teams on the PalFish GMV project lose time and cause incidents when handoff documents contain guessed table names, solutions skip root-cause evaluation, or schema changes silently break the shared Supabase database used by the pf-revenue repo. This Skill encodes the full change-control doctrine so every spec, handoff, commit, and schema change follows verified team rules. ## Core Features & Use Cases - Handoff document authoring: Enforces the canonical handoff structure (Origin, chốt decision, verified context, scope, acceptance criteria, test plan, anti-patterns) with a hard rule to grep-verify every table, column, and line number before writing. - Solution evaluation: Applies the three mandatory criteria (triệt để, không lỗi con, no infra/performance regression) to any proposed change before acceptance. - Spec workflow & task naming: Guides prototype-to-spec conversion using docs/SPEC_TEMPLATE.md and maintains TOP1/TOP2/TOP3/VAC-XX task-wave naming conventions. - Cross-repo safety: Requires impact checks on the shared bank_transactions table before any schema change that could affect pf-revenue's Lark sync. - Use Case: Before writing a handoff for a new bill softlock feature, run the grep verification commands to confirm actual column names in backend code, then produce a handoff with a verified context section and the mandatory tsc/test acceptance gate. ## Quick Start Ask the assistant to draft a handoff document for a new PalFish GMV task following the change-control rules, verifying all table and column names with grep first.

Frequently Asked Questions about change-control-and-handoffs

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I write a handoff document for an engineering team?

Use the canonical structure: Origin with the stakeholder quote, the locked decision, verified context with grep-confirmed file paths and line numbers, IN/OUT scope lists, per-file changes, numbered acceptance criteria ending with tsc and test gates, a test plan, and an anti-patterns section.

How do I verify table and column names before writing technical docs?

Run grep -rn against the backend source for each table and column name before citing them, and confirm line numbers with grep -n on the specific file. Only label a context section as verified after manually confirming every reference against current source.

What commit message format should I use for feature branches?

Use conventional prefixes: feat(scope), fix(scope), docs(scope), refactor(scope), or test(scope). Squash related commits into one before merging a feature branch, keeping only merge commits like sandbox-to-main merges intact.

Can I change the bank_transactions schema if another repo shares the database?

Only after a cross-repo impact check. Grep this repo's backend for bank_transactions references, then manually check the pf-revenue repo for the same column names, since it reads that table for Lark Base sync and schema changes can silently break it.

When should I not use this change-control workflow?

Do not use it for day-to-day code style decisions, deploy procedures, or database migration mechanics. Those belong to the frontend-conventions, backend-conventions, deploying-gmv, and database-and-migrations skills respectively.