Skip to content
consultancy-practices logo

Consultancy Practices

consultancy-practices

Apply effective software quality consultancy practices. Use when consulting, advising clients, or establishing consultancy workflows.

SKILL.md

Full skill instructions

Consultancy Practices

<default_to_action> When consulting on quality:

  1. LISTEN FIRST: Understand their context before prescribing solutions
  2. DISCOVER: What's the pain? What have they tried? What are constraints?
  3. PRIORITIZE: Impact/​effort matrix - high impact, low effort first
  4. TRANSFER KNOWLEDGE: Leave them better, not dependent on you
  5. MEASURE: Define success metrics upfront, track weekly

Engagement Types:

  • Assessment (1-4 weeks): Discover, analyze, recommend
  • Transformation (3-12 months): Implement new practices
  • Advisory (ongoing): Strategic guidance, course-correct
  • Crisis (1-4 weeks): Fix critical issues blocking production

Key Questions:

  • "Walk me through your last deployment"
  • "Tell me about a recent bug that escaped to production"
  • "If you could fix one thing, what would it be?" </​default_to_action>

Quick Reference Card

The Consulting Process

PhaseDurationGoalDeliverable
DiscoveryWeek 1-2Understand contextInterview notes, observations
AnalysisWeek 2-3Identify root causesImpact/​effort matrix
RecommendationsWeek 3-4Present findingsReport with roadmap
ImplementationMonth 2-6+Execute changesWorking system, trained team
TransitionFinal monthEnsure self-sufficiencyHandover docs

Impact/​Effort Matrix

PriorityWhatAction
High Impact, Low EffortQuick winsDo first
High Impact, High EffortMajor initiativesPlan carefully
Low Impact, Low EffortNice-to-havesIf time permits
Low Impact, High EffortDistractionsSkip

Common Patterns

"We Need Test Automation"

What they say: "We need test automation" What they mean: "Manual testing is too slow/​expensive"

Discovery: How long is regression? What's deployment frequency?

Typical Finding: They need faster feedback, not "automation"

Recommendation:

  1. Unit tests for new code (TDD)
  2. Smoke tests for critical paths
  3. Keep exploratory for discovery
  4. Build automation incrementally

"Fix Our Quality Problem"

What they say: "We have too many bugs" What they mean: "Something is broken but we don't know what"

Discovery: Where found? What types? When introduced?

Typical Finding: No test strategy, testing too late, poor feedback loops

Recommendation:

  1. Shift testing left
  2. Improve coverage on critical paths
  3. Speed up CI/​CD feedback
  4. Better requirements/​acceptance criteria

"We Want to Scale Quality"

What they say: "Growing fast, quality can't keep up" What they mean: "Can't hire enough QA fast enough"

Discovery: Current QA:Dev ratio? Where's QA spending time?

Typical Finding: QA is bottleneck - manual regression, gatekeeping

Recommendation:

  1. Make QA strategic, not tactical
  2. Developers own test automation
  3. QA focuses on exploratory, risk analysis
  4. Use agentic approaches for scale

Anti-Patterns

Anti-PatternProblemBetter
Cookie-CutterSame solution everywhereContext-specific recommendations
Tool PusherRecommend expensive toolsTools that solve actual problems
Process NaziImpose rigid processLightweight, fits their culture
Permanent FixtureNever leave, create dependencyWork toward them not needing you
Blame GamePoint fingers at peopleFix systems, not blame people

Difficult Situations

"We already tried that" → "Tell me what you tried and what didn't work" (learn from their experience)

"Our context is special" → "Help me understand what makes yours special" (they might be right, or making excuses)

"We don't have budget/​time" → "What's the cost of not fixing this? Let's start small" (show ROI)

"That won't work here" → "What specific constraints? Let's adapt" (find what WILL work)


Agent Integration

// Automated codebase assessment
const assessment = await Task("Assess Codebase", {
  scope: 'client-project/',
  depth: 'comprehensive',
  reportFormat: 'executive-summary'
}, "qe-quality-analyzer");

// Returns: { qualityScore, testCoverage, technicalDebt, recommendations }

