mirror of
https://github.com/SuperClaude-Org/SuperClaude_Framework.git
synced 2025-12-29 16:16:08 +00:00
Clean up references to deleted scripts and pattern system
- Removed references to validate-references.sh from YAML files - Removed expand-references.sh from settings.local.json - Cleaned up @pattern/@flags references from shared files - Updated documentation to reflect current no-code implementation - Simplified reference-index.yml to remove @include patterns This cleanup removes confusion from the abandoned pattern reference system while maintaining all functionality. 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
@@ -1,47 +1,260 @@
|
||||
# /git - Manage git workflows and repository operations
|
||||
|
||||
## Legend
|
||||
| Symbol | Meaning | | Abbrev | Meaning |
|
||||
|--------|---------|---|--------|---------|
|
||||
| → | leads to | | repo | repository |
|
||||
| & | and/with | | sync | synchronize |
|
||||
| w/ | with | | chkpt | checkpoint |
|
||||
| → | leads to | | cfg | configuration |
|
||||
| & | and/with | | impl | implementation |
|
||||
| w/ | with | | perf | performance |
|
||||
| @ | at/located | | ops | operations |
|
||||
| > | greater than | | val | validation |
|
||||
| ∀ | for all/every | | req | requirements |
|
||||
| ∃ | exists/there is | | deps | dependencies |
|
||||
| ∴ | therefore | | env | environment |
|
||||
| ∵ | because | | db | database |
|
||||
| ≡ | equivalent | | api | interface |
|
||||
| ≈ | approximately | | docs | documentation |
|
||||
| 📁 | directory/path | | std | standard |
|
||||
| 🔢 | number/count | | def | default |
|
||||
| 📝 | text/string | | ctx | context |
|
||||
| ⚙ | setting/config | | err | error |
|
||||
| 🎛 | control/flags | | exec | execution |
|
||||
| 🔧 | configuration | | qual | quality |
|
||||
| 📋 | group/category | | rec | recovery |
|
||||
| 🚨 | critical/urgent | | sev | severity |
|
||||
| ⚠ | warning/caution | | resp | response |
|
||||
| 🔄 | retry/recovery | | esc | escalation |
|
||||
| ✅ | success/fixed | | tok | token |
|
||||
| ❌ | failure/error | | opt | optimization |
|
||||
| ℹ | information | | UX | user experience |
|
||||
| ⚡ | fast/quick | | UI | user interface |
|
||||
| 🐌 | slow/delayed | | C | critical |
|
||||
| ✨ | complete/done | | H | high |
|
||||
| 📖 | read operation | | M | medium |
|
||||
| ✏ | edit operation | | L | low |
|
||||
| 🗑 | delete operation | | |
|
||||
|
||||
@include shared/command-templates.yml#Command_Header
|
||||
## Purpose
|
||||
Manage comprehensive git workflows for repositories specified in $ARGUMENTS with safety checks and automation.
|
||||
|
||||
Manage git workflows for repo in $ARGUMENTS.
|
||||
## Syntax
|
||||
`/git [flags] [operation/message]`
|
||||
|
||||
@see shared/thinking-modes.yml ∀ thinking flags
|
||||
## Universal Flags
|
||||
--plan: "Show execution plan before running"
|
||||
--uc: "UltraCompressed mode (~70% token reduction)"
|
||||
--ultracompressed: "Alias for --uc"
|
||||
--think: "Multi-file analysis w/ context (4K tokens)"
|
||||
--think-hard: "Deep architectural analysis (10K tokens)"
|
||||
--ultrathink: "Critical system redesign (32K tokens)"
|
||||
--c7: "Enable Context7→library documentation lookup"
|
||||
--seq: "Enable Sequential→complex analysis & thinking"
|
||||
--magic: "Enable Magic→UI component generation"
|
||||
--pup: "Enable Puppeteer→browser automation & testing"
|
||||
--all-mcp: "Enable all MCP servers"
|
||||
--no-mcp: "Disable all MCP servers (native tools only)"
|
||||
--no-c7: "Disable Context7 specifically"
|
||||
--no-seq: "Disable Sequential thinking specifically"
|
||||
--no-magic: "Disable Magic UI builder specifically"
|
||||
--no-pup: "Disable Puppeteer specifically"
|
||||
## Execution Control
|
||||
--watch: "Continuous monitoring w/ real-time feedback"
|
||||
--interactive: "Step-by-step guided process w/ user control"
|
||||
--dry-run: "Preview changes without execution"
|
||||
--force: "Override safety checks & confirmations"
|
||||
|
||||
Examples:
|
||||
- `/user:git --status` - Comprehensive repo status
|
||||
- `/user:git --commit "Add feature"` - Create commit
|
||||
- `/user:git --branch feature/ui` - Create & switch→branch
|
||||
- `/user:git --sync` - Fetch, pull & push
|
||||
- `/user:git --merge develop --think` - Merge w/ conflict analysis
|
||||
## Command-Specific Flags
|
||||
|
||||
Git operations:
|
||||
**Core Operations:**
|
||||
- `--status`: Comprehensive repository status with branch and remote information
|
||||
- `--commit [message]`: Create commit with automated staging and validation
|
||||
- `--branch [name]`: Create, switch, or manage branches
|
||||
- `--sync`: Fetch, pull, and push with conflict resolution
|
||||
- `--merge [branch]`: Merge branches with conflict analysis
|
||||
- `--stash [message]`: Stash management with descriptive messages
|
||||
|
||||
**--status:** Working tree status | Current branch & upstream | Stashed changes | Recent commits (5) | Unpushed commits | Remote status
|
||||
**Advanced Operations:**
|
||||
- `--history`: Detailed commit history with filtering options
|
||||
- `--checkpoint [message]`: Create tagged state snapshots for rollback
|
||||
- `--rollback [checkpoint]`: Rollback to specific checkpoint safely
|
||||
- `--rebase [branch]`: Interactive or automatic rebase operations
|
||||
|
||||
**--commit:** Stage files (-a→all) | Generate message if missing | Follow conventions | Verify tests pass | Create chkpt | GPG sign if configured
|
||||
**Branch Management:**
|
||||
- `--list`: Show all branches with descriptions and status
|
||||
- `--delete [branch]`: Delete merged branches safely
|
||||
- `--track [remote/branch]`: Set up branch tracking
|
||||
|
||||
**--branch:** Create from HEAD/base | Switch to existing | --delete→remove merged | --list→show all w/ descriptions | Auto-track remote | Protect current/main
|
||||
**Safety & Validation:**
|
||||
- `--verify`: Verify repository state and integrity
|
||||
- `--cleanup`: Clean up stale branches and references
|
||||
- `--backup`: Create backup before risky operations
|
||||
|
||||
**--sync:** Fetch all remotes | Pull w/ rebase | Push to tracked remote | Handle auth | Resolve conflicts | Update submodules
|
||||
## Examples
|
||||
- `/git --status` → Comprehensive repository status
|
||||
- `/git --commit "Add authentication feature"` → Create commit with message
|
||||
- `/git --branch feature/ui-redesign` → Create and switch to branch
|
||||
- `/git --sync --verify` → Sync with remote and verify state
|
||||
- `/git --merge develop --think` → Merge with conflict analysis
|
||||
- `/git --checkpoint "Before major refactor"` → Create safety checkpoint
|
||||
- `/git --history --author "john" --since "2024-01-01"` → Filtered history
|
||||
|
||||
**--merge:** Fetch target branch | Check conflicts | Create chkpt | Use merge strategy | Handle conflicts interactively | Verify results
|
||||
## Git Operations
|
||||
|
||||
**--stash:** Save w/ message | List w/ timestamps | Apply/pop specific | Drop old/unnecessary | Handle conflicts
|
||||
**Status Operation (--status):**
|
||||
- Working tree status and staged changes
|
||||
- Current branch and upstream tracking
|
||||
- Stashed changes with timestamps
|
||||
- Recent commits (last 5) with summaries
|
||||
- Unpushed commits count
|
||||
- Remote repository status
|
||||
|
||||
**--history:** Commit log w/ formats | Filter by author/date/path | Branch topology | Search messages | File change stats
|
||||
**Commit Operation (--commit):**
|
||||
- Automatic staging of modified files
|
||||
- Generate conventional commit message if missing
|
||||
- Pre-commit hooks and validation
|
||||
- Test verification before commit
|
||||
- Create automatic checkpoint
|
||||
- GPG signing if configured
|
||||
|
||||
**--checkpoint:** Tagged state snapshot | Descriptive message | Store in manifest | Enable rollback
|
||||
**Branch Management (--branch):**
|
||||
- Create new branch from HEAD or specified base
|
||||
- Switch to existing branch with safety checks
|
||||
- Delete merged branches with verification
|
||||
- List all branches with descriptions
|
||||
- Automatic remote tracking setup
|
||||
- Protection for main/master branches
|
||||
|
||||
**--rollback:** List available chkpts | Verify safety | Pre-rollback chkpt | Execute rollback | Verify state
|
||||
**Sync Operations (--sync):**
|
||||
- Fetch from all configured remotes
|
||||
- Pull with rebase to maintain clean history
|
||||
- Push to tracked remote branch
|
||||
- Handle authentication automatically
|
||||
- Resolve merge conflicts interactively
|
||||
- Update submodules if present
|
||||
|
||||
@see shared/git-workflow.yml ∀ best practices
|
||||
@see shared/checkpoint.yml ∀ checkpoint system
|
||||
@see shared/error-handling.yml ∀ safety checks
|
||||
**Merge Operations (--merge):**
|
||||
- Fetch target branch before merging
|
||||
- Analyze potential conflicts
|
||||
- Create checkpoint before merge
|
||||
- Use appropriate merge strategy
|
||||
- Handle conflicts with interactive resolution
|
||||
- Verify merge results
|
||||
|
||||
Workflow: Check status→Create chkpt→Execute→Verify→Sync
|
||||
**Stash Management (--stash):**
|
||||
- Save changes with descriptive message
|
||||
- List stashes with timestamps and summaries
|
||||
- Apply or pop specific stash entries
|
||||
- Drop old or unnecessary stashes
|
||||
- Handle conflicts during stash application
|
||||
|
||||
**History Operations (--history):**
|
||||
- Formatted commit log with customizable output
|
||||
- Filter by author, date, or file path
|
||||
- Branch topology visualization
|
||||
- Search commit messages
|
||||
- File change statistics
|
||||
|
||||
**Checkpoint System (--checkpoint):**
|
||||
- Create tagged state snapshots
|
||||
- Store with descriptive messages
|
||||
- Maintain checkpoint manifest
|
||||
- Enable safe rollback operations
|
||||
- Track checkpoint metadata
|
||||
|
||||
**Rollback Operations (--rollback):**
|
||||
- List available checkpoints with details
|
||||
- Verify rollback safety
|
||||
- Create pre-rollback checkpoint
|
||||
- Execute rollback with validation
|
||||
- Verify final repository state
|
||||
|
||||
## Workflow Patterns
|
||||
|
||||
**Standard Development Workflow:**
|
||||
1. Check status → Understand current state
|
||||
2. Create checkpoint → Safety backup
|
||||
3. Execute operation → Perform git action
|
||||
4. Verify results → Validate changes
|
||||
5. Sync with remote → Update shared repository
|
||||
|
||||
**Feature Development:**
|
||||
1. `git --status` → Check current state
|
||||
2. `git --branch feature/new-feature` → Create feature branch
|
||||
3. Development work...
|
||||
4. `git --commit "Implement feature"` → Commit changes
|
||||
5. `git --sync` → Push to remote
|
||||
6. `git --merge main` → Integrate with main
|
||||
|
||||
**Safe Operations:**
|
||||
- Always create checkpoints before risky operations
|
||||
- Verify repository state after major changes
|
||||
- Use interactive mode for conflict resolution
|
||||
- Maintain clean commit history with conventional messages
|
||||
|
||||
## Deliverables
|
||||
- **Updated Repository State**: Clean, consistent git history
|
||||
- **Branch Management**: Organized branch structure
|
||||
- **Remote Synchronization**: Up-to-date remote repositories
|
||||
- **Audit Trail**: Complete history of operations
|
||||
- **Safety Checkpoints**: Rollback points for recovery
|
||||
|
||||
## Research Requirements
|
||||
External_Library_Research:
|
||||
- Identify library/framework mentioned
|
||||
- Context7 lookup for official documentation
|
||||
- Verify API patterns and examples
|
||||
- Check version compatibility
|
||||
- Document findings in implementation
|
||||
Pattern_Research:
|
||||
- Search existing codebase for similar patterns
|
||||
- Magic component search if UI-related
|
||||
- WebSearch for official documentation
|
||||
- Validate approach with Sequential thinking
|
||||
- Document pattern choice rationale
|
||||
API_Integration_Research:
|
||||
- Official documentation lookup
|
||||
- Authentication requirements
|
||||
- Rate limiting and error handling
|
||||
- SDK availability and examples
|
||||
- Integration testing approach
|
||||
|
||||
## Lifecycle
|
||||
Pre_Execution:
|
||||
Risk_Assessment: Calculate risk score 1-10 based on data loss potential, irreversibility, scope, security
|
||||
Environment_Validation: Check required tools, permissions, resources, dependencies
|
||||
State_Preparation: Create checkpoint before risky ops, cache previous results
|
||||
During_Execution:
|
||||
Progress_Monitoring: Track operation progress, resource usage, error rates, token consumption
|
||||
Dynamic_Optimization: Adjust parallelism, switch strategies, cache results, fallback to native
|
||||
Error_Handling: Detect errors immediately, classify transient vs permanent, retry/fallback/halt
|
||||
Post_Execution:
|
||||
Verification: Confirm expected outcomes achieved, no side effects, state consistent
|
||||
Cleanup: Remove temp files, locks, cached data; update audit logs, metrics, docs
|
||||
Reporting: Generate success/failure report, performance metrics, recommendations
|
||||
|
||||
## Integration Patterns
|
||||
|
||||
**Quality Assurance:**
|
||||
- Pre-commit hooks for code quality
|
||||
- Test verification before commits
|
||||
- Conventional commit message enforcement
|
||||
- Branch protection rules
|
||||
|
||||
**Team Collaboration:**
|
||||
- Consistent branching strategies
|
||||
- Merge request workflows
|
||||
- Code review integration
|
||||
- Conflict resolution procedures
|
||||
|
||||
## Troubleshooting
|
||||
- **Merge Conflicts**: Use `--merge --interactive` for guided resolution
|
||||
- **Complex History**: Apply `--history --visual` for topology understanding
|
||||
- **Repository Issues**: Use `--verify --cleanup` for maintenance
|
||||
- **Rollback Needs**: Apply `--rollback` with checkpoint selection
|
||||
|
||||
## Success Messages
|
||||
✅ {operation} completed successfully
|
||||
📝 Created: {file_path}
|
||||
✏ Updated: {file_path}
|
||||
✨ Task completed: {task_title}
|
||||
|
||||
Deliverables: Updated repo state, commit history, branch mgmt, remote sync.
|
||||
Reference in New Issue
Block a user