Skip to main content

Local commit gate

The generated pre-commit hook runs validate. Configure it once in each clone.

GitHub Actions

init and adopt generate CI and deployment workflows. They pin third-party Actions to full commit SHAs and fail closed when real project checks or deployment steps have not been configured. After integration, connect the project’s own install, build, test, and deployment commands. For passing_is_monotonic to detect a state regression in a fresh checkout, CI must fetch enough Git history and provide a resolvable Git baseline:
See the validate command → GitHub Actions also recognizes GITHUB_BASE_REF. Without a Git baseline, the tool falls back to the local successful validation snapshot. If neither exists, it does not report a false regression.

Repository governance check

See the provider github check options → This command checks the GitHub configuration for the target branch. It infers owner and repo from origin by default, or you can provide them explicitly:
See the owner, repo, and branch options → PASS means the configuration was confirmed to meet the requirements, FAIL means it was confirmed not to meet them, and UNKNOWN means the current token lacks administrator permissions, so the result cannot be determined. This command does not run feature tests and does not replace validate.

Import CI evidence

See the evidence import options → Before importing, the tool uses gh api to confirm that the run completed successfully. Add --owner and --repo when you need to specify the repository explicitly.

Cross-machine claims

See the claim --push options → Git is not a real-time lock: two machines can claim the same feature locally at the same time. --push commits and pushes the claim. If the remote has already confirmed a claim for the same feature, the tool synchronizes and then attempts to claim the next ready feature. Use --remote and --branch to change the target.
Do not treat a regular local claim as a cross-machine lock. For cross-device collaboration, use --push and synchronize remote state before starting work.