// ROI analysis for quality initiatives
const roi = await Task("Calculate ROI", {
  currentState: { defectEscapeRate: 0.15, mttr: 48 },
  proposedImprovements: ['test-automation', 'ci-cd-pipeline'],
  timeframe: '6-months'
}, "qe-quality-analyzer");

// Returns: { estimatedCost, estimatedSavings, paybackPeriod }

Agent Coordination Hints

Memory Namespace

aqe/​consultancy/
├── assessments/​*      - Client assessments
├── recommendations/​*  - Prioritized recommendations
├── roi-analysis/​*     - ROI calculations
└── progress/​*         - Implementation tracking

Fleet Coordination

const consultingFleet = await FleetManager.coordinate({
  strategy: 'client-engagement',
  agents: [
    'qe-quality-analyzer',          // Assess current state
    'qe-regression-risk-analyzer',  // Risk assessment
    'qe-quality-gate',              // Define quality gates
    'qe-deployment-readiness'       // Deployment maturity
  ],
  topology: 'hierarchical'
});

Related Skills


Remember

Good consulting is about empowering teams, not creating dependency. Your success is measured by them not needing you anymore - while still wanting to work with you again.

Best compliment: "We've got this now, but when we tackle X next year, we're calling you."

Be honest. Be helpful. Be context-driven. Leave them better.

More DevOps & CI/CD skills

Project scaffolding, deployment configuration, and CI/CD setup for Google ADK agents.

6K 472.6K
View

Set up tracing, logging, and monitoring for deployed ADK agents across Cloud Trace, BigQuery, and third-party platforms.

6K 472.6K
View

Enterprise Azure infrastructure architect generating Bicep or Terraform from workload descriptions.

1.5K 454.3K
View
azure-kubernetes logo
DevOps & CI/CD

azure-kubernetes

Plan and configure production-ready Azure Kubernetes Service clusters with Day-0 and Day-1 best practices.

1.5K 447.1K
View

Raw mechanical interfaces fusing Swiss typographic print with military terminal aesthetics. Rigid grids, extreme type scale contrast, utilitarian color, analog degradation effects. For data-heavy dashboards, portfolios, or editorial sites that need to feel like declassified blueprints.

92.7K 354.9K
View
just-scrape logo
DevOps & CI/CD

just-scrape

Web search, scraping, extraction, crawling, and monitoring via ScrapeGraph AI CLI.

69 245K
View

Skill for working with Firebase Hosting (Classic). Use this when you want to deploy static web apps, Single Page Apps (SPAs), or simple microservices. Do NOT use for Firebase App Hosting.

462 159.7K
View

Deploy and manage web apps with Firebase App Hosting. Use this skill when deploying Next.js/Angular apps with backends.

462 159.1K
View
deploy-to-vercel logo
DevOps & CI/CD

deploy-to-vercel

Deploy applications and websites to Vercel. Use when the user requests deployment actions like "deploy my app", "deploy and give me the link", "push this live", or "create a preview deployment".

31.9K 146.6K
View
programmatic-seo logo
DevOps & CI/CD

programmatic-seo

Build SEO-optimized pages at scale using templates, data, and proven playbook patterns.

53.3K 140.1K
View

Design and build isolated, reusable Convex backend components with clear boundaries and app-facing wrappers.

63 123.5K
View

Deploy and manage projects on Vercel using token-based authentication. Use when working with Vercel CLI using access tokens rather than interactive login — e.g. "deploy to vercel", "set up vercel", "add environment variables to vercel".

31.9K 116.1K
View

Coding & apps AI tools

Opus Clip logo
Coding & apps

Opus Clip

Opus.ai: Revolutionize Your Web Experience

Free
View
I
Coding & apps

Imagica

Build a no-code AI app in minutes.

Freemium
View
E
Coding & apps

Emergent.sh

An IDE for code migration from legacy to modern frameworks through coding agents.

Freemium
View
Wonder Dynamics logo
Coding & apps

Wonder Dynamics

Automate CGI animation in live-action scenes

Paid
View
M
Coding & apps

Mixo

Launch a website in seconds with AI.

Paid
View
AI Code Convert logo
Coding & apps

AI Code Convert

Streamline Your Coding Experience with AI Code Helper

Free
View