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