hapo:sync

Synchronize spec files and task tracking within Claude Code workflows.

54|Updated Jan 21, 2026
One-click install
npx skills add https://github.com/haposoft/cafekit --skill hapo-sync
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: hapo:sync
Source: https://github.com/haposoft/cafekit/tree/main/packages/spec/src/claude/skills/sync
Command: npx skills add https://github.com/haposoft/cafekit --skill hapo-sync

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

The hapo:sync skill addresses the challenges of maintaining accurate spec state, task tracking, and consistency between the documentation and development workflows by providing a reliable way to update spec files and track tasks.

Core Features & Use Cases

  • State Tracking: Synchronizes spec.json, task_registry, and markdown files for tasks.
  • Task Synchronization: Updates task status with evidence-backed tracking.
  • Phase Advancement: Automatically prompts for phase advancement based on completed tasks.
  • State Audit: Ensures spec and task tracking consistency and corrects mismatches.

Quick Start

Synchronize and track a task: /hapo:sync auth R0-02 done

Frequently Asked Questions about hapo:sync

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

FAQPage Schema
How do I automate spec and task tracking consistency in my development workflow?

To automate spec and task tracking consistency, you can use a synchronization skill that updates spec files and task registries with evidence-backed state tracking. It ensures documentation accurately reflects development progress by maintaining YAML schema adherence across files.

What is state tracking for spec files and how does it keep task registries accurate?

State tracking for spec files is the process of synchronizing spec.json, task registries, and markdown files to reflect current development phases. It keeps task registries accurate by enforcing consistency and correcting mismatches between documentation and actual workflow state.

How do I synchronize a task status to done using YAML schema adherence?

To synchronize a task status to done, you execute a sync command with the task identifier and status. This triggers precise file manipulations that update the task registry and markdown files while maintaining strict YAML schema adherence.

Can I use automated phase advancement to prompt for the next development stage?

Yes, you can use automated phase advancement to prompt for the next development stage. The system automatically detects completed tasks and prompts for phase advancement, ensuring the workflow progresses only when task tracking criteria are met.

Does the hapo:sync skill work within the Claude Code workflow environment?

Yes, the hapo:sync skill is specifically designed to work within the Claude Code workflow. It integrates with this environment to provide automated state tracking, evidence-backed updates, and phase progression for development tasks.

Why does my task registry have mismatches with the spec.json file?

Your task registry has mismatches with the spec.json file due to manual updates breaking consistency. Performing a state audit automatically detects these inconsistencies and corrects them by synchronizing the spec state with the task tracking data.