Creating Variants

Creating Team Workflow Variants

Adapt aug marketplace content to team's existing tools and processes.

Philosophy: Prescriptive tools adapted to context beat generic tools. Fork aug content, adapt to team reality, maintain opinionated workflows.

Finding Aug Marketplace Source

Discovery sequence:

1. Check ~/.claude/plugins/known_marketplaces.json for aug location
2. Try common paths: ~/.claude/marketplaces/aug, ~/aug, /opt/aug
3. Ask user if detection fails

Verify by checking for $AUG_PATH/aug-dev/commands/plan-chat.md.

Discovery Areas

1. Git Workflow

Detect: .git/config (remote URL), git branch -a (patterns)

Key questions:

• "What branches do releases come from?" (main, develop, release/*)
• "How are features developed?" (feature/, user/, TICKET-*)

Options: Trunk-based, Gitflow, GitHub Flow, Custom

Adaptations: Branch prefixes, PR targets, commit message format

2. Issue Tracking

Detect: gh auth status, .jira/config, .github/

Key questions:

• "Where do you track work?" (GitHub Issues, Jira, Linear, files, none)
• "How do you reference issues in commits?" (#123, PROJ-123, plain text)

Options: GitHub Issues, Jira, Linear, File-based, None

Adaptations: Issue commands, reference formats, metadata fields

3. CI/CD Platform

Detect: .github/workflows/, Jenkinsfile, .gitlab-ci.yml, .circleci/config.yml

Key questions:

• "What triggers CI?" (push, PR, manual dispatch)
• "What must pass before merge?" (tests, lint, coverage threshold)

Adaptations: CI config generation, quality check integration

4. Build Tool

Detect: justfile, Makefile, package.json, pom.xml, build.gradle

Key questions:

• "What runs your builds?" (just, make, npm, gradle, maven)
• "What quality gates are missing?" (coverage, complexity, security)

Adaptations: Build command interface, quality gates

5. Stack & Tooling

Detect: File extensions, config files, dependency files

Key questions:

• "What tools do you love?" (keep these unchanged)
• "What tools cause friction?" (candidates for replacement)

Merge strategy: Keep working tools, add for gaps, replace only if causing pain

6. Team Conventions

Detect: git log (commit format), gh pr list (PR naming), directory structure

Key questions:

• "What commit message format?" (conventional commits, Jira-prefix, freeform)
• "Where does documentation live?" (README, docs/, wiki, Confluence)

Adaptation Patterns

Command Adaptation

• Branch patterns: feature/* vs {JIRA-KEY}-*
• Issue commands: gh issue vs jira issue
• Build commands: just check-all vs mvn verify
• Terminology: "epic" vs "feature"

Workflow Adaptation

Original: /plan-chat -> /plan-breakdown -> /plan-create -> /work

Adapted examples:

• Jira + Gitflow: /plan-feature -> /plan-tasks -> /create-jira-epic -> /implement
• File-based: /design-epic -> /break-into-tasks -> /save-plan -> /build-task

Generation Process

1. Discover: Analyze environment, ask clarifying questions
2. Select: Choose workflows/components to adapt
3. Adapt: Replace patterns while preserving intent
4. Generate: Write to .claude/{commands,skills,workflows}/
5. Document: Create VARIANT.md explaining adaptations

Output Structure

.claude/
├── commands/         # Adapted commands
├── skills/           # Merged stack configuration
├── workflows/        # Adapted workflows
└── VARIANT.md        # Adaptation documentation

Maintenance

Variants are static forks:

• No automatic upstream sync
• Team owns and modifies files
• Re-run /create-variant to regenerate, use git diff to cherry-pick

Anti-Patterns

• Do not create generic "works for everyone" variants
• Do not add runtime detection/branching logic
• Do not try to maintain automatic sync with aug
• Do not replace working tools without asking