From c99fafa03e9de724232b04a232f93ed3b2a82a64 Mon Sep 17 00:00:00 2001 From: "codegen-sh[bot]" <131295404+codegen-sh[bot]@users.noreply.github.com> Date: Wed, 24 Sep 2025 18:37:28 +0000 Subject: [PATCH 1/3] Add use cases documentation page - Created comprehensive use-cases.mdx page based on analysis of customer agent runs - Added page to Overview section in docs navigation - Categorized real-world usage patterns: development, code review, maintenance, project management, and specialized tasks - Included communication channel breakdown and key insights Co-authored-by: Jay Hack --- docs/docs.json | 1 + docs/introduction/use-cases.mdx | 162 ++++++++++++++++++++++++++++++++ 2 files changed, 163 insertions(+) create mode 100644 docs/introduction/use-cases.mdx diff --git a/docs/docs.json b/docs/docs.json index 2b1cc3eee..f85ad48fd 100644 --- a/docs/docs.json +++ b/docs/docs.json @@ -17,6 +17,7 @@ "group": "Overview", "pages": [ "introduction/overview", + "introduction/use-cases", "introduction/support", "introduction/community", "introduction/about", diff --git a/docs/introduction/use-cases.mdx b/docs/introduction/use-cases.mdx new file mode 100644 index 000000000..b2d1e5398 --- /dev/null +++ b/docs/introduction/use-cases.mdx @@ -0,0 +1,162 @@ +--- +title: "Use Cases" +description: "Real-world examples of how teams use Codegen agents based on analysis of thousands of customer interactions" +--- + +# Use Cases + +This page provides an LLM-generated summary of how teams are using Codegen agents, based on analysis of tens of thousands of customer agent runs. The data represents actual requests from users across different organizations and communication channels. + +## 🏗️ Code Development & Implementation (35%) + +The most common use case for Codegen agents is building new functionality and applications from scratch. + +**Full-stack app creation** +- Complete Next.js/React applications with production-ready UI/UX +- End-to-end web applications with authentication, databases, and deployment +- Mobile and desktop applications across different platforms + +**Feature implementation** +- Adding new functionality to existing codebases +- Implementing user stories and product requirements +- Building complex business logic and workflows + +**API development** +- Creating REST and GraphQL endpoints +- Third-party service integrations +- Microservices architecture and implementation + +**Database work** +- Schema design and migrations +- Complex queries and data analysis +- Database optimization and performance tuning + +## 🔍 Code Review & Analysis (25%) + +Teams heavily rely on Codegen for thorough code analysis and quality assurance. + +**PR reviews** +- Deep code analysis with inline suggestions +- Bug detection and security vulnerability identification +- Code quality and best practices validation + +**Codebase audits** +- Performance analysis and optimization recommendations +- Security reviews and compliance checks +- Technical debt assessment and prioritization + +**Architecture reviews** +- Design pattern validation and improvements +- System architecture recommendations +- Code organization and structure analysis + +**Migration analysis** +- Impact assessment for major changes +- Legacy system modernization planning +- Framework and library upgrade guidance + +## 🛠️ Bug Fixes & Maintenance (20%) + +Codegen agents excel at debugging and maintaining existing systems. + +**Issue resolution** +- Debugging complex problems across the stack +- Root cause analysis and systematic fixes +- Error handling and edge case management + +**Dependency updates** +- Package management and version conflict resolution +- Security patch application +- Breaking change migration assistance + +**Configuration fixes** +- Build system troubleshooting +- Deployment pipeline optimization +- Environment setup and configuration management + +**Performance optimization** +- Identifying and resolving bottlenecks +- Memory and CPU usage optimization +- Database query performance improvements + +## 📋 Project Management & Documentation (10%) + +Teams use Codegen to streamline project workflows and maintain documentation. + +**Linear ticket management** +- Creating and organizing development tasks +- Sprint planning and backlog management +- Progress tracking and status updates + +**Documentation creation** +- README files and setup instructions +- API documentation and guides +- Technical specifications and architecture docs + +**Project scoping** +- Breaking down large features into manageable tasks +- Effort estimation and timeline planning +- Risk assessment and mitigation strategies + +**Workflow automation** +- CI/CD pipeline setup and optimization +- Development process standardization +- Quality gates and automated checks + +## 🤖 AI/ML & Specialized Tasks (5%) + +Advanced use cases involving specialized tools and integrations. + +**Feature flag cleanup** +- Statsig and A/B testing tool maintenance +- Experimental feature management +- Configuration cleanup and optimization + +**Data analysis** +- SQL queries and business intelligence +- Performance metrics and analytics +- Data pipeline development and maintenance + +**Integration work** +- Third-party API connections +- Webhook setup and management +- Service-to-service communication + +**Custom tooling** +- Specialized utilities and automation scripts +- Developer productivity tools +- Internal service development + +## 💬 Communication Channels + +**Linear (35%)** +- Primarily used for ticket management and feature requests +- Project planning and sprint organization +- Task assignment and progress tracking + +**Chat/API (30%)** +- Development tasks and quick fixes +- Real-time problem solving +- Interactive debugging sessions + +**Slack (20%)** +- Team collaboration and questions +- Code reviews and discussions +- Knowledge sharing and support + +**GitHub (15%)** +- Pull request reviews and management +- Repository maintenance and organization +- Release planning and deployment + +## 🎯 Key Insights + +1. **Most common request**: "Review this PR" - developers want thorough, automated code analysis +2. **Growing trend**: Full-stack application development from scratch with production-ready requirements +3. **High value tasks**: Complex debugging, architecture decisions, and system design +4. **Quick wins**: Documentation updates, simple feature additions, and configuration fixes +5. **Team efficiency**: Agents handle routine tasks, allowing developers to focus on creative problem-solving + +## Getting Started + +Ready to leverage these use cases for your team? Check out our [overview](/introduction/overview) to get started, or explore specific [capabilities](/capabilities/capabilities) that align with your needs. From db85b4616f5bf354db83f37ea8fc7d20ad32f2e0 Mon Sep 17 00:00:00 2001 From: "codegen-sh[bot]" <131295404+codegen-sh[bot]@users.noreply.github.com> Date: Wed, 24 Sep 2025 18:53:01 +0000 Subject: [PATCH 2/3] Add sidebar title and icon to use cases page - Added sidebarTitle: 'Use Cases' to match other introduction pages - Added lightbulb icon with solid iconType for visual consistency - Follows the same frontmatter pattern as other docs pages Co-authored-by: Jay Hack --- docs/introduction/use-cases.mdx | 3 +++ 1 file changed, 3 insertions(+) diff --git a/docs/introduction/use-cases.mdx b/docs/introduction/use-cases.mdx index b2d1e5398..103a1cd17 100644 --- a/docs/introduction/use-cases.mdx +++ b/docs/introduction/use-cases.mdx @@ -1,5 +1,8 @@ --- title: "Use Cases" +sidebarTitle: "Use Cases" +icon: "lightbulb" +iconType: "solid" description: "Real-world examples of how teams use Codegen agents based on analysis of thousands of customer interactions" --- From b7d5aaf7ff684e9d90a357b268a0e68d3dc2727d Mon Sep 17 00:00:00 2001 From: "codegen-sh[bot]" <131295404+codegen-sh[bot]@users.noreply.github.com> Date: Wed, 24 Sep 2025 19:02:37 +0000 Subject: [PATCH 3/3] Remove description and header from use cases page - Removed description from frontmatter - Removed 'Use Cases' header to go straight into content - Cleaner, more direct presentation Co-authored-by: Jay Hack --- docs/introduction/use-cases.mdx | 3 --- 1 file changed, 3 deletions(-) diff --git a/docs/introduction/use-cases.mdx b/docs/introduction/use-cases.mdx index 103a1cd17..de441ad2a 100644 --- a/docs/introduction/use-cases.mdx +++ b/docs/introduction/use-cases.mdx @@ -3,11 +3,8 @@ title: "Use Cases" sidebarTitle: "Use Cases" icon: "lightbulb" iconType: "solid" -description: "Real-world examples of how teams use Codegen agents based on analysis of thousands of customer interactions" --- -# Use Cases - This page provides an LLM-generated summary of how teams are using Codegen agents, based on analysis of tens of thousands of customer agent runs. The data represents actual requests from users across different organizations and communication channels. ## 🏗️ Code Development & Implementation (35%)