Overview

Guides and practices for coding standards, build systems, component integration, dependency management, and development workflows.

Getting Started

Backend Onboarding — Start here for your first Kotlin backend change. The ordered reading path through module shape, package layout, the endpoint DSL, the error boundary, persistence, and the coding conventions.
Development Environment Setup — Install prerequisites, clone the workspace, configure 1Password secrets, and verify each layer of the stack.
Development Workflows — Quick reference for standard build, test, and deploy commands across Arda repositories.
Tooling — Overview of the tools used across the workspace.

Worktree Conventions — Directory layout, branch naming, and lifecycle for Git worktrees used in project and multi-agent work.
Multi-Repository Gradle Development — Composite build patterns when common-module changes accompany a consuming service change.

Test-Driven Development — The rule for all implementation work. Write the test first, watch it fail, then make it pass — what counts as seeing it fail, when a new test should not be red, commit discipline, and the exceptions.
Implementation Task Workflow — How to scope, plan, and execute an implementation task.
Kotlin Coding Standards — Coding standards and patterns for Kotlin backend services. Index page: the ten rules that matter most, a reading order, and seven topic pages under kotlin/.
Frontend Development — Patterns and conventions for the React/TypeScript frontend.
UI Component Conventions — Standards for building components in ux-prototype.
Gradle Project Setup — How to configure a new Gradle project or submodule.

Data Authority API Guide — How to call and extend the Data Authority API.
Data Authority Endpoint Guide — Endpoint reference for the Data Authority service.

Working with AI Agent Assistants — Principles for effective collaboration with Claude Code, multi-agent team structure, monitoring, and anti-patterns.