gw-config-management

Original：🇺🇸 English
Translated

Configure and optimize gw-tools for different project types and team needs. Use when setting up gw for new projects, configuring auto-copy files, troubleshooting configuration issues, or customizing gw for Next.js, Node.js APIs, monorepos, or React SPAs. Triggers on .gw/config.json, auto-copy patterns, environment files, or gw init commands.

3installs
Sourcemthines/gw-tools
Added on

NPX Install

npx skill4agent add mthines/gw-tools gw-config-management

Tags

Translated version includes tags in frontmatter
gw-toolsconfiguration-managementproject-setupworkflow-optimizationauto-copy-files

SKILL.md Content

View Translation Comparison →

gw Configuration Management

Configure gw-tools for optimal workflows across different project types and team environments.

Rules

RuleDescription
fundamentalsHIGH - Config file location, creation, and precedence
options-referenceHIGH - Complete reference for all config options
setupHIGH - Initial setup flow, secrets, team onboarding
auto-copyHIGH - File patterns to copy, what to include/exclude
team-configMEDIUM - Sharing config, documentation, onboarding
advancedLOW - Multiple sources, secret management integration
troubleshootingHIGH - Common issues and solutions

Project-Type Patterns

PatternDescription
nextjsMEDIUM - Next.js with Vercel deployment
nodejs-apiMEDIUM - Node.js backend/API services
monorepoMEDIUM - pnpm/Yarn/npm workspaces
react-spaMEDIUM - React Single Page Applications

Quick Reference

TaskCommand
Initialize config
gw init
Initialize with options
gw init --auto-copy-files .env,secrets/
Interactive setup
gw init --interactive
Clone and initialize
gw init git@github.com:user/repo.git
Sync files to worktree
gw sync feature-branch
Show setup command
gw show-init

Configuration Options

OptionPurposeDefault
root
Repository root pathAuto-detected
defaultBranch
Source for file copying
"main"
autoCopyFiles
Files to auto-copy
[]
updateStrategy
merge or rebase
"merge"
cleanThreshold
Days before stale
7
autoClean
Prompt for cleanup
false

Key Principles

  • Set up secrets in defaultBranch first: Source must exist before auto-copy works.
  • Commit config to version control: Team gets it automatically.
  • Copy secrets, not dependencies: 
    .env
    yes, 
    node_modules
    no.
  • Use 
    gw show-init
    for documentation    : Generate setup command.

Related Skills

  • git-worktree-workflows - Using worktrees effectively
  • autonomous-workflow - Autonomous development workflows

Resources

  • Project-Type Guides - Configuration guides for common project types
  • Next.js Setup Example
  • Monorepo Setup Example
  • Troubleshooting Guide