# 23people.io Handbook Summary **UPDATED AT:** 2025-04-24 This document presents a structured summary of the 23people.io Handbook, based on the files provided from the repository. The handbook is organized into several main sections covering everything from basic corporate information to specific technical details. ## Introduction 23people is a Chilean technology company founded in 2014 by two Software Engineers & Computer Scientists: Marcelo Ampuero and Manuel Reyes. The company focuses on providing technology services, especially in the areas of technology talent, digital platform development, and data and AI analysis. The name "23people" is inspired by the Matrix film saga, specifically the dialogue between The Architect and Neo where it mentions that 23 people will rebuild Zion. ## Who We Are ### Values 23people is based on three main values: 1. **Excellence and Intellectual Curiosity**: They pursue technical and professional excellence, cultivating a mindset of continuous learning. 2. **Collaboration and Assertive Communication**: They emphasize mutual support, transparency, and clear communication between professionals and teams. 3. **Sustainable Growth**: They seek economic growth and to become international benchmarks, but in a systematic, sustainable manner. ### Principles The company is guided by five fundamental principles: 1. **People First**: Prioritizes people, creating a respectful and motivating work environment. 2. **Sustainability**: Commitment to a sustainable business that respects natural, financial, and social resources. 3. **Transparency**: Making all processes and information that can be shared public. 4. **Equality**: Treating all people respectfully and equally, avoiding discrimination. 5. **Agility**: Use of agile principles to be an innovative, resilient, and efficient company. ### History Founded on November 26, 2014, by Marcelo Ampuero and Manuel Reyes with the idea of "creating a company where we ourselves would like to work". The company started modestly and has grown to have more than 90 active professionals, having counted more than 500 professionals throughout its history. They currently work with clients on three continents and have executed about 100 projects. ## What We Do 23people describes itself as "reliable technological facilitators and co-creators for companies seeking to evolve their digital products and services". Their service lines are: 1. **Tech Talent Outsourcing and Recruitment**: They identify and select technological professionals to complete client teams, offering: - IT Outsourcing - IT Hunting 2. **Digital Platforms, Cloud, and Modernization**: They co-create solutions for digitalization, automation, integrations, and operational data, including: - Integration - Modernization and Evolution - Data and Analytics - Automated QA 3. **Data, Advanced Analytics, and AI**: They enable data-driven decision-making through BigData technologies, predictive and generative AI, and advanced automation systems. ### What Sets Us Apart 1. **Specialization in Tech Roles**: Focus on professionals who master programming and software development. 2. **Optimization in Tech Recruitment**: Mature process for finding and selecting talent. 3. **Maturity in software development**: Data-based agile and evolutionary approach. 4. **Management of enterprise and emerging technologies**: Experience in mature and emerging technologies. 5. **Customer satisfaction**: Continuous accompaniment and support. ## Main Technologies 23people has a wide technological stack that covers different areas of development and implementation of digital solutions: ### Programming Languages - **Python**: Mainly used for AI projects, Machine Learning, data analysis, and backend. - **JavaScript/TypeScript**: Core of frontend and backend development with Node.js. - **Java**: For enterprise application development. - **C#**: Used in specific projects and .NET development. - **Go**: For microservices and high-performance applications. - **Rust**: In projects that require optimal performance and security. ### Web Frameworks and Technologies - **React**: Main library for user interface development. - **Next.js**: Framework for React applications with server-side rendering. - **Node.js**: Execution environment for server-side JavaScript. - **NestJS**: Framework for building server-side applications with Node.js. - **Spring Boot**: For Java application development. - **FastAPI/Flask**: Frameworks for API development in Python. - **Tailwind CSS**: For user interface styling. ### Databases - **MongoDB**: Main NoSQL database for projects requiring flexibility. - **PostgreSQL**: Robust relational database for projects with strict data structure. - **Redis**: For caching and key-value databases. - **Amazon DynamoDB**: For applications with scalability requirements. - **Vector databases**: Such as ChromaDB and Vectorize for AI applications. ### Cloud and Infrastructure - **Cloudflare**: For CDN, security, and application deployment (Cloudflare Pages, Workers, R2). - **AWS**: Wide range of services including S3, CloudWatch, Cognito, and RDS. - **Google Cloud Platform**: For specific services and projects requiring their tools. - **Azure**: For projects integrated with the Microsoft ecosystem. - **Docker**: For application containerization. - **Kubernetes**: For container orchestration in more complex projects. ### Artificial Intelligence and Machine Learning - **ML Frameworks**: TensorFlow, PyTorch, scikit-learn. - **Data processing libraries**: NumPy, Pandas. - **AI APIs**: OpenAI API, Anthropic API, Claude. - **AI Architectures and Techniques**: - Transformers - RAG (Retrieval-Augmented Generation) - AI Agents - LlamaIndex Framework ### Development Tools - **Git**: For version control. - **Visual Studio Code/Cursor**: Main IDEs. - **SonarQube**: For static code analysis. - **ESLint/RUFF**: Linters for JavaScript and Python. - **CI/CD Tools**: For continuous integration and deployment. - **Businessmap/Kanbanize**: For workflow management. This technological diversity allows 23people to address a wide range of projects, from web and mobile applications to complex artificial intelligence and data analysis solutions, always with a focus on efficiency, scalability, and sustainability. ## Our Organization ### Organizational Structure 23people's structure is circular to foster collaboration and communication. It is organized into multidisciplinary teams, each with a clear purpose: - **Tech Talent Services Team (TTS)**: Specialized in recruitment and retention of technological talent. - **Sales & Growth Marketing Team (SMKT)**: Manages commercial relationships and brand growth. - **Backoffice Services Team (BKO)**: Provides business administrative support. - **Research & Development Services Team (R&D)**: Explores emerging technologies. These teams make up the **Iarvis Tribe**. There is also the **Drakkar Tribe**, which groups the subcontracted professionals who work for clients. ### Internal Model Each team has autonomy around a defined purpose and offers specific services through "service APIs" that specify what they deliver, what to expect, and how to request it. Each team has: - A **Service Request Manager (SRM)**: Focused on "what" and "when" to do. - A **Service Delivery Manager (SDM)**: Focused on "how" and "who" does it. ### Position Levels and Responsibilities Positions are structured in three main layers: - **Direction**: Defines "what" must be achieved (strategic level). - **Management**: Implements "how" it is achieved (tactical level). - **Operations**: Executes "doing" the work (operational level). ## Practices Working practices at 23people include: 1. **Manage the work, not the people**: Use of visual workflows to manage activities. 2. **Everything is a service**: Visualizing work as a service that satisfies needs. 3. **Asynchronous communication**: Allowing collaborators to manage their time efficiently. 4. **Write, then communicate**: Structuring ideas before sharing them. 5. **Narrative structure**: Framework for effectively presenting initiatives or problems. 6. **Remote work**: Preference for remote work to improve work-life balance. 7. **Use of OKRs**: To establish and measure key objectives and results. ## Community and Benefits 23people offers various benefits for its collaborators: ### Agreements - Betterfly (wellness app) - Banco de Chile - Complementary Insurance ### Incentives - Vacation incentive - Birthday gift - National holidays and Christmas bonuses - Birthday day off - Baby shower bonus ### Refunds - Influenza vaccination - Courses and training - International certifications - Improvement of workspace ### Training - English classes ## Sustainability 23people has a commitment to sustainability, including: 1. **Formal commitment to Science Based Targets (SBTi)**: Reduction of carbon footprint aligned with the Paris Agreement. 2. **Emissions reduction strategy**: Plan to achieve Carbon Neutral certification. 3. **Sustainability team**: Led by the Global Operations Manager. 4. **Technology recommendations**: Selection of low-environmental-impact hardware and services. ## Technical Software Development Guide ### Principles - Simplicity above all - Balance between OOP and Functional Programming - SOLID principles - Business-centered approach - Scalability and maintainability - Transparency and collaboration ### Main Technologies 1. Node.js / NestJS 2. React 3. Python (for ML/AI) 4. MongoDB 5. PostgreSQL ### Methodologies - Kanban as an agile base - Adaptation to project needs - Constant collaboration and communication ### Practices - Version control (Git) - Code reviews - Automated testing - CI/CD - Pair/Mob Programming - Monitoring and observability - Light documentation ### Security - SonarQube - Burp Suite and OWASP ZAP - RUFF (for Python) - ESLint (for JavaScript/TypeScript) ## Featured Insights - **Business Digital Evolution**: Structured approach to digital evolution integrating data and expert knowledge. - **Recursion as a performance predictor**: Understanding recursion as an indicator of abstraction capability. - **Team Autonomy through Service APIs**: Model to maximize autonomy while maintaining organizational alignment. - **AI as a Capability Multiplier**: Use of AI to enhance professional capabilities.