jj-ai-guide

Automate JJ repository version-control workflows with safe, non-interactive steps.

2|1|Updated Jul 20, 2025
One-click install
npx skills add https://github.com/nushell-prophet/my-dotfiles --skill jj-ai-guide
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: jj-ai-guide
Source: https://github.com/nushell-prophet/my-dotfiles/tree/main/claude/skills/jj-ai-guide
Command: npx skills add https://github.com/nushell-prophet/my-dotfiles --skill jj-ai-guide

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

AI agents often struggle with JJ's complex workflows and safety constraints. This guide provides structured, safe patterns to navigate common version-control tasks in JJ without relying on interactive prompts.

Core Features & Use Cases

  • Comprehensive AI-ready JJ workflow patterns for commits, describes, squashes, creates, and metaediting with safe defaults.
  • Clear guidance on conflict handling, resolution, and recovery workflows to maintain history integrity.
  • Authorship management, bookmarking strategies, and workflow templates to improve auditability and collaboration.

Quick Start

Try a simple flow: check status, create a new working commit, describe it, and squash changes back to the parent using AI-safe steps.

Frequently Asked Questions about jj-ai-guide

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

FAQPage Schema
How do I automate safe version-control commits in a JJ repository using an AI agent?

To automate safe version-control commits in a JJ repository, AI agents must use non-interactive, step-by-step workflow patterns that apply safe defaults for creating commits and squashing changes. This ensures strict history integrity without relying on interactive prompts.

What is the best way to resolve conflicts in JJ without interactive prompts?

Resolving conflicts in JJ without interactive prompts requires structured AI-guided workflows that explicitly handle conflict resolution and recovery operations. This approach maintains history integrity by following strict, non-interactive recovery steps.

How do AI agents manage authorship and bookmarking strategies in JJ?

AI agents manage authorship and bookmarking strategies in JJ by applying workflow templates that provide explicit handling of authorship attribution. This improves auditability and collaboration across multiple commits during automated version-control operations.

Can I audit version-control history across multiple commits in JJ automatically?

Yes, you can audit version-control history across multiple commits in JJ automatically by using AI-guided workflows designed for non-interactive usage. These workflows provide explicit handling of history auditing and metaediting to ensure strict safety constraints.

Why do AI agents struggle with JJ version-control workflows and safety constraints?

AI agents struggle with JJ version-control workflows and safety constraints because JJ requires strict, non-interactive step-by-step operations. Without structured guidance, agents fail to navigate complex tasks like distributing changes, squashing, and conflict resolution safely.

Does this JJ workflow guide support editing commit descriptions and squashing changes non-interactively?

Yes, this JJ workflow guide supports non-interactive editing of commit descriptions and squashing changes. It provides comprehensive, AI-ready patterns with safe defaults for describes, squashes, creates, and metaediting to ensure safe automated version-control operations.