docs: add AGENTS.md with worktree-based workflow guidelines#3
Merged
Conversation
Codecov Report✅ All modified and coverable lines are covered by tests. Additional details and impacted files@@ Coverage Diff @@
## main #3 +/- ##
=====================================
Coverage 7.49% 7.49%
=====================================
Files 1 1
Lines 387 387
=====================================
Hits 29 29
Misses 357 357
Partials 1 1 🚀 New features to boost your workflow:
|
Create comprehensive guidelines for AI coding agents working on this project. Key principle: Agents should use wt to create worktrees for each task instead of switching branches in the main repository. Benefits: - User's main repo stays on main branch (non-disruptive) - Each feature gets isolated directory - Demonstrates best practices for the tool itself - Enables parallel work on multiple features Includes: - Golden rule: use worktrees, not branch switching - Complete agent workflow examples - Interactive command usage - PR/MR workflow - Common pitfalls to avoid - Project-specific conventions This ensures agents practice what wt preaches - proper worktree usage! 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
4bb04ed to
1320f6d
Compare
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Add
AGENTS.mdwith comprehensive guidelines for AI coding agents working on thewtproject.Key principle: Agents should use
wtto create worktrees for each task, not switch branches in the user's main repository.Changes
AGENTS.mdwith agent-specific workflow guidelinesWhy This Matters
AI agents often switch branches in the main repo, which:
Using worktrees:
mainbranchExample Agent Workflow
Meta Note
This PR itself was created using a worktree! 🎯
wt create docs/add-agents-guide # Worked in the worktree, not main repo🤖 Generated with Claude Code