FAQ

Frequently asked questions

About Coderbuds

What can Coderbuds show me about my team?

Coderbuds brings delivery, collaboration, and team-health signals into one place. You can see lead time, deployment frequency, review delays, pull request patterns, satisfaction trends, and how those measures change over time. Every metric links back to the work behind it, so you can understand what changed instead of guessing.

Do we need to use coding agents?

No. Connect GitHub or Bitbucket and Coderbuds can give you delivery and team-performance insights without any coding-agent setup. If your engineers do use coding agents, Coderbuds can also turn what the team learns into shared guidance inside those sessions.

Why not just put our standards in a CLAUDE.md file?

Start with one — it is the right first step, and we use rules files ourselves. What they cannot do is stay true. A rules file lives in one repo, so it drifts as the code moves and gets copied again for each agent vendor. It loads on every session whether it is relevant or not, and it never tells you which rules actually helped. Coderbuds serves the same standards to any agent across every repo, sends only what a session needs, and measures whether following them made the team faster.

Compare Coderbuds with repository context files

Is this a surveillance tool for tracking engineers?

Coderbuds is designed to improve how a team works, not to rank people. Engineering managers and team leads can see some individual delivery data, such as pull request activity. Engineers can see the same data about themselves, and coaching is shown to them first. Satisfaction surveys are anonymous and only reported at team level.

Are you just another DORA dashboard?

No. DORA metrics are one part of Coderbuds. The dashboard shows where delivery is slowing down, while the Coderbuds AI Agent provides tools for checking changes, following up reviews, and monitoring deployments. It then tracks whether those actions helped.

Do you store our code?

No. Your source code stays in GitHub or Bitbucket. Coderbuds stores only the delivery metadata it needs, such as pull request titles, timestamps, and statistics.

What is the SPACE Framework?

SPACE is a way to understand developer productivity from five angles: satisfaction and wellbeing, performance, activity, communication and collaboration, and efficiency and flow. It helps teams look beyond code output alone. Coderbuds brings those signals together with DORA delivery metrics.

How do you measure developer satisfaction?

We use anonymous weekly pulse surveys (3 questions, ~1 minute) and monthly deep dive surveys (15 questions, ~5 minutes) to track happiness, focus time, collaboration quality, tools satisfaction, and growth opportunities. Team leads only see aggregated team-level scores to protect individual privacy and encourage honest feedback.

Why measure multiple dimensions instead of just velocity?

Single metrics can be gamed. If you only track PRs shipped, teams create tiny PRs. If you only track deployments, quality suffers. SPACE's 5 dimensions create a balanced scorecard—you can't optimize one without the others staying healthy. It's how elite teams maintain sustainable performance.

How quickly can I see results?

Within 5 minutes of connecting your repositories. Trial users get 30 days of historical data imported and analyzed. Subscribers get 6 months of history for deeper trend analysis.

What makes Coderbuds different from LinearB or Swarmia?

AI agents that don't just show you metrics — they act on them. Review Chaser nudges slow reviewers, PR Size Coach suggests splits, Deploy Health responds to failures. Every agent tracks outcomes so you can prove what worked. Built for 5–50 person teams with transparent pricing and no implementation project.

How does Coderbuds help engineering leaders?

AI agents handle improvement at scale — chasing slow reviewers, flagging oversized PRs, and responding to deployment failures. You enable an agent, it takes action, and outcome tracking proves whether things improved. Leaders get measurable results without micromanaging.

Getting Started

How do I connect my GitHub repositories?

Navigate to your team's repositories page and click "Add Repository". You'll need GitHub admin access to the repositories you want to connect. Coderbuds will automatically set up webhooks to track pull requests and activities.

Why aren't my deployments showing up?

Deployments require GitHub Actions with proper deployment tracking. Make sure your workflow includes an environment section and the deployments: write permission. See our Setup Guide for examples.

How long does it take to see data?

Pull request data appears immediately once repositories are connected. DORA metrics typically show meaningful data after a few deployments and pull requests have been processed, usually within 24-48 hours of setup.

How are monthly seats counted?

Monthly billing is based on the number of active people in the last 30 days. Activity comes from pull requests or pull request logs, and linked accounts are collapsed so a person only counts once.

DORA Metrics

What are DORA metrics and why do they matter?

DORA (DevOps Research and Assessment) metrics are industry-standard measurements for software delivery performance: Deployment Frequency, Lead Time, Change Failure Rate, and Mean Time to Recovery. They help teams identify bottlenecks and improve their development practices.

How is Lead Time calculated?

Lead Time is measured from when a pull request is created until it's deployed to production. This includes code review time, merge time, and deployment pipeline duration. It reflects how quickly your team can deliver changes to users.

Can I manually mark deployments as failures?

Yes! Use the "Mark as Failure" button on deployment cards to track production issues that weren't automatically detected. You can also link recovery deployments to calculate accurate Mean Time to Recovery.

What's considered an elite-performing team?

Elite teams deploy multiple times per day, have lead times under 24 hours, change failure rates below 15%, and recover from incidents in under 1 hour. These benchmarks come from years of DevOps research across thousands of organizations.

Pull Requests

How are pull request sizes categorized?

PRs are automatically categorized by total lines changed (additions + deletions): Tiny (<10 lines), Small (10-99), Medium (100-299), Large (300-599), Extra Large (600-1199), and Oversized (1200+). Smaller PRs are generally easier to review and have lower defect rates.

What do the AI-powered quality scores mean?

AI scores analyze code structure, documentation quality, testing coverage, and adherence to best practices. Scores range from 1-10, helping teams identify PRs that might need additional review or improvements.

Can I filter pull requests by specific team members?

Currently, you can filter by repository and status. Team member filtering is on our roadmap. You can use the search functionality to find PRs by specific authors or reviewers.

Technical & Security

What GitHub permissions does Coderbuds need?

Coderbuds needs read access to repositories, pull requests, and deployment data. We also require webhook management permissions to receive real-time updates. All permissions are used only for metrics collection and analysis.

Can I use Coderbuds with private repositories?

Yes! Coderbuds fully supports private repositories. All data is encrypted in transit and at rest. We never store your actual code content, only metadata like commit SHAs, timestamps, and PR statistics.

Is Coderbuds SOC 2 ready and enterprise-grade?

Yes! Coderbuds implements enterprise-grade security: AES-256 encryption for all OAuth tokens, BitBucket webhook security (P0.1), HMAC-SHA256 validation with IP allowlisting, timing-attack protection, and comprehensive audit logging. Our security architecture resolves critical P0 vulnerabilities and meets SOC 2 requirements for enterprise deployments and regulatory compliance.

How do you secure webhook integrations?

We implement P0.1 BitBucket webhook security with HMAC-SHA256 signature validation, IP allowlisting for BitBucket Cloud ranges, and timing-attack protection using cryptographically secure comparisons. All webhook requests are validated against official provider IP ranges before processing, preventing unauthorized webhook injection and malicious attacks.

How are OAuth tokens protected?

All GitHub and BitBucket OAuth tokens are encrypted at rest using AES-256 encryption with Laravel's built-in security system. Tokens are encrypted when stored and decrypted only when needed for API requests. This protects against database breaches and meets enterprise security requirements.

Why are some of my old pull requests missing?

Coderbuds begins tracking data from the moment repositories are connected. Historical data isn't automatically imported, but you can contact support if you need specific historical analysis.

How do I remove a repository from tracking?

Go to your team's repositories page and click the remove button next to the repository. This will disable webhooks and stop new data collection. Historical data remains available for analysis.

Still have questions?

Our support team is here to help.