Development philosophy and operational knowledge for Nesalia Inc.
This repository contains the comprehensive development handbook for building software at scale with AI agents. It covers the entire development lifecycle:
- Issues Management - How to create and organize issues
- Planning - How to plan features of any size
- Techno Expertise - Knowledge base for technologies
- Developer Agent - How agents execute work
- Pull Requests - Code review and merging
- Documentation Standards - How to write docs
Humans: Design, plan, validate
Agents: Execute, implement, deliver
Humans focus on what and why. Agents handle how.
docs/
├── workflows/
│ └── software-engineering/
│ ├── issues-management/ # Issue templates and management
│ ├── planning/ # Planning levels and templates
│ ├── techno-expertise/ # Technology courses
│ ├── developer-agent/ # Agent execution guide
│ └── pull-requests/ # PR process and templates
├── guide/ # Technology guides
│ └── typescript/ # TypeScript best practices
- Quality over Speed - Contract tests ensure interface compliance
- Knowledge as Code - Techno expertise courses are versioned
- Metrics-Driven - Measure agent performance continuously
- Structured Process - Clear workflows for predictability
This is the source of truth for development practices. All projects reference this repository for:
- Coding standards
- Process workflows
- Knowledge base
This repository is maintained by the Architecture Team. Changes follow the same process as other projects.
Last updated: 2026-03-06