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.

Git and 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.

Implementation Practices

• 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.

API Guides

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

AI-Assisted Development

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